前言¶
用 DSH Web 驱动 Agent 跑任务时，一个现实的问题是：回合进行中你很难看到它此刻在做什么——工具调用到了哪一步、子代理有没有在协作、令牌消耗了多少、折算成人民币大概是多少。这些信息通常要等回合结束再翻记录。dsh-plugin-mission-control 解决的就是这件事：把当前 DeepSeek Harness Session 的实时状态放进 Session 列表下方的一块紧凑面板，需要细看时再展开成全屏仪表盘。
这是什么¶
dsh-plugin-mission-control 由 Jian-Sparrow 维护，当前版本 0.3.1。一句话定位：为当前 DeepSeek Harness Session 提供实时可观测性——呈现 Agent 活动、工具调用、子代理协作、权威令牌计数与 CNY 成本估算。
DSH 的理念是「一切皆插件」，这个插件正是以一行 Cordis 配置挂进 Web profile 的。使用前有两点设计值得先说清楚：
1、它只显示 Harness 已记录的 Session 事实，不向模型上下文添加模型工具、提示或隐藏推理，仪表盘也不渲染模型思维链。
2、它是 live-only 的：只在面板可见时维持订阅，不提供事后回放。
核心功能¶
全局 HUD¶
HUD 常驻显示：连接状态、总令牌数、四个令牌桶（Input / Output / Cache read / Cache write）、近期令牌速率、估算 CNY 成本、Agent 数、运行中工具数与诊断信息。令牌字段来自 Harness 的权威令牌计数，近期令牌速率按 velocityWindowMs 配置的滚动窗口统计。
Agent 树与实时工具流¶
面板以当前 Session 为根渲染一棵可选中 Agent 树，子代理协作也会呈现在其中。选中某个 Agent 后，令牌合计与工具行会联动过滤。
工具流逐行展示归属、耗时、结果状态，行数有上界（maxLiveRows），并可选载荷预览。
两个入口与全屏仪表盘¶
有两个原生入口：当前 Session 头部，以及 DSH Web 侧边栏底部（Settings 旁的 ◎ Mission Control）。未选中 Session 时，侧边栏入口处于禁用状态。
内嵌标题栏的 Expand Mission Control 可展开为全屏仪表盘：左侧 Agent 拓扑，右侧工具实时流，上方是 Token/CNY HUD；Restore Mission Control 恢复内嵌视图。Expand 与 Restore 不会重连 SSE、不会重置 Agent 选择、也不会清空工具行。Escape 可关闭任一呈现。
Live-only 订阅¶
面板可见时，插件只维持一条同源 SSE 订阅，跟随全局当前 Session；重连期间冻结最后快照。订阅在以下情况释放：关闭面板、侧边栏收起、Session 切换、插件卸载、浏览器断开。
安装与启用¶
依赖要求：
- DeepSeek Harness
0.1.0-rc.7 - DSH Web profile
- Node.js
^22.19.0或>=24.0.0 - 经 Corepack 使用 pnpm
先安装插件，再验证组合后的配置行，最后启动 DSH Web：
dsh plugin --profile web add dsh-plugin-mission-control
dsh --profile web --dump-config
dsh --profile web
插件包会向 Cordis 配置插入一行 mission-control，其默认层等效于：
- id: mission-control
name: dsh-plugin-mission-control
config:
previewMode: names-only
tokenPublishIntervalMs: 250
velocityWindowMs: 5000
maxLiveRows: 300
如果想用本地 checkout 而不是 npm 安装，把路径传给同一条命令即可：
dsh plugin --profile web add ./dsh-plugin-mission-control
典型用法¶
1、启动 DSH Web，在其中启动或打开一个 Session。
2、从 Session 头部选择 Mission Control，或点击侧边栏 Settings 旁的 ◎ Mission Control；未选中 Session 时侧边栏入口是禁用的。
3、需要细看时，点内嵌标题栏的 Expand Mission Control 进入全屏仪表盘，看完点 Restore Mission Control 回到 Session 列表面板。
4、切换选中的 Session 时，面板保持打开，实时流跟随新的当前 Session，订阅会随之释放重建。
5、修改配置：在 profile 或用户目录的 cordis.patch.yml 中整体覆盖 mission-control 行。
配置¶
上面默认层里的几个字段含义如下：previewMode 控制工具载荷预览的档位，tokenPublishIntervalMs 是令牌更新的合并间隔，velocityWindowMs 是近期令牌速率的滚动窗口，maxLiveRows 是保留的工具行数上限。
所有配置字段在 Cordis 插件加载时校验，非法配置会显式报错（fails loudly），不会被静默忽略。
成本估算¶
成本估算完全离线进行：插件内置一份版本化价目目录，只对精确匹配目录的 deepseek-official 路由计价，按峰/谷时段取价，HUD 会报告计价步比例。未知提供商、模型别名、未知模型、缺失请求路由或时间戳的步骤保持未计价，而不是按免费处理。
内置价目表于 2026-08-18 对照 DeepSeek 官方中文定价页核对。
需要强调的是：金额是估算而非实际账单，不含税费、账户条款、促销、取整规则或服务商侧计费调整；插件在运行时不查询账户或计费 API。
隐私与网络¶
previewMode 控制工具载荷的可见程度，共三档：
names-only（默认）：只显示工具名称、归属、耗时与结果状态；redacted：展示有界的参数与结果摘要，对敏感字段与凭据样式文本做尽力脱敏；脱敏是尽力而为，不构成安全边界；full：展示完整载荷，仪表盘保留屏幕警告。
无论哪一档，仪表盘都不渲染模型思维链或隐藏推理，只显示 Harness 已记录的 Session 事实。
网络暴露由 DSH Web 负责：插件使用同源端点，继承 Web profile 的绑定地址、trusted-host 校验、认证与反向代理行为。不要仅仅为了查看这个面板，把 DSH Web 暴露给不可信网络。
适用场景与注意¶
适合在 DSH Web 里跑多 Agent 或长任务、需要实时掌握工具调用与令牌成本的开发者。
使用前有几点注意：
1、插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。仓库中带有 LICENSE 文件，但本次核对未能确认具体许可证类型，请以仓库内容为准。
2、0.3.x 适配 Harness rc.7 的侧边栏 DOM（根植于 sidebar.footer.action 槽位）。未来 Harness 侧边栏标记变更可能需要插件更新；届时插件会以具名集成错误显式失败，而不是静默挂载到错误位置。
3、成本数字只作估算参考，不要当作账单依据。
4、面板是 live-only 的，只反映订阅期间的状态；关闭面板后订阅即释放。
结尾¶
回顾一下：dsh-plugin-mission-control 把 DSH Web 的当前 Session 变成一块可盯的实时面板——Agent 树、工具流、令牌计数与 CNY 估算在同一屏，且不向模型上下文注入任何内容。如果你日常在 DSH Web 里跑任务，它值得装进 Web profile 试一试。
- 社区目录页：https://www.skillhub.cn/plugins/Jian-Sparrow/dsh-plugin-mission-control
- GitHub 仓库：https://github.com/Jian-Sparrow/dsh-plugin-mission-control
其中目录链接指向社区维护的插件目录，该目录为独立站点，与 DeepSeek、幻方无官方从属关系。
