/
← Back to home@tangdancol-jpg

dsh-pipeline

DSH 多 AI 协作流水线插件：主对话只调度不干活，编写/测试/审核三权分立；含自建控制面板（任务/席位/归档/批量/悬浮会话预览）

Stars
1
Language
JavaScript
Created
Oct 14, 2026
Updated
Oct 18, 2026
WorkspaceWeb UI
GitHub repo

Introduction

dsh-pipeline — 多 AI 流水线插件 + 自建控制面板

中文 | English (US) | 日本語 | Русский

dsh-pipeline 是 DSH 的多 AI 协作流水线插件：主对话只调度不干活，编写 / 测试 / 审核三权分立， 越权、跳步、无 OK 关单在工具执行前由代码拦下。插件自带一个自建控制面板 —— 客户端入口 lib/client.js（375 行）在面板第一次被渲染时按需取回 18 个 lib/client.panel-*.js chunk （入口 + chunk 共 19 个文件、4743 行），在会话头部显示流水线状态、席位与会话预览；弹层经 ReactDOM.createPortal 挂到 document.body 并用 position:fixed 定位。本仓库 = 插件源码 + 开发者文档 + 交付报告与架构图（都在 docs/）+ 一个独立的本地只读页面（dashboard/）。

目录结构

.
├── README.md / README.en-US.md / README.ja.md / README.ru.md   ← 四语言同步的仓库说明
├── .gitattributes / .gitignore
├── LICENSE                    ← MIT
├── MANIFEST.sha256            ← 逐文件 sha256（不含自身），口径见 docs/manifest.md
├── plugin/
│   └── active/                ← 插件源码（唯一一份），安装时复制进 profile
│       ├── index.js           ← 宿主侧入口：apply / 工具 / 守门 / HTTP 路由 / 客户端注册
│       ├── lib/               ← 实现：按域拆子目录（含 panel/ 与 18 个客户端 chunk）
│       ├── presets/           ← 16 个角色预设（src/ 是源，generated/ 是产物）
│       ├── tests/             ← 自测：132 套，一文件一套
│       ├── tools/             ← 仓库工具；install-items.json 是复制范围的唯一出处
│       ├── design/            ← 开放设计记录（agent-teams / memory / panel）
│       ├── locale/ skills/
│       ├── install.ps1 / rollback.ps1
│       ├── package.json / cordis.patch.yml
│       └── README.md / ARCHITECTURE.md / WIRING.md / CONVENTIONS.md
├── docs/                      ← 开发者文档 + 交付报告与架构图
│   ├── README.md / install.md / …（一份文件讲一件事）
│   ├── release-checklist.md   ← 推送前检查清单
│   └── 产出交付文档-v3-20261014/   ← 本轮报告 + 架构图 v3（v2 保留作历史）
└── dashboard/                 ← 独立的本地只读页面（见 dashboard/README.md）

一、部署：clone → 安装

git clone https://github.com/tangdancol-jpg/dsh-pipeline.git dsh-pipeline
cd dsh-pipeline
powershell -NoProfile -ExecutionPolicy Bypass -File .\plugin\active\install.ps1 -DryRun   # 先预演
powershell -NoProfile -ExecutionPolicy Bypass -File .\plugin\active\install.ps1            # 正式安装

安装只做复制与登记：把运行期文件复制进 <DSH 用户目录>\profiles\<profile>\node_modules\dsh-pipeline\，再往该 profile 的 package.json / cordis.patch.yml 追加插件登记（改之前先备份），并把自带的 stop-ladder Skill 落到 <DSH 用户目录>\skills\stop-ladder\。

