返回目錄

dsh-edit-diff

精選清單收錄維護狀態: 活躍

better-er/dsh-edit-diff

「DSH·質量 diff」:接管 edit/write 及 extraTools 配置的其他工具卡片,行級去重與行內高亮,消除相同內容在刪除與新增兩區的重複;相容 PTC 模式。

前往 GitHub
$ dsh plugin --profile web add github:better-er/dsh-edit-diff

14

星數

0

Fork

TypeScript

語言

MIT

授權條款

2026-08-28

建立於

2026-11-14

最近推送

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/`。

安裝步驟

  1. 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

  2. 02

    從 npm 裝:執行 `dsh plugin --profile web add dsh-edit-diff`,套件內已含 `lib/index.js` 與 `lib/client.js`,安裝時不再建置。

    $ dsh plugin --profile web add dsh-edit-diff

  3. 03

    重新啟動 DSH web:兩種方式裝完都會自動掛載,不需要手動編輯任何檔案。

驗證整合成功

作者未說明

復原

  • 執行 `dsh plugin --profile web remove dsh-edit-diff` 並重新啟動 DSH web——README 說這樣是徹底移除,重新啟動後不再載入。

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

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`,否則讀不到內容。
2026-08-282026-11-03v0.4.5

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 行還要再展開一次才會全部顯示。

08資料與來源

  • 作者聲明github.com96a431e6adf0…

    - 是**标准形态的 dsh client 插件**,声明 `dsh.client`,导出 `./client`。

  • 作者聲明github.com96a431e6adf0…

    - **UI 挂载点**:接管 keyed 槽位 `tool.call.toolview` 的 `edit` 与 `write` 两个 key,以及 `extraTools` 里声明的每个工具名。

  • 作者聲明github.com96a431e6adf0…

    接管 DSH 浏览器的 `edit` / `write` 工具卡片,用近线性行级 diff 做真正的差异展示,消除内置 DiffBlock 把「未变化的相同行」在删除区红 `-` 行和新增区绿 `+` 行各渲染一遍的重复。

  • 作者聲明github.com96a431e6adf0…

    dsh plugin --profile web add github:better-er/dsh-edit-diff

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。