返回目錄

dsh-emacs

維護狀態: 活躍

vritser/dsh-emacs

面向 DeepSeek Harness 的 Emacs 客戶端。

前往 GitHub
$ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs

51

星數

7

Fork

Emacs Lisp

語言

GPL-3.0

授權條款

2026-08-23

建立於

2026-11-05

最近推送

GPL-3.0 的 DeepSeek Harness Emacs 用戶端,直接走 dsh 伺服器協定:Recents 優先的工作階段清單、可折疊的串流對話、@ 參照、斜線指令與 Skill、附件、子代理,以及顯示模型與用量的 mode line,Emacs 28.1+ 加一行 `load-path` 就能用。

DSH 整合

相容

作者聲明

安全稽核

未稽核

最後核實

2026-11-18

授權條款

GPL-3.0

01它能幫你完成什麼?

  • 不必離開 Emacs 就能推進一個 DeepSeek Harness 工作階段

    一個聊天 buffer:串流回覆、工具呼叫、折疊、可編輯草稿,以及 Recents 優先的工作階段清單

    本來就住在 Emacs 裡、不想再開瀏覽器或獨立終端機介面的 Emacs 使用者

  • 用鍵盤把工作區脈絡和指令交給 agent

    指向伺服器端檔案、目錄與工作階段的 `@` 參照,`/` 指令與 Skill 的 `TAB` 補全,暫存的附件,以及在工作區本機執行的 `!` shell 指令

    需要給 agent 明確檔案與指令脈絡的多檔案任務開發者

  • 跟住子工作階段和很長對話

    `M-x dsh-emacs-list-subagents` 開啟子工作階段(可續的接受後續輸入,一次性的唯讀),搭配分頁載入歷史

    執行大量子代理、需要檢視或續寫子任務的使用者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • Emacs 28.1 或更新版本——不強制依賴第三方 Emacs 套件
  • 一個 `dsh` CLI / 伺服器:缺少 CLI 時 `M-x dsh-emacs` 會提示安裝
  • 開發版(0.9.0,尚未發布)對應 dsh 0.2.2-rc.1;最近一次真實 E2E 驗證是 dsh 0.2.1-rc.2 搭配 dsh-emacs 0.8.0

安裝步驟

  1. 01

    `git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`

    $ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs

  2. 02

    把 `(add-to-list 'load-path (expand-file-name "~/dsh-emacs"))` 加進 Emacs 設定並求值,或重新啟動 Emacs

  3. 03

    加入 `(require 'dsh-emacs)`

  4. 04

    執行 `M-x dsh-emacs`——它會開啟工作階段清單,需要時啟動本機伺服器

  5. 05

    用 `M-x dsh-emacs-add-provider` 設定 provider,或用 `M-x dsh-emacs-open-web` 進行帳號登入

  6. 06

    按 `c` 新增工作階段,用 `C-c C-m` 選模型,在 `❯` 後輸入並按 `C-c C-c` 送出

驗證整合成功

作者未說明

03DSH 整合程度與能力邊界

DSH 整合相容

dsh 伺服器的 Emacs 用戶端:套件執行在 Emacs 內部,透過 RPC 協定管理或連線本機 `dsh` 伺服器,把工作階段內容呈現在一般 Emacs buffer 裡,不會安裝進任何 dsh profile。

  • 帶 Recents 的工作階段清單

    可選的本機專案或聊天脈絡→最近更新的 15 個可見工作階段(帶工作區標籤),其後是依工作區分組的其他工作階段

    沒有設定伺服器時啟動本機 dsh 伺服器
  • 可折疊的串流聊天 buffer

    一個既有工作階段,或新建的可編輯草稿→串流對話,工具與思考卡片可獨立折疊,並歸併成活動摘要與「已完成」分組

    `C-c C-o` 會把更早的輪次載入 buffer
  • 參照、斜線指令與附件

    `@` 路徑、`/` 指令或 Skill、暫存的檔案與剪貼簿圖片→伺服器端檔案 / 目錄 / 工作階段參照、補全後的指令,以及隨輸入一起送出的附件

    從執行 Emacs 的這台機器暫存檔案`!` shell 指令在工作區本機執行,既不送給模型也不寫入伺服器歷史
  • 模型與推理強度控制

    聊天 buffer 裡的按鍵→模型選擇(`C-c C-m`)與推理強度切換(`C-c C-e`),目前模型顯示在 mode line 上

  • 子代理與提問處理

    agent 的提問,或一次子工作階段清單請求→用 minibuffer 補全回答 agent 提問(多選可用逗號分隔),以及子工作階段清單

    可續的子工作階段接受後續輸入,一次性的維持唯讀
  • 伺服器管理與原始碼重新載入

    `dsh-emacs-base-url` / `dsh-emacs-server-auto-start` 設定,或改過的原始碼目錄→由它管理的本機伺服器、連到外部伺服器的連線,或保留對話與草稿的熱重新載入

    `M-x dsh-emacs-reload` 會在執行中的 Emacs 裡重新求值該套件

