前言¶
在 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/ 規範入手試一條自己的管線。
