ben4202121/buddybridge-deep

BuddyBridge Deep

第三方 Obsidian 插件 · 通过 ACP 桥接 DeepSeek Harness (DSH)
非官方 Obsidian 插件 · 通过 ACP 桥接 DeepSeek Harness

在 Obsidian 里直接和 DeepSeek Harness 对话：流式回复、思考过程、工具调用、多轮会话，并自动复用 DSH Web 的 API Key 与地址，开箱即用。

在 Obsidian 内与 DeepSeek Harness 对话——流式回复、思考块、工具调用、多轮会话，并零配置复用你的 DSH Web API Key 与 Base URL。

功能 Features

| 功能 | Features |
| :--- | :--- |
| 流式聊天面板（停止 / 重试） | 流式聊天，支持停止 / 重试 |
| 可折叠思考块与工具调用卡 | 可折叠的思考块与工具调用卡 |
| 每对话一个 DSH 会话，多轮上下文连贯 | 每个对话一个 DSH 会话，多轮上下文连贯 |
| 上下文注入：笔记路径 / 全文 / Vault 根路径（可开关） | 上下文注入：笔记路径 / 全文 / Vault 根路径（可开关） |
| 工具调用权限弹窗 | 工具调用权限弹窗 |
| 断链自动重连（指数退避） | 断链自动重连（指数退避） |
| 双语界面（简体中文 / English，跟随 Obsidian） | 双语界面（简体中文 / English，跟随 Obsidian） |
| 自动读取 DSH Web 凭据与地址，零配置 | 自动读取 DSH Web API Key 与 Base URL——无需手动设置 |
| 会话分叉 / 附加笔记 / 上下文占用指示 | 会话分叉 / 附加笔记 / 上下文占用指示 |
| 设置与聊天记录导出 / 导入 | 导出 / 导入设置与聊天记录 |
| 一键后端配置脚本 | 一键后端配置脚本 |

安装 Installation

1. 前置：DeepSeek Harness + ACP profile

本插件通过标准 ACP (Agent Client Protocol) stdio JSON-RPC 与 DSH 通信，需要本机已安装
DeepSeek Harness（dsh）并装配 ACP profile。

已装 dsh 的用户可一键装配（推荐）：

powershell -ExecutionPolicy Bypass -File scripts/setup-acp.ps1

脚本会自动安装配套的 @deepseek-ai/dsh-acp-demo 到 ~/.dsh/profiles/acp、编译 koffi 原生库并生成
cordis.yml，最后打印实际启动命令，形如：

node C:\Users\\.dsh\profiles\acp\node_modules\@deepseek-ai\dsh-acp-demo\lib\bin.js -c C:\Users\\.dsh\profiles\acp\cordis.yml

注意：dsh --profile acp 不会加载 ACP 服务器——demo 包不是 profile bundle，必须用上面的独立 bin 命令。

2. 安装插件本体

1. 复制 main.js / manifest.json / styles.css 到 /.obsidian/plugins/buddybridge-deep/
2. Obsidian 设置 → 第三方插件 → 开启「BuddyBridge Deep」
3. 设置页 →「DSH ACP 命令」填好启动命令 → 点「诊断连接」验证

配置 Configuration

设置 → BuddyBridge Deep：

| 项 | 说明 | Setting |
| :--- | :--- | :--- |
| DSH ACP 命令 | 启动 ACP stdio 服务器的命令 | ACP 启动命令 |
| DeepSeek API Key | 留空自动读取 DSH Web（~/.dsh/.credentials.yaml） | 留空时自动从 DSH Web 读取 |
| DeepSeek Base URL | 留空自动读取 DSH Web（~/.dsh/settings.yaml），如火山方舟 | 留空时自动从 DSH Web 读取 |
| 请求超时 | 单次请求超时秒数 | 请求超时 |
| 上下文注入 | 笔记路径 / 全文 / Vault 根路径开关 | 上下文注入开关 |
| 外观 | 主色调 / 字体大小 | 主色调 / 字体大小 |
| 界面语言 | 简体中文 / English / 跟随 Obsidian | 语言 |
| 管理 | 最大对话数 / 导出 / 导入 / 重置 | 最大对话数 / 导出 / 导入 / 重置 |

零配置凭据：DSH Web 已能对话的话，插件会直接复用它的 API Key 与 Base URL（读
~/.dsh/.credentials.yaml 与 ~/.dsh/settings.yaml），无需在插件里重复填写。

开发 Development

npm install          # 安装依赖
npm run build        # tsc 类型检查 + esbuild 打包 → main.js
npm test             # jest：239 个用例（含 ACP 客户端端到端集成测试），80% 覆盖率门禁
npm run dev          # 监听模式（esbuild --watch）

独立冒烟脚本（不依赖 Obsidian）：

node scripts/acp-smoke.mjs --command "dsh --profile acp" --cwd "C:\your\vault"

架构 Architecture

src/
├── core/                # 共享抽象层：bridge-adapter / stream-chunk / vault-tools
│   ├── dsh-env.ts       # DSH 全局 .env 读写（~/.dsh/.env）
│   └── dsh-shared.ts    # 自动读取 DSH Web 凭据与地址（credentials.yaml / settings.yaml）
├── bridges/deep/        # DeepSeek 适配层：ACP JSON-RPC stdio 客户端 + 命令解析
├── chat/manager.ts      # 会话管理
├── settings/            # 设置页、确认/权限弹窗、诊断、一键后端配置
├── views/chat.ts        # 聊天视图（流式、思考/工具块、错误卡重试）
├── context.ts / io.ts   # 上下文注入 / 导出导入
└── main.ts              # 插件入口

已知限制 Known Limitations

- 官方 @deepseek-ai/dsh-acp 自动化仅支持 fresh sessions：无 session/load / session/list / session/fork（插件重载后每对话新建会话）。
- 权限「始终允许」依赖服务器是否提供 allow_always 选项（官方默认仅 allow-once / reject-once）。
- 思考过程是否可见取决于 ACP 服务器是否发送 agent_thought_chunk。

License

MIT