Skip to main content
2

dsh-bridge-connector

2090003781/dsh-bridge-connector

Loopback HTTP/SSE service that lets an Obsidian plugin drive DSH sessions (list, create, send) and inject up to ten vault notes into the system prompt; needs the companion Bridge plugin running inside Obsidian.

Install

dsh plugin --profile web add github:2090003781/dsh-bridge-connector

README

dsh-bridge-connector

Bridge 是一个插件的两头:一头插 Obsidian,一头插 DSH。

这一头那一头
本仓库:跑在 DSH 进程里的插件,在 127.0.0.1:8812 起回环 HTTP/SSE 服务obsidian-bridge:跑在 Obsidian 进程里的插件,把命令/编辑器/工作区/库读写暴露成本机 HTTP(8811)

两头都装才完整——只装一头没有对端。它让 Obsidian 面板能

  • 列出会话、向某个会话发消息、新建会话
  • 把库内笔记(最多 10 篇)挂进 DSH 的系统提示词段 bridge:context,每轮重新组装、不进对话历史
  • 读/切「注入」开关

它不是 Obsidian 本人:笔记的读写由 Bridge 插件(Obsidian 内部,8811)完成,这个连接器只负责跟 DSH 对话。

配套的 Obsidian 插件在 obsidian-bridge(它是 Obsidian 插件,不是 DSH 插件,所以不在本仓库)。只装这个连接器没有可对话的对端。

安装

市场里点安装即可。手动装:

dsh plugin --profile web add https://github.com/2090003781/dsh-bridge-connector/releases/latest/download/dsh-bridge-connector.tgz

没有发布到 npm(npm 现在要求发布时提供 2FA 验证码),所以走 GitHub Release 的预构建 tarball,安装时不需要构建。

装完重启 DSH。服务与 token 信息写在 ~/.dsh-bridge/connector.json。

端点

除 /health 外都要 x-bridge-token(或 Bearer)。

方法路径作用
GET/health服务身份、订阅数、注入开关
GET/sessions会话清单
GET/session?sessionId=单个会话详情
POST/task向会话发一条消息
POST/session新建会话
GET/POST/config读/写注入开关
GET/inject当前注入列表
POST/inject注入一篇(≤512KB,最多 10 篇,同标题覆盖)
POST/inject/clear清一篇(带 id)或全部
GET/eventsSSE 事件流

配置

键默认说明
port8812端口被占时自动向后找 5 个
host127.0.0.1只允许回环
injectionfalse首次启动的默认值;之后以 ~/.dsh-bridge/state.json 为准
injectionTtlMs0注入过期时间,0 = 永不过期(只能手动清)

行为说明

  • 注入写进系统提示词段(order 250),下一轮生效,不写入对话历史
  • 段是进程级的,所有会话共享(包括 QQ 那条线)
  • 注入开关会落盘,DSH 重启后保持上次状态
  • 注入内容有 512KB/篇 的预算:它在系统提示词里,每轮都要重发

测试

npm test

License

MIT

Related plugins