MarSuero/deepseek-chat-obsidian

DeepSeek Chat for Obsidian

DeepSeek Chat for Obsidian 预览

建议搭配 / Recommended Companion

dsh-web-mobile 专门为 DSH Web 界面做了窄屏 UI 适配，跟本插件配合使用，强烈建议搭配。

dsh-web-mobile 为窄屏适配了 DSH Web UI。与本插件完美搭配——强烈推荐，可获得更好的移动端体验。

把 DeepSeek Harness (DSH) 的 Web 界面嵌入 Obsidian 侧边栏，并在打开面板时自动拉起本地 dsh web 服务。

将 DeepSeek Harness (DSH) 的 Web UI 嵌入 Obsidian 侧边栏面板，并在打开面板时自动启动本地 dsh web 服务。

功能 / Features

- 侧边栏嵌入 DSH 官方 Web UI，与浏览器里打开完全一致
- 打开面板时自动探测并启动 dsh web（dsh 找不到时回退 npx）
- 用 Obsidian 的 requestUrl 探测服务，绕过本地 CORS 限制
- 可配置服务地址、启动命令、是否自动启动、启动超时

- 在 Obsidian 面板中嵌入官方 DSH Web UI，与在浏览器中打开完全一致
- 打开面板时自动探测并启动 dsh web（回退到 npx）
- 通过 Obsidian 的 requestUrl 探测服务器，绕过本地 CORS 限制
- 可配置服务器 URL、启动命令、自动启动开关和启动超时

前置条件 / Prerequisites

- Obsidian ≥ 1.5.0（仅桌面版，插件需要启动本地进程）
- Node.js ≥ 18
- DSH 已安装（npm i -g @deepseek-ai/dsh），或允许插件用 npx 自动拉取
- DSH 已配置模型凭证（与 dsh web 一致）

- Obsidian ≥ 1.5.0（仅桌面版——插件会启动本地进程）
- Node.js ≥ 18
- 已安装 DSH（npm i -g @deepseek-ai/dsh），或允许插件通过 npx 获取
- 已配置 DSH 模型凭证（与 dsh web 相同）

安装 / Installation

从 Release 安装（推荐）/ From Release (recommended)

1. 在 Releases 下载 main.js、manifest.json、styles.css
2. 在你的 vault 里新建目录 .obsidian/plugins/deepseek-chat/
3. 把三个文件放进去
4. 在 Obsidian 的第三方插件列表里启用「DeepSeek Chat」

1. 从 Releases 下载 main.js、manifest.json、styles.css
2. 在你的 vault 中创建 .obsidian/plugins/deepseek-chat/
3. 将这三个文件放入其中
4. 在 Obsidian 的社区插件列表中启用“DeepSeek Chat”

从源码安装 / From Source

git clone https://github.com/MarSuero/deepseek-chat-obsidian.git
cd deepseek-chat-obsidian
npm install
npm run build

然后把 main.js、manifest.json、styles.css 复制到 .obsidian/plugins/deepseek-chat/。

然后将 main.js、manifest.json、styles.css 复制到 .obsidian/plugins/deepseek-chat/。

使用 / Usage

- 点左侧 ribbon 的消息图标，或命令面板搜「DeepSeek Chat」，打开面板
- 首次打开会等待 dsh web 就绪后加载网页
- 在面板里就像用浏览器一样操作 DSH 的完整界面

- 点击左侧 ribbon 的消息图标，或从命令面板运行“DeepSeek Chat”
- 首次打开会等待 dsh web 就绪，然后加载页面
- 在面板中使用完整的 DSH 界面，就像在浏览器中一样

配置 / Configuration

在 设置 → 第三方插件 → DeepSeek Chat 里配置：
| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| 服务器地址 | http://127.0.0.1:3080 | DSH web 服务地址 |
| 启动命令 | dsh | 启动命令，找不到时回退 npx |
| 自动启动服务器 | 开启 | 打开面板时若服务未运行则自动拉起 |
| 启动超时（秒） | 60 | 等待服务就绪的最长时间 |

在 设置 → 社区插件 → DeepSeek Chat 中配置：

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| 服务器地址 | http://127.0.0.1:3080 | DSH web 服务地址 |
| 启动命令 | dsh | 启动命令，找不到时回退 npx |
| 自动启动服务器 | 开启 | 打开面板时若服务未运行则自动拉起 |
| 启动超时（秒） | 60 | 等待服务就绪的最长时间 |

开发 / Development

npm install
npm run dev     # watch 模式
npm run build   # 生产构建，输出 main.js
npm run typecheck  # 类型检查（npx tsc --noEmit）

源码结构：

src/
main.ts           # 插件入口：注册视图、命令、设置，管理服务器
view.ts           # ItemView：内嵌 iframe 加载 DSH web UI
settings.ts       # 设置 tab 与类型定义
serverManager.ts  # dsh web 生命周期：探测、自动启动、停止
transport.ts      # HTTP 传输：requestUrl（绕过 CORS）/ fetch 兜底

src/
main.ts           # 插件入口：注册视图、命令、设置，管理服务器
view.ts           # ItemView：内嵌 iframe 加载 DSH web UI
settings.ts       # 设置 tab 与类型定义
serverManager.ts  # dsh web 生命周期：探测、自动启动、停止
transport.ts      # HTTP 传输：requestUrl（绕过 CORS）/ fetch 兜底

发布 / Releasing

打一个语义化版本号 tag，GitHub Actions 会自动构建 main.js、更新 versions.json，并创建带 main.js / manifest.json / styles.css 的 release：

git tag 0.1.0
git push origin 0.1.0

推送一个语义化版本号 tag；GitHub Actions 会构建 main.js、更新 versions.json，并创建带 main.js / manifest.json / styles.css 的 release：

git tag 0.1.0
git push origin 0.1.0

为什么是 iframe 而不是原生面板 / Why iframe instead of a native panel

DSH 的 Web UI 是它功能最完整的界面，且本地服务不返回 CORS 头。用 iframe 嵌入官方 UI 是最稳的方案：完整功能、零协议维护成本，页面自身的请求是同源的，不存在跨域问题。

DSH 的 Web UI 是它功能最完整的界面，且本地服务不返回 CORS 头。用 iframe 嵌入官方 UI 是最稳的方案：完整功能、零协议维护成本，页面自身的请求是同源的，不存在跨域问题。

致谢 / Acknowledgements

- DeepSeek Harness
- DeepSeek-Harness-for-VS-Code（dsh web 启动与回退逻辑的参考）

- DeepSeek Harness
- DeepSeek-Harness-for-VS-Code（dsh web 启动与回退逻辑的参考）

License

MIT