前言¶
DSH 的官方工具在 Native 模式下返回內容往往較長,容易觸發報錯循環,調用輪次上去後 token 成本並不低;PTC 模式下讓模型手寫 TypeScript 也有同樣的問題。社區裏有一類插件不改變 DSH 的插件模型,而是替換一些內置工具、減掉可省的開銷,dsh-ops-linux 就是其中針對 Linux/ARM64 的一個分支。
下面介紹這個插件。它是 SunsetRNE/dsh-ops-Linux 倉庫,由維護者 SunsetRNE 維護,在社區插件目錄 SkillHub 中歸類爲「客戶端」分類,目錄頁顯示星標爲 0(該倉庫當前幾乎無關注度)。它是 T-Auto/dsh-ops 的自維護分支,目標平臺是 Linux/ARM64(含 Android),適配 DSH 0.2.2。與上游的差別是平臺適配和構建步驟,README 中有 PORT.en.md 記錄移植改動與編譯方式。
它解決什麼問題¶
上游 dsh-ops 的定位是「提高 token 效率,同時隱藏部分官方工具」,改動面小、侵入性低,與其它插件兼容較廣。具體手段有四類:
- 用緊湊、帶行號、錯誤回饋更好的工具替換官方 read/glob/grep,減少 Native 模式的報錯循環。
- 爲 PTC 模式提供返回結構化 JSON 的工具,降低模型手寫 TypeScript 的 token 量和心智負擔。
- 啓用 DSH 預留的
tools_addition動態工具加載,把 pdf/word 讀取、超多文件批量修改等高級功能做成按需暴露的工具,避免一次性塞進系統提示詞。 - 提供漸進工具面:discovery 行啓用的會話始終拿到動態加載入口,其餘用戶按需開啓,降低提示詞膨脹。
核心功能¶
插件以「模式行」組織能力,當前 bundle 共八行:mode-minimal、mode-standard、mode-ptc、mode-cordis、discovery、compat、panel、tui。
1、四個預設模式行分別增強內置的 Minimal / Standard / PTC / Cordis preset:Standard 與 Cordis 替換官方 read/glob/grep;PTC 提供類型化 SDK,PTC SDK 目錄包含 18 個 API,其中 15 個是文件/文檔工具,另外 3 個是批處理、結果引用和加載器;Minimal 只替換 Windows shell。
2、discovery 行啓用的會話始終獲得動態加載入口,用於後續按需加載高級功能。
3、compat 模式默認關閉,開啓後保留全部官方工具,適合要從官方工具遷移或共存的場景。
4、panel 與 tui 中,tui 提供只讀 OPS 側欄:聚焦後可用 f 篩選、n/p 翻頁、a 確認跨會話提醒;側欄不搶焦點,不發起額外工具調用。
需要注意的是,ops_bash(與 dsh 原生 bash 行爲一致)只在 Windows 提供,Linux/ARM64 上不適用。
安裝與啓用¶
本分支沒有發佈到 npm,安裝命令來自倉庫 README:
dsh plugin --profile web add <tarball or this checkout>
即用本地 tarball 或倉庫 checkout 直接添加。需要先確認本機 DSH CLI 可用,且目標 profile 已初始化。
如果你用的是上游 npm 上的 dsh-ops(面向 Windows / Linux x64 / macOS),官方安裝方式有兩種。
第一種是通過插件市場。在目標 DSH 應用的插件市場中輸入包名 dsh-ops,選擇自定義 npm 地址 https://mirrors.huaweicloud.com/repository/npm/,安裝後啓用。README 特別說明目前不推薦用 npmmirror,存在 bug。
第二種是 npx 一鍵安裝,必須顯式指定目標 profile:
npx --yes dsh-ops@latest install --profile desktop
npx --yes dsh-ops@latest install --profile web
npx --yes dsh-ops@latest install --profile tui
tui 映射到 dsh-TUI 產品的 dsh-tui profile,不是舊的 tui 目錄。安裝前先初始化目標應用;桌面端必須使用桌面應用自帶的 CLI,默認探測路徑是 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd,裝在其它位置要加 --dsh-cli "<安裝目錄>\resources\runtime\cli\bin\dsh.cmd"。
也可以直接用官方 CLI:
dsh plugin --profile web add dsh-ops
dsh plugin --profile dsh-tui add dsh-ops
"<桌面安裝目錄>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-ops
普通 DSH CLI 不能管理保留的 desktop profile,這一點不要混用。
安裝前可以用 --dry-run 預演:
npx --yes dsh-ops@latest install --profile web --dry-run
預演只打印計劃,不啓動 CLI、不修改 profile,做的是 CLI 路徑解析、文件存在性、POSIX 執行權限等靜態檢查。
查看狀態和卸載:
npx --yes dsh-ops@latest status --profile desktop
npx --yes dsh-ops@latest uninstall --profile desktop
把 desktop 換成 web 或 tui 即可。
典型用法¶
裝好之後,按目標場景選擇模式行。以 Standard 爲例,開啓 mode-standard 後官方 read/glob/grep 被替換;需要按需加載高級功能時,同時開啓 discovery,讓會話始終拿到動態加載入口;不想改動官方工具行爲時,把 compat 打開,保留全部官方工具。
在 dsh-TUI 中啓用 dsh-ops/tui 行並重啓,即可看到 OPS 只讀側欄。
適用場景與注意事項¶
適合在 Linux/ARM64(含 Android)上跑 DSH、希望壓低 token 消耗、同時不想大改現有插件配置的用戶。上游 Windows 用戶想試這套工具面也可以直接用 npm 上的 dsh-ops。
幾點需要注意:
- 插件以當前 DSH 進程權限運行,安裝前應先檢查源碼與許可證。本倉庫源碼以 MIT 許可分發(上游
dsh-ops亦爲 MIT);0.3.2 之前的版本曾內置 Apache-2.0 的 FastCtx 源碼,該組件現已移除,當前發行版不含 FastCtx 代碼或二進制,許可文本與歷史歸屬保留在licenses/fastctx/與 NOTICE。 - README 聲明的宿主兼容範圍是 DSH 0.2.0-rc.2 與 0.2.1-rc.2,而本分支簡介寫的是適配 DSH 0.2.2。兩者存在不一致,安裝前請先確認你的 DSH 版本落在哪個範圍。
- 舊的
shell、file、ptc、hide-official行已移除,如果之前爲它們保存過 profile 覆蓋,需要刪掉並重新配置模式開關;background行也已移除,保留該行的 profile 只會記錄一條警告。 - 這是第三方自維護分支,Star 數爲 0,社區關注度低,長期維護和兼容取決於維護者。改動前建議讀 PORT.en.md 與上游文檔,確認你需要的模式行在目標平臺上可用。
結尾¶
dsh-ops-linux 的價值在於把 dsh-ops 的工具面搬到 Linux/ARM64,同時保留了上游「低改動面、低侵入性、按 profile 組織」的設計。如果你在 Linux/ARM64 上使用 DSH,可以試試這個分支;如果你的環境是 Windows / macOS / Linux x64,直接看上游 T-Auto/dsh-ops 更合適。
目錄頁:https://www.skillhub.cn/plugins/SunsetRNE/dsh-ops-Linux
GitHub:https://github.com/SunsetRNE/dsh-ops-Linux