前言¶
DeepSeek Harness (DSH) 是一個本地運行的智能體開發與運行框架，而 Obsidian 是一款功能強大的本地知識管理與筆記工具。obsidian-dsh-acp 的核心作用是作爲一個 ACP (Agent Client Protocol) 服務器，將 DSH 的能力橋接到 Obsidian 的 Agent Client 插件中。通過這個適配器，用戶可以在 Obsidian 的原生界面中直接驅動 DSH，執行任務、管理會話，而無需在瀏覽器中操作 DSH 的 Web 界面。
核心能力¶
該插件提供以下主要功能：
- ACP 服務器與集成：提供 ACP v1 協議支持（通過 stdin/stdout），作爲中間層連接 Obsidian Agent Client 和 DSH 的 headless 模式。
- 會話管理：支持會話列表、恢復、加載、分叉和刪除。會話數據持久化存儲在本地 JSON 文件中（默認路徑），支持跨重啓加載。
- 工具調用幀：支持在 Obsidian 中顯示工具調用狀態（
in_progress->completed），並展示 token 使用量。 - 會話模型切換：允許在會話級別切換模型（如 DeepSeek-V4-Flash, Kimi-K2.6 等），該配置僅對當前會話生效，不影響共享配置文件。
- 會話摘要預覽：每輪對話後自動生成摘要並存儲，在會話列表中可預覽對話內容。
- 外部會話導入：支持導入其他 ACP 代理（如 claude-agent-acp）導出的會話數據，將其轉化爲 DSH 格式存儲。
- DSH Web 會話管理面板：提供額外的 Web 界面用於管理會話、查看歸檔和執行導入操作。
安裝與配置¶
在使用前，請確保環境滿足以下依賴：
* Node.js >= 22.13
* DeepSeek Harness (dsh) >= 0.1.5-rc.3
安裝方式主要有兩種：
-
在 Obsidian 中配置：
將其配置爲 Obsidian Agent Client 插件中的“自定義代理”。 -
在 DSH 配置文件中安裝：
使用以下命令將插件作爲 cordis 插件添加到指定的 DSH 配置文件中：
dsh plugin --profile <name> add obsidian-dsh-acp
插件包含一個名爲 `dsh-acp` 的可執行文件（二進制）。
使用示例¶
- 導入外部會話：
使用命令行工具導入外部 ACP 會話文件：
node dsh-acp.mjs import <session.json> [--title '..'] [--cwd /path]
或者在 dsh-acp 會話中直接發送命令 `/import /path/to/claude-session.json`。
注意事項¶
- 官方橋接限制：雖然代碼包含官方橋接支持，但需要設置
DSH_ACP_USE_OFFICIAL_BRIDGE=1。目前該功能在典型的 dsh web 配置文件中無法使用。 - 許可證：插件遵循 MIT 許可證。
- 來源：該插件由 SilenZerOrz 開發，可在 GitHub 獲取源碼。
