前言¶
在 DeepSeek Harness（DSH）里跑多 Agent 协作，常见做法是各自开几个会话、靠人工或脚本在角色之间传任务。角色一多，任务状态、路由、会话注册就容易散在聊天记录里，很难看清整条链跑到哪一步、哪一环卡住。
下面介绍 not-big-dog/dsh-pipeline-kernel（社区目录：SkillHub 页面）。它把「任务板、台账、部署、注册表、巡检、打包复用、控制面板」收进一个 Cordis 插件，用配置定义管线，而不是把具体业务写死在内核里。
这是什么¶
pipeline-kernel 是管线无关的管理内核：一条管线对应 pipelines 表里的一行配置，通过 pipeline_define 定义；内核不绑定生图、视频等具体业务，默认也不预置任何管线，由使用者自行定义与部署。
维护者为 not-big-dog。插件在 GitHub 上约 36 stars，当前版本 0.9.0，MIT 许可证。UI 与文档跟随 DSH 语言设置，支持中文与 English。
内核承担三类职责（详见仓库 docs/）：通讯、台账、UI。业务能力放在管线内部的角色与预设里，不进内核。
核心功能¶
管线定义与部署¶
用 pipeline_define 描述角色（roles）、执行链（chain）、门控（gates）等；pipeline_deploy 启动链，pipeline_seed 为未注册角色创建会话并写入注册表。
任务流转与台账¶
pipeline_push 投递任务；角色通过 pipeline_list 查看、pipeline_claim 认领、pipeline_done 完成并声明路由。内核根据结果自动把任务送到下一环。pipeline_status 查看全景。
任务标签约定包括 target:<角色>、task:<编号>、attempt:1 等，便于路由与追踪。
Web 控制面板¶
重启 dsh web 后，界面右下角有 pipeline 胶囊按钮，展开为右侧全高侧栏：
- 活动：各管线运行摘要（角色状态、进行中任务、最近完成、失败置顶）
- 管线：管线一等实体（Graph 缩略图、KPI、打包产物）；点任务可打开 Task Inspector
- 新建：定义新管线（工作文件夹必选，走系统目录选择器）
- 归档：冷存储，归档不删数据可恢复；永久删除仅在归档箱内，需输入管线 id 确认
巡检（watchdog）¶
自 v0.8 起默认开启，无需额外配置。每 5 分钟扫描：对 open 任务补唤醒（同任务 10 分钟冷却）、对 done 但路由未完成的僵尸任务自愈补投、全链静止 30 分钟后向主管汇报。无管线或无任务时不产生噪音。
打包复用¶
侧栏「管线」视图支持查看打包产物，便于把已定义的管线配置复用到其他环境（细节见仓库 docs/）。
安装与启用¶
依赖要求（v0.9+）：宿主 deepseek-harness 0.1.0-rc.8 及以上；插件锁定 ^0.1.0-rc.8，Cordis 4.x。Node 引擎要求 ^22.19.0 || >=24.0.0。
方式一：编辑 profile 的 package.json，加入依赖并在 bundles 列表注册：
// C:\Users\<you>\.dsh\profiles\web\package.json → dependencies
"dsh-pipeline-kernel": "link:<本包路径>"
// bundles 列表加入 "dsh-pipeline-kernel"
方式二：使用 DSH CLI：
dsh plugin --profile web add <本包路径>
安装后重启 dsh web。新会话才会出现 pipeline_* 工具；已有会话的工具目录固定，需重建会话。
插件以当前 DSH 进程权限运行。安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境与安全要求。
典型用法¶
按 README 快速开始，六步可跑通一条自定义管线：
- 定义管线：
pipeline_define {id:"my-pipe", roles:{supervisor:{preset:"pipeline-supervisor"}, ...}, chain:["supervisor",...], gates:{...}}
- 部署：
pipeline_deploy {pipelineId:"my-pipe"}
- 播种角色会话：
pipeline_seed {pipelineId:"my-pipe"}
- 投任务：
pipeline_push {title, description, tags:["target:<角色>","task:<编号>","attempt:1"]}
-
流转：
pipeline_list→pipeline_claim→pipeline_done {result:"done route:<角色|UID> 产物:..."} -
看全景：
pipeline_status
字段与拓扑规范见 docs/管线定义规范.md；工具与 HTTP 端点清单见 docs/内核接口文档.md；架构说明见 docs/内核设计文档.md。
巡检配置（可选）¶
默认已开启。若要调整或关闭，在 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
适用场景与注意¶
适合谁：需要在 DSH 里编排多 Agent 单向任务链的开发者——例如主管 + 多工位角色、需要任务板与自动路由、又希望业务逻辑留在管线配置而非插件代码里。
不适合当作：开箱即用的生图/视频等业务插件；内核不提供预置管线，业务要自己定义。
注意：
- 宿主版本须满足
deepseek-harness 0.1.0-rc.8+，与插件 peer 依赖对齐后再装。 - 存量会话不会自动获得
pipeline_*工具，装完后开新会话。 - 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件是社区维护的 Cordis 扩展之一。
结尾¶
dsh-pipeline-kernel 把多 Agent 管线的通用管理能力（任务、台账、部署、注册、巡检、UI）从具体业务里拆出来：你定义配置行，内核负责跑链与可视。若你正在 DSH 里搭多角色协作，值得从 README 的快速开始与 docs/ 规范入手试一条自己的管线。
