dsh-working-activity

English | 中文

DeepSeek Harness（DSH）的实时工作状态行插件。agent 工作期间，插件把会话的持久事件流与实时模型输出折叠成一行：当前相位文案、真正在跑的工具、已耗时，以及回合结束摘要。

所有组合了本插件的界面渲染的都是同一行：终端界面（dsh-tui）、浏览器 Web UI 与桌面 GUI。浏览器与桌面端读取会话投影，不会为此向会话日志追加任何内容。

| | | |---|---| | 包名 | dsh-working-activity | | 宿主 | DSH 0.1.0-rc.6 至 0.2.1-rc.2（见兼容性） | | 界面 | TUI · Web UI · 桌面 GUI | | 传输 | 会话投影 workingActivity；可选的 ignorable plugin:working-activity/status 记录 | | 运行时 | Node ^22.19 \|\| >=24 | | 许可证 | BSD-3-Clause |

目录

• 功能
• 工作原理
• 环境要求
• 安装
  • TUI
  • Web UI
  • 桌面 GUI
• 配置
• 投影契约
• 会话记录契约
• 兼容性
• 架构
• 开发
• 故障排查
• 隐私与安全
• 许可证

功能

• 相位感知的状态行。 状态行按 waiting → thinking → tool → done 移动。每个相位有独立的文案池、轮换节奏与耗时格式；已结算的相位展示固定的收尾摘要，而不是继续计数的计时器。
• 真实的工具活动。 运行中的工具渲染为动词 + 参数细节 + 已耗时（跑个命令 npm test · 12s）。结果与调用按精确 call id 配对；失败的工具使用失败文案并带 ✗ 标记。
• 回合摘要。 turn/end 后状态行变为 搞定 ✓ · 4 工具 · 想12s 干11s——完成工具数、思考耗时与干活耗时——并短暂钉住最后一个工具的片段。
• 实时自述。 narrate 默认开启：插件注入一条简短的系统提示词约定，要求模型在每个步骤开始时写一行 ⏵ …。该行实时显示在状态行中，持久消息里仍然保留它。
• 双语、按特性开关的文案。 中英文案池、日间/深夜变体、长思考分档、周末与节假日文案、稀有彩蛋、工具连击、模型切换梗与失败文案都可独立开关。phrases: false 或 mode: minimal 渲染朴素功能标签。
• 构造上无侵入。 插件不注册工具、不追加 surface 事件、不进入派生的模型历史。它唯一可能影响提示词的部分是可选的自述约定。
• 可选的不变量伴生插件。 ./invariant 校验本包自己的活动快照——legacy activity/status 事件与当前 plugin:working-activity/status 记录两种拼写——检查相位词表、非空 line 与有限非负指标，覆盖已加载会话以及之后的每次追加。
• 一次折叠，三个界面。 node 半边持有状态机；TUI、Web UI 与 GUI 只渲染投影值，没有界面重新实现相位逻辑。

工作原理

node 半边为每个会话维护一个 ActivityTracker，输入有三类：

1. 持久会话事件——turn/start、step/start、assistant/message、tool/call、tool/result、turn/end、assistant/attempt、model/selection，以及压缩、审批与重试信号。
2. 实时 assistant-stream 帧——agent/assistant-stream（start / chunk / end）。当前宿主线上，流式增量、首 token 时刻与 ⏵ 自述都由这些帧承载。
3. agent 状态——agent/status（idle / running）。

tracker 渲染一行纯文本，并通过两条通道对外提供同一个值：

• 投影——workingActivity 会话投影折叠持久日志并发给客户端。这是 TUI、Web UI 与 GUI 的传输通道。
• 持久记录——publish: true 时，渲染出的快照还会作为只记日志的记录追加，供重放会话日志的消费者使用。在 DSH 0.2.x 上是 ignorable 的 plugin:working-activity/status 记录；旧走廊使用 legacy activity/status 事件。

| 相位 | 进入条件 | 示例行 | |---|---|---| | waiting | 回合已开启，模型尚未产出 token | 等待模型响应 · 总3s | | thinking | 收到实时 token 或 reasoning 增量 | 嗯…让我捋捋 · 总12s | | tool | 有 tool/call 尚未收到结果 | 跑个命令 npm test · 12s | | done | 回合已结束 | 搞定 ✓ · 4 工具 · 想12s 干11s | | idle | 没有进行中的回合 | （不渲染） |

