MIT 授權的 TypeScript DSH 瀏覽器端外掛:把 `edit` / `write` 的內建卡片換成只顯示真實變化行的行級 diff,帶行內字元高亮、長 diff 二次收合,並透過 `extraTools` 接管遠端 edit/write 工具。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-16
授權條款
MIT
01它能幫你完成什麼?
在 DSH 工作階段裡看 `edit` / `write` 的結果時,只想看到真正改掉的行,而不是永遠對不上的紅區與綠區
完全相同的行一律不繪製:改一行就只有一行紅 `-` 加一行綠 `+`,被改動的字元在行內加上底線標出
在瀏覽器裡逐筆複查 DSH 檔案改動的人,尤其是被內建 DiffBlock 在刪除區與新增區各畫一次脈絡行拖慢閱讀的人
PTC 模式下 `edit` / `write` 以 `run_code` 子呼叫執行時,同樣能看到改了什麼
子呼叫裡繪製同一套最佳化 diff,靠 `callId` 中的 `:code:` 標記辨識
把檔案改動放進 `run_code` 子呼叫執行的人——預設卡片只回報呼叫成功與否
讓遠端 edit/write 工具也用同一套顯示,不必再寫第二個外掛
`edit_remote` 與 `write_remote` 在外掛內附的 `cordis.patch.yml` 裡預設已接管,其他工具寫進 `extraTools` 即可
透過 dsh-remote-file-system 而不是內建工具寫檔案的環境
02如何將外掛接入 DeepSeek Harness?
先決條件
- 安裝指令以 `web` profile 書寫(`--profile web`);外掛同時宣告了 `dsh.bundle`,裝到哪個 profile 就會被自動辨識為 profile layer 並掛載,不必手寫組合 entry。
- 裝完需要重新啟動 DSH web——README 說兩種方式都會自動掛載,重新啟動後啟用,不需要手動編輯任何檔案。
- 從 GitHub 安裝時 npm 需要執行 `prepare` 腳本現場建置,因為儲存庫裡不含 `lib/`。
安裝步驟
- 01
從 GitHub 裝:執行 `dsh plugin --profile web add github:better-er/dsh-edit-diff`,安裝時 npm 會觸發 `prepare` 腳本現場建置 `lib/`。
$ dsh plugin --profile web add github:better-er/dsh-edit-diff
- 02
從 npm 裝:執行 `dsh plugin --profile web add dsh-edit-diff`,套件內已含 `lib/index.js` 與 `lib/client.js`,安裝時不再建置。
$ dsh plugin --profile web add dsh-edit-diff
- 03
重新啟動 DSH web:兩種方式裝完都會自動掛載,不需要手動編輯任何檔案。
驗證整合成功
作者未說明
復原
- 執行 `dsh plugin --profile web remove dsh-edit-diff` 並重新啟動 DSH web——README 說這樣是徹底移除,重新啟動後不再載入。
03DSH 整合程度與能力邊界
DSH 瀏覽器端外掛 —— 宣告 `dsh.client` 並匯出 `./client`,在 keyed 槽位 `tool.call.toolview` 上註冊 `edit` / `write` 兩個 key 以及 `extraTools` 裡宣告的每個工具名稱,以 `priority: -1` 遮蔽內建的 `file-mutation-toolview`;安裝指令為 `dsh plugin --profile web add github:better-er/dsh-edit-diff`
只繪製變化的行,並在行內標出改動的字元
近線性 diff 演算法
超大檔案的差異會退化成粗粒度的整塊顯示,不再是精細 diff預設收合、長 diff 二次收合、複製與統計
卡片預設只有一行摘要,展開後才顯示 diff 內容差異行超過 14 行時,中間部分要再展開一次才會全部顯示複製出來的內容只含差異行,每行帶 `- ` 或 `+ ` 前綴對齊原生觀感,單一檔案與多檔案都涵蓋
接管 `edit` / `write` 以外的寫入工具
以 `write` 型繪製的工具呼叫只能顯示全新增行,因為整檔覆寫沒有舊內容可比對以較低優先順序遮蔽內建繪製,設定即時下達
settings 變化會讓瀏覽器端重建這批 key 的註冊
04適合誰?何時不該用?
適合
- 在瀏覽器裡逐筆複查 DSH 檔案改動的人,尤其是被內建 DiffBlock 在刪除區與新增區各畫一次脈絡行拖慢閱讀的人
- 把檔案改動放進 `run_code` 子呼叫執行的人——預設卡片只回報呼叫成功與否
- 透過 dsh-remote-file-system 而不是內建工具寫檔案的環境
不適合
- `write` 是整檔覆寫、沒有舊內容,卡片只能顯示全新增的綠行;需要精確到字元的 diff 應該用 `edit`。
05相容性、維護與安全提醒
- 繪製全在瀏覽器端:主機端半身只把設定轉成 `dsh-edit-diff` settings 命名空間,外掛以較低優先順序遮蔽內建繪製,不改動 DSH 原始碼。
- `write` 是整檔覆寫、沒有舊內容,卡片只能顯示全新增的綠行;需要精確到字元的 diff 應該用 `edit`。
- 有兩道明確的繪製上限:一行的改動區超過 512 字元時不再逐字元對齊,行級差異超過 600 行時退化成整塊刪除加新增。
- `extraTools` 裡的參數名稱省略時按 `file_path` / `old_string` / `new_string` / `content` 取值;參數名稱不同的工具必須逐項補 `pathKey` / `oldKey` / `newKey` / `contentKey`,否則讀不到內容。
MIT · 最新版本 v0.4.5(2026-11-14T11:26:34Z)· DSH web 瀏覽器端外掛,不改 DSH 原始碼
06常見問題
怎麼把 dsh-edit-diff 裝進 DeepSeek Harness?
在 DSH 裡執行 `dsh plugin --profile web add github:better-er/dsh-edit-diff` 從 GitHub 安裝,npm 會執行 `prepare` 腳本現場建置 `lib/`;也可以執行 `dsh plugin --profile web add dsh-edit-diff` 裝 npm 套件,套件內已含建置產物 `lib/index.js` 與 `lib/client.js`。兩種方式裝完都會自動掛載,重新啟動 DSH web 後啟用。
它會改動 DSH 原始碼或內建繪製器嗎?
不會。它是標準形態的 DSH 瀏覽器端外掛,宣告 `dsh.client` 並匯出 `./client`,在 keyed 槽位 `tool.call.toolview` 上以 `priority: -1` 註冊,用較低優先順序遮蔽內建的 `file-mutation-toolview`,而不是在同一優先順序上衝突。繪製全在瀏覽器端,主機端半身只把設定轉成 `dsh-edit-diff` settings 命名空間。
自己的遠端 edit/write 工具也能用這套顯示嗎?
可以,把它們寫進 `extraTools`:給工具名稱,參數名稱不同再補 `pathKey` / `oldKey` / `newKey` / `contentKey`,省略時按 `file_path`、`old_string`、`new_string`、`content` 取值。外掛內附的 `cordis.patch.yml` 已經預設接管 dsh-remote-file-system 的 `edit_remote` 與 `write_remote`,要改這份預設就在 profile 的 `cordis.patch.yml` 裡按 id 覆寫。
為什麼 `write` 的卡片只有綠色新增行?
`write` 是整檔覆寫,沒有舊內容可比對,只能把新檔案整體顯示成新增行;想要精確 diff 請用 `edit`。PTC 模式下透過 `callId` 中的 `:code:` 標記辨識 `run_code` 子呼叫,子呼叫裡的 `edit` / `write` 也會走這套最佳化顯示。
多大的 diff 還能正常繪製?
演算法先做共同前綴/後綴收縮,只對中間的小差異帶跑 Myers diff,複雜度與差異量成正比。超過門檻就換成粗粒度顯示:單行改動區超過 512 字元不再逐字元對齊,行級差異超過 600 行退化成整塊刪除加新增。卡片預設收合,差異行超過 14 行還要再展開一次才會全部顯示。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛,高效能低佔用,可愛畫素鯨魚,流暢滑鼠互動,npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座,支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒體工作臺外掛:一句話記靈感,一鍵生成指令碼、封面、配圖和分鏡
dsh-drawai
作者 fourzkw
DSH 右側欄裡的可編輯畫布 —— 加上讓模型直接改圖的兩個工具
08資料與來源
- 是**标准形态的 dsh client 插件**,声明 `dsh.client`,导出 `./client`。
- **UI 挂载点**:接管 keyed 槽位 `tool.call.toolview` 的 `edit` 与 `write` 两个 key,以及 `extraTools` 里声明的每个工具名。
接管 DSH 浏览器的 `edit` / `write` 工具卡片,用近线性行级 diff 做真正的差异展示,消除内置 DiffBlock 把「未变化的相同行」在删除区红 `-` 行和新增区绿 `+` 行各渲染一遍的重复。
dsh plugin --profile web add github:better-er/dsh-edit-diff
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
