阅读导航

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	在主对话点名 CLI，在同一侧栏按 CLI 分组查看任务	减少在多个终端之间查找任务和结果的切换
保留原生能力	不同 CLI 使用各自的参数、登录与会话协议，模型目录按实际能力读取	可以继续使用熟悉的 CLI 生态；模型和强度不会被硬套成一套规则
智能体有名字、有角色	唯一名称、角色预设、自定义提示词，以及按名称续聊	同一位审校员或开发助手可以反复调用，职责更清楚
过程与结果放在一起	独立对话、公开工具事件、任务状态，以及 CLI 实际提供的用量	能看到任务走到哪一步，出错后有记录可查
明确选择，可控调度	首次选型、每个 CLI 独立开关、停止操作；同会话互斥、同目录写任务串行	任务按明确的选择执行；失败时不会悄悄换用另一个 CLI
融入 Harness 工作流	复用宿主的侧栏、问题卡片、主题与控件，完成结果回到主对话	派遣、查看、继续和收尾都在熟悉的界面中完成

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

3. 功能与界面效果

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

3.1 任务总览与独立对话

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

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

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

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

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

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

3.4 亮暗主题与交互

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

4. 环境与 CLI 支持

4.1 环境要求

项目	要求
操作系统	当前验证基线为 macOS；部分适配器依赖 macOS Seatbelt
宿主	DeepSeek Harness 0.2.0-rc.2
Node.js	≥ 22.19.0
外部 CLI	按需安装，无需把全部 CLI 都装上；准备好对应账号或 API 权限
源码开发	pnpm 11.25.0，以仓库锁文件为准

4.2 支持范围与验证边界

“已接入”表示有对应适配器，并不等于所有模型、套餐或平台都已实测。下表是截至 v0.6.5 的项目验证记录。

CLI	已核验版本	当前验证范围
Antigravity	1.2.16	首轮、续聊与停止已有真实验收
Codex	0.160.0	真实首轮与同会话续聊通过
Claude Code	2.1.176	真实首轮与续聊通过；测试环境的 sonnet 映射到 GLM
Kimi Code	0.42.0	协议回归通过；真实请求被订阅权限 403 阻止
官方 MiMo Code	0.1.15	真实首轮与续聊通过
ZCode	0.16.9	原生登录、headless 与会话协议已接入；详见专项记录
Grok Build	1.0.0	登录记录读取与协议接入；真实模型任务及订阅可用性未验收
OMP	16.4.4	RPC 接入；智谱 Coding CN GLM-5.3-Flash 已实测
Pi	1.0.2	原生 RPC 接入；智谱 Coding CN GLM-5.3-Flash 已实测
Hermes Agent	v0.21.5+7527.g4787e4d	原生账号向导、模型查询和沙箱启动已验证；真实模型运行与续聊未验收
OpenCode	1.18.21	原生目录与 JSONL 接入；智谱模型已实测，免费 MiMo 请求曾返回 403

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

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

5. 安装与更新

5.1 从 Release 安装（推荐）

1. 安装并打开一次 DeepSeek Harness 0.2.0-rc.2，初始化 Desktop profile；准备好要使用的 CLI。
2. 前往 v0.6.5 发布页，下载 dsh-cliworker-now-0.6.5.tgz 和 SHA256SUMS.txt。
3. 结束活动任务并完整退出 Harness。若文件保存在“下载”目录，执行：

cd "$HOME/Downloads"
shasum -a 256 -c SHA256SUMS.txt

DSH='/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh'
"$DSH" plugin --profile desktop add \
  "$HOME/Downloads/dsh-cliworker-now-0.6.5.tgz"

4. 重新打开 Harness，在插件页确认 dsh-cliworker-now 已启用；必要时点击“刷新”。
5. 在主会话标题栏点击 Finder 左侧的 CLI Worker Logo，或在右侧栏新标签页选择 CLI Worker。

安装命令由 Harness 转交包管理器处理本地 .tgz，无需手动解压；首次安装可能需要联网下载依赖。如果 Harness 不在默认应用目录，请把 DSH 改成实际路径。

5.2 从源码安装

git clone https://github.com/SuperWheel/cliworker-now.git
cd cliworker-now
pnpm install --frozen-lockfile
pnpm --config.verify-deps-before-run=false build

DSH='/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh'
"$DSH" plugin --profile desktop add "$PWD"

从源码目录安装会建立本地目录链接，因此源码目录需要保留；执行安装前应结束活动任务并完整退出 Harness。该插件通过 Harness 插件机制安装，不是独立桌面应用，也无需修改 Harness 核心源码。

5.3 更新与卸载

更新前结束正在运行的 CLI Worker 任务和账号终端。下载新版本安装包，完整退出 Harness 后按上面的安装命令安装，再重新打开 Harness。源码安装则在保留的源码目录中更新依赖和构建。仅刷新插件列表不足以重新加载 Host 接口。

卸载命令：

DSH='/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh'
"$DSH" plugin --profile desktop remove dsh-cliworker-now

卸载保留本机历史状态，不会自动删除会话与账号数据。

6. 使用方法

6.1 首次派遣

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

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

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

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

未回答或取消不会启动任务。已有有效的项目模型偏好时，会沿用模型和强度；每个新智能体仍会单独询问角色。

flowchart LR
    A[主对话明确指定 CLI] --> B[模型 · 强度 · 角色]
    B --> C[有名字的独立智能体]
    C --> D[侧栏查看过程与结果]
    D --> E[结果返回主对话]
    D --> F[本轮结束后按名称续聊]
    F --> C

6.2 查看、停止与继续

• 点击任务卡片进入独立对话；返回总览不会清空未发送的草稿。
• 运行中可以停止任务；插件等待受管理的进程退出后再报告停止。
• 本轮结束后，在子对话输入下一步，或在主对话中说：“让代码审查员继续检查测试覆盖。”
• 按名称续聊限定在当前主会话内，复用同一个 CLI 会话；重命名不会清空历史或改变角色。
• 关闭侧栏不会停止后台任务，完成结果仍会回到主对话。

6.3 管理角色与 CLI

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

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

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

7.1 执行与数据边界

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

7.2 常见问题

已经在终端安装了 CLI，为什么 Desktop 找不到？

Desktop 不会读取你的 .zshrc。插件会识别部分常见安装位置；仍找不到时，在插件配置中设置对应 CLI 的可执行文件绝对路径。可用配置项见 详细配置与版本说明。

模型菜单报错或更新后出现 HTTP 404，怎么办？

先结束运行中的任务，然后完整退出并重新打开 Harness。只刷新插件列表，可能留下旧 Host 与新 Client，导致接口不一致。重新启动后仍失败，再检查该 CLI 的安装、账号和原生模型目录。

每个 CLI 都需要订阅吗？已登录为什么仍然失败？

订阅、API 计费和模型权限由各 CLI 的服务商决定。能够打开登录页、读取本地账号或列出模型，不代表对应模型请求一定可用；遇到 403 等错误需核对原生账号权限。

为什么没有思考强度选项或上下文百分比？

插件只提供 CLI 明确支持的强度。未提供能力时沿用 CLI 配置；未提供可核查上下文数据时显示 —，不会根据模型名称或累计用量猜测。

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 正在使用的版本。

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

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

v0.6.5 的 Logo 与界面改动通过类型检查、27 项界面与注册测试、隔离构建、正式构建及打包校验，并做过亮暗界面检查。各 CLI 的真实验收范围请看第 4 节和 实际验证记录。

9. 文档、反馈与许可

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

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