README file from
GithubBuddyBridge Deep
第三方 Obsidian 插件 · 通过 ACP 桥接 DeepSeek Harness (DSH) Unofficial Obsidian plugin · Bridges DeepSeek Harness via ACP
在 Obsidian 里直接和 DeepSeek Harness 对话：流式回复、思考过程、工具调用、多轮会话，并自动复用 DSH Web 的 API Key 与地址，开箱即用。
Chat with DeepSeek Harness inside Obsidian — streaming replies, thinking blocks, tool calls, multi-turn sessions, and zero-config reuse of your DSH Web API key & base URL.
功能 Features
| 功能 | Features |
|---|---|
| 流式聊天面板（停止 / 重试） | Streaming chat with stop / retry |
| 可折叠思考块与工具调用卡 | Collapsible thinking blocks & tool-call cards |
| 每对话一个 DSH 会话，多轮上下文连贯 | One DSH session per conversation, multi-turn context |
| 上下文注入：笔记路径 / 全文 / Vault 根路径（可开关） | Context injection: note path / full content / vault root (toggles) |
| 工具调用权限弹窗 | Permission modal for tool calls |
| 断链自动重连（指数退避） | Auto-reconnect with exponential backoff |
| 双语界面（简体中文 / English，跟随 Obsidian） | Bilingual UI (zh / en, follows Obsidian) |
| 自动读取 DSH Web 凭据与地址，零配置 | Auto-reads DSH Web API key & base URL — no manual setup |
| 会话分叉 / 附加笔记 / 上下文占用指示 | Fork conversations / attach notes / context usage meter |
| 设置与聊天记录导出 / 导入 | Export / import settings & chat history |
| 一键后端配置脚本 | One-click backend setup script |
安装 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\<you>\.dsh\profiles\acp\node_modules\@deepseek-ai\dsh-acp-demo\lib\bin.js -c C:\Users\<you>\.dsh\profiles\acp\cordis.yml
注意：
dsh --profile acp不会加载 ACP 服务器——demo 包不是 profile bundle，必须用上面的独立 bin 命令。
2. 安装插件本体
- 复制
main.js/manifest.json/styles.css到<你的Vault>/.obsidian/plugins/buddybridge-deep/ - Obsidian 设置 → 第三方插件 → 开启「BuddyBridge Deep」
- 设置页 →「DSH ACP 命令」填好启动命令 → 点「诊断连接」验证
配置 Configuration
设置 → BuddyBridge Deep：
| 项 | 说明 | Setting |
|---|---|---|
| DSH ACP 命令 | 启动 ACP stdio 服务器的命令 | ACP start command |
| DeepSeek API Key | 留空自动读取 DSH Web（~/.dsh/.credentials.yaml） | Auto-read from DSH Web when empty |
| DeepSeek Base URL | 留空自动读取 DSH Web（~/.dsh/settings.yaml），如火山方舟 | Auto-read from DSH Web when empty |
| 请求超时 | 单次请求超时秒数 | Request timeout |
| 上下文注入 | 笔记路径 / 全文 / Vault 根路径开关 | Context injection toggles |
| 外观 | 主色调 / 字体大小 | Primary color / font size |
| 界面语言 | 简体中文 / English / 跟随 Obsidian | Language |
| 管理 | 最大对话数 / 导出 / 导入 / 重置 | Max conversations / export / import / reset |
零配置凭据：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