dsh-cliworker-now

6. 使用方法

6.1 首次派遣

在已选工作目录的 Harness 主对话里，明确说出要使用的 CLI，例如：

用 Codex 检查这个项目的登录错误处理，把这个智能体命名为“代码审查员”。

也可以使用简称或别名（本地 v0.6.7 起）：

调用 agy cli 帮我审查这个项目。

调用 glm cli 帮我检查这段代码。

agy 对应 Antigravity，glm / zhipu / 智谱 对应 ZCode，harmes 对应 Hermes Agent。插件会为当前明确调用提供路由提示，并在派遣工具里统一解析名称；支持 Antigravity（agy）CLI 这样的同名别名，重复指定同一 CLI 仍视为一个目标。较长名称的轻微拼写误差只有唯一候选时才接受。未知名称或多个目标返回简短错误和候选，不自动派遣，普通模型讨论、否定调用和引用示例不会触发路由提示。是否调用工具仍由 Harness 主模型决定；如果模型忽略请求，可明确说“使用 CLI Worker 插件调用 agy CLI”。

首次使用相应项目和 CLI 时，通过 Harness 原生问题卡片选择：

1. 模型：来自该 CLI 的实际目录。
2. 思考强度：仅提供当前模型支持的选项。
3. 智能体预设：选择已有角色、不使用预设，或在“其他”里写临时提示词。

模型、强度和角色全部确认后，才保存设定并启动任务。只会出现两类询问：

• 选择模型、思考强度和角色：项目中首次使用该 CLI，或选择重新设置时出现。先选模型，再选择它支持的强度和角色。
• 是否沿用以前的设定：同项目、同 CLI 的新主对话首次调用时出现；沿用即使用整套设定，重新选择则回到选型。

同一主对话之后的调用直接使用已确认设定，重启后也不会重复询问。取消或未完整回答不保存半套设定、不启动任务。旧版只保存模型和强度的偏好，升级后首次需补全整套选择。

明确调用 CLI 时，当前请求会携带对应 CLI 的派遣指引：直接调用 cliworker_start 打开选型，模型、强度和角色由插件收集，选型完成后才启动任务。每次工具调用必须显式传入 cli（Antigravity 也一样）；漏传会返回参数错误，不会采用上次调用或默认 CLI。主模型无需预先提问角色或确认启动；通用提问工具保持不变。

全部 11 个 CLI 只使用自身原生登录，或在该 CLI 自己的配置／私有 .env 中单独设置的 API Key。模型与强度按“本 CLI 支持”与“当前自身账号可用范围”筛选；Claude 自身显式网关配置按第 4 节的专门规则展示候选，并说明远端可用性未核验。公共目录、旧缓存、固定别名和匿名免费模型不能单独成为可选依据；未满足上述证据条件时显示空列表及简短原因。账号范围使用只读模型查询，不通过生成请求试探权限。

设置、模型菜单和任务卡片只显示模型名称，删除服务商、组织路径前缀及括号附注；同一原生模型去重，不同原生模型同名时仍保留独立选项，保存和执行使用完整路由 ID。新选择优先有明确证据且可用的免费额度，缺省零成本和价格未知不当免费。有效的既有选择保持不变，首次使用仍须由你选型，免费路由失败也不会自动转为付费请求。

OMP（Oh My Pi）与 Pi Coding Agent 是两个独立 CLI；安装、账号、模型和会话各自管理，即使使用相同模型也不能互换。插件核验实际执行程序身份；Pi 优先使用已核验的原生安装，不暗中切换到另一旧版。

Windows 也能发现当前用户注册的官方 Codex 应用包内 CLI 和官方 npm 固定入口，以及 Hermes 的官方安装目录；只有安装痕迹而没有可执行文件时会提示完成安装。Windows 支持已核验的 Pi 官方固定启动器，以及 OpenCode npm 包声明的原生程序入口。插件静态解析并校验安装身份；无法确认或已损坏的入口会提示检查安装。Pi 其他版本需先核验 SDK/RPC 和原生菜单后接入。

