前言¶
DeepSeek Harness(DSH)插件生態中,下游應用經常需要跟上高速演進的上游 harness:更新集成膠水、跑構建和測試、確認插件契約是否仍然對齊,最後把改動交給人工審覈。
huchunlinnk/deepseek-desk-rsi 是一個 DSH 插件,目標就是讓下游應用與上游 DSH 保持同步。它的思路是“AI for AI:DSH 維護 DSH”,也就是用 DSH 自身執行上游同步流程,並把結果以 PR 形式交給人審。
這是什麼¶
huchunlinnk/deepseek-desk-rsi 由 huchunlinnk 維護,許可證爲 MIT。它註冊 6 個工具,並注入一個 rsi:loop system-prompt 段,用於約束同步環路的行爲。
它複用 DSH 提供的 peer 依賴:
@deepseek-ai/dsh-tools
@deepseek-ai/cordis
實現方式是零構建即裝:純 ESM + JSDoc,無 prepare 腳本。
核心環路¶
下面介紹它提供的同步環路:
perceive → integrate → verify → parity → repair → propose
各階段對應關係如下:
1、perceive
通過 rsi_perceive 對比上游相對某個 base ref 的差異。
2、integrate
把上游變化落到下游應用的集成代碼中。
3、verify
通過 rsi_verify 執行硬適應度檢查:
cargo build && cargo test && bash scripts/smoke-web.sh
退出碼 0 纔算通過。
4、parity
通過 rsi_parity 用 parity.json 校驗 128 插件契約,要求精確名字匹配。
5、repair
通過 rsi_checkpoint 與 rsi_rollback 提供 Memento 檢查點和回滾。修復有界,最多 3 輪。
6、propose
通過 rsi_propose 用 gh 開 PR,作爲人審閘門。
對等契約¶
parity.json 來自官方 dsh-base + dsh-web-app 兩個 bundle 生成,包含 128 個插件。同步後如果缺少必需插件名字,rsi_parity 會失敗。
上游插件發生增刪改名後,可以從官方 harness 路徑重新生成契約:
node scripts/gen-parity.mjs /path/to/deepseek-harness
安裝與啓用¶
安裝命令如下:
dsh plugin --profile rsi add github:huchunlinnk/deepseek-desk-rsi#main
接着需要啓用對應 profile。把 profile/ 目錄複製進:
$DSH_HOME/profiles/rsi
並指向你的倉庫。
完成以上步驟後,可以運行每日同步:
dsh --profile rsi "Run the daily upstream sync: perceive, integrate, verify, parity, repair if needed, then propose a PR."
測試¶
安裝或修改後,可以運行:
npm test
適用場景與注意¶
適合這類情況:
- 維護依賴 DSH 的下游應用。
- 上游 DSH 變化較快,需要持續追平。
- 希望由 DSH 執行感知、集成、驗證、對齊和修復,最終只生成 PR。
- 希望保留人工 merge 閘門。
使用前需要注意:
- 一個正在運行的環就是擁有 shell 權限的本地用戶。
- 密鑰絕不進源碼。
- PR 是閘門。
- 把 upstream 釘到你信任的 commit。
- 環只提議,人來 merge。
- 修復有界,最多 3 輪。
- 安裝前應檢查源碼與許可證。該插件許可證爲 MIT。
資源鏈接¶
- GitHub 倉庫:https://github.com/huchunlinnk/deepseek-desk-rsi
- 插件目錄頁:https://www.skillhub.cn/plugins/huchunlinnk/deepseek-desk-rsi(該 URL 按插件線索提供,本文不擴展其內容)