chenzhexii/obsidian-dsh

DeepSeek Harness Embed（Obsidian 插件）

把 DeepSeek Harness（DSH）的智能体对话以原生聊天面板的形式放在 Obsidian 右侧栏：插件管理本地 dsh web 服务，通过 DSH 官方 HTTP/WebSocket 协议直接对话——会话管理、模型与思考强度切换、拖拽文档进对话，全部原生实现，不依赖 iframe。

特性

- 💬 原生右侧栏聊天：消息流式输出，思考过程可折叠查看，工具调用折叠为小行
- 🗂️ 会话管理：新增 / 切换 / 归档对话（归档走 DSH 官方 workspace.archiveSession）
- 🎛️ 模型与思考强度：实时读取模型目录（provider/model），一键切换，思考强度（Off/High/Max 等）随模型联动
- 📎 拖拽文档进对话：从 Obsidian 左侧文件列表拖入笔记，作为本次对话的上下文（也支持命令「把当前笔记附加到 DSH 对话」）
- 🖥️ 服务管理：自动启动/复用本地 dsh web（端口 3080 已有实例则直接连接），状态栏显示状态

安装

前置要求

1. 安装 Node.js（≥ 18）。
2. 全局安装 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh

安装插件

把本仓库的 obsidian-dsh 目录复制到你的 vault（文件夹名必须与 manifest.json 的 id 一致，即 obsidian-dsh）：

/.obsidian/plugins/obsidian-dsh/

其中必须包含 main.js、manifest.json、styles.css。然后在 Obsidian 设置 → 第三方插件中启用，重启 Obsidian（或禁用再启用插件）。

从源码构建

cd obsidian-dsh
npm install
npm run build     # 产出 main.js

工作区

插件以当前打开的 Obsidian 仓库（vault）作为 DSH 的工作区域：

- 打开面板时，自动选择 cwd 为 vault 目录的最近会话；没有则自动创建（并确保 DSH 中存在一个以 vault 路径为根的工作区 workspace）
- 会话下拉框只显示当前 vault 工作区内的对话，其他工作区（如 Harness Web 界面里的其他目录）的会话不会混进来
- 「➕ 新对话」创建的会话同样挂在 vault 工作区下，DSH 智能体的工作目录即 vault 根目录，可直接读写你的笔记
- 面板头部显示 📁 vault 文件夹名（悬停可看完整路径）

响应式布局

- 面板较窄（，信封 {type:"client-request", rpcId, method, payload}
- 事件流：/api/events.mux 是 WebSocket 端点（HTTP 会返回 426 要求升级），插件内置轻量 RFC-6455 客户端读取消息事件（不协商压缩、不带 Origin，可过信任栅栏）
- 消息流：session.prompt（mode queue）→ mux 推送 user/message、assistant/chunk（text/reasoning 增量）、assistant/message（最终文本）、turn/start|end
- 会话：session.list / session.create（cwd=vault）/ session.history / workspace.archiveSession
- 模型：session.models / session.selectModel（provider、model、reasoningEffort）

常见问题

面板显示"服务未启动"：确认 dsh --version 可用；打开插件设置页看「环境检测 / 测试连接」；若 3080 已被占用且开启了「复用已运行的服务」，插件会直接连接已有实例。

端口冲突：设置里把端口改为 0 自动挑选空闲端口。

拖拽不生效：从左侧"文件列表"拖入，拖入后输入框上方应出现文件名 chip；再输入指令发送即可。

看不到思考过程：模型不支持或思考强度为 Off 时无思考块；有思考时会以「思考过程」折叠显示。

安全说明

- 只监听 127.0.0.1，不暴露到局域网。
- DSH 服务可执行本机命令（这是它的设计能力），请勿把监听地址暴露给不可信网络。

许可证

MIT