esengine--deepseek-reasonix/docs/COLLABORATION_MODES.zh-CN.md

协作方式与运行模式

Reasonix 桌面端输入框左下角的菜单包含两条互相独立的轴：

• 计划模式：先只读分析并产出计划，确认后再执行。
• 目标模式：给 Reasonix 一个目标，让它持续推进直到完成、阻塞或停止。
• 运行模式：在“轻量”“均衡”“交付优先”三档之间选择成本与交付质量倾向。

计划模式和目标模式属于“协作方式”轴，通常二选一；运行模式是独立轴，可以和普通聊天、计划模式、目标模式任意组合。

计划模式

计划模式适合在动手前先确认方案。开启后，Reasonix 会先读取必要上下文、分析问题并给出计划；在你确认前，不会执行写文件、改代码、提交、删除、发布等有副作用的操作。

怎么开启

• 点击输入框左下角的“协作方式”按钮，选择“计划”。
• 也可以使用 Shift+Tab 切换计划模式。
• 开启后输入框下方会显示“计划”标签；点击该标签或再次使用 Shift+Tab 可退出。

建议使用场景

• 你还不确定实现方案，希望先看 Reasonix 的拆解。
• 改动范围可能跨多个文件、模块或配置。
• 需要先评估风险、测试面、兼容性或发布影响。
• 你希望先让 Reasonix 只读代码和文档，再决定是否继续实施。

注意事项

• 计划模式不是“自动完成任务”。它会先暂停在计划阶段，等待你确认。
• 计划模式会减少误改风险，但会多一次确认步骤。
• 如果你已经明确要直接改一个小问题，普通模式通常更快。
• 计划模式只控制“先规划再执行”的流程，不决定成本或交付倾向；可按任务选择任一运行模式。

目标模式

目标模式适合给 Reasonix 一个更长线的目标，让它持续推进。目标启动后，Reasonix 会围绕该目标工作，直到任务完成、遇到阻塞、被你停止，或需要你确认关键决策。

怎么开启

• 点击“协作方式”按钮，选择“目标”。
• 如果输入框里已有文字，选择“目标”会把当前文字作为目标启动。
• 如果输入框为空，选择“目标”后会进入目标输入状态，输入目标并发送即可启动。
• 开启后输入框下方会显示“目标”标签；点击该标签可退出目标模式。

建议使用场景

• 你希望 Reasonix 连续完成一组相关步骤，例如“修复这个问题并补测试”。
• 任务需要探索、实现、验证多个阶段。
• 你希望减少中途反复下指令，让 Reasonix 在目标范围内持续推进。
• 目标明显是长周期研究、排障或优化，例如“持续排查直到根因明确”“彻底实现并验证” “不要原地打转”。这类目标会自动进入 AutoResearch 策略，把状态写到 .reasonix/autoresearch/<task-id>/。

推荐目标写法

复杂目标可以写成一份任务合约：Context、Request、Output format、Constraints、Pause policy。 Goal 模式会把这些部分当作任务边界；除非下一步涉及不可逆或对外可见操作、任务范围变化， 或需要你提供信息，否则会继续完成任务后再汇报。完整模板见 TASK_CONTRACT.zh-CN.md。

注意事项

• 目标要写得具体。推荐包含范围、成功标准和限制，例如“只改桌面端输入栏，补前端测试，不改后端协议”。
• 目标模式不是跳过审批。遇到高风险操作、权限限制、阻塞或需要产品判断时，仍可能停下来询问。
• 如果目标过大或边界不清，Reasonix 可能需要更多探索轮次，也会消耗更多 token。
• AutoResearch 是 Goal 的自动持久化策略，不是独立的后台 daemon，也不是 Settings 里的全局 skill。 可以用 /goal --research <目标> 强制启用，或用 /goal --simple <目标> 强制保持轻量 Goal。
• 普通聊天里命中非常强的长周期信号时，Reasonix 会自动升级为 Goal + AutoResearch；弱表达 如“长期来看”“优化一下”“研究一下”不会触发。
• 目标模式和计划模式是同一协作轴。切到计划模式时，会退出目标草稿/目标显示状态；运行模式不会因此改变。

运行模式

运行模式决定会话启动时的工具面和执行合约。每个标签页独立保存选择；切换模式会重建当前会话运行时，但保留会话历史。

轻量 · 节省 Token（Economy）

Economy 对应原来的“省 token”模式。它精简初始技能索引和工具 schema，将 Skills、MCP、CodeGraph/LSP、web_fetch、安装来源和 subagent 等可选能力放到 connect_tool_source 后按需启用。

