前言¶
在使用 DeepSeek Harness（DSH）构建智能体时，记忆模块往往以文件或向量库形式存在，关系结构散落在代码或数据库中。开发者很难直观地看到这些记忆单元之间的关联，也很难快速定位某个概念在记忆系统中的位置。dsh-brain-viewer 在左侧边栏提供入口，把一个 Markdown 知识库转换成脑形的关系图，直观展示记忆单元之间的连接。
是什么¶
dsh-brain-viewer 是一个为 DeepSeek Harness 提供的 AI brain viewer 插件：左侧边栏底部会出现一个 🧠 AI Brain 按钮，点击后展开全屏的脑形关系图。插件内置了一个 Markdown 知识库管道，支持扫描工作区（md/docx/xlsx），将文档切分为记忆单元，写入与 Obsidian 兼容的 [[wiki-link]] 格式笔记，并生成对应的图。
插件由 vamyane 维护，版本为 0.2.2，许可证为 MIT。
核心功能¶
左侧边栏入口¶
插件安装后，重启 DSH。左侧边栏底部会出现 🧠 AI Brain 按钮。点击该按钮会打开一个全屏的面板，展示当前的知识图谱。
脑形布局¶
- 图谱采用大脑轮廓形状，节点分布模拟簇中心与漂移神经元。
- 支持鼠标悬停高亮，拖拽节点时具有反弹效果。
- 突触脉冲效果在节点之间传递。
- 大规模图谱（超过 2500 个节点）会自动限制帧率，在 DPR 1.25 时保持约 30 fps，并自动降级到 20 fps 以保证流畅度。
知识库管道¶
插件自带 brain/ 目录，包含完整的 Markdown 知识库处理流程：
- 扫描工作区：支持 md、docx、xlsx 格式的文件。
- 切分文档：将文档拆分为记忆单元。
- 生成笔记：写入与 Obsidian 兼容的 [[wiki-link]] 格式到
brain/vault/。 - 编译图谱：生成
app/brain.html并嵌入到lib/client.js。
Demo 数据¶
插件随包分发一个通用 demo vault，安装后可直接查看效果，无需准备数据。
近实时同步¶
插件提供 watch 工具，监听 Markdown vault 或文档文件夹的变化。修改被防抖（2.5 秒），图谱在约 1-3 秒内重建，并更新 app/brain.html。刷新 DSH 页面即可看到新节点。
安装与启用¶
使用官方安装命令：
dsh plugin --profile desktop add dsh-brain-viewer
安装完成后完全退出并重新打开 DSH，左侧边栏底部会出现 🧠 AI Brain 按钮。
构建自己的知识图谱¶
环境要求¶
- Node.js 20+
- Python 3.8+（仅用于重建，查看器本身不依赖 Python）
重建命令¶
在已安装的插件目录或本地检出目录中执行：
# 扫描自己的文件夹生成图谱
node tools/rebuild.mjs --workspace "D:/my-notes"
# 恢复 demo 脑图
node tools/rebuild.mjs --demo
重建完成后刷新 DSH 页面。如果未生效，重启 DSH 一次。
近实时监听¶
监听 Markdown vault¶
node tools/watch.mjs --vault "C:/path/to/vault"
监听文档文件夹¶
node tools/watch.mjs --workspace "D:/my-notes"
修改被防抖（2.5 秒），图谱在约 1-3 秒内重建，刷新页面即可看到更新。
性能与隐私¶
client.js以 gzip+base64 嵌入方式打包，文件体积从 3.6 MB 减少到约 1 MB，仅在面板打开时解压。- 大规模图谱启用视口剔除、缓存 sprite、页面隐藏时暂停渲染。
- 关闭面板时会卸载 iframe，空闲时不再占用 CPU。
- Demo vault 由通用内容生成（
brain/seed_demo.py）。 tools/rebuild.mjs --workspace仅读取本地文件，不上传。- 图谱在 iframe 中通过本地 Blob URL 渲染，不发起网络请求。
卸载¶
dsh plugin --profile desktop remove dsh-brain-viewer
或删除配置文件中的 dsh.profile.bundles 中的 dsh-brain-viewer 条目。
常见问题：侧边栏按钮消失¶
DSH 在每次启动时运行 pnpm install。如果插件仅存在于 dsh.profile.bundles 而未记录在 dependencies，pnpm 会将其移至 node_modules/.ignored/，导致侧边栏按钮消失。
正确安装流程：
- 将插件保持在
<profile>/local-plugins/dsh-brain-viewer。 - 在
dependencies中记录"dsh-brain-viewer": "link:./local-plugins/dsh-brain-viewer"。 - 运行
pnpm install，让 lockfile 记录链接。 - 重启 DSH。
如遇 minimumReleaseAge / supply-chain 政策报错（依赖包在镜像清单中缺失），可在 profile 的 pnpm-workspace.yaml 中添加到 minimumReleaseAgeExclude。
适用场景与注意¶
适合需要将本地 Markdown 文档库可视化、快速定位记忆单元之间关系、在开发过程中查看 DSH 知识库结构的开发者。
使用前建议检查插件源码与许可证。插件以当前 DSH 进程权限运行，请确保信任其行为。
总结¶
dsh-brain-viewer 把一个文件夹的 Markdown 笔记变成脑形关系图，与 Obsidian 的 [[wiki-link]] 兼容，支持近实时同步。它降低了查看知识库结构的心智负担，适合需要频繁回顾记忆单元关联的 DSH 使用者。
- 插件目录页：https://www.skillhub.cn/plugins/vamyane/dsh-brain-viewer
- GitHub 仓库：https://github.com/vamyane/dsh-brain-viewer
