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
安装步骤
- 01
`git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`
$ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs
- 02
把 `(add-to-list 'load-path (expand-file-name "~/dsh-emacs"))` 加进 Emacs 配置并求值,或重启 Emacs
- 03
加入 `(require 'dsh-emacs)`
- 04
执行 `M-x dsh-emacs`——它会打开会话列表,需要时启动本地服务端
- 05
用 `M-x dsh-emacs-add-provider` 配置 provider,或用 `M-x dsh-emacs-open-web` 做账号登录
- 06
按 `c` 新建会话,用 `C-c C-m` 选模型,在 `❯` 后输入并按 `C-c C-c` 发送
验证接入成功
作者未说明
03DSH 适配与能力边界
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`),升级后需要清理个人配置。
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 布局则必须重启。
07相关的 DSH 工作流
dsh-oil-creator
作者 oil-oil
AI 辅助的本地创作者工作台,支持在 DeepSeek Harness 中创作内容
dsh-novel-writer
作者 akira399
大肥鱼的小说工坊 — DSH 网络小说创作插件:九阶段门禁式创作流程 + 世界书设定注入 + 本地书籍导入 + AI 一键润色 + 去AI味 + 黄金三章诊断 + 百万字一致性 + 市场调研与模板复制。
dsh-multica-runtime
作者 multica-ai
为 Multica 平台提供 DeepSeek Harness 运行时支持,让智能体工作流无缝运行。
dsh-plugin-radar
作者 adamplatin123
DSH Plugin Radar — open-source ecosystem radar for DeepSeek Harness plugins: continuous discovery (21k+ candidates), k8s runtime validation (13k+ tests), 15-min snapshots; the catalog is a generated artifact — 开源 DSH 插件生态雷达:持续发现 2.1 万+ 候选、k8s 运行级实测 1.3 万+、15 分钟快照;插件目录为自动生成的产物
08数据与来源
from Emacs: streaming replies, tool calls, workspace sessions, subagent chats, file attachments, and model selection. Re…
3. Run `M-x dsh-emacs`.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