环境要求

• 组合了 agent loop 与至少一个界面（TUI、Web UI 或 GUI）的 DSH profile。
• Node ^22.19 || >=24。
• 官方 CLI 安装 profile 插件时会调用 pnpm。

安装

本包是自挂载 bundle：声明了 dsh.bundle.patch（cordis.patch.yml），官方 CLI 既安装本包，也会把它追加到 profile 的 bundle 层列表。启动时，bundle patch 把 working-activity 行插入组合树，无需手动挂载。

dsh plugin --profile <profile> add dsh-working-activity

要调整配置，请在 profile 的用户层（$DSH_HOME/profiles/<profile>/cordis.patch.yml）按 id 覆盖该行的 config，不要插入第二个同 id 行：

- id: working-activity
  config:
    tickMs: 250
    publishIntervalMs: 500

检查组合结果：

dsh --profile <profile> --dump-config

TUI

TUI 支持随 dsh-tui 提供。dsh-tui 依赖本包，其 profile 通过 @deepseek-harness-tui/dsh-tui/working-activity 挂载（该子路径是 re-export，并把 publish 固定为 false），从 workingActivity 投影渲染工作状态行。dsh-tui 还复用本包的 ./frames 预设与 ./config 解析器，用于帧选择器和 ~/.dsh-tui/working-activity.json 设置。

把 dsh-tui 装进 profile 即可；本插件作为它的依赖自动到达，不要向同一个 profile 再单独 add 一次：

dsh plugin --profile <profile> add @deepseek-harness-tui/dsh-tui
dsh --profile <profile>

宿主直接组合本包时也可独立使用；宿主提供 ctx.tuiPrompt 时，插件会注册 ${activity} 模板值，可在 prompt 模板中这样启用：

- id: tui
  config:
    theme:
      leftPrompt: '${cwd}${git/worktree}${activity}${model}${context}'

当前 DSH 线不组合 tuiPrompt；在这条线上，投影是 TUI 的唯一传输通道，上述模板值是惰性的。

Web UI

把插件装进组合了 Web 客户端的 profile，然后启动该 profile（官方 web profile 也可以直接 dsh web）：

dsh plugin --profile <profile> add dsh-working-activity
dsh --profile <profile>

浏览器半边是一个客户端 bundle（lib/client.js，随包发布）。宿主的 client-module loader 会扫描 loader 条目中的 dsh.client 声明，并把 bundle 交给 shell。bundle 在 conversation.input.dock 上注册一个条目——id activity、order 15——渲染为 composer 上方的一行暗色状态：

• 相位色呼吸标记、宿主组合好的整行文案、本回合工具数；
• 首个值到达之前、以及相位为 idle 时不渲染；
• 值处于 live 时，已耗时片段每秒在客户端本地重算——因为投影本身只在已提交事件折叠时才变化。

本包声明的客户端编队：

"dsh": {
  "bundle": { "patch": "./cordis.patch.yml" },
  "client": {
    "platform": "web",
    "inject": [
      "@deepseek-ai/dsh-client-ui-conversation",
      "@deepseek-ai/dsh-client-ui-renderer",
      "@deepseek-ai/dsh-client-ui-session"
    ]
  }
}

dsh.client.inject 列的是启动行（boot row）——必须先到达的包依赖——不是 Cordis 服务注入。客户端插件自己导出的 inject 是 ['slots']。@deepseek-ai/dsh-client-ui-slots 是 shell 的种子模块，不是 boot row，因此不出现在 dsh.client.inject 中。

桌面 GUI

桌面 GUI（deepseek-harness-desktop，Tauri）复用 Web 客户端入口：同一份 platform: "web" 声明、同一个 conversation.input.dock 座位、同一次 useProjection('workingActivity') 读取，宿主侧同样是会话投影。插件运行在内核 Web 客户端里（当前线是 React 18.3.1），不在 GUI 宿主的 React 树中；react peer 范围（^18.2.0 || ^19.0.0）同时覆盖两者，React 19 宿主不会把第二份 React 副本带进 bundle。