阶段拿到什么
clone 之后整个仓库：plugin/active/（源码 + tests/ + presets/ + design/）、docs/、dashboard/、MANIFEST.sha256。
install 装进 profile 的只有运行期文件：index.js、lib/、locale/、skills/、presets/、icon.svg、package.json、cordis.patch.yml、README.md、ARCHITECTURE.md、两个 .ps1，以及 tests/（pipeline_selftest 要读它）。
默认不装的仓库根的 docs/ 与 dashboard/（安装脚本只从 plugin/active/ 复制），以及插件目录里的 design/、examples/、REPORT.md、tools/。这些随 clone 一起下载，只是不进 profile。
-WithDocs 才带的examples/、REPORT.md、tools/（仍在 plugin/active/ 内）。

复制范围的唯一出处是 plugin/active/tools/install-items.json：install.ps1 与 tools/sync*.mjs 都读这一份，改它等于同时改三处。

常用参数说明
-DryRun只打印将要做什么，不改任何文件。
-Profile <名字>装进哪个 profile，默认 desktop。
-WithDocs额外装上 examples/、REPORT.md、tools/。
-NoSpawnRoles只发令牌、不创建角色会话（零 token 的试跑模式）。

完整参数（-ProjectRoot / -Transport / -GuardMainReadsCode / -MaxReworkPerLeg / -L0OrchestratorSeparate …）、脚本改了哪些文件、怎么回滚（rollback.ps1）见 docs/install.md。装完要重启 DSH（或重载插件），运行中的进程才会用上新代码。

二、插件源码：plugin/active/

模块布局

入口是 index.js，实现都在 lib/。五个上千行的原文件已按主题拆到子目录，原文件保留为门面 （对外导出名不变，调用方不用改 import）：

门面子目录内容
lib/store.jslib/store/任务存储：读写落盘、主管枢纽判据、状态迁移前置条件、交接物提交、人工介入…
lib/tools.jslib/tools/pipeline_* 工具定义，按工具分组
lib/guard.jslib/guard/守门：角色读写分类、席位与授权面、shell 判据、脚本展开、主判定
lib/handoff.jslib/handoff/交接物：字段表、校验、内容扫描、记录
lib/wakeup.jslib/wakeup/唤醒：唤醒键、账本身份、投递、唤醒器

按功能拆开的其它域：

目录内容
lib/panel/自建面板：snapshot.js（只读快照）/ seats.js（席位三层合并）/ task-fields.js（字段与键序契约）/ actions.js（8 个写动作）/ archive.js（_trash 归档视图）/ pins.js（_panel-pins.json 置顶）
lib/model/领域对象：task / baseline / artifact / close-report / human-request / handoff-*（结构、默认值、字段清单）
lib/errors/错误码（codes.js）与拒绝 / 提示文案（text.js）的唯一出处
lib/transport/通道接口与实现：session / team / subagent / manual / simulated；createTransport() 是唯一选择点
lib/team/官方 Agent Teams 适配：命名、通道探测、人格注入、四槽补钉、投递、任务板镜像
lib/states/ lib/tiers/ lib/guard/ 等状态机、档位规则、闸门…都按「一个文件一个改动原因」拆（见 CONVENTIONS.md §4）

docs/ 里报告写的 lib/store.js:2471 这类行号指的是拆分前的单文件；现在的位置请按函数名 到当前源码树的 lib/ 下查。

客户端：入口 375 行 + 18 个 chunk

浏览器半边不是一个大文件：入口 lib/client.js 375 行，面板实现拆成 18 个 chunk —— 入口 + chunk 共 19 个文件、合计 4743 行——文件大小是信号不是死限：超过 400 行先按 CONVENTIONS §4 的四问自检（职责是否单一 / 能否一句话命名 / 评审能否看出边界 / 并行改是否撞车）， 拆不拆由人和评审判断；体检报告见 tests/file-size-check.mjs。

