seek://map/obsidian-dsh-acp
Obsidian 桥(Agent Client 接入)
#acp #obsidian #client
TL;DR
把 DeepSeek Harness 接进 Obsidian 的 ACP 适配器:在 Agent Client 插件里注册为 Custom Agent,每轮以 headless 一次性任务执行并流式回传输出;自带持久会话层(列表/分支/删除/续接)与 DSH 形状的回合归档,install.sh 可一步装好 DSH profile 与 Obsidian。
Obsidian 用户不必切出编辑器也能用上 DeepSeek Harness:适配器以 stdin/stdout 讲 ACP,被 Agent Client 插件作为 Custom Agent 拉起,每轮 prompt 执行 headless 任务,输出流式回到聊天面板。在无状态单回合之上,它还维护磁盘上的持久会话存储(列表、分支、删除、续接),并把每个完成的回合写成 DSH 形状的归档。
速览
- install
- dsh plugin --profile web add obsidian-dsh-acp
- license
- MIT
- note
- 需在 Obsidian 安装 Agent Client 社区插件并把 nodePath 指到真实 node 可执行文件,shebang 才能解析。
要点
- 在 Obsidian Agent Client 插件里注册为 Custom Agent,每轮 prompt 拉起 dsh --profile headless 执行,输出以 agent_message_chunk 流式回传、以 end_turn 收尾
- 持久会话层:session/list 从磁盘 JSON 索引重载真实会话,session/fork 深拷贝历史并记录父链接,session/delete 连磁盘归档一并清理,另支持 resume/load
- 每个完成的回合(用户与助手)都追加写入 DSH 形状的事件归档,落在 dsh-acp-archives/ 下,避开主进程 zstd 压缩的 sessions/ 日志
- 随包附带 install.sh 一键安装:幂等、改文件前先备份、支持任意 vault 与 --dry-run 预演;也可以按 README 步骤在 Obsidian 里手动配置 Custom Agent
常见问题
它和本 map 已收录的 ACP 桥(Zed 等编辑器接入)是什么关系?
deepseek-harness-acp 面向 Zed 等通用 ACP 客户端,把完整 DSH agent 放进这些客户端并共享 DSH 凭据与会话;本项目专为 Obsidian Agent Client 而写,据其 README,每轮 prompt 拉起 dsh --profile headless,并自带磁盘上的持久会话索引与回合归档——两者是不同仓库。
需要什么环境?
需要 Node.js 22.13 或更新版本,且 dsh 后端可正常启动;据其 README,headless profile 需能解析到默认模型提供商,全局 settings 只配 web 专用 provider 时要给它单独的设置。
npm 包现在能直接装吗?
可以——npm 包已发布;本站 2026-09-22 探测 registry 读得 0.2.3。据其 README,安装命令是 dsh plugin --profile web add obsidian-dsh-acp。
会话数据存在哪,会和 DSH 自身会话冲突吗?
持久索引默认在 ~/.dsh-acp/dsh-acp-sessions.json;回合归档写在 <DSH_HOME>/dsh-acp-archives/<编码后 cwd>/session-<id>/session.jsonl,刻意放在主进程 sessions/ 之外,避免与 zstd 压缩日志冲突;session/delete 会把记录与磁盘归档一起清掉。
官方参考