• 适合日常问答、代码解释、小范围阅读和成本敏感任务。
• 主要降低每轮固定携带的提示词与工具 schema token，不会降低模型本身的推理能力。
• 首次使用某类可选工具时可能多一个按需启用步骤。

均衡 · 默认（Balanced）

Balanced 是默认档，对应旧版本持久化值 full。它一次性提供完整工具面，不增加额外执行合约，由模型根据任务自主决定探索、实现与验证深度。

• 适合大多数普通开发与聊天任务。
• --profile balanced 和不传 --profile 保持旧默认 provider 请求字节不变。
• 旧 session/tab 中空值或 full 都会继续解释为 Balanced。

交付优先 · 完整验证（Delivery）

Delivery 使用与 Balanced 相同的完整工具面，额外增加稳定的能力代理工具 use_capability（inspect/call/decline，用于按需调用含 auto_start=false 的 MCP，且不把动态工具写入主 Registry），并增加稳定的交付合约：明确验收标准；条件允许时先复现；检查项目规则和相关代码；修复根因；运行聚焦验证；复审 diff 与相邻行为；没有证据时不宣称成功，并明确标注未验证项或假设。

• 适合编码、修 bug、跨文件实现和需要可靠交付证据的任务。
• 通常会使用更多模型调用和 token，耗时也可能更长。
• 宿主会在变更或验证命令前检查是否已有具体的 todo_write 验收清单；缺失时直接阻止执行并要求补齐。
• 发生变更后，宿主会要求在最后一次变更之后复查结果、运行成功的验证命令，并用引用该命令的 complete_step 正式签收；不满足时拦截最终回答并自动要求继续。
• 对明确要求实现、修复或修改的任务，如果没有观察到真实变更，宿主会拒绝“已经完成”的纯文本声明；只读分析仍可凭读取/检查证据正常结束。
• Skill/MCP 的 require/prefer 路由由宿主门禁强制：require 必须成功调用（宿主确认不可用时可带真实 blocker 结束），prefer 缺失会提醒一次，之后必须调用或 use_capability(action="decline") 提交非空理由。
• 中/高风险改动会强制运行结构化 review / security_review（通过审查子 Agent 的 review_report）；task/run_skill 等元工具本身不算 mutation，子 Agent 的真实写入会回传父级证据账本。
• Delivery 的 system contract 与 use_capability Schema 是每个该 Profile 会话固定的 provider 前缀；按需连接 MCP 不会改变主 Registry Schema。Balanced 的提示词和工具 Schema 仍保持字节兼容。从其他 Profile 切换过来会产生一次新的缓存前缀。

怎么选择

• 桌面端点击输入框左下角菜单，在“运行模式”下选择“轻量 · 节省 Token”“均衡 · 默认”或“交付优先 · 完整验证”。
• 轻量和交付优先模式会在输入框下方显示“轻量”或“交付优先”标签；点击标签可回到均衡模式。
• CLI 启动时使用 reasonix --profile economy|balanced|delivery，非交互运行使用 reasonix run --profile ...。
• TUI 会话内使用 /work-mode economy|balanced|delivery 热切换；不带参数的 /work-mode 会列出三档并标记当前项。/profile 保留为技术兼容别名，但帮助和补全以 /work-mode 为主。
• 会话内切换会在保留 history、session 路径、审批/Yolo 状态的前提下原子重建 Controller。当前 turn、审批/询问或后台任务仍在运行时不能切换；构建失败时旧运行时继续可用。
• /work-mode 只修改当前会话，不写入全局默认值。跨 Profile 切换会形成一次新的 provider 缓存前缀；同一 Profile 内的 system contract 与工具 Schema 保持稳定。

协作方式与 Profile 如何组合

组合	是否支持	说明
普通 + 轻量	支持	日常聊天的低开销选择。
计划 + 均衡	支持	先用完整工具面研究并确认方案，再执行。
目标 + 交付优先	支持	持续推进明确目标，并强调实现与验证闭环。
计划 + 目标	不建议同时使用	两者都是协作方式轴，切换计划会退出目标草稿/目标显示状态。
工具权限（询问/自动/Yolo）+ 任一组合	支持	工具权限只控制是否自动批准工具调用。

工具权限的详细区别和使用场景，见 TOOL_APPROVAL_MODES.zh-CN.md。

推荐选择

• 不确定怎么选：保持均衡和普通模式。
• 成本敏感或简单问答：选择轻量。
• 担心 Reasonix 改错：开启计划模式，先确认方案。
• 想让 Reasonix 持续推进一个明确目标：开启目标模式，目标写清楚成功标准。
• 编码、修 bug 或复杂实现更看重最终质量：选择交付优先，可再搭配目标模式。