GUI 侧的要求与 Web UI 相同：组合上文三个 boot row，并让 shell 的模块种子表提供 react/jsx-runtime。已验证的契约、证据与已知限制见 docs/gui-compatibility.md。

配置

所有键都是可选的；未设置时使用下表的 schema 默认值。在 profile 用户层覆盖 working-activity 行的配置。

| 键 | 类型 | 默认值 | 含义 | |---|---|---|---| | phrases | boolean | true | 俏皮文案池。false 渲染朴素功能标签；mode: minimal 会在未显式设置时关闭它。 | | publish | boolean | false | 为会话日志重放型消费者追加只记日志的工作状态记录。DSH 0.2.x 上是 ignorable 记录（plugin:working-activity/status），不影响 resume；旧走廊降级为 legacy activity/status 事件。第一方界面读取投影，不需要它。见会话记录契约。 | | tickMs | number | 500 | 状态渲染 tick，单位 ms（100–5000，步长 50）。活跃相位按自身调度唤醒，并受该值上限约束。 | | publishIntervalMs | number | 2000 | 状态行稳定时两次发布事件的最小间隔（500–30000，步长 500）。 | | detailLimit | number | 40 | 路径、命令与模式等细节的最大展示长度（8–120）。 | | customActions | object | {} | 工具名 → 动作文案池，大小写不敏感匹配。示例：{"my_deploy": ["部署一下", "上线中"]}。 | | narrate | boolean | true | 向系统提示词注入 ⏵ 自述约定，并展示提取出的行。设为 false 则完全由事件推导。 | | lang | 'auto' \| 'zh' \| 'en' | 'auto' | 文案语言。auto 的解析顺序：DSH_TUI_LANG → ~/.dsh-tui/lang.json → 操作系统 locale → zh。 | | frames | string | 'moon8' | 帧预设名。对 UI 消费者是信息性的；dsh-tui 自己解析持久化的帧选择。 | | mode | 'lively' \| 'minimal' | 'lively' | minimal 只保留功能性信息（朴素标签，无俏皮文案池）。 | | features | object | {} | 单特性开关；显式值优先于 mode 默认值。 | | customPhrases | string[] | [] | 追加到基础思考文案池的额外短句。 | | showTokPerSec | boolean | false | 流式输出时显示估算的 ~tok/s 前缀。该值由增量文本推导，不是 provider 的 usage。 | | workRemindAt | number | 0 | 累计工作达到该小时数后提示休息（0–24；0 关闭）。 | | debugLog | boolean | false | 把每个不同渲染行的 JSON 追踪追加到 ~/.dsh-tui/working-activity-debug.log（或 DSH_WORKING_ACTIVITY_DEBUG_LOG 指定的路径）。 |

features 接受且由 tracker 实际生效的特性开关：

phrases、rareEggs、nightPhrases、weekend、holidays、combo、failPhrases、modelQuips、continuePhrases。

投影契约

投影键是 workingActivity，在宿主组合了 sessionProjections 服务时注册；没有投影注册表的 profile 会直接跳过，不报错。

DSH 0.2.x 的注册定义契约：

| 字段 | 含义 | |---|---| | key | 'workingActivity' | | stateSchema | 在持久化状态用于折叠之前校验它。 | | stateVersion | 持久化缓存失效版本；快照形状或折叠语义变化时递增。 | | init(header, inheritedEventCount) | 空日志的初始状态。 | | apply(state, event) | 纯转换。对本单元不建模的事件返回同一个引用，宿主因此不做任何下游工作。 | | wire.viewSchema | 客户端值离开宿主前进行校验。 | | wire.view(state) | 渲染完整的客户端值。 |

同一个定义对象还携带旧注册表拼写——顶层 schema、viewSchema、view 以及零参数 init——因此一个对象无需运行时版本探测，就能注册到 0.1.0-rc.6、0.1.2-alpha.2、0.1.7-rc.2 与 0.2.x 的注册表。宿主提供 stateOf(session, key) 时，插件用它把只在实时阶段存在的事实（当前 ⏵ 自述与首 token 时刻）叠加到折叠值上；没有该接口的宿主回退到已结算消息携带的自述。

