前言¶
在 DeepSeek Harness（DSH）裏跑智能體任務，成本往往落在兩處：工具返回塞進上下文裏的 Token，以及模型在報錯、重試之間多走的輪次。官方工具覆蓋面廣，但在讀大文件、批量改倉庫、Native / PTC 兩種 harness 模式下，返回體偏大或格式不利於模型繼續寫代碼時，任務會變慢、賬單會變厚。
下面介紹社區插件 dsh-ops（npm 包名 dsh-ops，倉庫 T-Auto/dsh-ops）。它以提高 Token 效率爲明確目標：用新增的 ops 系列工具替代或隱藏部分官方工具，並配合 DSH 預留的 tools_addition 做漸進式加載，在常見場景裏壓低提示詞膨脹和調用次數。維護方爲 T-Auto 團隊；在 SkillHub 等社區目錄中歸類爲「模型推理」相關插件。截至資料記錄，GitHub 約 3665 stars、101 forks（以倉庫頁面實時數據爲準）。
這是什麼¶
dsh-ops 是面向 DSH 的底層操作工具插件，自述定位爲：低改動面、低侵入性，並儘量與其它插件兼容。它不另起一套 harness，而是在現有 DSH 進程裏掛載組件，把文件、Shell、PTC、可選 TUI 側欄等能力按 profile 裝進你的桌面端、Web 或 dsh-TUI 應用。
當前發行版源碼以 MIT 許可分發（package.json 記錄版本 0.4.1）。插件以當前 DSH 進程權限運行；安裝前應在 GitHub 覈對源碼與 許可證 / 溯源說明。
核心功能¶
ops 工具與官方工具的取捨¶
插件通過 ops 命名空間的工具完成多數讀寫與命令操作，並可在策略層隱藏部分官方工具，減少模型在功能重疊工具之間來回試探。設計強調「方案級」替換而非全盤改寫 DSH，便於與社區其它插件並存。
漸進式 tools_addition¶
啓用 DSH 預留的 tools_addition 動態工具加載，把 PDF、Word 讀取、大批量文件修改等偏重場景放在按需加載的高級能力裏。常見對話不會把這些工具的 schema 一次性塞進系統提示，從而控制 Token；需要時再加載，避免提示詞長期膨脹。
Native 模式¶
爲 Native harness 提供返回更緊湊、帶行號、錯誤信息更清晰的操作面，目標是遏制「報錯—盲目重試」循環，減少無效輪次。
PTC 模式¶
爲 PTC（Programmatic Tool Calling）模式提供返回結構化 JSON 的工具，降低模型在 PTC 下編寫 TypeScript 時的 Token 總量與心智負擔。倉庫說明 PTC SDK 目錄包含 18 個 API：其中 15 個爲文件/文檔類工具，另有批處理、結果引用和加載器相關接口。細節見倉庫 PTC 設計與使用。
Windows 上的 Shell 行爲¶
僅 Windows 平臺：可啓用與 DSH 原生 bash 行爲一致的 ops_bash，並可選禁用 PowerShell，使 Shell 類任務路徑與 Linux/macOS 體驗更一致。可選載荷 @dsh-ops/bash-win32-x64 的許可與上游組件說明見倉庫 PROVENANCE。
dsh-TUI 可選只讀側欄¶
在 dsh-TUI 中啓用 dsh-ops/tui 插件行並重啓後，可增加 OPS 只讀側欄：不搶焦點、不觸發額外工具調用，用於瀏覽有界保留元數據。聚焦後支持 f 篩選、n/p 翻頁、a 確認跨會話提醒等本地快捷鍵。說明見 側欄文檔。
已移除的後臺組件¶
早期版本曾內置 FastCtx 後臺任務（dsh-ops/background）；0.3.2 之後該組件已移除。若 profile 仍保留 background 行，加載時僅記錄警告、不發佈工具，可直接從配置刪掉該行。舊版在 <DSH_HOME>/dsh-ops/ 下 provision 的文件需按 README 單獨清理。
安裝與啓用¶
安裝方式分兩類：DSH 插件市場（npm 包名）與 npm 一鍵安裝 / 官方 CLI。請勿使用未在文檔出現的 dsh plugin add github:owner/repo 形式。
插件市場¶
- 在目標 DSH 應用的插件市場中搜索 npm 包名
dsh-ops。 - 選擇「自定義地址」，填入華爲雲 npm 鏡像（文檔當前推薦，因 npmmirror 存在已知問題）：
https://mirrors.huaweicloud.com/repository/npm/
- 安裝後在應用中啓用插件。若能穩定訪問 npm 官方源，也可選官方源。
npm 一鍵安裝¶
必須先初始化目標 DSH 應用，並顯式選擇 profile。tui 對應 dsh-TUI 產品的 dsh-tui profile，不是舊版 tui 目錄名。
桌面端應使用桌面應用自帶的 CLI；默認探測路徑爲 Windows 下的 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd。安裝目錄不同時加 --dsh-cli 指向該 dsh.cmd。
預演安裝（不修改 profile）可加 --dry-run：
npx --yes dsh-ops@latest install --profile desktop
npx --yes dsh-ops@latest install --profile web
npx --yes dsh-ops@latest install --profile tui
也可直接使用官方 CLI（注意 desktop profile 只能用桌面自帶入口，普通 dsh CLI 不能管理保留的 desktop profile）：
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
更新、狀態與卸載¶
更新：重新執行相同的 npx ... install --profile ...，或 dsh plugin ... add dsh-ops@latest，並按應用提示重載或重啓。
查看狀態 / 卸載（將 desktop 換成 web 或 tui）：
npx --yes dsh-ops@latest status --profile desktop
npx --yes dsh-ops@latest uninstall --profile desktop
也可在插件市場卸載，或 dsh plugin --profile ... remove dsh-ops。單獨 provision 的 Bash 運行時可用 dsh-ops bash-runtime remove --yes 移除。清理舊版 <DSH_HOME>/dsh-ops/ 遺留時可用 npx --yes dsh-ops@latest uninstall --yes；~/.fastctx/ 默認不刪，需要時加 --purge-fastctx。
典型用法與文檔入口¶
安裝並啓用後，ops 工具會隨 DSH 會話出現在模型可調用的工具列表中；具體工具名、參數與策略（例如隱藏哪些官方工具）以倉庫 使用指南、組件參考、配置參考 爲準。
PTC 集成與 Native 行爲差異見 native-ptc.md。排錯與驗收可參考 常見問題、手動驗收。
README 中附有團隊在自用 benchmark 上的 Token 效率對比示意圖；完整 benchmark 以倉庫後續更新爲準，本文不復述未公開的數字。
適用場景與注意¶
更適合誰：長期在 DSH 裏做倉庫級讀寫、Shell、文檔處理或 PTC 腳本生成的開發者；希望在不大改工作流的前提下壓低 Token 與輪次；需要 Windows 上與原生 bash 對齊的 Shell 行爲；使用 dsh-TUI 且希望有隻讀 OPS 元數據側欄的用戶。
需要注意：
- 插件與 DSH 同權限運行，涉及文件刪除、Shell 命令、批量修改等操作前，應理解策略與工具範圍。
- 與隱藏官方工具相關的策略可能影響你或其它插件對內置工具的依賴，升級 dsh-ops 或 DSH 後建議對照 CHANGELOG。
- 社區目錄（如 SkillHub 插件頁）獨立於 DeepSeek / 幻方，並非官方應用商店；安裝源以 README 寫的 npm 包與鏡像爲準。
- 支持平臺（package.json）：win32 / linux / darwin，x64 / arm64。
結尾¶
dsh-ops 把「少 Token、少輪次」做成可安裝的 DSH 插件：ops 工具面、tools_addition 漸進加載、Native / PTC 雙模式優化，以及可選 TUI 側欄，都在同一 npm 包 dsh-ops 下按 profile 交付。若要瀏覽簡介與分類，可打開社區目錄 dsh-ops；源碼、安裝細節與路線圖見 GitHub T-Auto/dsh-ops。
