中文 English

TronCode 使用手册

下载

Windows 平台

  • 下载地址: Windows 版本下载
  • 系统要求: Windows 10 或更高版本
  • 安装方式: 双击下载的 .exe 文件，按照安装向导完成安装

Mac 平台

  • 下载地址: Mac 版本下载
  • 系统要求: macOS 10.15 或更高版本
  • 安装方式:
    1. 双击下载的 .zip 文件，解压缩。
    2. 将 TronCode 应用拖拽到 Applications 文件夹
    3. 首次运行时可能需要在系统偏好设置中允许运行

TronCode Key 注册申请

注册链接

访问官方页面：TronCode 注册

注册步骤

步骤 1：访问注册页面

  1. 打开浏览器，访问 注册链接
  2. 点击左下角"登录"按钮
  3. 输入手机号，用验证码登录注册

步骤 2：申请 API Key

  1. 打开浏览器，访问 API Key申请
  2. 点击"创建API Key"按钮
  3. 输入API Key名称（便于管理）
  4. 点击"创建" 按钮

步骤 3：保存 API Key

⚠️ 重要提醒: API Key 只会显示一次，请务必复制并安全保存！

Key 的使用

配置 API Key

方法一：通过设置界面配置

  1. 打开 TronCode 应用
  2. 在右侧 TRONIC CHAT 栏，输入创建的API Key，保存即可

Key 管理

查看 Key 状态

  • 在设置界面可以查看当前 Key 的状态
  • 显示信息包括：有效期、剩余配额、权限级别

更新 Key

  1. 当 Key 即将过期时，系统会提前提醒
  2. 访问官网账户页面申请新的 Key
  3. 在设置中更新为新的 Key

Key 安全建议

  • 不要将 API Key 分享给他人
  • 定期更换 API Key
  • 如发现 Key 泄露，立即在官网删除，并申请新的key

TronCode 主要功能

主要功能

1. 智能代码生成

  • 功能描述: 基于自然语言描述生成高质量代码
  • 支持语言: Python, JavaScript, Java, C++, Go, Rust 等主流编程语言
  • 使用方法:
    1. 在输入框中描述您的需求
    2. 选择目标编程语言
    3. 点击"生成代码"按钮
    4. 查看并使用生成的代码

2. 代码优化与重构

  • 功能描述: 分析现有代码并提供优化建议
  • 主要特性:
    • 性能优化建议
    • 代码风格统一
    • 安全漏洞检测
    • 最佳实践推荐

3. 代码解释与文档生成

  • 功能描述: 为复杂代码生成清晰的解释和文档
  • 输出格式:
    • 函数/类的详细说明
    • 参数和返回值描述
    • 使用示例
    • Markdown 格式文档

4. 错误诊断与修复

  • 功能描述: 快速定位并修复代码错误
  • 支持的错误类型:
    • 语法错误
    • 逻辑错误
    • 运行时错误
    • 性能问题

TronCode 使用介绍

第一节：与 TronCode 聊天

如何与 TronCode 对话

关键建议： 只需用中文/英文输入您想要的内容。无需特殊命令。

好的对话示例：

创建一个名为 utils.py 的新文件，并添加一个名为 add 的函数，该函数接受两个数字作为参数并返回它们的和
在文件 @src/components/Button.tsx 中，将按钮的颜色更改为蓝色
在 @/src/App.js 中查找变量 oldValue 的所有实例，并将其替换为 newValue

使请求生效的因素：

  • 具体 - "修复 calculateTotal 中返回不正确结果的错误"胜过"修复代码"
  • 使用 @ 提及 - 使用 @filename 直接引用文件和代码
  • 一次一个任务 - 将复杂工作分解为可管理的步骤
  • 包含示例 - 显示您想要的样式或格式

聊天界面

基本控件：

  • 聊天历史记录 - 查看您的对话和任务历史记录
  • 输入字段 - 在此处输入您的请求（按 Enter 发送）
  • 操作按钮 - 批准或拒绝 TronCode 的提议更改
  • 加号按钮 - 开始新的任务会话
  • 模式选择器 - 选择 TronCode 应如何处理您的任务

快速交互

点击操作：

  • 文件路径 → 打开文件
  • URL → 在浏览器中打开
  • 消息 → 展开/折叠详细信息
  • 代码块 → 出现复制按钮

状态信号：

  • 旋转 → TronCode 正在工作
  • 红色 → 发生错误
  • 绿色 → 成功

需要避免的常见错误

替代这个... 尝试这个
"Fix the code" "修复 calculateTotal 中返回不正确结果的错误"
假设 TronCode 知道上下文 使用 @ 引用特定文件
多个不相关的任务 一次提交一个重点突出的请求
技术术语过多 清晰、直接的语言效果最好

重要的原因： 当您像与需要明确指导的队友交谈一样进行交流时，TronCode 的效果最佳。

第二节：使用模式

TronCode 中的模式是专门设计的智能体，可以根据当前任务调整助手的行为。每种模式都提供不同的能力、专业知识和访问权限，帮助你完成特定目标。

为什么使用不同的模式？

  • 任务专业化：获得针对当前任务所需的精确帮助
  • 安全控制：在专注于规划或学习时，防止意外的文件修改
  • 专注交互：接收针对当前活动优化的响应
  • 工作流优化：在规划、实施、调试和学习之间无缝切换

