返回目录

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 插件,绝不滥发。