代码模式
在代码模式中选择项目、理解仓库、修改测试代码并审查变更。
更新于
本页目录
Code(代码)为软件项目提供持久工作目录、文件树、命令执行、Git(版本控制)上下文和变更审查,适合从问题定位到实现验证的完整工程流程。
进入和选择项目
点击顶部“代码”,确认输入框显示“向 TuriX 代码发送消息”。首次使用点击“添加项目”并选择本地仓库;未选择工作目录时,TuriX 无法建立完整代码上下文。
页面右侧包含待办、后台任务、仓库信息、更改和文件。底部可以添加日志或需求附件、调用 Skill(技能)、查看上下文、选择快速/专家模式以及切换工作目录或分支。
第一次理解代码库
先运行只读分析,确认项目规则:
只读分析这个仓库:说明技术栈、主要入口、目录职责、启动与测试命令、
配置来源和高风险模块。读取 README、AGENTS.md、贡献指南和脚本,
不要修改文件或安装依赖。
多仓库工作区应点名目标仓库。开始修改前检查当前分支、未提交改动和仓库规范,避免把其他人的工作混入结果。
推荐开发流程
- 提供错误信息、复现步骤、预期结果、实际结果和环境。
- 先定位入口、调用链、数据流、失败点和证据,不要直接猜测修改。
- 明确公开接口、兼容性、安全、性能和不在范围内的重构。
- 实施最小修改,优先运行聚焦测试。
- 按风险补充类型检查、lint(静态检查)、构建或更广测试。
- 查看完整差异和仓库状态,再决定是否提交或继续。
任务中应写明只分析、给方案还是允许修改,以及可以执行的测试、构建和依赖安装范围。
分支与 worktree
| 环境 | 适合情况 |
|---|---|
| 主工作区 | 工作区干净、任务简单且有人监督 |
| 新 worktree(隔离工作树) | 并行任务、需要隔离改动或不希望打扰主目录 |

创建或切换分支前检查未提交改动。设置中的分支和 worktree 前缀只是默认命名,仓库自己的规则优先。合并、删除工作树、强制丢弃改动、推送和覆盖远端历史都需要单独确认。
查看过程和变更
- 待办:开发计划和完成进度;
- 后台任务:仍在运行的命令或进程;
- 仓库信息:仓库数量、分支、主副本和 worktree 状态;
- 更改:逐文件查看新增、修改和删除;
- 文件:浏览和搜索项目文件。
审查时检查修改是否对应根因,边界输入和错误分支是否处理,公开接口是否兼容,测试是否覆盖失败场景,以及是否出现无关格式化、日志、密钥或大范围重构。
点击“立即回答”会停止后续工具调用,可能导致测试和清理未完成;此时先检查工作区。历史消息上的“创建分支”也可能与当前磁盘状态不一致,应先核对基点。
交付和安全
要求结果列出根因、修改文件、行为变化、测试命令与结果、未运行验证和剩余风险。生成代码仍需人工审查。
不要提供生产密钥。数据库迁移、依赖大版本升级、部署、提交、推送、创建合并请求和删除分支属于独立状态变更,只有得到明确授权后才能执行。
常见问题
| 现象 | 检查与处理 |
|---|---|
| 无法发送任务 | 确认已经选择项目和工作目录 |
| 命令失败 | 阅读完整错误,检查依赖、权限和项目脚本后再调整 |
| 任务被停止 | 检查半完成修改、后台进程和生成文件 |
| 工作区无法切换分支 | 先处理未提交改动或未解决冲突 |
| 变更超出范围 | 停止继续修改,逐文件审查并要求解释来源 |