多代理进度看板 caimc21069065-prog/dsh-savvy-progress

dsh-savvy-progress

DeepSeek Harness（dsh）插件：多智能体实时进度 + 成本可视化。对标 Claude Code 的 Savvy Progress，按 dsh 的 Cordis 插件体系与事件/投影架构重新实现。

在 dsh 的 Web / Desktop 界面上提供：

1. 顶部进度条（Progress Band）——输入框上方，显示编排任务标题/阶段/任务数、运行中的子代理数、总耗时与预估成本；点击打开代理面板。
2. 右侧 Agents 面板——右栏新标签页「代理进度」，实时列出每个子代理的状态、模型、运行时长、token 用量与成本估算，支持分组、过滤、展开详情、跳转子代理会话。

多智能体并行工作时不再只有一个 spinner。

- 版本：0.1.0
- 适用宿主：DeepSeek Harness ≥ 0.2.0-rc.2（针对 0.2.1-rc.3 API 开发验证）
- 许可证：MIT

功能

只读观察（默认，零侵入）

无需任何编排技能配合，插件从 dsh runtime 只读观察：

- 子代理生命周期：agent/created / agent/status / agent/disposed / subagent/start / subagent/end
- 发现与血缘：父会话的 subagent/catalog 事件、子会话的 subagent/descriptor（label、一次性/可持续模式、模型）
- 用量与路由：request/context（模型/上下文窗口）、assistant/message 的 usage（输入/输出/缓存 token）
- 每代理：轮数、工具调用数、累计 token、USD 成本估算（按模型单价表）、最近错误

面板在任何多代理任务（AgentTeams、自定义编排、手动 spawn）下都能工作。

可选主动上报工具（v0.2 功能，已内置）

| 工具 | 调用者 | 作用 |
| savvy_progress | 仅主会话（编排者） | 上报 flow：标题、阶段、任务列表、done/total、finished。子代理调用会被忽略（不报错） |
| savvy_step | 任意代理 | 上报自己的步骤进度：done/total/note |

上报写入各自会话的持久化 plugin record，重启/恢复后仍可回放。

界面

┌──────────────────────────────────────────────────────────────┐
│ ● 重构认证模块 · 阶段: delegate 3/7 任务 2 运行中 ≈ $0.42 2m 18s │ ← Band ├──────────────────────────────────────────────────────────────┤ │ Agents │ │ ● 运行中 (2) │ │ ├ worker-auth deepseek-chat · 1m 12s · 步骤 2/5 · ≈ $0.18 │ │ └ worker-test deepseek-reasoner · 48s · ≈ $0.06 │ │ ○ 已完成 (1) ▾ │ │ └ research … │ │ 合计成本 ≈ $0.42 · 总耗时 2m 18s │ ← Panel（右栏） └──────────────────────────────────────────────────────────────┘

- 面板按 运行中 / 失败 / 已完成 分组，已完成可折叠，支持「仅显示运行中」过滤
- 行点击展开详情：轮数、工具调用、token 明细（含缓存读写）、step note、错误、会话 id
- 可持续（continuable）且已完成的子代理可一键「打开会话」在主视图查看
- 中英双语（跟随 dsh 语言设置）

架构

Host (Node, Cordis 插件) Client (Web, dsh-client)
┌────────────────────────────┐ ┌──────────────────────────┐
│ observer.ts ← agent/* 等 │ │ Band.tsx │ │ store.ts 内存态+节流 │ session log │ conversation.input.dock │ │ ↓ appendPluginRecord │ ───────────▶ │ Panel.tsx │ │ projection.ts savvy-agents │ (plugin: │ sidebar.right.pane.tab │ │ /savvy-flow/savvy-step │ record) │ useProjection(...) │ │ tools.ts savvy_progress │ │ │ │ savvy_step │ │ │ └────────────────────────────┘ └──────────────────────────┘

- 快照（plugin:savvy-progress/agents）以节流间隔（默认 1s，内容变化时才写）追加到根会话日志，作为 ignorable plugin record 持久化——旧版本宿主读取会安全跳过，不会破坏会话。
- 三个投影单元（savvy-agents / savvy-flow / savvy-step）把 record 折叠成 wire 值，Web 端 useProjection 直接读取，客户端零领域代码，重启后自动回放。
- 事件数据模型见 src/types.ts（SavvyAgentRow / SavvyAgentsView / SavvyFlowView / SavvyStepView）。

安装

方式一：加入 profile patch（推荐）

在 dsh profile（如 ~/.dsh/profiles/web/cordis.patch.yml 或 desktop 对应文件）追加：

- insert:
- id: savvy-progress
name: dsh-savvy-progress
config:
tools: true
showCost: true
snapshotIntervalMs: 1000
maxFinishedAgents: 50
costRates: {}

并在 profile 目录安装本包：

cd ~/.dsh/profiles/web
pnpm add /path/to/dsh-savvy-progress

重启 dsh（或热加载）后生效。

方式二：通过插件管理器

dsh plugin add /path/to/dsh-savvy-progress

配置项

| 键 | 类型 | 默认 | 说明 |
| tools | boolean | true | 注册 savvy_progress / savvy_step 工具 |
| showCost | boolean | true | 显示并估算成本 |
| snapshotIntervalMs | number | 1000 | 快照发射节流（200–10000ms） |
| maxFinishedAgents | number | 50 | 每个根会话保留的已完成行数 |
| costRates | object | 内置表 | 按模型 id 前缀覆盖单价（USD/1M tokens），如 {"deepseek-chat": {"input": 0.28, "output": 1.1}} |

内置单价表覆盖 deepseek-chat / deepseek-reasoner / deepseek-v3 / deepseek-r1；未匹配模型使用保守默认值。成本为粗略估算（未建模缓存折扣），界面均标注 ≈。

开发

npm install
npm run check # 类型检查
npm run build # 构建 lib/（host ESM + client ModuleLoader bundle + d.ts）
npm run smoke # host 侧集成冒烟测试（真 cordis + 真 Session）

源码结构：

src/
├── index.ts # host 入口：apply + Config ├── types.ts # 共享 wire 类型 + 事件/投影/record 声明合并 ├── observer.ts # 只读观察 agent/subagent/session 事件 ├── store.ts # 内存状态 + 节流快照发布 ├── projection.ts # session-projection 三个单元 ├── cost.ts # 成本估算 ├── tools.ts # savvy_progress / savvy_step └── client/ # Web 半边（打包为 window.__ModuleLoader__ 注册 bundle） ├── index.tsx # 注册 locale / Band / Panel ├── Band.tsx # conversation.input.dock 槽位 ├── Panel.tsx # sidebar.right.pane.tab 槽位（savvy-agents 标签页） ├── locales.ts # zh / en 词典 ├── format.ts # 纯格式化 └── types.ts # type-only 槽位契约引用

已知限制

- 成本为估算值：按 token 数 × 单价表线性累加，不含缓存命中折扣与阶梯计费。
- 上下文占用百分比暂未展示（runtime 尚无对应事件），字段已预留。
- dsh 快速迭代中，本插件针对 0.2.1-rc.3 的事件面验证；宿主升级后如事件名变化需同步适配。

致谢

- 设计对标：JohnnyVizz/claude-kit · savvy-progress
- 需求文档：dsh-savvy-progress.md

License

MIT