CLI Worker Now

阅读导航

1. 项目定位 · 2. 特点与优势 · 3. 界面效果 · 4. 支持范围 · 5. 安装更新 · 6. 使用方法 · 7. 常见问题 · 8. 开发验证 · 9. 文档与反馈

1. 项目定位

CLI Worker Now 是 DeepSeek Harness 的独立多 CLI 智能体插件。它把分散在终端中的外部 AI CLI，接入 Harness 的主对话和右侧栏：主对话负责派遣与接收结果，侧栏负责展示各个智能体的任务、对话和状态。

适合已经使用多个 AI CLI，希望集中管理任务、反复调用同一位助手的人。你仍然使用各 CLI 自己的账号、模型与原生会话，插件负责把这些工作组织起来。

• 开发协作：指定 Codex 审查代码，再按同一个智能体名称继续追问。
• 小说创作与审校：为逻辑、文风、商业审稿和正文修订配置不同角色。
• 长任务跟进：保留独立对话和执行记录，任务结束后继续，不必重新描述全部背景。

插件依赖 DeepSeek Harness 和相应 CLI；不附带模型服务、订阅或 API 额度。CLI 的模型请求由各自服务商处理。

2. 特点与优势

这些优势侧重于任务组织、上下文延续和操作体验。插件不承诺提升模型本身的准确率，也不把不同 CLI 的权限能力视为完全相同。

3. 功能与界面效果

以下效果图均直接拍摄于 DeepSeek Harness Desktop 0.2.0-rc.2 + CLI Worker Now v0.6.5。为公开展示新建了独立演示会话，使用 Antigravity 的 gemini-3.8-flash / low 真实执行一条欢迎语任务。

当前版本使用用户选定的天蓝平切 Logo：入口使用原彩色图，标题随浅色／深色主题显示相同轮廓的黑／白版。下面的历史截图仍为 v0.6.5。

3.1 任务总览与独立对话

按 CLI 分组查看智能体，筛选进行中、已完成和异常任务。进入某个智能体后，可以查看独立对话、公开执行记录和用量，在本轮结束后继续交流。

点击右侧任务卡片，进入这位智能体的独立对话。主对话和子对话各自保留记录。

3.2 角色预设与自定义提示词

设置页以“名称 + 概述”的卡片管理角色。内置七种小说创作角色，也可新增适用于开发、研究或其他任务的角色。每个智能体保留创建时的角色副本；修改预设在重新选型时生效，不改变已确认设定或已有对话。

3.3 CLI 连接、账号与模型偏好

每个 CLI 可以单独开启或关闭，分别管理账号、项目默认模型与思考强度。支持的 CLI 可直接打开原生账号终端；登录状态与账号来源按各 CLI 的实际能力显示。

macOS 与 Windows 共用同一账号终端，支持选择文字复制及 Cmd+V／Ctrl+V 粘贴；右键在有选区时复制、无选区时粘贴，输入位置使用闪烁块状光标。登录时直接打开原生授权网页；Windows ZCode 的完整登录网址也可在终端点击或选择复制到浏览器。

3.4 亮暗主题与交互

跟随 Harness 的亮暗主题，保留卡片展开收起、按钮悬停、原生菜单和固定高度设置弹窗；系统启用“减少动态效果”时相应停用动画。

4. 环境与 CLI 支持

4.1 环境要求

4.2 支持范围与验证边界

插件使用各 CLI 原生的保护和权限模式，不再附加操作系统进程沙箱。Windows x64 已通过运行层和 11 个 CLI 的账号来源测试，并实测 Codex/Pi/OMP 启动及 Pi SDK 元数据；下表区分接入版本与实际模型调用记录。模型列表只展示当前 CLI 自身账号可用的选项。

MiMo 指 XiaomiMiMo/MiMo-Code。Hermes Agent 替代的是旧的外部 Harness CLI 入口，DeepSeek Harness 宿主仍是插件的运行基础。

MiMo 短时间重复加载模型能力时复用有界内存缓存，减少 Windows 上反复启动 CLI 的等待。首次加载仍需查询原生 CLI；账号、配置、项目或程序变化使缓存失效，每次派遣仍核对当前账号授权。

设置页的账号状态请求最多两个并发，包含当前选中的 CLI。首次打开优先当前项，切换时只调整待排顺序；模型目录另行查询，因此这不是全部子进程的数量上限。关闭或禁用会取消对应读取，底层进程清理仍由 Host 管理。

Kimi 已核验的 managed OAuth 模型能力和 Claude 的命令参数能力也可短时复用；每次目录查询仍核对当前凭据、有效期和远端权限，不缓存远端额度。Windows 后台查询及嵌入式账号终端的启动器隐藏额外控制台窗口。

成功且进程退出已确认的扩展 CLI 模型查询会自动删除本次临时目录和原生解压缓存；失败或清理未确认时保留现场，不删除原始账号文件。

专项记录：ZCode · Grok · Pi / OMP · Hermes · OpenCode

5. 安装与更新

5.1 一行安装

dsh plugin --profile desktop add dsh-cliworker-now@0.7.7