客户端值：

interface WorkingActivityView {
  phase: 'idle' | 'waiting' | 'thinking' | 'tool' | 'done'
  line: string            // 宿主渲染出的整行文案
  live: boolean           // 活跃相位，其耗时文本应在客户端继续跳秒
  label?: string          // 当前工具动作或阶段标签
  detail?: string         // 路径 / 命令 / 模式片段
  phrase?: string         // 当前俏皮文案或 ⏵ 自述
  toolCount: number       // 本回合已完成的工具数
  phaseStartedAt: number  // 当前相位开始的 epoch 毫秒
  turnStartedAt: number   // 当前回合开始的 epoch 毫秒（idle 时为 0）
  updatedAt: number       // 最后一次折叠事件的时间戳
  lang: 'zh' | 'en'       // 渲染 line 时使用的语言
}

投影是事件驱动的，两次折叠之间 line 可能落后于墙钟。值里带有时间戳，客户端可以据此只重算那个会动的片段；Web 与 GUI 半边正是这样做的，片段形状无法识别时则回退到宿主原文。

客户端插件用 session 标准 kit 读取该值：

const activity = useProjection('workingActivity')

会话记录契约

publish: true 会追加只记日志的工作状态记录，供重放会话日志的消费者使用。该项默认关闭：第一方 TUI、Web UI 与 GUI 读取投影；只有重放型消费者才需要向共享日志追加。

DSH 0.2.x（0.2.0-rc.2 / 0.2.1-rc.2）。 写入使用 session.appendPluginRecord()，记录类型为 plugin:working-activity/status。宿主会把该记录标记为 ignorable: true；无法识别的记录会被保留并跳过，因此不会让会话无法 resume。

旧走廊（0.1.0-rc.6 至 0.1.7-rc.2）。 这些宿主没有 appendPluginRecord，插件自动降级为通过 session.append() 追加 legacy activity/status 会话事件。该代事件没有 ignorable 标记，因此插件在加载时会把类型注册进所有可达的 dsh-session 副本——包括持久化校验器实际解析到的那份——以保持 resume 与持久化读取可用。注册是无条件且幂等的，也能读取更早 publish: true 配置写下的日志。若某个读取方解析到插件锚点无法触达的 dsh-session 副本，仍存在残余风险；第一方界面不需要开启发布。

两种拼写的载荷相同：

{
  phase: 'idle' | 'waiting' | 'thinking' | 'tool' | 'done'
  line: string            // 纯文本状态行，无 ANSI
  label?: string          // 当前工作标签（工具动作 / 阶段）
  detail?: string         // 路径 / 命令 / 模式片段
  phrase?: string         // 当前俏皮文案
  toolCount: number       // 本回合已完成的工具数
  turnElapsedMs: number   // 距回合开始的毫秒数
  phaseStartedAt: number  // 相位开始的 epoch 毫秒（动画锚点）
}

两种拼写都不带 surfaceOp，都不会进入派生的模型历史。

发布规则：状态行变化立即发布；稳定行最多每 publishIntervalMs 重发一次，让长工具的已耗时保持实时而不刷爆日志。可选字段缺省时省略；载荷是无损 JSON。

可选的不变量伴生插件会同时校验两种拼写：legacy activity/status 事件与当前 plugin:working-activity/status 记录。

兼容性

node 半边支持下列宿主线。界面列表示该宿主线上可用的渲染通道；除最后一列注明的可选日志记录消费者外，传输始终是 workingActivity 投影。

| DSH 宿主线 | TUI（dsh-tui） | Web UI | 桌面 GUI | 验证 | |---|---|---|---|---| | 0.1.0-rc.6 | 兼容维护¹ | 不支持 | 不支持 | legacy 投影形状测试；运行时类型注册夹具 | | 0.1.2-alpha.2 | 兼容维护¹ | 不支持 | 不支持 | pnpm run test:alpha2（已发布宿主图夹具） | | 0.1.7-rc.2 | 支持 | 支持 | 不适用² | pnpm run test:rc2（已发布宿主图夹具） | | 0.2.0-rc.2 | 支持 | 支持 | 支持³ | 主测试套件 + RC2 宿主夹具 + client bundle 门禁 + GUI 契约门禁 | | 0.2.1-rc.2 | 支持 | 支持 | 支持³ | 主测试套件 + RC2 宿主夹具 + client bundle 门禁 + GUI 契约门禁 |

