前言¶
DeepSeek Harness（DSH）支持多个 agent 并行执行。编队一旦跑起来，往往会同时面对多路会话、共享待办、子代理的实时工具调用，以及写域重叠带来的冲突风险。单靠原生会话列表和弹窗，很难在一屏里回答「谁在干什么、任务卡在哪、要不要拦一刀」。
Cockpit（dsh-cockpit）把编队状态、任务板、实时流和写操作收进一块实时面板，并可在同一界面完成审批、发话、中断。从 v0.2 起可内嵌在 DSH 工作台侧栏，也保留独立 URL，便于第二块屏或手机访问。插件由社区维护者 zoe1nan 发布，在 SkillHub 目录中归类为「工作流」；源码托管于 GitHub，采用 MIT 许可证，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话定位：面向 DSH agent 编队的实时指挥台（Live command deck）——看清编队在做什么，并在同一处做决定。
它解决的是「多 agent 并行时的可观测性与可控性」：成员 roster、任务依赖、工具调用流、本轮 token 与进度，以及审批闸口、消息队列/插话、中断轮次等写操作，都集中在 /cockpit/ 界面（或工作台内嵌主区）完成。数据默认本地优先：插件监听本机 DSH 端口，不向外部服务器上报；除你点击触发的操作外，不自动改任务、不自动同意审批。
核心功能¶
下面按 README 中 v1.2 特性归纳，只列资料已写明的能力。
看：编队、任务板与实时流¶
- 实时编队：每个成员展示模型、真实 token 数、当前动作、负责范围（从任务主题/改动文件归纳）；按运行中 / 空闲 / 异常分组，运行中排在前面。
- 任务板：共享任务、状态列、依赖（
blockedBy）；两人写域重叠会标为「双写风险」。 - 计划兜底：没有共享任务板时，用本轮 todo 计划铺满任务板，避免空白。
- 实时流：工具调用用人话展示（如「运行命令」「编辑文件」「搜索内容」）；参数默认一行省略，可展开；v1.2 起连续同类调用折叠为「×N」。
- 本轮数据：进度、token、耗时、步骤、模型、状态，液面进度条随事件更新。
- 会话切换：左栏或顶部 pill 切换会话；顶栏「复制链接」可分享当前会话视图（v1.1）。
- 自检与诊断：设置页一键检查插件、状态数据、实时流、胶囊、HUD 数据桥、远程、待审批、宿主接口等，可复制完整报告（v1.1）。
操作：审批、发话、中断¶
- 审批闸口：审批请求出现在指挥台，可允许一次或拒绝；25 秒未处理则交回 DSH 原生弹窗。可用环境变量
DSH_COCKPIT_APPROVALS=0关闭接管。 - 发消息：对指定 agent 排队送达，或「插入」打断当前轮立刻插话。
- 中断：行内确认后停止正在跑的轮。
- 写操作安全：同源校验、失败回滚、本地审计日志
~/.dsh/cockpit/audit.jsonl。
桌面胶囊（仅 Windows）¶
Windows 10 2004+ 安装插件后可得桌面悬浮胶囊：液体进度条、步骤读数、「N 跑 · M 批」徽标；点击可打开指挥台（有待审批时直达审批区）。胶囊跟随任意正在运行的会话（多会话时跟随最近输入的那个，空闲回到「待命」）。进程由插件托管（自动启停与崩溃重启），设置页可开关。macOS / Linux 仅指挥台，胶囊自动隐藏。
手机与远程¶
默认关闭。开启后支持局域网 6 位一次性配对码（2 分钟有效、单次使用、错误限速）；需要 HTTPS 时提供隧道向导（检测 cloudflared / Tailscale，只给出命令）。公网 HTTPS、Secure Cookie、配对设备可撤销；审批到达且页面在后台时可发系统通知；支持 PWA 安装与离线外壳。远程相关环境变量包括 DSH_COCKPIT_REMOTE_PORT（默认 6688）、DSH_COCKPIT_REMOTE_SECURE=1 等。
界面与扩展¶
内嵌工作台、独立页、手机单栏三套布局；列宽可拖、双击复位；深色模式跟随工作台；1250 / 1000 / 390 三档适配。其他 DSH 插件可通过 ctx.cockpit.registerCard 注册只读 JSON 扩展卡（list / metrics / status / text），动作走同源 POST /cockpit/api/cards/<id>/action；契约见仓库 docs/STATE.md。
安装与启用¶
前置条件：已安装带插件系统与客户端模块的 DeepSeek Harness、Node.js ≥ 22。桌面胶囊仅 Windows 10 2004+。
- 从 Releases 下载
dsh-cockpit-<version>.tgz（README 示例版本为 1.2.2）。 - 安装到指定 profile 并重启 DSH：
dsh plugin --profile <profile> add /path/to/dsh-cockpit-1.2.2.tgz
- 重启后侧栏出现「Cockpit 指挥台」，点开即在主区使用；Windows 上桌面胶囊随宿主自动启动。
独立访问地址：http://127.0.0.1:<DSH 端口>/cockpit/。
升级：对新版本 tgz 重复 add 后重启；设置与别名在 ~/.dsh/cockpit/，升级不丢。卸载：
dsh plugin --profile <profile> remove dsh-cockpit
再重启 DSH。
典型用法¶
日常盯编队¶
侧栏进入 Cockpit，左栏选会话或顶部 pill 切换。中间看任务板与写域冲突提示，右侧实时流展开工具参数。需要拦审批时在面板内点允许/拒绝，避免只靠系统弹窗。
对某个 agent 插话或中断¶
在指挥台对目标 agent 发排队消息，或选「插入」打断当前轮；确认后可用行内中断停止正在执行的轮。
第二屏或手机¶
本机第二显示器打开 http://127.0.0.1:<DSH 端口>/cockpit/；手机在设置里开启远程、用配对码接入（公网场景按向导配置 HTTPS）。顶栏复制链接可把当前会话视图发给同事，对方打开落在同一 session（v1.1）。
插件作者注册扩展卡¶
在自有插件中注入 cockpit 并 registerCard，示例结构见 README（如 git-status 卡片）；可参考仓库 examples/git-card。
本地开发预览（不依赖已安装的 DSH）：
npm run preview
默认 http://127.0.0.1:6077/cockpit/（mock 数据）。
适用场景与注意¶
适合谁：经常用 DSH 跑多 agent 编队、需要任务板与写域风险提示、希望在同一界面批审批和发话的用户；Windows 用户若需要桌面胶囊可一并受益。
权限与安全：插件以当前 DSH 进程权限运行，安装前请阅读源码与 MIT 许可证，确认远程、审批接管等行为符合你的环境策略。远程默认关、审批 25 秒超时回退原生弹窗；PWA 与系统通知需要安全上下文（HTTPS 或 localhost）。已知限制包括：后台 Web Push 未实现；同一会话内 teammate 无法删除，界面用折叠分组处理。
生态说明：DSH 社区插件目录（如 SkillHub 上的 dsh-cockpit 页）为独立站点，与官方无从属关系；星标等数据以你访问 GitHub 时页面显示为准（目录线索为 24 stars）。
结尾¶
dsh-cockpit 把「编队正在做什么」和「此刻要不要动手」放在同一块指挥台上：内嵌工作台或独立 /cockpit/、任务板与实时流、审批与写操作审计，外加 Windows 胶囊与可选远程。若你已在用 DSH 多 agent 工作流，可按 Releases 中的 tgz 用官方 dsh plugin add 路径安装试用。
- 目录页：https://www.skillhub.cn/plugins/zoe1nan/dsh-cockpit
- GitHub：https://github.com/zoe1nan/dsh-cockpit
