dsh-hippo:把工作区、记忆与会话画成可旋转的神经元图

前言

在 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 关闭自动重扫。

典型用法

  1. 安装并重启 DSH,从侧栏打开「海马体」,先熟悉默认工作区与 ~/.dsh 形成的簇与连边。
  2. 若有笔记目录未出现在图中,在 ~/.dsh/dsh-hippo.json 的 sources 里增加 dir / group / label,或依赖面板「+ 工作区会话」补全会话路径。
  3. 需要与追溯结论对照时,配合 dsh-reason-tree 使用「定位至海马体」,在图中跳到对应节点后再点节点读原文。
  4. 会话较多时,用 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。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye