前言¶
DeepSeek Harness(DSH)把智能體能力拆成可組合的插件與預設。若你希望在官方 standard 預設之外,使用一套更強調政策正文覆蓋、文件操作中和與自檢回執的 Agent 行爲,又不想在本地跑安裝腳本或手動拷貝目錄,就需要一種「只含聲明、隨包升級」的掛載方式。社區維護的 dsh-free-mode(codesensi)把上游破甲類預設重新打包爲純 DSH bundle,安裝後在預設選擇器裏出現 自在模式,適合已經熟悉 DSH 插件命令、且能接受自行審閱補丁內容的開發者。
這是什麼¶
dsh-free-mode 是 MIT 許可的 DSH 插件包:整個倉庫實質只有 patch/free.patch.yml 一份聲明式補丁,不含可執行代碼。維護者爲 codesensi,在 SkillHub 等社區目錄中歸類爲 工作流。插件簡介指向爲 DSH 注入與「破甲模式」同源的 Agent 預設方案;本包在 UI 中顯示爲 自在模式(v4 強化版政策正文 + 逐條覆蓋層 + 文件操作中和塊,並附「自在否」自檢回執口令)。
預設正文重新打包自上游 z91772524-ai/dsh-pojia-mode(破甲模式 v1.1):將安裝器落盤的內容改爲 dsh.bundle.patch 形式的純聲明式 bundle,不再攜帶腳本或安裝器,並隨 npm 包版本更新。
核心功能¶
下面介紹本插件在 DSH 裏實際提供的能力,均來自倉庫 README 與 package.json 聲明。
- 聲明式掛載:通過
package.json中的dsh.bundle.patch指向./patch/free.patch.yml,DSH 啓動時自動應用補丁層。 - 預設條目:補丁聲明
preset-free,在選擇器中顯示爲「自在模式」,order: 20,排在官方 standard 預設之後。 - 鏡像 standard 插件清單:
patch/free.patch.yml逐條鏡像 DSH 0.2.1-rc.3 官方standard預設的插件清單(含@deepseek-ai/dsh-agent-preset與cordis:group分組)。DSH 升級若改變 standard 構成,本預設可能出現能力差異,需維護者同步更新鏡像與engines.dsh範圍。 - 零額外依賴:除 DSH 本體外無其他運行時依賴。
環境要求¶
engines.dsh: >=0.2.1-rc.3 <0.3.0
需要 DSH 0.2.1-rc.3 或更高,且低於 0.3.0(聲明式 Agent 預設 + 插件 bundle 機制)。當前 npm 包版本爲 1.2.0(以 package.json 爲準)。
安裝與啓用¶
先做安裝,再重啓 DSH;補丁在啓動時掛載,之後在預設選擇器中選擇「自在模式」。
從 Git 倉庫安裝(用戶名/倉庫名):
dsh plugin add codesensi/dsh-free-mode
從 npm 安裝:
dsh plugin add dsh-free-mode
安裝完成後 重啓 DSH,打開預設選擇器即可看到「自在模式」。
卸載:
dsh plugin remove dsh-free-mode
卸載後同樣需重啓 DSH,preset-free 聲明隨插件包移除。
與上游破甲安裝器並存時的注意¶
若曾用上游 dsh-pojia-mode 的安裝器,預設會寫入 $DSH_HOME/.agent-presets/pj-mode,與本插件的 preset-free 是兩套獨立聲明,可以共存、互不覆蓋。但顯示名同類(上游爲「破甲模式」,本插件爲「自在模式」),同時安裝會在選擇器裏出現兩個相近條目,且上游落盤內容不會隨本插件 npm 版本更新。README 建議:若已裝過上游,可先刪除 $DSH_HOME/.agent-presets/ 下對應目錄(如 pj-mode),只保留本插件,便於隨版本升級。
典型用法¶
本插件沒有單獨的業務 CLI;用法即「安裝 → 重啓 → 在 DSH 預設選擇器選用自在模式」。維護者本地校驗補丁可用:
python tools/validate_patch.py patch/free.patch.yml
打包爲 npm tarball(供 dsh plugin add 使用):
pnpm pack
適用場景與注意¶
適合誰:已在用 DSH 0.2.1-rc.x、需要額外 Agent 預設且偏好聲明式插件包(無安裝腳本)的開發者;願意對照 GitHub 上的 patch/free.patch.yml 理解政策與工具行爲差異。
不適合當作什麼:這不是 DeepSeek 或幻方官方應用;SkillHub 等目錄是社區生態站點。插件以當前 DSH 進程權限運行,預設會參與 Agent 與文件相關能力,安裝前應閱讀源碼、許可證(MIT)及補丁正文,自行判斷是否滿足合規與安全要求。
版本兼容:engines.dsh 上界爲 <0.3.0;大版本 DSH 變更時可能需要等待插件 minor/major 發版調整鏡像。
鏈接¶
經過上面的步驟,你可以在不動本地安裝腳本的前提下,用標準 dsh plugin add 流程掛載「自在模式」,並在上游與本包之間按 README 建議避免重複條目。