前言¶

在 DSH 裏跑通一套部署、排查或發佈流程，往往要反覆口述步驟；換一個新會話，又得從頭對齊上下文。把步驟記在筆記或倉庫 README 裏能緩解一部分問題，但模型不會自動把這些文檔當成「可按指令執行的技能」來發現與加載。下面介紹 dsh-plugin-workflow-library：在某次會話裏把流程跑通後，用自然語言觸發固化，插件在配置的目錄裏生成結構化工作流；後續會話中，這些工作流作爲技能出現在目錄中，按需加載執行。

這是什麼¶

dsh-plugin-workflow-library 是 DeepSeek Harness 的工作流類插件，由維護者 zh-Littlebird（Hu Zhang）發佈，當前 npm 包版本爲 0.1.0，許可證 MIT。

定位可以概括爲：把可重複的 DSH 流程沉澱成可複用資產。對模型說一句「把這個流程固化一下」，插件會在你配置的根目錄下新建工作流文件夾；下個會話裏說「按上次那套來」，模型從技能目錄加載說明後照做。插件歸屬 DSH 社區生態（SkillHub 目錄與 GitHub 倉庫），與 DeepSeek / 幻方無官方從屬關係。

核心功能¶

保存工作流（workflow_save）¶

模型在會話中調用 workflow_save 後，會在庫根目錄下生成類似結構：

<root>/
  INDEX.md
  deploy-model/
    SKILL.md          # 何時使用 / 輸入 / 步驟 / 驗收 / 常見坑
    workflow.json     # 步驟、參數、來源會話、版本
    assets/           # 可選：腳本與模板

workflow.json 是權威記錄，SKILL.md 由它渲染，創建時不會出現兩份內容不一致。SKILL.md 的 frontmatter（name / description / whenToUse / metadata）與 @deepseek-ai/dsh-skill-filesystem 兼容：若將來想脫離本插件，可把 customSkillDirs 指向該目錄。

技能發現與索引¶

默認開啓 registerSkills，工作流注冊爲技能供模型發現。默認開啓 autoIndex，每次保存後重建 INDEX.md，便於瀏覽已有工作流。

設置界面¶

裝好後可在 設置 → 工作流庫 中確認根目錄（默認 ~/.dsh/workflows）及相關選項。

安全邊界¶

保存前會掃描常見密鑰形態（如 sk-…、ghp_…、私鑰、Bearer、URL 內嵌口令），命中即拒絕，要求改成 <REDACTED>。assets 只接受相對路徑，拒絕 ..、絕對路徑與盤符；單文件 64KB，總量 256KB。根目錄不能是磁盤根或系統目錄，寫入前做可寫探測。工作流只寫入配置的庫目錄，不會改動工作區裏的其它文件。

安裝與啓用¶

官方 README 給出的安裝方式爲：

dsh plugin --profile desktop add dsh-plugin-workflow-library

也可通過 plugin_manager 的 install_bundle，target 傳包名或已獲取的插件目錄。

運行環境要求（來自 package.json）：Node >=22.19.0，DSH >=0.2.1-rc.2 <0.3.0。

安裝前建議查看 GitHub 源碼 與 MIT 許可證。插件以當前 DSH 進程權限運行，請確認其讀寫範圍符合你的安全預期。

典型用法¶

1、裝好後打開 設置 → 工作流庫，確認根目錄（默認 ~/.dsh/workflows）。

2、在任意會話裏把一件事跑通，然後說「把這個流程固化成工作流」。

3、模型調用 workflow_save，在庫目錄生成 SKILL.md、workflow.json 及可選的 assets/。

4、下個會話直接說「按上次部署模型那套來」，模型從技能目錄加載 SKILL.md 後按步驟執行。

配置項¶

適用場景與注意¶

適合經常在 DSH 中重複同類操作（部署、檢查清單、固定排查路徑）的開發者：一次跑通、一次固化，新會話用自然語言引用即可。

不適合把含未脫敏密鑰的會話直接固化——插件會攔截常見祕密形態，但仍應以 <REDACTED> 自覺處理敏感信息。同名工作流默認追加後綴目錄（onConflict: suffix），需要覆蓋升版本時可改爲 replace。

結尾¶

dsh-plugin-workflow-library 把「口述一遍流程」變成「庫裏的 SKILL + workflow.json」，並與 DSH 技能發現機制對齊。目錄與文檔：

• SkillHub：zh-Littlebird/dsh-plugin-workflow-library
• GitHub：github.com/zh-Littlebird/dsh-plugin-workflow-library