dshan — 把 DeepSeek Harness 装进 Obsidian 侧栏

English README · 贡献指南 · 行为准则 · 安全策略

dshan 是一个 Obsidian 社区插件，把 DeepSeek Harness（DSH） 以原生 Obsidian 聊天视图的形式带进你的 vault——与 Claudian 一致：界面完全在 Obsidian 内部（原生 DOM、Obsidian 自己的 Markdown 渲染、[[wikilink]] 直接可用），agent 则运行在你的本地 DSH 服务上。

dshan 与你已在运行的同一个 dsh web 服务（默认 http://127.0.0.1:3080）通信，插件直接通过 DSH 的 /api 线上协议：会话、流式回合、工具卡片、审批、取消，全部渲染为原生 Obsidian UI。浏览器界面不再嵌入——仍可通过「在浏览器打开」命令使用，且与插件看到同样的会话。

功能

• Obsidian 原生聊天视图 —— 右侧栏（默认）、左侧栏、标签页或弹出窗口
• vault 即 DSH 工作区 —— 会话以 cwd = vault 创建，agent 直接读写你的 vault，自动加载 CLAUDE.md 作为 workspace instructions；它写入的每个文件即时出现在 Obsidian 文件管理器
• 完整回合体验，原生渲染 —— 流式正文（Markdown 渲染，[[wikilink]] 悬浮预览可用）、可折叠思考过程、工具调用卡片、审批按钮、停止按钮、会话列表与历史
• 进程管理 —— 先探测防双开、崩溃退避重启、退出策略可配置
• Obsidian 交互 —— 「发送选区到 dshan」「发送当前笔记到 dshan」直接把文本放入原生输入框
• 与浏览器界面解耦 —— 同一 DSH 服务仍可用命令在浏览器中打开

环境要求

• Obsidian 1.7.2+（仅桌面端：macOS / Linux / Windows）
• 已安装 DSH CLI（npm install -g @deepseek-ai/dsh），或在插件设置中手动指定路径

安装

• 从源码构建（见 docs/DEVELOPMENT.md）或从 GitHub Releases 下载（待发布）。
• 手动安装：把 main.js、manifest.json、 复制到 并启用插件。