OMP、Pi、Hermes 和 OpenCode 的账号行按自身认证显示服务商及方式。有账号登录时简写为“OpenAI账号登录”等，完整安全身份及其他 API 认证保留在悬浮详情；仅 API 时显示“zai.cn API 登录”等。有效认证不会统一降成“已配置”。只有配置声明、缺失或失效凭据保留对应灰/红状态，模型权限仍单独核对。

OMP、Pi 和 Hermes 的“退出”使用统一按钮并打开各自原生退出菜单。多个自身账号目录先选择来源；操作针对所选真实来源，其他来源保留。Pi/OMP 原生退出不能删除的 .env 或模型配置内 API，需在原配置中管理。Hermes 原生写入的停用来源会同步约束登录、模型和调用，不从保留的配置值恢复账号。

Windows 的 ZCode 和 OpenCode 还会通过已知默认目录、当前用户及系统安装登记、已运行的对应程序位置，以及开始菜单和桌面快捷方式发现自定义安装目录，支持非系统盘、中文和空格路径。ZCode 核验 resources/glm/zcode.cjs 及配套 provider 文件；OpenCode 桌面安装采用实际存在的独立 opencode-cli.exe，桌面版本未附 CLI 时会明确提示。已有显式路径、ZCode 已部署运行时和正常 PATH 入口优先；多个不同可用安装需通过 zcodeExecutable / opencodeExecutable 指定。DisplayIcon 是安装注册表中的程序/图标文件路径，不要求桌面上存在图标或快捷方式。任意位置的便携目录若没有安装登记、快捷方式或 PATH，且程序未运行，仍需显式配置；发现安装位置不代表已登录或模型可用。

Desktop 中按磁盘实际文件识别安装，兼容 Electron 对 ASAR 归档的处理；OpenCode 的正常 npm CLI 不要求旁侧存在桌面归档。无需重装 CLI 或重新配置账号。

每个 CLI 设置页的独立“高级设置”默认折叠，通过右侧箭头展开后可管理 CLI 路径。首次成功识别会将路径保存到本机，后续优先复用；也可输入完整文件路径并点击“刷新”，同步更新 CLI 状态，或“恢复自动识别”。这项设置跨项目共用，但按机器和操作系统隔离。手动路径优先于部署配置，部署配置优先于自动记录；自动记录文件消失后重新识别，手动路径失效则保留并提示，不会静默换用另一个安装。请填写 CLI 文件路径，不要填写桌面 GUI、目录、命令参数或外层引号。

设置页的标题、标签、留白、分隔线和控件遵循统一设计规范，后续扩展复用同一套参数。

ZCode 登录前可选择“中国智谱 BigModel”或“海外 Z.AI”，Mac 和 Windows 使用同一入口；只启动所选来源的官方授权。完整 CLI 的 login [zai|bigmodel] 能力与部分 Desktop 内置旧 CLI 不同，仅有 Z.AI 的旧版本选择 BigModel 时会提示升级，不会改开海外页面。插件优先使用 ~/.local/share/cliworker-now/runtimes/zcode/cli/zcode.cjs 中已部署的完整 CLI，显式配置的执行路径优先级更高；Windows 安装需对应平台的原生依赖。升级 CLI 不会自动迁移 ZCode Desktop 账号，登录继续写入插件独立的 ZCode 账号目录。

Windows 的原生授权网址会完整打开一次，也可在终端中点击或选择复制；网页打开不代表授权已完成，需按官方网页提示完成登录。

