前言¶
在 DeepSeek Harness(DSH)里长期开发时,工作区 Markdown、.dsh 下的记忆与人设、以及按会话追加的聊天记录会分散在多个目录里。用文件树或全文搜索可以定位单篇内容,但很难一眼看出「哪些笔记、哪几次对话在讲同一件事」。下面介绍的 dsh-hippo(侧栏名「海马体」)把这些只读来源汇总后,用文件作簇心、标题与列表项作节点、共同关键词作连边,在侧栏渲染一张可交互的神经元网络,便于浏览与跳转原文。
这是什么¶
dsh-hippo 是 DSH 社区插件,分类为「记忆」。维护者 Snerou,源码与说明见 GitHub:Snerou/dsh-hippo,目录页见 skillhub.cn/plugins/Snerou/dsh-hippo。插件把工作区文件、DSH 记忆和过去会话渲染为可旋转的神经元图(Hippocampus for DeepSeek Harness),数据仅在本地解析,不上传。
核心功能¶
图怎么建¶
- 文件为簇:每个被扫描到的
.md/.markdown/.txt文件形成一个簇;簇内节点来自文档标题与列表项。 - 关键词连边:不同节点若共享关键词,会在图中连成网络。
- 交互:点击节点查看原文;滚轮缩放;拖拽旋转整张图;双击聚焦单个簇。
默认读哪些目录¶
插件只读文本,跳过 node_modules、附件、日志与缓存。
| 来源 | 说明 |
|---|---|
| 当前工作区 | 环境变量 DSH_WORKSPACE;未设置时使用 ~/Documents/deepseek-harness/default-workspace |
~/.dsh |
DSH 记忆、人设、技能等(不含 profiles 目录本身) |
| 会话 | ~/.dsh/sessions 与 ~/.dsh/profiles/*/sessions |
| 追溯树 | ~/.dsh/profiles/*/trace(「根源追溯」产生的 md) |
会话如何进图¶
每次启动 DSH 会重新扫描会话文件。每个会话解析为:
- 一个会话节点(标题优先用 DSH 记录的会话名,否则取用户第一句话);
- 最多 8 条条目节点(用户发言,已去掉系统注入说明)。
会话文件为追加式多帧 zstd;插件按帧解压,结果按「大小 + 修改时间」缓存到 ~/.dsh/dsh-hippo/session-cache.json,未变更的文件不重复解压。因此重启 DSH 后,新会话与新文件会自动纳入图中,无需手动刷新。
图中标题会规范为中文短句:去掉盘符路径、后缀、XML 标签与聊天时间戳;英文占比高时按内置词表翻译;无法翻译时用「会话 · 日期」兜底。
与 dsh-reason-tree 联动¶
安装 dsh-reason-tree 后,在追溯面板点击「定位至海马体」,海马体会定位到对应文件或结论节点。若该 md 不在当前扫描范围,插件会把其所在目录补进数据源并重拉图。联动通过 localStorage 与 window 自定义事件完成,两插件无需互相 import。
安装与启用¶
在 desktop profile 下执行官方安装命令:
dsh plugin --profile desktop add dsh-hippo
安装完成后重启 DSH,左侧栏会出现「海马体」图标。
若图中缺少某工作区的会话,可在面板右下角点击「+ 工作区会话」。插件会自动发现本机会话目录并写入配置,立即生效,无需再次重启。
配置¶
可选配置文件:~/.dsh/dsh-hippo.json(不存在则使用默认值)。
{
"sources": [
{ "dir": "D:/notes", "group": "note", "label": "笔记" },
{ "dir": "D:/diary", "group": "diary", "label": "日记" }
],
"sessionDirs": ["C:/Users/me/.dsh/sessions"],
"sessions": { "enabled": true, "limit": 60 },
"scanIntervalSec": 60
}
sources:额外扫描目录;group影响颜色分组,label为分组显示名。sessionDirs:额外会话目录(「+ 工作区会话」也会写入此处)。sessions.limit:最多加载会话数(按时间新到旧);设为0或enabled: false可关闭会话进图。scanIntervalSec:后台重扫间隔(秒),默认 60;设为0关闭自动重扫。
典型用法¶
- 安装并重启 DSH,从侧栏打开「海马体」,先熟悉默认工作区与
~/.dsh形成的簇与连边。 - 若有笔记目录未出现在图中,在
~/.dsh/dsh-hippo.json的sources里增加dir/group/label,或依赖面板「+ 工作区会话」补全会话路径。 - 需要与追溯结论对照时,配合 dsh-reason-tree 使用「定位至海马体」,在图中跳到对应节点后再点节点读原文。
- 会话较多时,用
sessions.limit限制数量,避免图过大;需要更实时刷新时调整scanIntervalSec(设为 0 则仅依赖启动时与手动触发逻辑)。
权限、安全与适用场景¶
插件只读本地文件,并注册自有 HTTP 路由;资料说明其没有杀进程或启动外部程序的接口。
/dsh-hippo/add-source仅允许将家目录、~/.dsh、工作区或已有数据源下的目录写入配置,其他路径返回 403。/dsh-hippo/node只读取图中已扫描到的文件,不接受任意路径参数。
所有解析在本地内存完成,插件包内不含用户数据;读哪些目录取决于你本机配置与磁盘内容。DSH 生态强调「一切皆插件」;社区目录站点与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看源码与 MIT 许可证。插件以当前 DSH 进程权限运行,能读到的路径与进程用户一致。
适合:希望在同一视图里关联工作区文档、DSH 记忆、历史会话与追溯 md 的 DSH 桌面用户。不适合:需要写回或修改记忆文件的场景(本插件只读)。
结尾¶
dsh-hippo 把分散的 Markdown 与会话整理成可旋转、可聚焦的神经元图,并支持与会话缓存、可选数据源及 reason-tree 定位联动。进一步了解可访问目录页 https://www.skillhub.cn/plugins/Snerou/dsh-hippo 与仓库 https://github.com/Snerou/dsh-hippo。