常见问题
安装、嵌入式开发、编译上传、AI 使用、账号积分 —— 高频问题速查。
安装与启动
Q：软件提示「缺少编译器」？ 嵌入式工具链以插件形式提供：Arduino 插件内置 arduino-cli，ESP-IDF / STM32 插件检测复用本机安装。若提示缺失，到「设置 → 插件」检查插件状态，或重新安装。
Q：安装后双击没反应？
- 右键安装包 →「以管理员身份运行」
- 检查 Windows SmartScreen 是否拦截，点击「更多信息 → 仍要运行」
- 卸载后重新安装最新版本
Q：如何更新到新版本？ 软件会自动检查更新并弹窗提示，点击「安装并重启」即可。也可以到官网下载最新安装包覆盖安装。
平台与数据
Q：支持哪些开发板？ Arduino 全系（含 ESP8266）、ESP-IDF（ESP32 系列）、STM32Cube、51 单片机（STC 系列）。串口可自动识别。
Q：需要自行安装编译器吗？
取决于平台。Arduino 插件的 arduino-cli 随插件下载，首次编译时再自动下载对应平台核心；ESP-IDF、STM32、51 单片机需要本机已安装对应工具链（ESP-IDF、STM32CubeCLT、SDCC），插件会自动检测并给出安装指引。
Q：离线可以使用吗？ 编译、烧录、串口均在本地完成。AI 编写代码需要联网，也可以在设置里填写自己的模型 Key。
Q：代码会上传到服务器吗？ 编译、烧录、串口均在本机完成。AI 需要把你让它读取的文件内容发送给模型；如果自行填写 Key，请求直达模型厂商，不经过我们的服务器。
Q：支持 macOS / Linux 吗？
目前仅支持 Windows 10 / 11（64 位）。macOS 与 Linux 版本正在开发中，可通过 chipcode@xinxianzn.com 说明你的使用场景。
其他项目类型
Q：能开发非嵌入式项目吗？ 可以。新建项目支持 Python / Node.js / C++ / Rust / 通用类型，AI 智能体读写代码、执行命令、运行测试、联网检索——完全通用的软件开发体验。
Q：怎么运行我的程序？
两种方式：让 AI 在终端里执行（如 python main.py），或打开底部「终端」面板手动运行。
Q：能跑测试吗？ 内置测试运行器自动识别 pytest / unittest / go test / cargo test 并解析结果。也可以让 AI 直接「运行测试并修复失败的用例」。
Q：支持 Git 吗？ 支持，无需打开终端。左侧活动栏的**「源代码管理」面板提供：改动列表（点文件名直接看 diff）、暂存 / 取消暂存 / 丢弃 / 提交 / 推送 / 拉取、从 Git 克隆项目（克隆完自动打开）、关联远端（GitHub / Gitee / GitLab / 自建）、冲突解决（逐块选「我的 / 对方的 / 都要」，也可让 AI 给一版合并建议）、检查点回退（回到任意一回合前，回退前自动保存撤销点，因此可以撤销**）。「连接账号」中已连接的令牌同样用于 git（私有仓库克隆 / 推送，认证失败后自动重试一次；要求 https 地址且 git ≥ 2.31）。未安装 git 时面板会给出安装指引；便携版 git 可在「设置 → 开发 → 版本控制」中指定路径。
Q：有命令行版吗？
有，随包提供 triecode CLI：triecode run "任务" 单次指令、triecode 全屏交互界面、triecode compile / flash / monitor 硬件命令、triecode doctor 环境自检，与桌面端共享同一智能体引擎。
Q：能让 AI 定时干活吗？ 可以。「设置 → 开发 → 定时任务」能创建按时间（每小时 / 每天 / cron）、按文件变化、按进程退出触发的任务；可写档任务在隔离副本中运行，改动进入收件箱等待确认（应用 / 丢弃）。任务只在应用运行时执行——点 × 默认收进托盘，任务照常运行。
Q：代码补全支持哪些语言？ Monaco 编辑器为所有文件提供基础高亮与补全；C/C++ 有完整的 clangd 代码智能（跳转定义 / 查引用 / 全仓符号）。TypeScript / Python / Rust 的语言服务器正在规划中。
Q：AI 能联网吗？ 能。内置 web_search / web_fetch，可以查文档、找方案。联网检索不消耗额外积分（按正常提问计费）。
编译与上传（嵌入式）
Q：上传失败，提示无法连接开发板？
- 确认选择了正确的开发板型号和串口
- 确认 USB 驱动已安装（CH340 等常见芯片可能需要装驱动）
- 拔掉板子重插，或换一个 USB 口
- 若板子正在被其他串口软件占用，先关闭
Q：编译报错如何快速解决？ 直接把报错信息发给 AI：「帮我看看这个编译错误怎么解决」，AI 会给出原因和修复代码。
AI 使用
Q：AI 每次提问都消耗积分吗？ 是。积分消耗按模型系数计算，思考档位越高消耗越多。可以在 AI 面板切换思考档位控制消耗。
Q：AI 说它改了文件，但代码没变？ 这是 AI 偶尔出现的「幻觉」：描述了操作但实际没有执行。ChipCode 内置防幻觉检测，会提醒 AI 实际调用工具。如果仍然出现，可以重新发送一次需求，或切换到需要确认的模式再执行。
Q：如何让 AI 操作前先征得我同意？ 把模式切到「🛡️ 默认」或「📋 计划」：默认模式写入/删除前会弹窗确认；计划模式只出方案不执行。
账号与积分
Q：免费版能用多久？ 免费版永久可用，每月赠送 200 积分。积分用完后可以充值或升级套餐。
Q：积分为什么变少了？ AI 提问会消耗积分。可在「我的账户」查看套餐积分剩余和下次重置时间。
Q：怎么开发票？
购买后如需发票，联系 chipcode@xinxianzn.com，提供订单号。
Q：多台电脑能登录同一个账号吗？ 可以。积分和套餐跟随账号，不绑定设备。但同一时间请勿多处同时高频提问。
其他
Q：软件是免费的吗？ 软件本身免费下载使用，编辑器、终端、测试运行器等基础功能全部免费。AI 功能采用积分制，免费版每月赠送 200 积分。
Q：遇到问题找谁？
页面底部「关注我们」中有抖音、小红书与 QQ 用户交流群（点击 QQ 群可查看入群二维码），也可以邮件联系 chipcode@xinxianzn.com。