切换模式

四种切换模式的方式：

  1. 下拉菜单：点击聊天输入框左侧的选择器
  2. 斜杠命令：在聊天输入框中输入 /architect、/ask、/debug 或 /code
  3. 切换命令/键盘快捷键：使用适用于你操作系统的键盘快捷键。每次按下都会按顺序循环切换可用模式，到达末尾后返回第一个模式。
操作系统 快捷键
macOS ⌘ + .
Windows Ctrl + .
Linux Ctrl + .
  1. 接受建议：在适当时点击 TronCode 提供的模式切换建议

内置模式

Code代码模式（默认）
方面 详细信息
描述 一位熟练的软件工程师，精通编程语言、设计模式和最佳实践
工具访问 完全访问所有工具组：read、edit、browser、command、mcp
适合场景 编写代码、实现功能、调试和一般开发
特殊功能 无工具限制——所有编码任务完全灵活
Ask问答模式
方面 详细信息
描述 一位知识渊博的技术助手， 专注于回答问题而不修改代码库
工具访问 有限访问：仅 read、browser、mcp（无法编辑文件或运行命令）
适合场景 代码解释、概念探索和技术学习
特殊功能 优化为在不修改项目的情况下提供信息丰富的响应
Architect架构师模式
方面 详细信息
描述 一位经验丰富的技术领导和规划者，帮助设计系统并创建实施计划
工具访问 访问 read、browser、mcp 和受限的 edit（仅限 markdown 文件）
适合场景 系统设计、高层规划和架构讨论
特殊功能 遵循从信息收集到详细规划的结构化方法
Debug调试模式
方面 详细信息
描述 一位擅长系统化故障排除和诊断的专家问题解决者
工具访问 完全访问所有工具组：read、edit、browser、command、mcp
适合场景 追踪错误、诊断问题并解决复杂问题
特殊功能 使用分析、缩小可能性和修复问题的系统化方法
Orchestrator协调者模式
方面 详细信息
描述 一位战略工作流协调者，通过将复杂任务委派给适当的专业模式来协调工作
工具访问 有限的访问权限，用于创建新任务和协调工作流
适合场景 将复杂项目分解为可管理的子任务，并分配给专业模式
特殊功能 使用 new_task 工具将工作委派给其他模式

自定义模式

通过定义工具访问权限、文件权限和行为指令，创建你自己的专业助手。自定义模式有助于执行团队标准或创建特定用途的助手。

第三节：上下文提及

上下文提及是一种强大的方式，可以为 TronCode 提供项目的具体信息，使其能够更准确高效地执行任务。你可以使用提及来引用文件、文件夹、问题和 Git 提交。上下文提及以 @ 符号开头。

提及类型

提及类型 格式 描述 示例用法
文件 @/path/to/file.ts 将文件内容包含在请求上下文中 "解释 @/src/utils.ts 中的函数"
文件夹 @/path/to/folder/ 以树状格式提供目录结构 "@/src/components/ 中有哪些文件？"
问题 @problems 包含 VS Code 问题面板的诊断信息 "@problems 修复我代码中的所有错误"
终端 @terminal 包含最近的终端命令和输出 "修复 @terminal 中显示的错误"
Git 提交 @a1b2c3d 通过哈希引用特定提交 "提交 @a1b2c3d 中有什么变化？"
Git 更改 @git-changes 显示未提交的更改 "为 @git-changes 建议一条提交消息"
URL @https://example.com 导入网站内容 "总结 @https://docusaurus.io/"

如何使用提及

  1. 在聊天输入框中输入 @ 以触发建议下拉菜单
  2. 继续输入以过滤建议，或使用箭头键导航
  3. 按回车键或鼠标点击选择
  4. 在请求中组合多个提及："修复 @/src/component.ts 中的 @problems"

下拉菜单会自动建议：

  • 最近打开的文件
  • 可见的文件夹
  • 最近的 Git 提交
  • 特殊关键字（problems、terminal、git-changes）

最佳实践

实践 描述
使用具体路径 引用确切文件而非描述它们
使用相对路径 始终从工作区根目录开始：@/src/file.ts 而非 @C:/Projects/src/file.ts
验证引用 确保路径和提交哈希正确
点击提及 点击聊天历史中的提及以打开文件或查看内容
避免复制粘贴 使用提及而非手动复制代码或错误信息
组合提及 "使用提交 @a1b2c3d 中的模式修复 @/src/component.ts 中的 @problems"

常见问题

常见问题

Q: API Key 配额用完了怎么办？

A: 可以在官网账户页面查看配额使用情况，并根据需要升级套餐或等待配额重置。

Q: 生成的代码质量如何保证？

A: TronCode 使用先进的 AI 模型，但建议您：

  • 仔细审查生成的代码
  • 进行充分的测试
  • 根据项目需求进行适当调整

Q: 支持离线使用吗？

A: TronCode 需要网络连接来访问 AI 服务，暂不支持完全离线使用。

Q: 如何获得技术支持？

A: 您可以通过以下方式获得帮助：

  • 邮件支持：support@yantronic.com

联系我们

最后更新时间：2025年9月