MIT 的 DSH 外掛：把官方工具面換成持久 bash、結構化 read、原子 write 與多格式 edit，另帶可選 AST 工具與兩個預設集。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-12
授權條款
MIT
01它能幫你完成什麼？
讓 DSH Agent 有一個帶狀態的 shell 與精確的檔案讀取，而不是一次一條指令
持久的 bash：`cd`、`export` 跨呼叫保持狀態，冗長日誌自動壓縮，超長輸出只留頭尾、完整內容落盤，長指令自動轉背景
大部分時間都在 shell 與檔案工具裡打轉的 DSH 使用者
用原子寫入、多種補丁格式與回傳 diff 來改檔案
回傳 diff 的原子 `write`，支援 replace / patch / hashline / apply-patch 的 `edit`，多段編輯、唯一性檢查與空白差異模糊比對
希望在大檔案與封存檔上少失敗幾次的使用者
在官方 standard 與 PTC 預設集之外，裝上 Tool Plus 預設集
兩條 `@deepseek-ai/dsh-agent-preset` 宣告隨外掛提供，裝完即可在預設集清單裡選；設定頁「Tool Plus → 預設集」可做最小更新、對齊範本、還原隨套件與檢視差異
需要統一某個 DSH profile 暴露哪些工具的團隊
02如何將外掛接入 DeepSeek Harness？
先決條件
- 全域安裝 `dsh` CLI（`npm i -g @deepseek-ai/dsh`），Node.js ≥ 24.9
- pnpm ≥ 10.4，因為 `--allow-build` 要放行本套件與 `koffi` 的安裝腳本
- Windows 上需要 Git Bash 作為 bash 執行環境
- 針對 DeepSeek Harness `dsh` v0.2.2-rc.1——README 標示它是 pre-release，介面可能變動
安裝步驟
- 01
Web profile：`dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`
$ dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
- 02
桌面端：profile 由桌面應用程式獨占，先 `cd ~/.dsh/profiles/desktop`，再執行 `pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`
- 03
pnpm 版本太舊用不了 `--allow-build` 時，往該 profile 的 `pnpm-workspace.yaml` 加兩個 `allowBuilds:` 條目，或在 profile 目錄執行 `pnpm approve-builds --all`，再重跑安裝指令
驗證整合成功
作者未說明
03DSH 整合程度與能力邊界
DSH 外掛（移植自 Oh My Pi 核心）：安裝後接管官方 bash / pwsh / 檔案 / 搜尋工具，另帶可選的 `ast_grep` / `ast_edit` 與兩個隨補丁層宣告的 agent 預設集
持久 bash 與安全刪除
Agent 送來的 shell 指令→跨呼叫保持狀態、壓縮日誌、只留頭尾並把完整輸出落盤、長指令自動轉背景，`rm` 把檔案移進系統資源回收筒
各平台回收筒位置不同：網路磁碟沒有回收筒，macOS 需要 10.12+，部分 Linux 桌面環境看不到項目結構化 `read`
一個路徑，可帶 `:N-M`、`:raw` 或多區間→依行區間讀取、大程式碼檔回傳結構摘要、直接讀 zip/tar、SQLite、notebook、PDF、圖片直讀並自動縮放，網頁抓取時可用本機瀏覽器渲染 SPA
抓取由 JS 渲染的頁面時可能啟動本機瀏覽器原子 `write` 與多格式 `edit`
檔案內容或一條編輯指令→回傳 diff 的原子寫入、可直接寫封存檔成員與 SQLite 的補丁式寫入，以及 replace / patch / hashline / apply-patch 四種編輯格式
多段編輯會做唯一性檢查與空白差異模糊比對grep / glob 與可選 AST 工具
一個模式或檔名 glob→全文搜尋與檔名比對，支援 mtime 排序、上下文行與可設定的忽略規則；可選 `ast_grep` / `ast_edit` 做語法樹搜尋與重寫
`ast_grep` / `ast_edit` 預設關閉，需要在設定裡開啟預設集管理
設定頁的「Tool Plus → 預設集」→最小更新、對齊範本、還原隨套件宣告，或先看差異再動手
寫入走宿主自己的 `ctx.configEditor`，因此自帶 profile 鎖、並行保護、原子寫與失敗回滾
04適合誰？何時不該用？
適合
- 大部分時間都在 shell 與檔案工具裡打轉的 DSH 使用者
- 希望在大檔案與封存檔上少失敗幾次的使用者
- 需要統一某個 DSH profile 暴露哪些工具的團隊
不適合
- README 建議在 `danger-full-access` 下使用，因為沙箱模式可能誤擋檔案寫入。
- 在 Linux 上跑 SWE-bench Multilingual 時解題率與官方持平，但每題總 token 與系統提示詞 token 更高；README 明確不承諾在 Linux 上更省 token 或效能更強。
- `--allow-build` 需要 pnpm ≥ 10.4；在 pnpm 11 上不加會報 `ERR_PNPM_IGNORED_BUILDS` 裝不上。外掛針對 `dsh` v0.2.2-rc.1 這個 pre-release，介面可能變動。
05相容性、維護與安全提醒
- 安全 `rm` 把檔案移進系統資源回收筒，但各平台不一致：網路磁碟沒有回收筒，macOS 需要 10.12+，部分 Linux 桌面環境看不到項目，只能到實際位置自行還原。
- README 建議在 `danger-full-access` 下使用，因為沙箱模式可能誤擋檔案寫入。
- 在 Linux 上跑 SWE-bench Multilingual 時解題率與官方持平，但每題總 token 與系統提示詞 token 更高；README 明確不承諾在 Linux 上更省 token 或效能更強。
- `--allow-build` 需要 pnpm ≥ 10.4；在 pnpm 11 上不加會報 `ERR_PNPM_IGNORED_BUILDS` 裝不上。外掛針對 `dsh` v0.2.2-rc.1 這個 pre-release，介面可能變動。
- 不提供獨立的 `pwsh` 工具，shell 情境統一由持久 `bash` 承擔；在 Windows 上這意味著需要 Git Bash。
MIT 原始碼；本文所有事實都來自記錄提交處的儲存庫 README，未做獨立安全稽核。
06常見問題
Web profile 上怎麼安裝 Tool Plus？
執行 `dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`。兩個 `--allow-build` 分別放行本套件與 `koffi` 的安裝腳本，需要 pnpm ≥ 10.4；pnpm 11 上不加會直接裝不上。
為什麼桌面端裝法不一樣？
桌面應用程式的 profile 由它獨占，`dsh plugin --profile desktop` 會被拒絕。要進它自己的目錄：`cd ~/.dsh/profiles/desktop`，再執行 `pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`。
它真的比官方工具省 token 嗎？
依它自己的基準測試並不是。在 Linux 上跑 SWE-bench Multilingual，解題率與官方持平，`bash` 單次回傳的 token 更少，但每題總 token 與系統提示詞 token 更高，所以 README 明確說不承諾在 Linux 上更省 token 或效能更強。
安全 `rm` 具體做了什麼？
把檔案移進系統資源回收筒而不是永久刪除：Windows 是資源回收筒，macOS 是 `~/.Trash`，Linux 是 `$XDG_DATA_HOME/Trash`。網路磁碟沒有回收筒，macOS 需要 10.12+，部分 Linux 桌面環境看不到項目；真要刪除時用 `command rm`。
它針對哪個 DSH 版本與環境？
DeepSeek Harness `dsh` v0.2.2-rc.1（README 提醒這是 pre-release，介面可能變動），需要 Node.js ≥ 24.9、全域安裝的 `dsh`、Windows 上的 Git Bash，並依建議在 `danger-full-access` 下使用。
07相關的 DSH 工作流程
dsh-our-free-model
作者 ebony-vinyl
在 dsh 里装上这个插件即可，无需登录、注册或填 API Key，就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness（dsh）路由套件：先装运行时注入器，再加载任务感知的推理模式路由预设（已实测 P1-P23）。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件，旨在减少 Token 消耗与任务耗时
brooks-lint
作者 hyhmrright
基于 12 本经典工程书籍的 AI 代码评审工具，提供腐化风险诊断、书籍引用、严重度标签及 6 种分析模式。
08資料與來源
DeepSeek Harness 基础工具增强：持久 bash、结构化 read、多模式 edit、原子 write、全文搜索、图像直读，一个插件全覆盖。基于 [Oh My Pi](https://github.com/can1357/oh…
| **Tool Plus 标准增强版** | 官方 standard | 官方标准模式全部能力 + 文件/Shell 工具集换成本插件 |
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-11-12。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。