前言¶
在 DeepSeek Harness（DSH）裏做項目治理時，常見做法是臨時寫一段提示詞，或把規則散落在對話裏。問題是：長期共享事實難以沉澱到 Git 資產，工程、實驗、質量與發佈結論容易混在一起，複雜治理開始前也缺少可比較的基線。
dsh_plugin_swift_cycle 是 Swift Cycle 的 DSH 適配器。它把鎖定的 Swift Cycle v1.2.0 載荷註冊爲只能由用戶顯式調用的 Harness Skill，支持版本固定與離線驗證。維護者爲 Solismuchengxue，SkillHub 分類爲 admin-security，GitHub 倉庫當前約 15 stars。
這是什麼¶
一句話定位：Swift Cycle governance skill adapter for DeepSeek Harness；user-invoked，version-pinned，offline-verifiable。
適配器版本爲 0.1.1，上游 Swift Cycle 爲 v1.2.0（commit af3c5ddafba516c304613ea69081118fc234add7）。npm 包名爲 dsh-plugin-swift-cycle，許可證 MIT。完整治理規則以鎖定的上游 SKILL.md 爲準，本適配器 README 不復制 Skill 正文。
核心功能¶
適配器向 Harness 註冊的 Swift Cycle 能力包括：
- Knowledge Promotion：把長期共享事實從本地記錄晉升到適當的 Git 管理資產。
- State Separation：拆分彼此獨立的工程、實驗、質量和發佈結論。
- Governance Baseline：複雜治理開始前記錄可比較的當前基線。
- Commit Boundary Planning：爲多提交工作預先劃分單一意圖和驗證邊界。
- Source/Runtime Boundary：分別驗證源碼、製品、運行態和實際消費者。
調用策略如下。適配器註冊 name = swift-cycle，modelInvocable = false，userInvocable = true。Swift Cycle 不進入模型可隱式選擇的 Skill 目錄，用戶需顯式輸入：
/swift-cycle
安裝與啓用¶
日常安裝使用 npm latest：
dsh plugin --profile web add dsh-plugin-swift-cycle
需要固定、可重放的安裝身份時指定版本：
dsh plugin --profile web add dsh-plugin-swift-cycle@0.1.1
npm 固定版本不可變。需要直接從 GitHub 安裝同一版本時，使用 v0.1.1 對應的完整 40 位 commit：
dsh plugin --profile web add "github:Solismuchengxue/dsh_plugin_swift_cycle#d44bee70c109bb1d772d26ee790d6de9aadce9cc"
安裝或改動 profile 前先檢查合成配置：
dsh --profile web --dump-config
GitHub v0.1.0 固定 commit 與 npm 0.1.1 均已在同一個真實 Web profile 中完成安裝、加載和只讀調用煙測。其他 profile 的安裝仍需用戶單獨授權。各版本的安裝身份和驗證邊界以對應 GitHub Release v0.1.1 爲準；不要把未固定的默認分支用於可重放安裝。
典型用法¶
安裝完成後，在 DSH 對話中顯式調用：
/swift-cycle
維護者如需本地驗證適配器與上游載荷一致性，需要 Node.js 20 或更高版本。本包沒有運行時依賴，也不需要執行安裝生命週期腳本：
npm test
npm run verify:upstream
npm run pack:dry-run
也可顯式提供一個 Swift Cycle checkout，做只讀載荷比對：
node scripts/verify-upstream.mjs --source "<path-to-swift-cycle-skill-directory>"
適配器加載和運行時不會訪問網絡，不讀取憑據，也不會修改用戶級 Skill 目錄。通過 npm 或 GitHub 安裝時，分發工具仍需要聯網獲取用戶指定的固定版本。
適用場景與注意¶
適合誰
- 需要在 DSH 中按 Swift Cycle 規則做項目治理、狀態拆分與提交邊界規劃的開發者。
- 希望 Skill 版本可固定、載荷可離線驗證、調用必須由用戶顯式觸發的團隊。
務必注意
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與 MIT 許可證，並理解其治理邊界。 - 根據鎖定的 DeepSeek Harness Skill Registry 規則，項目級同名條目可以覆蓋本適配器的 Runtime 註冊；Runtime 註冊可能遮蔽同層的用戶級同名條目。本適配器不會刪除或改寫被遮蔽的 Skill。
- 倉庫文檔記錄的驗證結論覆蓋源碼、候選製品、隔離 Harness Runtime 與部分真實 Web consumer 煙測，不代表其他項目、寫入流程或生產治理已經驗證。
DSH 生態的理念是「一切皆插件」。SkillHub 是獨立社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh_plugin_swift_cycle 把 Swift Cycle v1.2.0 以版本鎖定、用戶顯式調用、離線可驗證的方式接入 DSH，適合在 admin-security 場景下做結構化項目治理。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Solismuchengxue/dsh_plugin_swift_cycle
- GitHub 倉庫：https://github.com/Solismuchengxue/dsh_plugin_swift_cycle
