wehub-resource-sync
134 lines
9.5 KiB
Markdown
134 lines
9.5 KiB
Markdown
# 协作方式与运行模式
|
||
|
||
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`](./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`](./TOOL_APPROVAL_MODES.zh-CN.md)。
|
||
|
||
## 推荐选择
|
||
|
||
- **不确定怎么选**：保持均衡和普通模式。
|
||
- **成本敏感或简单问答**：选择轻量。
|
||
- **担心 Reasonix 改错**：开启计划模式，先确认方案。
|
||
- **想让 Reasonix 持续推进一个明确目标**：开启目标模式，目标写清楚成功标准。
|
||
- **编码、修 bug 或复杂实现更看重最终质量**：选择交付优先，可再搭配目标模式。
|