前言¶
在 DeepSeek Harness (DSH) 生態中，針對 XDSP 前端項目的版本管理與模塊發佈，通常需要執行 yarn transpile 和 npm publish 等串行步驟。手動操作不僅耗時，還容易在多模塊發佈時出現版本衝突或發佈中斷。dsh-publish-skill 旨在將這一流程封裝爲 DSH 的 Skill，使其能直接在對話環境中被調用。
是什麼¶
dsh-publish-skill 是一個爲 DeepSeek Harness 註冊的插件，提供僅限用戶調用的 /publish-skill 技能。該插件由 WonderfulEdge 維護，採用 MIT 許可證，核心價值在於實現 XDSP 前端模塊的順序化、受控發佈。
核心功能¶
該插件提供以下具體能力：
* 全量發佈：對 packages/ 目錄下的所有模塊進行發佈。
* 斷點續發：利用 START_PACKAGE 參數，從上一個發佈失敗的模塊繼續執行。
* 單模塊發佈：利用 PACKAGE 參數，僅發佈指定的單個模塊。
* 統一版本管理：自動修改目標模塊 package.json 頂層的 version 字段。
* 嚴格串行執行：確保 yarn transpile 和 npm publish 按順序執行，不併發。
* 發佈前確認：首次發佈前會確認版本號與有序模塊列表。
* 跳過編譯檢查：只要 transpile 階段無錯誤，即忽略 TypeScript 編譯結果並直接發佈當前模塊。
* 無副作用操作：不自動提交 Git、不修改 lockfile、不自動登錄 npm 或更改 registry。
安裝與啓用¶
插件安裝目標是 web profile，不包含瀏覽器 bundle。安裝後需重啓當前 Web Harness 進程以使 profile 重新組合。
安裝命令：
dsh plugin --profile web add github:WonderfulEdge/dsh-publish-skill
若需從本地目錄安裝，可執行：
dsh plugin --profile web add ./publish-skill
典型用法¶
技能聲明瞭 disable-model-invocation: true，模型不會自行選擇它，必須由用戶輸入指令觸發。
全量發佈：
/publish-skill TARGET_VERSION=2.1.4-beta.0
從指定模塊續發：
/publish-skill TARGET_VERSION=2.1.4-beta.0 START_PACKAGE=xdsp-chatbi
只發佈一個模塊：
/publish-skill TARGET_VERSION=2.1.4-beta.0 PACKAGE=xdsp-bi
若未提供 TARGET_VERSION，技能會先詢問版本號，不會自行猜測。
適用場景與注意¶
- 加載機制：技能僅通過用戶輸入
/publish-skill時加載。 - 權限與安全：插件以當前 DSH 進程的權限運行。安裝前應檢查源碼與許可證（MIT）。
- 生態說明：該插件收錄於社區目錄（如 awesome-dsh-plugin.com），與 DeepSeek 或幻方無官方從屬關係。
總結¶
dsh-publish-skill 通過串行化執行和手動確認機制，解決了 XDSP 前端模塊發佈中的版本管理與併發問題，適合需要在 DSH 環境中自動化發佈流程的開發者使用。
- 目錄頁: https://www.skillhub.cn/plugins/WonderfulEdge/dsh-publish-skill
- 源碼: https://github.com/WonderfulEdge/dsh-publish-skill