¹ 为兼容性维护，由隔离夹具 / 形状断言覆盖；主开发树不再针对该线编译。 ² 桌面 GUI 使用 0.2.x 内核线，0.1.7-rc.2 不是 GUI 目标。 ³ 桌面 GUI 复用 Web 客户端入口。GUI 0.22.4 推荐 DSH 0.2.0-rc.2，该版本在 peer 范围内。已验证的契约、证据与剩余限制见 docs/gui-compatibility.md。

说明：

• TUI 需要 dsh-tui 版本的 DSH 适配器支持同一条宿主线。当前 dsh-tui 线以 0.2.x 为主目标，自行维护活动行 / 投影消费，并以 publish: false 挂载本包。只有宿主组合了 tuiPrompt 时，插件才注册 ${activity} prompt 值；当前 DSH 线不组合该服务。
• Web UI 需要 0.1.7-rc.2、0.2.0-rc.2 或 0.2.1-rc.2 客户端编队。浏览器 bundle 按 RC2 shell 的种子表构建（react、react/jsx-runtime、react-dom、@deepseek-ai/cordis、zod、@tanstack/react-virtual、@deepseek-ai/dsh-client-store、-ui-slots、-ui-primitives、-ui-dockkit）；0.1.7-rc.2 shell 是它的子集，也能解析 bundle 唯一的 value import：react/jsx-runtime。
• 桌面 GUI 复用 Web 入口：platform: "web"、同一个 dock 座位、同一份投影。插件运行在内核 Web 客户端里（当前线是 React 18.3.1），不在 GUI 宿主的 React 树中；peer 范围同时覆盖 18 / 19，避免 React 19 宿主把第二份 React 副本带进 bundle。GUI 必须提供 react/jsx-runtime 种子并组合上文三个 boot row。运行 pnpm run verify:gui 检查 GUI 契约（GUI 检出不存在时该门禁会跳过）。
• 旧日志消费者（例如重放会话日志的终端 UI）可在任一支持的宿主线上设置 publish: true。在 0.2.x 上是 ignorable 插件记录；在旧线是 legacy activity/status 事件，由注册垫片兜底。

架构

src/
  index.ts                 插件入口：行配置、每会话 runtime、
                           TUI prompt 槽位、自述段、发布出口
  status.ts                纯 ActivityTracker 状态机与渲染器
  phrases.ts               双语文案池与选择逻辑
  frames.ts                帧预设（与 dsh-tui 共享）
  lang.ts                  语言解析与文案字典
  config.ts                文件式 working-activity 配置解析器
  projection.ts            workingActivity 会话投影（覆盖所有走廊）
  events.ts                activity/status 事件 + plugin-record 类型合并
  registration.ts          旧走廊的会话事件类型注册垫片
  invariant.ts             可选的 dsh-invariants 伴生插件
  compat/
    session-events.ts      持久 SessionEvent → ActivityEvent
    assistant-stream.ts    实时 agent/assistant-stream 帧 → ActivityEvent
    tool-result.ts         tool/result 的 call id 与失败读取
  client/
    index.ts               客户端入口：dock 注册
    WorkingLine.tsx        dock 组件
    elapsed.ts             本地耗时重算
    activity.ts            投影键的类型合并
    WorkingLine.module.css
cordis.patch.yml           自挂载 bundle patch

分层是刻意的：status.ts、phrases.ts、frames.ts、lang.ts 是纯逻辑且注入时钟；所有宿主形状猜测集中在 src/compat/；客户端半边只导入类型，不做领域折叠。

对模型的影响

