TronCode IDE 使用手册
TronCode 是一款 AI 驱动的智能代码编辑器,内置 AI 助手,让你在熟悉的编辑器环境中高效完成代码生成、优化、调试等任务。
下载安装
Windows 平台
- 系统要求:Windows 10 或更高版本
- 安装方式:下载后双击
.exe文件,按安装向导完成安装
macOS 平台
- 系统要求:macOS 10.15 或更高版本
- 安装方式:
- 解压下载的
.zip文件 - 将 TronCode 应用拖拽到 Applications 文件夹
- 首次运行时,在「系统设置 → 隐私与安全性」中点击"仍然打开"
- 解压下载的
TronCode Key 注册申请
注册链接
访问官方页面:TronCode 平台,用手机号验证码注册登录。
注册步骤
步骤 1:访问注册页面
- 打开浏览器,访问 平台登录页
- 点击"登录"按钮
- 输入手机号,用验证码登录/注册
步骤 2:申请 API Key
- 登录后进入「API Key 管理」页面
- 点击"创建 API Key"按钮
- 输入 Key 名称(便于管理)
- 点击"创建"完成
步骤 3:保存 API Key
重要提醒:API Key 只会显示一次,请务必复制并安全保存!
Key 的使用
配置 API Key
通过设置界面配置
- 打开 TronCode 应用
- 在右侧 TRONIC CHAT 栏,输入创建的 API Key,保存即可
Key 管理
查看 Key 状态
- 在设置界面可以查看当前 Key 的状态
- 显示信息包括:有效期、剩余配额、权限级别
更新 Key
- 当 Key 即将过期时,系统会提前提醒
- 访问官网账户页面申请新的 Key
- 在设置中更新为新的 Key
Key 安全建议
- 不要将 API Key 分享给他人
- 定期更换 API Key
- 如发现 Key 泄露,立即在官网删除并申请新的 Key
TronCode 主要功能
1. 智能代码生成
- 功能描述:基于自然语言描述生成高质量代码
- 支持语言:Python、JavaScript、Java、C++、Go、Rust 等主流编程语言
- 使用方法:在输入框中描述你的需求,选择目标语言,查看生成的代码
2. 代码优化与重构
- 功能描述:分析现有代码并提供优化建议
- 主要特性:性能优化、代码风格统一、安全漏洞检测、最佳实践推荐
3. 代码解释与文档生成
- 功能描述:为复杂代码生成清晰的解释和文档
- 输出格式:函数/类详细说明、参数和返回值描述、使用示例、Markdown 格式文档
4. 错误诊断与修复
- 功能描述:快速定位并修复代码错误
- 支持的错误类型:语法错误、逻辑错误、运行时错误、性能问题
TronCode 使用介绍
第一节:与 TronCode 聊天
如何与 TronCode 对话
关键建议:只需用中文/英文输入你想要的内容,无需特殊命令。
好的对话示例:
创建一个名为 utils.py 的新文件,并添加一个名为 add 的函数,接受两个数字并返回它们的和
在文件 @src/components/Button.tsx 中,将按钮的颜色更改为蓝色
让请求生效的关键因素:
- 具体:「修复
calculateTotal中返回不正确结果的错误」胜过「修复代码」 - 使用 @ 提及:用
@filename直接引用文件和代码 - 一次一个任务:将复杂工作分解为可管理的步骤
- 包含示例:展示你想要的样式或格式
聊天界面
- 聊天历史记录:查看你的对话和任务历史
- 输入字段:在此输入请求(按 Enter 发送)
- 操作按钮:批准或拒绝 TronCode 的提议更改
- 加号按钮:开始新的任务会话
- 模式选择器:选择 TronCode 处理任务的方式
需要避免的常见错误
| 替代这个... | 尝试这个 |
|---|---|
| "Fix the code" | 「修复 calculateTotal 中返回不正确结果的错误」 |
| 假设 TronCode 知道上下文 | 使用 @ 引用特定文件 |
| 多个不相关的任务 | 一次提交一个重点突出的请求 |
| 技术术语过多 | 清晰、直接的语言效果最好 |
第二节:使用模式
TronCode 中的模式是专门设计的智能体,根据当前任务调整助手的行为。
切换模式
四种切换方式:
- 下拉菜单:点击聊天输入框左侧的选择器
- 斜杠命令:输入
/architect、/ask、/debug或/code - 键盘快捷键:
⌘+.(macOS)/Ctrl+.(Windows/Linux)循环切换模式 - 接受建议:点击 TronCode 提供的模式切换建议
内置模式
| 模式 | 描述 | 工具访问 | 适合场景 |
|---|---|---|---|
| Code(默认) | 熟练的软件工程师 | 完全访问所有工具 | 编写代码、实现功能、一般开发 |
| Ask | 知识渊博的技术助手,不修改代码库 | 仅 read、browser、mcp | 代码解释、概念探索、技术学习 |
| Architect | 技术领导和规划者 | read、browser、mcp 及受限 edit(仅 markdown) | 系统设计、高层规划、架构讨论 |
| Debug | 系统化故障排除专家 | 完全访问所有工具 | 追踪 bug、诊断问题 |
| Orchestrator | 战略工作流协调者 | 有限访问,用于任务协调 | 将复杂项目分解为子任务 |
自定义模式
通过定义工具访问权限、文件权限和行为指令,创建你自己的专业助手。自定义模式有助于执行团队标准或创建特定用途的助手。
第三节:上下文提及
上下文提及是一种强大的方式,使用 @ 符号引用文件、文件夹、问题和 Git 提交,为 TronCode 提供项目的具体信息。
提及类型
| 提及类型 | 格式 | 描述 |
|---|---|---|
| 文件 | @/path/to/file.ts | 将文件内容包含在请求上下文中 |
| 文件夹 | @/path/to/folder/ | 以树状格式提供目录结构 |
| 问题 | @problems | 包含 VS Code 问题面板的诊断信息 |
| 终端 | @terminal | 包含最近的终端命令和输出 |
| Git 提交 | @a1b2c3d | 通过哈希引用特定提交 |
| Git 更改 | @git-changes | 显示未提交的更改 |
| URL | @https://example.com | 导入网站内容 |
如何使用提及
- 在聊天输入框中输入
@触发建议下拉菜单 - 继续输入以过滤建议,或用箭头键导航
- 按回车或鼠标点击选择
- 在请求中组合多个提及:「修复
@/src/component.ts中的@problems」
常见问题
Q: API Key 配额用完了怎么办?
A: 在官网账户页面查看配额使用情况,并根据需要升级套餐或等待配额重置。
Q: 生成的代码质量如何保证?
A: TronCode 使用先进的 AI 模型,建议你:仔细审查生成的代码,进行充分的测试,根据项目需求进行适当调整。
Q: 支持离线使用吗?
A: TronCode 需要网络连接来访问 AI 服务,暂不支持完全离线使用。
Q: 如何获得技术支持?
A: 邮件支持:support@linkwo.com
联系我们
- 官方网站:https://www.troncode.cn
- 技术支持:support@linkwo.com
- 商务合作:business@linkwo.com