文件行数职责
lib/client.js375入口：模块注册、「多AI 协调」开关（order 100）、面板 lazy wrapper（order 110，第一次渲染才去取 chunk）
lib/client.panel-view.js388纯渲染：任务卡 / 归档卡 / 列表 / [pipeline] 标签，不取数、不持状态
lib/client.panel-menu.js335⋯ 菜单：触发器、菜单项、两击确认文案、卡片内下拉、置顶按钮
lib/client.panel-shell.js320组件骨架：共享作用域 S、按依赖序调 chunk 的 create / setup、把骨架串起来
lib/client.panel-actions.js297动作契约：三条路由、动作表与文案、两击确认判据、取数 / 提交写操作
lib/client.panel-preview.js296预览底料：尺寸 / 时机 / 过滤常量、uiWorkspace 与 sessions 服务、事件窗口 → 预览行
lib/client.panel-atoms.js294内容原子：状态 / 档位色板、等级徽标、团队人数、状态徽标、id、摘要、可选卡身
lib/client.panel-preview-control.js281预览状态机：悬停计时、30 秒缓存、在途序号防串台、点气泡开真实会话、卸载 / 切换时收层
lib/client.panel-portal.js249弹层容器与出口：createPortal → document.body、fixed 落点计算、滚动 / 改尺寸重算
lib/client.panel-batch.js240批量状态机：进 / 出批量、整卡选中、两击删除、串行执行与进度、归档视图切换
lib/client.panel-interact.js223交互 glue：开关 / 钉住与悬停慢关、卡片菜单、动作 UI、批量与预览状态槽、打开席位会话
lib/client.panel-batch-bar.js206底部批量栏：sticky 通栏、按视图给按钮、进度与两击确认
lib/client.panel-preview-bubble.js201预览浮层：定高圆角窗、标题行、最多 12 条气泡（用户靠右 / AI 靠左、空正文「正在思考…」）
lib/client.panel-seats.js198席位格：角色中文名、席位号、状态圆点、chip 渲染与可点 / tooltip 判据
lib/client.panel-outside.js196点外面 / ESC 判据：ref.contains + target.closest 复核、document 捕获监听、挂摘 effect
lib/client.panel-preview-data.js180预览取数与几何：retain 会话引用读事件窗口、贴着面板左边缘算浮层落点
lib/client.panel-poll.js168轮询 / 取数：5 秒轮询任务快照与归档列表、页面隐藏时跳过、失败保留上次数据
lib/client.panel-card-actions.js167卡片动作执行：⋯ 菜单开合、删单 / 永久删除两击确认、置顶、动作后刷新哪份数据
lib/client.panel-controls.js129可点小控件：头部按钮、批量圆勾、置顶标记，全部自带 no-drag 与宿主事件截断

装载方式（三段；chunk 协议由宿主 @deepseek-ai/dsh-client-modules 原生提供）：

  1. 入口：宿主按 /plugins/dsh-pipeline/client.js?rev=<入口 rev> 当经典脚本加载（无 import / export / 顶层 await），入口自己调 window.__ModuleLoader__.load({ id, factory }) 注册。
  2. 按需取 chunk：面板第一次被渲染时，入口用 Promise.all 逐个 require.async('./client.<name>.js') 并行取回 18 个 chunk，交给 shell 按依赖序 create(deps) 组装 —— 没打开过面板就不下载。
  3. 宿主怎么发：chunk 走 /plugins/dsh-pipeline/<chunk>?rev=<入口 rev>，宿主按需异步读文件并 immutable 缓存（rev 变了才重取）；chunk 必须与入口同目录、也是经典脚本，用 window.__ModuleLoader__.load({ id, chunk, factory }) 注册。chunk 之间不能同步 require， 组合只在入口做。

因为协议是「入口 + 同级文件」，手工 JS 直接放进去就行：不需要 tsdown，也不需要改 package.json。新增客户端逻辑一律新开 chunk（入口 375 行，别再往里塞），理由与边界见 plugin/active/CONVENTIONS.md §4。

