多 Agent 管线内核 not-big-dog/DSH-pipeline-kernel

pipeline-kernel

DeepSeek Harness (DSH) 插件（Cordis）｜ 多智能体管线管理内核：任务板 / 台账 / 部署 / 注册表 / 巡检 / 打包复用 / 控制面板 A DSH (DeepSeek Harness) Cordis plugin — the management kernel for multi-agent pipelines: task board / ledger / deployment / registry / watchdog / packaging & reuse / control panel.

pipeline-kernel 是管线无关的管理内核：管线 = 配置数据（pipelines 表一行，用 pipeline_define 定义），内核不绑定任何具体业务。默认无预置管线，由使用者自行定义与部署。

The kernel is pipeline-agnostic: a pipeline is just a config row (defined via pipeline_define); no business is baked in. There is no preset pipeline — define and deploy your own.

English · 中文

定位

- 内核 = 管线无关的管理能力（通讯 / 台账 / UI 三大职责，见 docs/）；管线 = 数据（配置行）
- 业务能力（生图、视频等）是管线内部设置，不进内核
- 多语言：UI 与文档自动跟随 DSH 语言设置（中文 / English）

安装

// C:\Users\<you>\.dsh\profiles\web\package.json → dependencies
"dsh-pipeline-kernel": "link:<本包路径>" // bundles 列表加入 "dsh-pipeline-kernel"

或 dsh plugin --profile web add <本包路径>。重启 dsh web 后，新会话带 pipeline_ 工具（存量会话工具目录固定，需重建会话）。

依赖要求（v0.9+）：宿主 deepseek-harness 0.1.0-rc.8 及以上（本插件自身锁定 ^0.1.0-rc.8，cordis 4.x）。开发/CI 用 pnpm install --frozen-lockfile。

快速开始

1. 定义管线：pipeline_define {id:"my-pipe", roles:{supervisor:{preset:"pipeline-supervisor"}, ...}, chain:["supervisor",...], gates:{...}}
2. 起链：pipeline_deploy {pipelineId:"my-pipe"}
3. 播种角色会话：pipeline_seed {pipelineId:"my-pipe"}（按定义给未注册角色创建会话，自动写注册表）
4. 投任务：pipeline_push {title, description, tags:["target:<角色>","task:<编号>","attempt:1"]}
5. 流转：pipeline_list → pipeline_claim → pipeline_done {result:"done route:<角色|UID> 产物:..."}（内核自动路由下一环）
6. 看全景：pipeline_status

控制面板（Web UI）

右下角 pipeline 胶囊按钮 → 展开右侧全高侧栏：

- 活动：各管线运行摘要（角色状态 / 进行中任务 / 最近完成 / 失败置顶）
- 管线：管线一等实体（Graph 缩略图 / KPI / 打包产物）；点击任务展开 Task Inspector
- 新建：定义新管线（工作文件夹必选，走系统目录选择器）
- 归档：冷存储——归档不删除数据，可恢复；永久删除仅在归档箱内、需输入管线 id 确认

巡检（watchdog）

v0.8 起 默认开启（无需配置）：每 5 分钟扫描 open 任务补唤醒（同任务 10 分钟冷却）、done 但路由未完成（僵尸）自愈补投、全链静止 30 分钟汇报主管。无管线/无任务时零噪音。如需调整或关闭，在 cordis.patch.yml 覆写：

c:\users\<you>\.dsh\profiles\web\cordis.patch.yml
pipeline-kernel:
watchdogEnabled: false # 关闭巡检（默认 true） watchdogIntervalMs: 300000 # 巡检周期（默认 5 分钟） watchdogStallMs: 1800000 # 全链静止判定（默认 30 分钟） watchdogWakeCooldownMs: 600000 # 同任务补唤醒冷却（默认 10 分钟） watchdogReportCooldownMs: 1800000

文档索引

| 文档 | 内容 |
| docs/管线定义规范.md | 管线定义字段与拓扑规范（roles/chain/gates/entry…） |
| docs/内核接口文档.md | 内核工具与端点清单（pipeline_ / HTTP 路由） |
| docs/内核设计文档.md | 架构与职责划分 |
| docs/UI-方案-K7-边栏设计.md | 控制面板 UI 方案 |

License

MIT

Positioning

- Kernel = pipeline-agnostic management (communication / ledger / UI — see docs/); pipeline = data (a config row)
- Business capabilities (image generation, video, …) belong inside the pipeline, not the kernel
- Bilingual: the UI and docs follow the DSH language setting (中文 / English)

Install

// C:\Users\<you>\.dsh\profiles\web\package.json → dependencies
"dsh-pipeline-kernel": "link:<path-to-this-package>"
// add "dsh-pipeline-kernel" to the bundles list

或者执行 dsh plugin --profile web add <path-to-this-package>。重启 dsh web 后，新会话会拿到 pipeline_ 工具（已存在的会话保持固定的工具目录不变——请重建它们）。

依赖要求（v0.9+）：宿主 deepseek-harness 0.1.0-rc.8 或更新版本（本插件自身锁定 ^0.1.0-rc.8；cordis 4.x）。开发/CI 使用 pnpm install --frozen-lockfile。

快速开始

1. 定义管线：pipeline_define {id:"my-pipe", roles:{supervisor:{preset:"pipeline-supervisor"}, ...}, chain:["supervisor",...], gates:{...}}
2. 部署：pipeline_deploy {pipelineId:"my-pipe"}
3. 播种角色会话：pipeline_seed {pipelineId:"my-pipe"}（为未注册的角色创建会话，写入注册表）
4. 推送任务：pipeline_push {title, description, tags:["target:<role>","task:<id>","attempt:1"]}
5. 流转：pipeline_list → pipeline_claim → pipeline_done {result:"done route:<role|UID> artifacts:..."}（自动路由到下一环）
6. 总览：pipeline_status

控制面板（Web UI）

右下角的 pipeline 胶囊按钮展开后是一个全高侧边栏：

- Activity：按管线汇总的运行情况（角色状态 / 进行中的任务 / 最近完成 / 失败置顶）
- Pipelines：管线作为一等实体（图缩略图 / KPI / 包）；点击任务打开 Task Inspector
- New：定义新管线（必须指定工作文件夹，通过系统目录选择器挑选）
- Archive：冷存储——归档从不删除数据，且可逆；永久删除只存在于归档中，需要输入管线 id 确认

看门狗

自 v0.8 起默认开启（无需配置）：每 5 分钟重新唤醒未关闭的任务（每个任务 10 分钟冷却），自愈僵尸任务（已完成但路由从未结束），并在 30 分钟后向 supervisor 上报停滞的链。没有管线/任务时零噪音。在 cordis.patch.yml 中调整或关闭：

c:\users\<you>\.dsh\profiles\web\cordis.patch.yml
pipeline-kernel:
watchdogEnabled: false # turn watchdog off (default true)
watchdogIntervalMs: 300000 # tick interval (default 5 min)
watchdogStallMs: 1800000 # chain-stall threshold (default 30 min)
watchdogWakeCooldownMs: 600000 # per-task wake cooldown (default 10 min)
watchdogReportCooldownMs: 1800000

文档

| 文档 | 内容 |
| docs/管线定义规范.md | 管线定义 schema 与拓扑（roles/chain/gates/entry…） |
| docs/内核接口文档.md | 内核工具与端点参考（pipeline_ / HTTP 路由） |
| docs/内核设计文档.md | 架构与职责 |
| docs/UI-方案-K7-边栏设计.md | 控制面板 UI 设计 |

许可证

MIT