代码模式

在代码模式中选择项目、理解仓库、修改测试代码并审查变更。

更新于

本页目录

Code(代码)为软件项目提供持久工作目录、文件树、命令执行、Git(版本控制)上下文和变更审查,适合从问题定位到实现验证的完整工程流程。

进入和选择项目

点击顶部“代码”,确认输入框显示“向 TuriX 代码发送消息”。首次使用点击“添加项目”并选择本地仓库;未选择工作目录时,TuriX 无法建立完整代码上下文。

页面右侧包含待办、后台任务、仓库信息、更改和文件。底部可以添加日志或需求附件、调用 Skill(技能)、查看上下文、选择快速/专家模式以及切换工作目录或分支。

第一次理解代码库

先运行只读分析,确认项目规则:

只读分析这个仓库:说明技术栈、主要入口、目录职责、启动与测试命令、
配置来源和高风险模块。读取 README、AGENTS.md、贡献指南和脚本,
不要修改文件或安装依赖。

多仓库工作区应点名目标仓库。开始修改前检查当前分支、未提交改动和仓库规范,避免把其他人的工作混入结果。

推荐开发流程

  1. 提供错误信息、复现步骤、预期结果、实际结果和环境。
  2. 先定位入口、调用链、数据流、失败点和证据,不要直接猜测修改。
  3. 明确公开接口、兼容性、安全、性能和不在范围内的重构。
  4. 实施最小修改,优先运行聚焦测试。
  5. 按风险补充类型检查、lint(静态检查)、构建或更广测试。
  6. 查看完整差异和仓库状态,再决定是否提交或继续。

任务中应写明只分析、给方案还是允许修改,以及可以执行的测试、构建和依赖安装范围。

分支与 worktree

环境适合情况
主工作区工作区干净、任务简单且有人监督
新 worktree(隔离工作树)并行任务、需要隔离改动或不希望打扰主目录

代码模式界面截图

创建或切换分支前检查未提交改动。设置中的分支和 worktree 前缀只是默认命名,仓库自己的规则优先。合并、删除工作树、强制丢弃改动、推送和覆盖远端历史都需要单独确认。

查看过程和变更

  • 待办:开发计划和完成进度;
  • 后台任务:仍在运行的命令或进程;
  • 仓库信息:仓库数量、分支、主副本和 worktree 状态;
  • 更改:逐文件查看新增、修改和删除;
  • 文件:浏览和搜索项目文件。

审查时检查修改是否对应根因,边界输入和错误分支是否处理,公开接口是否兼容,测试是否覆盖失败场景,以及是否出现无关格式化、日志、密钥或大范围重构。

点击“立即回答”会停止后续工具调用,可能导致测试和清理未完成;此时先检查工作区。历史消息上的“创建分支”也可能与当前磁盘状态不一致,应先核对基点。

交付和安全

要求结果列出根因、修改文件、行为变化、测试命令与结果、未运行验证和剩余风险。生成代码仍需人工审查。

不要提供生产密钥。数据库迁移、依赖大版本升级、部署、提交、推送、创建合并请求和删除分支属于独立状态变更,只有得到明确授权后才能执行。

常见问题

现象检查与处理
无法发送任务确认已经选择项目和工作目录
命令失败阅读完整错误,检查依赖、权限和项目脚本后再调整
任务被停止检查半完成修改、后台进程和生成文件
工作区无法切换分支先处理未提交改动或未解决冲突
变更超出范围停止继续修改,逐文件审查并要求解释来源