dsh plugin --profile web add dsh-cliworker-now@0.7.7

dsh plugin --profile desktop add https://github.com/SuperWheel/cliworker-now/releases/download/v0.7.7/dsh-cliworker-now-0.7.7.tgz

git clone https://github.com/SuperWheel/cliworker-now.git
cd cliworker-now
pnpm install --frozen-lockfile
pnpm --config.verifyDepsBeforeRun=false build
dsh plugin --profile desktop add .

dsh plugin --profile desktop remove 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 支持”与“当前自身账号可用范围”的交集；公共目录、旧缓存、固定别名和匿名免费模型不能单独成为可选依据。无法确认时显示空列表及简短原因。账号范围使用只读模型查询，不通过生成请求试探权限。

设置、模型菜单和任务卡片只显示模型名称，删除服务商、组织路径前缀及括号附注；同一原生模型去重，不同原生模型同名时仍保留独立选项，保存和执行使用完整路由 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 原生写入的停用来源会同步约束登录、模型和调用，不从保留的配置值恢复账号。

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

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

CLI 连接的状态点含义：

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

7. 权限、数据与常见问题

7.1 执行与数据边界

• 按明确选择执行：CLI 缺失或失败时不会自动换用另一个 CLI；不接管在插件外启动的 CLI。
• 调度有边界：默认两个并发；同一 CLI 会话单轮互斥，同一目录的写任务串行。仅支持主对话 → 直接子智能体两层结构，不支持运行中插话或递归派遣。
• 权限按原生能力处理：Harness 规划模式或只读权限下拒绝启动。允许执行后，支持的 CLI 可按只读任务模式派遣；Kimi 和 Hermes 非交互模式不支持只读派遣。插件不附加 OS 沙箱，各 CLI 的原生权限与工具限制见专项文档。
• 记录保存在本机：默认位于 $DSH_HOME/cliworker-now（通常为 ~/.dsh/cliworker-now），POSIX 系统中目录权限 0700、文件 0600。外部 CLI 仍会按自己的服务与配置发送模型请求，不能据此认为任务完全离线。
• 用量有来源：只展示 CLI 提供或可核查的统计，缺失显示 —；上下文占用与累计 Token 不是同一指标。Antigravity 的估算来源会在详情中说明。
• 账号有边界：原生已登录会话正确显示绿色；自身 API 配置单独标记，模型权限按当前账号筛选。插件不在页面展示 API 密钥；部分 CLI 与原生终端共用账号，退出操作可能同时影响该 CLI 的其他终端。

7.2 常见问题

8. 开发与验证

项目使用 TypeScript ESM + React：Host 管理进程与持久化，Client 通过 Harness 原生 Gateway 访问 Host，共享协议负责两侧的数据约定。

pnpm install --frozen-lockfile
pnpm --config.verify-deps-before-run=false typecheck
pnpm --config.verify-deps-before-run=false test
pnpm --config.verify-deps-before-run=false build:preview

隔离包输出到 .cache/preview-package。先在隔离 profile 验收，确认没有活动任务后，再运行正式构建；避免开发构建影响 Desktop 正在使用的版本。

在 Mac 构建后，可通过 SSH 在自己的 Windows 原生测试机安装隔离依赖、运行定向回归并回传日志与包哈希；见 Windows 远程测试指南。入口为 pnpm --config.verifyDepsBeforeRun=false test:windows:remote --config .test-data/windows-remote/config.json，默认不调用模型或验收 Desktop 界面。

真实 CLI 验收是额外步骤，会使用对应账号与模型额度，不由以上自动测试代替：

pnpm --config.verify-deps-before-run=false smoke:extended --help

v0.6.15 通过类型检查、1112 项本机回归及真实 Windows 运行层检查；Windows CI 的源码与日志可从 验证工作流 查看。各 CLI 的真实验收范围请看第 4 节和 实际验证记录。

开发变更使用 OpenSpec 管理方案、增量规格与任务；按变更逐步补齐规格，保留现有设计和验收历史。依赖已固定在项目中，安装后可运行：

pnpm spec:list
pnpm spec:check

Codex 中选择 openspec-propose 技能准备方案，再用 openspec-apply-change 实施；完成验证后用 openspec-archive-change 归档。具体命令、文档分工及其他 CLI 的接入见 OpenSpec 开发指南。OpenSpec 是本仓库的开发工具，插件使用者无需安装。

9. 文档、反馈与许可

• 设计与协议：架构、调度、权限与持久化设计。
• OpenSpec 开发指南：需求到实施、验证与归档的工作流。
• 任务与实际验证：已实施内容和验收记录。
• 历史版本与详细配置：逐版本变更、适配器配置及限制。
• 角色预设：默认智能体的职责与边界。
• 效果图来源与隐私处理：原生截图来源与隐私说明。
• 提交 Issue：请附 Harness / 插件 / CLI 版本、复现步骤与已脱敏日志；不要上传账号令牌或私人项目内容。

项目采用 MIT License，是独立社区插件。DeepSeek Harness 及各 CLI 的名称、图标和商标归各自权利人所有，不表示官方关联或背书。