弹层为什么挂 body：宿主会话头部那一排是窗口拖拽区，又有自己的层叠顺序与命中区 —— 弹层只要还长在它的 DOM 里，点击就可能被吞掉。所以 ⋯ 菜单与预览浮层用 ReactDOM.createPortal(children, document.body) 渲染，配 position:fixed：落点按触发按钮的 getBoundingClientRect() 算（右缘对齐 right = 视口宽 − rect.right、top = rect.bottom + 6、 宽 min(440, 92vw)、高 min(560, 70vh)、四周至少留 8px），滚动 / 改尺寸后 100ms 节流重算； 点外面收起用 target.closest('[data-pipeline-panel]') 等 DOM 属性复核，判不出来就不关 （宁可漏关一次，也不误关正在用的面板）。取不到 react-dom 时回退成原样渲染，不把面板弄挂。

测试

cd plugin/active
node tests\run-all.mjs            # 全套；结果写到 tests\last-run.txt
node tests\<套件>.mjs             # 单跑一套
  • 全套当前 4267/4267 通过（132 套）。面板相关五套：client-check.mjs（入口与 18 个 chunk 的装载契约、渲染与点击，30 项）、panel-ui-check.mjs（头部「批量 / 归档」点击回归， 14 项）、panel-portal-check.mjs（弹层 portal 与 fixed 落点，3 项）、panel-snapshot-check.mjs （快照契约，74 项）、panel-actions-check.mjs（写动作 / 归档 / 置顶，99 项）。
  • 有少数套件依赖宿主安装：DSH_APP_ASAR 指向 <DSH 安装>\resources\app.asar， 预置与宿主 schema 类判据要从里面读宿主包。拿不到判据时如实标注「跳过、不计入通过率」； 本机口径：设了 DSH_APP_ASAR 后 4267/4267，不设时 3 条预置校验会红（环境面，不是代码面）。
  • tests/seat-liveness-wake-check.mjs 没有注册进全套，内容已落后于现在的失联判据，单跑会失败。

推送前的完整检查清单见 docs/release-checklist.md。

三、控制面板

插件内面板（会话头部右侧）

挂在 conversation.session.header.utilities（list 槽），与「多AI 协调」开关并排：

  • 等级徽标：每张任务卡最左是 L0–L5 档位徽标 + 团队人数（N 个 AI），一眼看清这单多重。
  • ⋯ 菜单：按状态列出「终止 / 恢复 / 归档 / 删单」；删单要连点两次确认。
  • 置顶：📌 置顶 / 取消置顶，置顶的单排最前，其余按 updated_at 倒序。
  • 批量：头部「批量」→ 圆勾多选 → 底部批量栏「归档所选 / 删除所选」，串行执行并显示进度。
  • 归档视图：头部「归档 N」列已归档单，行内可「恢复」或「永久删除」（后者两击确认）， 「← 返回任务」切回。
  • 悬停即开、点一下钉住：席位 chip 悬停 140ms 展开、移开 800ms 后收起；点一下面板按钮钉住， 点外面或 ESC 收起。
  • 大窗会话预览：鼠标停在席位 chip 上，面板左侧浮出约 520×520 的预览窗（最多 12 条，可滚动）。 只显示真实用户 / AI 对话（过滤注入的系统上下文与工具行）；AI 还没吐正文时显示 「正在思考…」；点任意气泡打开该会话（openSession）。

弹层（⋯ 菜单与预览浮层）经 ReactDOM.createPortal 挂到 document.body + position:fixed， 不落在宿主会话头部的 DOM 里 —— 那是拖拽 / 层叠区，挂进去点击会被吞掉。

数据与写动作是两条道：

用途路由口径
读GET /.dsh-pipeline/panel只读快照，5 秒轮询、页面隐藏时跳过；只读 task.json 的结构化字段（id / 状态 / 需求摘要 / 席位 / 待办数 / 任务板编号 / 档位 / 置顶 / allowed_actions），不含交接物正文、补丁、代码
读（归档）GET /.dsh-pipeline/panel?view=archived只读 <项目根>/.pipeline/_trash/ 下的已归档单
写POST /.dsh-pipeline/panel/action8 个动作：cancel / restore / archive / delete / pin / unpin / unarchive / delete_archived；开关关着时一律拒；delete / delete_archived 要 confirm: true；只收同源 JSON

