Obsidian 桥接 wuenna/dsh-obsidian-bridge

dsh-obsidian-bridge

一个 DeepSeek Harness（DSH）插件，将所服务的 DSH Web GUI 与在其旁边 iframe 中运行的 Obsidian 连接起来。一个宿主模块——index.mjs，一个普通的 DSH 插件，带有 export const name / export function apply(ctx)，且自身没有浏览器 bundle。浏览器那一半是它注入到所服务的 index.html 中的单个脚本。

它添加了什么

| 方向 | 功能 |
| Obsidian → DSH | 从选中的区域填充 composer 草稿（postMessage dsh-fill-draft），并带有 Obsidian 侧可据以采取行动的回复（dsh-fill-ack：applied / stale / separator present）。注入的脚本会合并到已经输入的内容中，而不是覆盖它。 |
| DSH → Obsidian | 通过点击聊天中出现的路径（工具输出、标题、文件卡片）来在 Obsidian 中打开文件，以及点击 [[wikilinks]]——注入的脚本将它们渲染为链接，并将 dsh-wikilink 转发到 Obsidian 侧。 |
| Obsidian → DSH | 在 DSH iframe 内按下的键盘快捷键会被转发到宿主窗口（dsh-kbd-shortcut），Obsidian 侧通过 dsh-kbd-cfg 推送其按键列表。编辑键（Enter、方向键、Ctrl+Z……）保留在本地。 |
| DSH → agent | 编辑指令注入。 当最新的用户消息带有隐式的 [BRIDGES is delivering packages for you…… · N words · L4:1-L9:20 · label ·] 行时，一个 pre-step 钩子会将其转换为确定性的编辑指令（“读取该区域，呈现结果，请求同意，然后用 fs edit 写回”）。该指令通过 DSH 原生的一次性收件箱（agent.inbox.prepend('next-step', …)）投递，因此它绝不会作为独立消息出现在聊天记录中。 |
| Embed auth | 跨站 iframe 认证适配器（自 2.3.2 起）。DSH 的浏览器会话 Strict cookie 在跨站 iframe 中在结构上不可用，因此此插件接受一个额外凭据：GET /?token=&ob=1 返回 200，而不是原来的 303 cookie 流程（没有 ob 时，真实浏览器保持原路径不变），并且当请求携带匹配的 Bearer 头或查询 token 时，/api 的 401 判定会被覆盖。403 fence 判定绝不会被触碰。 |

要求

- DSH 0.1.x，带有 web profile（注入的脚本针对所发布的 Web GUI 的 DOM：textarea[data-phase]、role="tree"、composer dock）。
- Obsidian 侧插件，它使用 dsh- postMessage 协议通信，并推送 vaultRoot / 按键绑定。

宿主那一半是经过特性检测的：如果它要修补的服务或方法缺失（较旧的 DSH）或已移动（一次重构），插件会降级为惰性，而不是使 profile 失败。

安装

此插件没有 dsh.bundle 元数据，因此它不会*用 dsh plugin add 安装，也不会出现在侧边栏的插件页面——内置插件管理器只拥有 bundle。它由 profile 自己的补丁层以绝对路径作为普通插件模块加载 (~/.dsh/profiles/web/cordis.patch.yml)：

- insert:
- id: dsh-obsidian-bridge
name: file:///C:/Users/wuw/.dsh/profiles/web/dsh-obsidian-bridge/index.mjs

将 file:// URL 指向你存放此目录的位置，然后重新加载配置文件（HMR 会实时拾取补丁层）。

运行时文件（不在 git 中）

每次注入尝试时写入 index.mjs 旁边：

| 文件 | 用途 |
| inject-ledger.json | 抗压缩账本：每条已投递指令对应一个条目，以 sha256(path \| location \| instruction) 为键，外加每个会话的计数器。 |
| inject-log.jsonl | 仅追加的决策日志（action、reason、keyHits、sessionCount）；超过 256 KB 后截断。 |

两者都是每次安装的状态，且日志会记录会话活动——它们已列入 .gitignore，必须留在仓库之外。

注入限制

INJECT_LIMITS 防止重复选择变成循环：

{ ttlMs: 600000, maxKeyHits: 1, maxSessionInjections: 20, maxItems: 200 }

十分钟内每个键投递一次，每个会话最多 20 次，账本最多保留 200 个条目。

版本说明

| 版本 | 变更 |
| 2.6.x | 当前版本线；wikilink 渲染、路径 → Obsidian 点击、UI 状态 ping。 |
| 2.4.4 | 单次注入：编辑器指令通过一次性收件箱传递，而不是每一步都追加一条持久化的用户消息；新增账本和会话上限。 |
| 2.3.2 | 针对 DSH ≥ 0.1.2 跨站 iframe 内浏览器会话认证的嵌入器认证适配器。 |

备注

- 该插件仅通过加载器（行、钩子、一个 index.html 转换）以及 DSH Web 连接服务的认证判定来接触 DSH。无需修改 DSH 源代码，index.mjs 就是整个宿主端部分。
- 此处未声明 license 字段，因此该仓库不附带任何许可授权；发布前请添加一个。