账号发现和执行绑定同一来源；保存选型、新任务、排队出队和续聊都会重新核对账号、模型与强度。换号或退出会阻止旧任务启动，历史任务换号后需新建任务；升级前未记录账号绑定的历史任务也需新建，原对话保留。插件不读取其他 CLI 的凭据，也不继承 Harness API 凭据；旧 zaiCredentialRef 配置兼容读取但不生效。旧派生认证快照会按当前自身来源重建，原生账号、历史会话和偏好保留；失效偏好需重新选择。

Antigravity 使用自身原生登录和实时 agy models 目录，只展示原生返回的模型及强度变体。Windows 使用原生 Credential Manager 中当前交互式用户的账号，仅返回安全身份摘要。账号读取先完成，模型查询的等待或失败不会把已登录账号改为未登录。重复的在途账号读取会合并，后续刷新与执行授权仍读取当前账号。

Claude 会显示当前来源：自身配置的本地代理可达时使用代理，代理关闭时使用原生官方账号。代理认证或模型查询失败会明确报错，不自动换号。官方登录／退出只作用于官方账号，保留代理设置；任务启动前固定来源，不在运行中切换。官方 OAuth 模型需同时通过原生身份、模型能力和剩余额度核验；缺少证据时不放行。

当前账号范围边界：Kimi 原生 managed OAuth 使用自身模型别名、认证目录和可确认的套餐额度；额度为空、未知或耗尽时提示检查账号。其他未核验的 Kimi OAuth 模式及 OpenCode OAuth 暂不开放派遣。Claude 自身设置中的 API Key／Bearer Token、Kimi 自身 API 配置、MiMo 原生网页登录写入的自身 API 认证，以及可核对的本地配置，按账号列表筛选；保留网页登录附带的官方服务地址。Codex 支持已核验的官方文件账号路径，keyring 或自定义路由缺少范围证据时不放行。MiMo 目前只接受可核验的本地配置，文件／环境插值和远程组织配置需先移除。OpenCode 原生 OAuth 写回缺少账号版本保护，暂只开放自身 API 配置。

Codex 能读取模型但当前额度耗尽时，设置明确提示等待额度恢复；认证失效或访问被拒绝单独提示检查登录。两者都保留现有账号和项目偏好，不把原生模型能力当成当前可调用权限。

Kimi 已有有效或可续期的自身原生登录时显示“已登录”及可确认的简短账号 ID；原生未保存邮箱或昵称时不编造，点击“管理登录”打开原生终端；切换账号由用户输入 /logout 后再输入 /login。账号终端使用独立空目录，不加载用户项目 MCP；原生若显示 Trust 提示，由用户自行确认。只有提供商配置而没有对应令牌时显示未登录，不会自动退出原账号。

Hermes 首次明确打开登录设置后使用插件内独立原生账号目录，自动导入关闭，状态、模型、任务统一绑定该目录；之后退出不会回退到全局旧账号。原全局账号和历史保留，Host 不把其他 CLI 导入凭据作为自身登录证据，不注入 Harness 认证；原生进程按自身权限运行。现有官方安装的已选依赖环境可直接复用，账号操作不触发重新安装。

Hermes 的 Nous 登录按当前原生授权识别，模型来自该账号认证的官方目录及访问权限；无付费权限时仅开放明确免费的可用模型。Mac 与 Windows 共用自动续期：短期访问令牌临近过期或已过期时，使用同一账号的原生刷新凭据续期，健康令牌不额外启动进程。临时网络问题可刷新重试，只有刷新凭据缺失或明确失效才要求重新登录。续期不调用模型、不切换账号，也不清除额度或冷却限制；不会用旧快照恢复已退出的账号。

Grok 先核对自身官方 Build 访问门禁，再读取认证模型目录并匹配原生模型及强度能力；登录成功或目录 HTTP 200 均不能单独证明调用权限。是否有付费订阅也不能代替服务端门禁结果；未知或拒绝时保持空列表和简短原因，不通过生成请求试探。