落盘位置（都在工作区 .pipeline/ 下，跟着 profile 走）：置顶 _panel-pins.json、归档 _trash/<任务id>-<时刻>/、永久删除的墓碑 _purge-log.jsonl。设计取舍与字段契约见 plugin/active/design/panel/01-面板设计.md。

独立的只读页面 dashboard/

给控制角色（主对话 / 需求分析 / 主管 / 归档）看的本地单页，每次请求现读 docs/ 下的 需求清单、bug 单与变动日志。只监听 127.0.0.1，带钥匙才能看；dashboard\start.cmd / dashboard\stop.cmd 启停，细节见 dashboard/README.md。

四、DSH 插件声明

plugin/active/package.json 声明了插件是什么、装进宿主哪一层：

字段值含义
namedsh-pipeline插件包名，也是客户端模块 id 与 /plugins/<id>/ 前缀
version0.1.0包版本
dsh.manifestVersion1插件清单协议版本
engines.dsh>=0.2.1-rc.2兼容的 DSH 版本范围
dsh.bundle.patchcordis.patch.yml、presets/generated/pipeline-presets.patch.yml装载时应用的 Cordis patch 与角色预设
dsh.clientplatform: web、inject: ["@deepseek-ai/dsh-client-ui-workspace"]客户端半边的宿主声明；入口固定为包根 lib/client.js（宿主按包名定位），入口再按需取同目录 18 个 client.panel-*.js chunk
  • 提供的工具与守门：pipeline_* 工具面（开单、需求分析、计划、派活、交接、审核、关单、 查询、自检、开关…）与对应的单调守卫 —— 越权、跳步、无 OK 关单在工具执行前被拒；「多AI 协调」 开关关掉后守门弃权、写操作被拒。
  • 安装方式：plugin/active/install.ps1 把运行期文件复制进 <DSH 用户目录>\profiles\<profile>\node_modules\dsh-pipeline\，并把插件登记追加到该 profile 的 package.json / cordis.patch.yml（详见第一节）。
  • 兼容性：需要支持包内 chunk 协议的 DSH —— 该协议由 @deepseek-ai/dsh-client-modules 提供，0.2.1-rc.2 起可用；react-dom 在该版本的平台 seed 表里，入口从宿主 seed 取，不额外打包。 更老的 DSH 上，面板会显示一行可读的「多AI协调团队加载失败：<原因>」，开关与流水线功能不受影响 （不是白屏）。

五、文档：docs/

面向开发者、一份文件讲一件事的文档在 docs/：

交付期产物在 产出交付文档-v3-20261014/：本轮报告 2026-10-18-面板与客户端分块.md、 架构图 架构图-main-path-v3.html；上一轮的 架构图-main-path-v2.html 保留作历史，不再改动。

文档里一律不写本机路径：用 %USERPROFILE%\.dsh\…、$HOME、<path\to\thing> 或相对路径； 面板地址写作 127.0.0.1:<端口>；会话 id 等原值不保留，写作 session-…。

六、校验

MANIFEST.sha256 是除自身以外每个被跟踪文件的 sha256。在仓库根目录运行：

sha256sum -c MANIFEST.sha256

改动文件后要重新生成它（口径与 Windows 上的替代命令见 docs/manifest.md）。

七、开源协议与出处

  • 协议：MIT，全文见根目录 LICENSE。
  • 仓库：https://github.com/tangdancol-jpg/dsh-pipeline。
  • 参与：用 GitHub issue 报缺陷 / 提需求；PR 请保持「一份文件讲一件事」与 CONVENTIONS.md §4 的拆分口径，并在描述里附上 node tests\run-all.mjs 的结果。
  • 第三方依赖：无运行期 npm 依赖；@deepseek-ai/dsh-tools 是可选 peer（拿不到时 defineTool 退化为恒等函数，插件仍可装载）。plugin/active/skills/stop-ladder/SKILL.md 随插件分发，出处见文件自身。

八、文档索引