CLI 与任务配置
入口： 任务输入栏底部选择器栏（Selector Bar）
任务级配置控制单个任务使用哪套 CLI 工具、哪个模型、多深的思考深度以及多宽松的执行授权。每个任务的配置相互独立。
默认值分两种情况：
- 首次新建任务（从未改过任何配置）时，使用出厂默认，各项默认值见下文。
- 修改过任意任务的配置后，整套配置会被记为「最后配置」，之后新建任务自动继承你上次的选择（v0.4.0 起）。这份记忆是应用级的，重启应用后依然有效。
你看到的「默认」可能是上次的配置
新建任务时各选项显示的值，往往不是出厂默认，而是你上一次使用的配置。如果发现新任务的模型或授权模式「莫名」变了，多半是上次任务中改过——直接在选择器栏改回即可。
若尚未安装 Claude CLI、Codex CLI、OpenCode CLI、Kimi Code CLI、Qoder CLI、Hermes、Pi 或 dsh，请先参阅 环境准备。CLI 的可执行文件路径可在 常规设置 → CLI 命令 中自定义。
多 CLI 架构
自 v0.7.0 起，应用支持多套 CLI 工具链，可在同一工作区中混合使用；自 v0.9.0 起新增第三个家族 OpenCode CLI，自 v0.10.0 起新增第四个家族 Kimi Code，自 v0.10.1 起新增第五个家族 Qoder CLI，并新增第六个家族 Hermes、第七个家族 Pi 与第八个家族 DeepSeek Harness（dsh）（均为实验性支持，默认关闭，须先在常规设置 → 实验功能中开启对应开关后，选择器栏才会出现这些选项）：
| 工具 | 标识 | 适用场景 |
|---|---|---|
| Claude CLI | Anthropic 图标 | Claude 系列模型，支持 OAuth 直连或第三方供应商 |
| Codex CLI | OpenAI 图标 | Codex/GPT 系列模型，支持 OpenAI 兼容接口 |
| OpenCode CLI | opencode.ai 图标 | 开源 CLI，复用应用已配置的 OpenAI 兼容供应商（deepseek、GLM 等），无需重复填写 Key（v0.9.0 起） |
| Kimi Code | Kimi 图标 | 月之暗面 Kimi K 系列模型，支持 Kimi 账号登录或复用应用已配置的第三方供应商（v0.10.0 起） |
| Qoder CLI | Qoder 图标 | 阿里 Qoder 终端 Agent（可执行文件名 qodercli），用 Qoder 账号登录后按档位调用其模型（v0.10.1 起） |
| Hermes | Hermes 图标 | Hermes Agent（NousResearch，Python 生态），复用应用已配置的模型供应商；实验性，默认关闭 |
| Pi | Pi 图标 | Pi coding agent，RPC 驱动 + 托管 Bridge；实验性，默认关闭 |
| dsh | dsh 图标 | DeepSeek Harness，dsh web 实例 + HTTP RPC 驱动；模型经 RPC 从应用已配置的供应商注入；实验性，默认关闭 |
在任务的选择器栏中点击 CLI 图标或名称，即可在各 CLI 之间切换。八个家族的模型、思考深度、权限等配置各记各的、互不串台。
任务级配置项
CLI 选择
选择本任务使用的工具链：Claude CLI、Codex CLI、OpenCode CLI、Kimi Code、Qoder CLI、Hermes、Pi 或 dsh。选择后，下方的模型、思考深度、执行授权选项会随之切换为对应工具链的选项。选择 dsh 后，CLI 选择器右侧还会出现Agent 预设选择器（决定会话的 persona / 工具集 / 技能，发消息前必须选定，见 DeepSeek Harness 配置）。
只列出已安装的 CLI（v0.10.4 起）：应用启动与 CLI 安装完成时会自动检测本机已安装的 CLI，下拉中只显示检测到已安装的家族，未安装的不会出现。已经建好的任务即使所选 CLI 后来被卸载，下拉仍会保留显示当前项（切走后该项即消失），不会静默改动任务配置。Hermes、Pi 与 dsh 还需在实验功能中开启对应开关才会出现在下拉中（已存在的 Hermes / Pi / dsh 任务不受开关影响，照常显示）。若八个家族全部未安装，选择器栏下方会显示红色提示，点击可跳转到依赖管理安装。
模型
选择本任务实际调用的模型档位。
Claude CLI 模型档位（由轻量到强力）：
| 档位 | 对应角色 |
|---|---|
| Haiku | 轻量任务 |
| Sonnet | 常规任务 |
| Opus | 复杂任务 |
| Fable | 专项档位（v0.6.5 起） |
出厂默认： Opus
各档位对应的具体模型版本由当前激活的模型供应商决定。
Codex CLI 模型： 通过 模型供应商 中的 Codex OAuth 或自定义供应商配置；未手动选择模型时，默认使用 gpt-5.5（界面原文）。
OpenCode CLI 模型： OpenCode 没有原生 OAuth 档位，其模型下拉复用应用已配置的 OpenAI 兼容供应商（模型映射经配置注入 OpenCode，无需重复填写 API Key）。因此需先在 模型供应商 中为某个供应商填好 OpenAI 接口地址与模型，再回到任务中选择该「供应商 / 模型」。
Kimi Code 模型（v0.10.0 起）分两组：
| 分组 | 内容 |
|---|---|
| Kimi 账户 | 原生档位 K2.7 Coding、K2.7 Coding Highspeed、K3、K3-256K（v0.10.3 起随 Kimi CLI 0.28.1 重构：K3 为 1M 默认档，新增 K3-256K 的 256K 档，旧 k3[1m] 档已下线），需先完成 Kimi 账号登录；档位清单数据驱动，会话运行中打开面板会从 CLI 实时拉取最新档位 |
| 供应商模型 | 复用应用已配置的模型供应商——Anthropic 或 OpenAI 接口地址任一已填写的启用供应商，其模型全部列出，经环境变量注入 Kimi Code，无需重复填写 API Key |
模型可在会话中途切换、即时生效；上下文用量指示器按所选模型取真实窗口（K3 为 1M token，K3-256K 与 K2.7 系为 256K）。
Qoder CLI 模型（v0.10.1 起）为 Qoder 自身的静态档位表，不绑定第三方供应商：
| 档位 | 说明 |
|---|---|
| Auto（智能路由） | 默认档，由 Qoder 按任务复杂度自动选择实际模型 |
| Ultimate / Performance / Efficient / Lite | 由强到轻的固定档位，直接透传给 qodercli |
档位随任务保存，中途切换会以新参数重启子进程后生效。Qoder 一期不支持自定义供应商（BYOK），因此模型下拉中不出现模型供应商里配置的第三方模型。
Hermes 模型（实验性）：Hermes 没有原生 OAuth 档位，模型下拉直接列出你在模型供应商中配置的全部供应商及其模型，经环境变量注入 Hermes（供应商组选择 + 三件套 hermes_model / hermes_provider_id / hermes_provider_model 落库）。模型可在会话中途切换，保留历史继续对话。
Pi 模型（实验性）：同样复用模型供应商中配置的供应商模型（任务按 pi_provider / pi_model 落库），经 Bridge 注入 Pi；模型下拉与思考控制（thinking）联动。
dsh 模型（实验性）：从你在模型供应商配置的供应商中经 RPC 注入选择（任务按 dsh_preset / dsh_model 落库）；不选时模型「跟随预设」，使用所选 Agent 预设内置的模型。
思考深度
控制模型在回答前花多少算力进行内部推理（即"扩展思考"功能的深度）。
Claude CLI 思考深度（由浅到深）：
| 档位 | 界面原文 |
|---|---|
| 低 | low |
| 中 | medium |
| 高 | high |
| 超高 | xhigh |
| 最高 | max |
| 极限 | ultracode |
Codex CLI 思考深度（由浅到深）：
| 档位 | 界面原文 |
|---|---|
| 极简 | minimal |
| 低 | low |
| 中 | medium |
| 高 | high |
| 超高 | xhigh |
OpenCode CLI 思考深度（由浅到深，v0.9.0 起）：
| 档位（界面原文） | 说明 |
|---|---|
| default | 首档，不指定推理深度，使用所选模型的内置默认（同时保护不支持推理的模型） |
| minimal / low / medium / high / xhigh | 由浅到深指定 OpenCode 的推理深度 |
Kimi Code 思考深度（v0.10.0 起）：选择供应商模型时提供 default / off / minimal / low / medium / high / max 七档（首档 default 表示不指定、使用该模型的内置默认，同时保护不支持推理的模型），切换后自动以新配置重启子进程、真实生效；选择 Kimi 账户原生模型时按模型族区分（v0.10.3 起随 CLI 0.28.1 对齐）：
- K3 系（K3 / K3-256K）：提供 low / high / max 三档（默认 high），经写入 CLI 配置生效，切换后重启子进程应用
- K2.7 系（K2.7 Coding / Highspeed）：为常开思考（always_thinking），仅有 on 一档，选择器自动隐藏
Qoder CLI 思考深度（v0.10.1 起，由浅到深）：
| 档位（界面原文） | 说明 |
|---|---|
| default | 首档，不指定推理深度，使用所选档位的内置默认 |
| low / medium / high / xhigh / max | 由浅到深指定 Qoder 的推理深度 |
档位切换后会以新参数重启子进程，下一轮对话生效。
Pi 思考档位（实验性）：提供 default（不指定、使用所选模型的内置默认）及 Pi 的思考档位列表（界面原文），切换即时生效。
dsh 思考深度（实验性）：提供通用档位 low / medium / high / xhigh / max / ultracode（出厂默认 max）。
Hermes 无思考深度选择器：Hermes 当前不提供思考深度选项，选择器栏自动隐藏该项。
出厂默认：
- Claude CLI：max
- Codex CLI：medium
- OpenCode CLI：default（不指定，跟随模型内置默认）
- Kimi Code：default（供应商模型时；原生模型无需选择）
- Qoder CLI：default（不指定，跟随档位内置默认）
- Pi：default（不指定）
- dsh：max
- Hermes：无思考深度选项（见上文）
思考深度越高，回答质量通常越好，但耗时与 Token 消耗也相应增加。若希望加快响应，可手动调低档位。
执行授权
控制 CLI 在执行文件操作、运行命令等行为时的自主程度。
Claude CLI 授权模式（v0.9.0 起与 Claude CLI 的 --permission-mode 对齐为 6 档，界面显示原文）：
| 模式（界面原文） | 说明 |
|---|---|
| default | 每次写文件、执行命令前均弹出权限卡片，等你确认后再执行 |
| plan | 先生成完整操作计划，确认后再执行 |
| acceptEdits | 文件编辑操作自动通过，其他操作仍需确认 |
| auto | 自动档（v0.9.0 新增）：放行裁决交回 Claude CLI 自身，由 CLI 决定哪些操作直接放行、哪些仍需询问 |
| dontAsk | 不询问档（v0.9.0 新增）：同样交由 Claude CLI 裁决，本模式下尽量不打断询问 |
| bypassPermissions | 所有操作自动通过，无需确认 |
auto与dontAsk是本版对齐 Claude CLI 新增的两档，应用不再代为自动放行，而是把--permission-mode透传给被拉起的 Claude CLI 由其裁决。
Codex CLI 授权模式：
| 档位（界面原文） | 说明 |
|---|---|
| 只读 | 仅允许读取文件，不执行写入或命令 |
| 自动 | 自动执行大多数操作，高风险操作询问确认 |
| 完全访问 | 所有操作自动通过，等同于 Claude 的 bypassPermissions |
OpenCode CLI 授权档位（v0.9.0 起，界面显示原文）：
| 档位（界面原文） | 说明 |
|---|---|
| auto | 自动执行文件编辑与命令，不逐条询问（默认档） |
| ask | 每次改文件、执行命令前都弹出审批卡片，等你确认 |
Kimi Code 权限模式（v0.10.0 起，界面显示原文）：
| 模式（界面原文） | 说明 |
|---|---|
| default | 每次执行命令、改文件前弹出审批卡片，等你确认 |
| plan | 只读规划模式，先产出计划再经你审批 |
| auto | 自动放行安全操作，高风险操作仍会询问（默认档） |
| yolo | 全部放行，不再逐条询问 |
Qoder CLI 授权模式（v0.10.1 起，界面显示原文）：
| 模式（界面原文） | 说明 |
|---|---|
| default | 每次写文件、执行命令前弹出权限卡片，等你确认（默认档） |
| acceptEdits | 文件编辑自动通过，其他操作仍需确认 |
| auto | 放行裁决交回 Qoder CLI 自身，由其决定哪些操作直接放行 |
| dontAsk | 同样交由 Qoder CLI 裁决，本模式下尽量不打断询问 |
| bypassPermissions | 所有操作自动通过，无需确认 |
Qoder 没有
plan（规划）档，其余档位与 Claude CLI 同名同义。
Pi 授权模式（实验性，界面显示原文）：
| 档位（界面原文） | 说明 |
|---|---|
| 审批 | 每次写文件、执行命令前弹出权限卡片，等你确认（默认档） |
| 计划 | 只读规划模式，先产出完整计划再经你审批 |
| 完全访问 | 所有操作自动通过，无需确认 |
Pi 的权限请求经 LongCode 托管的 Bridge 拦截并转成审批卡片，与原生协议无关。
dsh 授权档位（实验性，dsh 原生三档预设）：
| 档位（界面原文） | 说明 |
|---|---|
| 只读（read-only） | 仅允许读取，不写入文件、不执行命令 |
| 工作区写入（workspace-write） | 允许在工作区内写入文件与执行命令 |
| 完全访问（danger-full-access） | 所有操作自动通过，无需确认（默认档） |
dsh 的权限档位即 dsh 的权限预设名，由 dsh 原生执行；切换后随下一条消息经 /permission 命令注入生效（尽力而为，失败会给出错误提示）。
Hermes 无授权选择器：Hermes 任务不在选择器栏显示执行授权下拉，运行时确认以审批卡片形式呈现。
出厂默认：
- Claude CLI：完全自主（bypassPermissions）
- Codex CLI：自动
- OpenCode CLI：auto
- Kimi Code：auto
- Qoder CLI：default（逐条确认）
- Pi：审批（逐条确认）
- dsh：完全访问（danger-full-access）
- Hermes：无授权选择器（见上文）
出厂默认为完全自主
Claude CLI 的出厂默认即为"完全自主"——该模式与 Codex 的"完全访问"、OpenCode 的 auto、Kimi 的 yolo、Qoder 的 bypassPermissions、Pi 的"完全访问"、dsh 的"完全访问"都会跳过逐条确认（或大幅减少询问），CLI 可在无人值守情况下修改、删除文件或执行系统命令。若你希望逐步确认每个操作，请改为 default / plan（Claude / Kimi）、default（Qoder）、"审批"（Pi）、"只读"（Codex）、"只读"或"工作区写入"（dsh）或 ask（OpenCode）。建议仅在受控环境（沙盒、CI）或你完全了解任务内容时使用完全自主模式。
与全局设置的关系
任务级配置仅影响当前任务，不修改全局默认值。关系如下：
| 配置层级 | 位置 | 作用范围 |
|---|---|---|
| CLI 可执行文件路径 | 常规设置 → CLI 命令 | 全局，所有任务共用 |
| 模型供应商 / API Key | 模型供应商 | 全局，决定可用的模型集合 |
| 模型 / 思考深度 / 授权 | 任务选择器栏 | 单任务，新建任务继承上次配置 |
| Hermes / Pi / dsh 可见性 | 常规设置 → 实验功能 | 全局，关闭时隐藏对应入口 |
Hermes 的能力与边界
Hermes（实验性，默认关闭）经 ACP 协议驱动，对话体验与其他家族对齐：实时流式回复、思考与正文分流、工具卡、审批卡片、历史还原、/ 命令面板、群聊协作（可创建 Hermes 群成员）、在线切换模型（保留历史）、卡死看门狗（一轮内长时间无输入时发出系统提示）等。受其协议限制，Hermes 暂不支持以下两项，相关入口自动隐藏：
Hermes 的配置（工具组件、工具集凭证、消息网关、子代理委派）见 Hermes 配置。注意：Hermes 的 terminal 工具在 Windows 上存在上游卡死问题（实验开关文案中有提示），使用前请留意。
Pi 的能力与边界
Pi（实验性，默认关闭）经原生 RPC 驱动 + LongCode 托管 Bridge 接入。Pi 任务支持：
- 实时流式回复、工具卡、审批卡片（权限经 Bridge 拦截）、AskUserQuestion 结构化提问
- 会话分叉（分叉到新会话，文件级 fork，基于 Pi 原生 parentId 树）
- MCP 运行健康检测（stdio 握手 / HTTP JSON-RPC）、子智能体运行态生命周期卡片、用量统计（计入使用统计的 Pi 维度，实验开关关闭时不统计）
/命令面板与技能（经 Pi 原生 Skills 接入）、原生 AGENTS.md 记忆
当前版本的边界：
| 项 | 说明 |
|---|---|
| 不支持编辑历史消息重跑 | 就地回滚重发暂未支持，相关入口自动隐藏 |
| Package 版本受控 | MCP / 子智能体 / 钩子 / 增强记忆各适配一个经过版本验证的实现，版本由 LoongCode 检测与代管（见 Pi 配置） |
| 插件设置页无 Pi 页签 | Pi 的 Package / Extension 与 LoongCode 的「插件」不是同一概念，在 Pi 配置 中管理 |
| 无终端 TUI 模式 | 暂不支持终端 TUI 模式 |
Kimi Code 的能力边界
Kimi Code 任务的对话体验与其他家族对齐（实时流式回复、思考与正文分流、工具卡、审批卡、子智能体子卡片、/ 命令与 @ 文件、图片输入、历史还原、深度搜索等），但受其协议限制，v0.10.0 暂不支持以下两项，相关入口会自动隐藏：
Qoder CLI 的能力与边界
Qoder 与 Claude Code 属于同源方言——应用用同一套驱动拉起 qodercli，因此 Qoder 任务一上来就具备与 Claude 任务同级的完整体验：
- 实时流式回复、思考与正文分流、统一工具卡、审批卡片、子智能体子卡片
/命令面板与@文件面板、代码检查点、编辑历史消息重跑与会话分叉- 关闭重开后的历史完整还原、终端 TUI 模式（含从草稿直接进入）、深度搜索、AI 生成提交消息
- 设置侧的 MCP、记忆、钩子、技能、子智能体、插件 六个面板均有 Qoder 页签，读写
~/.qoder下的对应配置
当前版本的边界：
| 项 | 说明 |
|---|---|
无 plan 档 | 授权档位少一个规划模式（见上文执行授权） |
| 不支持第三方供应商（BYOK） | 模型只能从 Qoder 静态档位中选，模型供应商里配置的第三方模型不会出现在 Qoder 任务中；网络请求跟随系统代理，不走供应商的网络代理三态 |
| 无账号用量 | Qoder 未提供配额查询接口，侧边栏用量徽标与登录卡片的用量区块都不含 Qoder |
| 重开任务后用量条暂显「—」 | Qoder 只在实时事件里给出上下文占用比例、不写进会话文件，因此关闭再打开任务时上下文用量条会显示占位符，等下一轮对话结束后恢复 |
| 应用内不提供登出 | Qoder CLI 没有 logout 子命令，登出请在终端或 TUI 模式的 Qoder 交互界面里执行 /logout |
子智能体工具卡显示为 Agent
Qoder 派生子智能体的原生工具名就叫 Agent（Claude 侧叫 Task），应用如实透传不做改写；子智能体对话仍照常路由进独立折叠卡片。
dsh 的能力与边界
dsh（DeepSeek Harness，实验性，默认关闭）经 dsh web 实例（HTTP RPC + WebSocket）驱动，对话体验与其他家族对齐：
- 实时流式回复、思考与正文分流、统一工具卡、编辑历史消息重跑（经 RPC fork + 会话改指，无需重启进程）
- 对话中注入的上下文（context injection）以可折叠卡片呈现，ToolAsk 确认以回执卡片呈现
- 子智能体运行态有独立生命周期卡片，子会话事件实时流式推送
/命令面板按 dsh 的技能根（项目根、~/.dsh、~/.agents）扫描技能- 设置侧的 MCP、技能、记忆 三个面板有 dsh 页签（门控于 dsh 插件状态，dsh 自身管理对应能力，页面只读展示）
当前版本的边界：
| 项 | 说明 |
|---|---|
依赖 npm 包 @deepseek-ai/dsh | 需先安装 dsh CLI，且开启实验功能 → DeepSeek Harness 支持 |
| MCP 在 dsh 侧配置 | MCP 服务器本体在 dsh 的 cordis.patch.yml 中配置；安装 @deepseek-ai/dsh-mcp-client 插件后，MCP 设置页才显示 dsh 页签（仅状态展示） |
| Agent 预设只读 | 预设创作在 dsh 侧（~/.dsh/.agent-presets），应用内仅选择与展示 |
| 无终端 TUI 模式 | 暂不支持终端 TUI 模式 |
插件与预设的管理入口
dsh 的插件（npm 包）与 Agent 预设统一在设置 → 依赖管理 → DeepSeek Harness 中管理，见 DeepSeek Harness 配置。
下一步
- 模型供应商 — 配置第三方 API 以解锁更多模型选择
- 依赖管理 — 检测与安装 Claude CLI / Codex CLI / OpenCode CLI / Kimi Code CLI / Qoder CLI / Hermes / Pi / dsh
- Hermes 配置 — Hermes 的工具组件、工具集凭证、消息网关与子代理委派（实验）
- Pi 配置 — Pi 的 Bridge 与 Package / Extension 管理（实验）
- DeepSeek Harness 配置 — dsh 的插件与 Agent 预设管理（实验）