04適合誰?何時不該用?

適合

  • 本來就住在 Emacs 裡、不想再開瀏覽器或獨立終端機介面的 Emacs 使用者
  • 需要給 agent 明確檔案與指令脈絡的多檔案任務開發者
  • 執行大量子代理、需要檢視或續寫子任務的使用者

不適合

  • 需要 Emacs 28.1+ 和一個 dsh 伺服器;開發版對應 dsh 0.2.2-rc.1,而最近一次真實驗端到端驗證(dsh 0.2.1-rc.2 搭配 dsh-emacs 0.8.0)並未涵蓋這個新基準。
  • 遠端位址(含 HTTPS)永遠不會觸發本機伺服器啟動,而且只有 dsh-emacs 自己啟動的伺服器才會自動驗證——外部伺服器要提供啟動權杖或 `dsh-emacs-server-auth-token`。
  • 升級正在執行的 0.8.0 連線必須中斷後重連;被移除的定義或變更過的 struct 佈局必須重新啟動,而不能只靠重新載入。

05相容性、維護與安全提醒

  • 需要 Emacs 28.1+ 和一個 dsh 伺服器;開發版對應 dsh 0.2.2-rc.1,而最近一次真實驗端到端驗證(dsh 0.2.1-rc.2 搭配 dsh-emacs 0.8.0)並未涵蓋這個新基準。
  • 遠端位址(含 HTTPS)永遠不會觸發本機伺服器啟動,而且只有 dsh-emacs 自己啟動的伺服器才會自動驗證——外部伺服器要提供啟動權杖或 `dsh-emacs-server-auth-token`。
  • 升級正在執行的 0.8.0 連線必須中斷後重連;被移除的定義或變更過的 struct 佈局必須重新啟動,而不能只靠重新載入。
  • 若干選項與輔助函式被無別名移除(0.7.0 移除了 `dsh-emacs-group-consecutive-tools` 與 `dsh-emacs-assistant-divider`),升級後需要清理個人設定。
2026-08-232026-11-05v0.8.0

GPL-3.0 · README 分支 main · 最新 release v0.8.0(2026-11-04)

06常見問題

要怎麼把 dsh-emacs 裝進 Emacs?

先複製倉庫(`git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`),把該目錄加入 `load-path` 並 `(require 'dsh-emacs)`,然後求值或重新啟動 Emacs。執行 `M-x dsh-emacs`:它會開啟工作階段清單,需要時啟動本機伺服器,缺少 dsh CLI 時提示安裝。

對應哪個 DSH 與 Emacs 版本?

開發版(0.9.0,尚未發布)對應 dsh 0.2.2-rc.1,要求 Emacs 28.1+,且不強制依賴第三方 Emacs 套件。最近一次真實驗端到端驗證用的是 dsh 0.2.1-rc.2 加 dsh-emacs 0.8.0,因此那次驗證並未涵蓋新的基準。

需要自己先執行一個 dsh 伺服器嗎?

不需要,預設由 dsh-emacs 管理本機伺服器。若要連自己執行的伺服器,請設好 `dsh-emacs-base-url` 並把 `dsh-emacs-server-auto-start` 設為 nil;遠端位址(含 HTTPS)永遠不會觸發本機啟動,而且只有 dsh-emacs 自己啟動的伺服器才會自動完成驗證。

憑證保存在哪裡?

保存在 dsh 伺服器。用 `M-x dsh-emacs-add-provider` 設定 provider,或用 `M-x dsh-emacs-open-web` 進行帳號登入;憑證和模型設定都留在 dsh 伺服器,不會寫進 Emacs。

怎麼升級或重新載入?

`M-x dsh-emacs-reload` 可以在保留對話和草稿的前提下重新載入改過的原始碼;但升級正在執行的 0.8.0 連線需要中斷後重連,被移除的定義或變更過的 struct 佈局則必須重新啟動。

08資料與來源

  • 作者聲明github.combc26985f2861…

    from Emacs: streaming replies, tool calls, workspace sessions, subagent chats, file attachments, and model selection. Re…

  • 作者聲明github.combc26985f2861…

    3. Run `M-x dsh-emacs`.

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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