flowchart LR
    A[项目首次使用该 CLI] --> B[模型 · 强度 · 角色]
    N[同项目新主对话调用该 CLI] --> Q{是否沿用以前设定}
    Q -->|否| B
    Q -->|是| C[有名字的独立智能体]
    B --> C
    C --> D[侧栏查看过程与结果]
    D --> E[结果返回主对话]
    D --> F[本轮结束后按名称续聊]
    F --> C

6.2 查看、停止与继续

• 点击任务卡片进入独立对话；返回总览不会清空未发送的草稿。
• 总览的搜索和状态筛选固定在上方，任务列表独立滚动，首卡顶部完整显示；不显示匹配说明或清除筛选文字。异常右侧的垃圾桶按钮可查看已删除对话，再次点击或选择任一状态筛选均可返回；查看已删除时四筛选呈灰色，垃圾桶为深红底白图标。
• 右键任务卡片可修改聊天标题、智能体名称或删除；聚焦卡片打开按钮后也可按 Shift+F10 或菜单键操作。卡片不显示省略号按钮，右侧箭头在整行居中；已删除的空闲任务及其历史可以恢复。
• 默认名称采用 agy-1、codex-1 等短名称，旧默认名兼容寻址；名称按钮加宽但文字起点保持，名称与模型到分隔线的文字距离相等，点击后文字显示「已复制」，移开鼠标约一秒后恢复。
• 思考强度统一显示为 Low、High 等，保存和执行仍使用 CLI 原生值。
• 缺少账号记录的旧任务保留历史；标题下与原生新会话按钮等高的提示条提供「新建对话」，可按原模型、强度和角色使用当前自身账号新开。未建立原生会话的任务不在输入区重复说明，仍不能续聊。
• 运行中可以停止任务；插件等待受管理的进程退出后再报告停止。
• 子对话使用与 Harness 主聊天一致的返回最新圆形按钮和历史功能条淡入淡出；最新消息功能条保持可见，历史条在悬停或键盘聚焦时出现。
• 子对话输入框按 Enter 发送、Shift+Enter 换行，支持 Ctrl/Cmd+Enter，中文输入法确认不会误发送。
• 本轮结束后，在子对话输入下一步，或在主对话中说：“让代码审查员继续检查测试覆盖。”
• 按名称续聊限定在当前主会话内，复用同一个 CLI 会话；重命名不会清空历史或改变角色。
• 关闭侧栏不会停止后台任务，完成结果仍会回到主对话。

6.3 管理角色与 CLI

设置入口	可以做什么	生效范围
智能体设置	新增、编辑、删除“名称 / 概述 / 角色提示词”预设	当前 Harness profile 共用；已有智能体保留原角色副本
CLI 连接	独立开关、刷新状态、登录设置或切换账号、打开原生账号终端	对应 CLI；关闭前需先结束其任务与账号终端
项目默认设置	保存默认模型与思考强度	当前项目 + 当前 CLI 的新主对话；已确认对话保持原设定
子对话模型菜单	在本轮结束后修改当前智能体的模型或强度	下一轮续聊，保留同一个 CLI 会话

内置角色：商业审稿人、逻辑审校员、文风审校员、正文修订师、剧情节点设计师、剧情结构规划师、小说主笔。更多说明见 默认角色预设。

CLI 连接的状态点含义：

状态点	含义
灰色	未安装、未登录、仅有普通配置或尚未检查；检查中显示加载状态
红色	已知登录失效、配置损坏、读取失败、无效的显式执行路径或已配置后的模型目录失败
绿色	已登录：来自原生状态、可续用登录会话或当前账号的精确凭据绑定

未配置 CLI 的空模型目录保持灰色。账号查询结束后再加载模型；刷新账号或结束账号操作会使旧模型清单失效并重新查询。模型刷新中或失败后不能继续选择旧列表，已有项目默认设置保留，恢复后需重新核对。导航与账号摘要使用相同状态规则。账号区仅保留一行状态与必要身份，错误显示简短原因。