dsh-obsidian-board：把本地 Obsidian 变成 DSH 的本地知识库对话面板

下面介绍 dsh-obsidian-board。这是一个 DeepSeek Harness (DSH) 插件，它将本地的 Obsidian vault 变成一个专门的 RAG 对话面板。该插件属于“双半插件”：宿主端负责文件索引和 BM25 检索，浏览器端负责 UI 渲染和交互。

核心能力¶

本地检索与索引
检索完全在本地运行，使用 BM25 算法配合 CJK 大二分词。基于文件修改时间（mtime）进行增量索引，处理 10,000 个笔记的库时，全量扫描耗时不到 1 秒，增量更新约 50 毫秒。支持标题和路径权重提升。

引用与交互
回答中包含 [n] 引用标记或下方的芯片。点击这些标记或芯片，可以在右侧源面板中打开对应的笔记。源面板宽度可拖拽调整，双击可重置。

输出与控制
停止按钮在检索、规划、生成（包括模型静默期）阶段均有效。停止后的回复显示为中性状态，而非报错。回答中断后会标记为“interrupted”并提供重试按钮。

隔离与安全
面板历史记录存储在浏览器本地命名空间，不会写入 DSH 的主会话日志。第三方材料（如公网收集、vendor 目录）会被降权，优先检索用户自己的笔记。无网络依赖，不包含嵌入模型。

安装与启用¶

先执行安装命令：

dsh plugin --profile web add "dsh-obsidian-board"

桌面端用户需将 --profile web 替换为 --profile desktop。

配置与使用¶

在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中配置 vault 路径：

- insert:
    - id: dsh-obsidian-board
      name: dsh-obsidian-board
      config:
        vaultPath: "D:\\notes\\MyVault"   # 绝对路径，~ 也可用
        topK: 8                           # 每次引用的块数
        chunkLimit: 1200                  # 单个块的字符限制

配置完成后，在 DSH 侧边栏的“Panels”组中点击 Obsidian。首次点击会弹出目录选择器或设置卡片，选择或输入本地 vault 路径即可建立连接。

典型用法如下：
1. 询问笔记内容："我的笔记里关于 X 是什么？"
2. 总结特定内容："总结 #tag 下的观点"
3. 点击回答中的 [1] 或下方芯片，打开右侧源面板查看原文。

注意事项¶

• 检索机制：目前仅支持 BM25 检索，不支持语义嵌入搜索。
• 历史记录：面板历史存储在浏览器本地，重启 DSH 宿主后，历史会从宿主内存恢复。
• 依赖要求：需要 @deepseek-ai/dsh-typert-protocol >= 0.1.5-rc.1。