DSH Dock
eLerVi211 downloadsDock the official DeepSeek Harness Web (127.0.0.1:3080) into an Obsidian sidebar panel. Runs the official dsh CLI with per-vault isolated sessions.
- Overview
- Scorecard
- Updates14
把官方 DeepSeek Harness Web（127.0.0.1:3080）停靠进 Obsidian 侧边栏——跑官方
dsh CLI、官方 UI 原样嵌入，轻量高效。
✨ 特性
- 📦 开箱即用 — Obsidian 市场一键安装，或复制 3 个文件
- 🪟 官方原生 — 定位 dsh → 拉起官方
dsh web→ iframe 原样嵌入 - 🔐 鉴权自动接管（B2） — 官方 dsh web 的浏览器鉴权 cookie 是
SameSite=Strict，跨站 iframe 无法认证。本插件在面板内核起一个本机反向代理，读取 dsh web 凭证库的会话签名密钥、注入 cookie 并重写 Host/Origin 通过官方/api信任围栏 —— 面板无需 launch token，无论服务是新起还是已存在都能直接显示（HTTP + WebSocket 双向代理） - 🗂️ Per-vault 隔离 — 会话按库独立、配置全局共享，多库并行互不串扰
- 🔌 Obsidian API 桥（B1） — 插件加载即在本机 127.0.0.1 起一个 token 鉴权的 HTTP 桥，把
app.vault/metadataCache/fileManager的官方解析结果喂给 DSH 侧vault_*工具（桥优先、文件回退），工具写后 Obsidian UI 与索引即时刷新 - 🤝 珠联璧合 — 与 dsh-tool-obsidian-vault 联动，Obsidian 内直接驱动 Agent 笔记工作流
- 🧹 进程自清洁 — 卸载/停用 SIGTERM 关停；崩溃残留的孤儿进程下次启动自动清扫
📦 安装
前置：Obsidian 桌面端 ≥ 1.5.0 ·
npm i -g @deepseek-ai/dsh· Node ≥ 20
① 插件市场（推荐）：设置 → 第三方插件 → 浏览 → 搜索 DSH Dock → 安装并启用。
② 手动安装：把 main.js + manifest.json + styles.css 复制到 vault 的 .obsidian/plugins/dsh-dock/，再在设置中启用。
启用后点侧边栏机器人图标（或命令「打开 DSH 面板」）。首次启动自动初始化 $DSH_HOME 并拉起官方 dsh web，几秒后面板出现。
🗂️ Per-vault 隔离（默认）
会话隔离、配置共享——模型、密钥、主题配一次全库生效，只有会话/历史按库独立。
| 维度 | 行为 |
|---|---|
| 会话 / 历史 | 每库独占 ~/.dsh/vaults/<库名>-<hash6> |
| 监听端口 | port + vaultRoot hash % 4096（冲突概率 ~1/4096） |
| vault 识别 | 注入 DSH_OBSIDIAN_VAULT_PATH + 标记文件跟随（不覆盖 cwd） |
| 模型 / 密钥 / 主题 / presets | 全局共享：软链 profiles/ + cordis.patch.yml 指回 ~/.dsh |
⚙️ 设置
| 设置 | 默认 |
|---|---|
| dsh CLI 路径 | 自动探测（$DSH_BIN → npm 全局） |
| Node 可执行文件 | 系统 node（最稳定） |
| 监听端口 | 3080（≥1，不用 0 表示「OS 分配」——launcher 无需发现子进程实际端口） |
| DSH_HOME 模式 | per-vault 隔离（可切换 shared / 自定义） |
| 随 Obsidian 自动启动 | ✅ 开 |
| Obsidian API 桥 | ✅ 开（127.0.0.1 回环，token 鉴权，端口 18080+ 独立于 dsh web） |
🔧 Obsidian API 桥（B1）
node <dsh>/lib/bin.js web --host 127.0.0.1 --port <port> env: DSH_HOME
→ 等待就绪（秒退立即报错，不盲等）→ iframe 面板 → http://127.0.0.1:<port>/
端口上已有 DSH 服务 → 直接挂接，不重复拉起
Obsidian API 桥（B1，独立于 dsh web）：
createBridgeServer(service=ObsidianBridgeService(app)) @ 127.0.0.1:<18080+hash>
→ /health /v1/{current,notes,note,metadata,frontmatter,backlinks,search,tags,folders}
→ POST /v1/{write,edit,frontmatter,rename}（Bearer token 鉴权，仅回环）
→ 桥地址/token 经 DSH_OBSIDIAN_BRIDGE_URL/TOKEN env + current-vault.json 标记文件
双通道注入 DSH 进程；工具侧「桥优先、文件回退」
⚠️ 已知限制
- 仅桌面端（依赖
child_process） - 端口被非 DSH 服务占用 → 秒退报错；被另一 DSH 占用 → 直接挂接
- 会话全文搜索需 Node ≥ 22.5
- dsh web 鉴权依赖
~/.dsh/.credentials.yaml：面板代理需要读取其中的client-connection/browser-session签名密钥来注入 cookie。若目标 dsh web 用了非默认/非共享的凭证库路径，面板将报「面板鉴权代理启动失败」（届时用「在系统浏览器中打开」访问官方地址）。 - 桥的
vault_rename_note遵循 Obsidian「自动更新内部链接」设置（关闭时不改写引用，与 Obsidian UI 行为一致） - 桥覆盖 vault / fileManager / metadataCache / workspace 中与笔记工作流相关的全部核心 API；全文搜索无公开 API（桥内实现 substring/regex），附件二进制读写与
/v1/events变更推送未做
🤝 珠联璧合
dsh-tool-obsidian-vault 是 DSH 侧工具插件（20 个 vault_* 工具，让 Agent 直接读写本地 Obsidian 笔记）；本插件是 Obsidian 侧外壳——一个管「门」（让 DSH 住进 Obsidian），一个管「钥匙」（让 Agent 认识 Obsidian）。
| 环节 | 本插件（Obsidian 侧） | 工具侧如何受益（DSH 侧） |
|---|---|---|
| 启动 DSH | 点机器人图标，面板即官方 DSH Web UI | 无需自己开终端跑 dsh web |
| 定位当前库 | 注入 DSH_OBSIDIAN_VAULT_PATH / DSH_OBSIDIAN_VAULT_NAME |
「注入的本库」优先于工作目录巧合，多库同开不串 |
| 会话工作目录 | 不覆盖（保持 dsh 默认）；库识别走注入的 env + 标记文件 | cwd 与库根是两个独立概念，不合并 |
| 多库并行 | 端口按库 hash 偏移互不冲突 | 面板共享同一份 preset，一次装好全库可用 |
| 配置共享 | cordis.patch.yml 指回 ~/.dsh |
配一次全库生效，只有会话/历史按库隔离 |
三步启用：① 装好本插件 → ② 在 DSH 侧装 Obsidian 模式 preset（复制其 preset/ 到 ~/.dsh/.agent-presets/obsidian）→ ③ 面板新建会话选「Obsidian 模式」，说「读一下今天的笔记」「把这段整理进 [[xxx]]」，Agent 自动读写当前库，无需任何路径配置。
仅 per-vault 模式（默认）注入 env（库名/路径 + 桥地址/token）；shared 模式多库共用一个服务，工具侧退回「最近活跃打开库 / 工作目录」解析。cwd 一律不覆盖——库识别靠
DSH_OBSIDIAN_VAULT_PATH与标记文件。
License
MIT