• 工具： 不注册任何工具。
• surface 事件： 默认不追加。发布的快照只记日志：0.2.x 上是 ignorable 插件记录，旧线是 legacy activity/status 事件。两者都无法到达模型。
• 提示词： narrate: true 时注入一个固定系统提示词段（⏵ 约定）。设 narrate: false 则对提示词零贡献。
• 每次请求 token： 零；上述固定自述段除外。
• KV 缓存： 自述段按语言固定，不随回合变化。

开发

cd packages/activity/working-activity
pnpm install --frozen-lockfile
pnpm run build              # host tsc + client tsc，产物进 lib/types/
pnpm run build:client       # 浏览器 bundle，产物 lib/client.js
pnpm test                   # 单元 + Host 集成测试（vitest）
pnpm run verify:deps        # manifest 依赖门禁
pnpm run verify:lockfiles   # lockfile 一致性门禁
pnpm run verify:host-vocabulary
pnpm run verify:client-bundle
pnpm run verify:gui         # 桌面 GUI 契约（GUI 检出不存在时跳过）
pnpm run prepublishOnly     # 全部发布门禁
pnpm run test:alpha2        # 隔离的 0.1.2-alpha.2 宿主夹具
pnpm run test:rc2           # 隔离的 0.2.1-rc.2 宿主夹具

主开发图钉在 DSH 0.2.1-rc.2（Cordis 4.0.5）。test:alpha2 与 test:rc2 各自携带独立锁文件与已发布宿主图，互斥的 peer 集合不会混装。父包重建后必须重装夹具（pnpm run test:rc2 已包含两步）。

客户端 bundle 是闭包工厂产物，经 window.__ModuleLoader__.load({ id, factory }) 加载。无浏览器即可校验：loader 契约、模块说明符相对 RC2 种子表的纯度、声明的客户端行，以及 dock 注册与渲染分支。

故障排查

TUI 里没有状态行。 确认插件出现在组合后的 profile 中（dsh --profile <profile> --dump-config），并确认 dsh-tui 版本支持该宿主线。TUI 读取投影，publish 不影响它。

Web UI 里没有状态行。 确认已安装包包含 lib/client.js、profile 组合了三个 boot row、浏览器控制台没有 MissingClientBundleError。若是打包问题，运行 pnpm run verify:client-bundle。

工具数一直是 0，状态行卡在第一个工具上。 这是 0.1.7-rc.2 之前的 tool/result 关联断裂。升级到当前发布版；修复后的代码从 message.source.callId / message.toolCallId 读取 call id，从 message.isError 读取失败标记。

开启 publish 后会话无法 resume。 在 DSH 0.2.0-rc.2 / 0.2.1-rc.2 上，发布的快照是 ignorable 插件记录，不会阻塞 resume。旧走廊会尝试把所有可达的 dsh-session 副本都注册上 legacy 类型；若读取方解析到插件无法触达的副本，请关闭 publish。第一方界面不需要它。

不变量伴生插件没有运行。 bundle patch 只挂载 working-activity 行。请在 profile 用户层显式插入注册表与伴生行：

- insert:
    - id: invariants
      name: '@deepseek-ai/dsh-invariants'
    - id: working-activity-invariant
      name: 'dsh-working-activity/invariant'

若组合中已经挂载了 invariants 注册表，跳过该行。

文案语言不对。 在行上设置 lang: zh 或 lang: en，或控制共享链（DSH_TUI_LANG、~/.dsh-tui/lang.json、操作系统 locale）。解析出的语言也会随投影下发，客户端据此用同一语言重算耗时。

状态行文案不符合预期。 设置 debugLog: true；每个不同的渲染行都会以 JSON 追加到 ~/.dsh-tui/working-activity-debug.log，包含推导输入（相位、文案池、槽位）。可用 DSH_WORKING_ACTIVITY_DEBUG_LOG 重定向追踪文件。

隐私与安全

插件不采集数据、不发起网络请求、没有遥测。状态值全部由会话流在本地推导。开启 publish: true 时，快照只写入本地会话日志——0.2.x 上是 ignorable 插件记录，旧线是只记日志的 activity/status 事件——永不进入模型历史。customActions、文案池与语言偏好只保存在本地配置中。

许可证

BSD-3-Clause，见 LICENSE。

仓库根目录的 pi-working-activity 扩展是独立包，使用 MIT 许可证；见仓库 README。