前言¶
在 DeepSeek Harness 的插件化使用場景中,有些需求並不是新增一個 agent runtime,而是把已有的 longgraph prompt library 接到會話的 skill seam 上。dsh-plugin-longgraph 屬於這類社區插件:它把 longgraph、loop-graph、loop-converge 這三個 authoring skills 註冊到 ctx.skills。
這是什麼¶
dsh-plugin-longgraph 是一個社區插件,由 levi-qiao 維護,MIT 許可。它只服務於 DeepSeek Harness,不會在其他產品上安裝或啓動節點。資料說明,它與 DeepSeek AI 無官方從屬或維護關係,也不是官方 Harness bundle。
這個插件不添加 agent runtime。它通過 DeepSeek Harness 的 skill seam 暴露 longgraph prompt library,並用 resourceBase 指向打包好的技能目錄,使 templates 和 references 可以解析。
核心能力¶
插件提供三個技能:
1、longgraph:先做 fit check,再交給 loop-graph。
2、loop-graph:訪談、編譯 .longgraph/<date-slug>/,然後啓動或打印 DSH prompts。
3、loop-converge:應用 code-convergence preset,然後執行同樣的編譯。
實現上,它沒有 runtime config,並通過 ctx.skills.registerProvider 注入技能。
它還會聲明 dsh.bundle.patch,並隨包提供 cordis.patch.yml,其中插入一個名爲 dsh-plugin-longgraph 的行。
dsh.bundle.patch
cordis.patch.yml
dsh-plugin-longgraph
安裝與啓用¶
DeepSeek Harness 處於 developer preview。資料給出的安裝命令如下:
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph
dsh --profile web
安裝完成後,可以調用以下技能:
invoke skill({ name: "longgraph" })
也可以調用 loop-graph 或 loop-converge。
如果需要固定一個 commit,可以使用:
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph#<commit>
需要說明的是,資料中的安裝命令使用 --profile web;資料未說明該 profile 是否在所有環境都必需。
Git 安裝會拉取源碼,prepare 會運行 tsdown。如果使用 pnpm 10+ 且 pnpm 阻止 prepare,可以把該包加入 profile 的 pnpm-workspace.yaml build allowlist,然後重試。
資料也給出 Direct Cordis row:
- id: longgraph-skills
name: dsh-plugin-longgraph
典型用法¶
先根據目標選擇入口:
1、使用 longgraph:先做 fit check,再交給 loop-graph。
2、使用 loop-graph:進入訪談流程,編譯到 .longgraph/<date-slug>/,然後啓動或打印 DSH prompts。
3、使用 loop-converge:先應用 code-convergence preset,再執行同樣的編譯。
如果涉及 timers,資料給出以下約束:
- 使用兩個獨立的 root sessions。
every_seconds下限是 300。- schedule 是 session-local,兩個 sessions 都必須保持 live。
- 若某個 session 正忙,它會等空閒後再
followup();timer 不會打斷 fire。 - 不要
followup()或inject()另一個 session。
依賴與兼容性¶
資料給出的 peerDependencies 範圍如下:
@deepseek-ai/cordis >=4.0.1 <5
@deepseek-ai/dsh-skill >=0.1.0-rc.5 <0.2.0
由於 DeepSeek Harness 仍在 developer preview,兼容性破壞性變化會要求新的插件版本。
開發命令¶
如果需要本地驗證,資料給出的命令是:
pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm integration
適用場景與注意¶
適合在 DeepSeek Harness 中使用 longgraph prompt library 的開發者,尤其希望只註冊技能、不引入額外 agent runtime 的場景。
不適合作爲以下替代方案:
dsh-agent-loopScheduleJobsWeb UI
它也不是 multi-host skill pack。
安裝前請注意:插件會以當前 dsh 進程權限運行,並且會註冊可被會話調用的技能。建議先檢查 GitHub 源碼、MIT 許可證、peerDependencies 範圍,以及 cordis.patch.yml 中插入的行。
鏈接¶
- GitHub:https://github.com/levi-qiao/dsh-plugin-longgraph
- 目錄頁:資料未提供。
結尾¶
dsh-plugin-longgraph 的價值比較具體:把 longgraph、loop-graph、loop-converge 這幾個編寫技能接到 DeepSeek Harness 的 ctx.skills 上,讓模型可以通過 skill seam 使用對應指令。對於想在 DSH 中使用 longgraph prompt library 的場景,它是一個輕量的社區接入點。