dsh-hippo

中文文档
1.0.7发布于 2026/11/03MITES Module零依赖

海马体:把工作区文件、DSH 记忆和会话记录画成一张可交互的神经元网络,挂在侧栏随时翻。

原始使用文档
文档目录8 节
  1. 安装
  2. 它会读什么
  3. 会话也会进球里
  4. 配置
  5. 权限说明
  6. 和「根源追溯」联动
  7. 数据不出本机
  8. 许可

海马体(dsh-hippo)

把工作区文件、DSH 记忆和会话记录画成一张会转的神经元网络,挂在侧栏随时翻。

文件是簇心,每一条标题/列表项是节点,共同关键词把它们连成一张网。点节点看原文,滚轮缩放,拖拽旋转,双击聚焦单簇。

安装

dsh plugin --profile desktop add dsh-hippo

装完重启 DSH,左侧栏会出现「海马体」图标。

如果图里没看到某个工作区的会话,点面板右下角的「+ 工作区会话」,它会自动找出这台机器上的会话目录并补进配置,立刻生效,不需要重启。

它会读什么

默认来源:

来源说明
当前工作区DSH_WORKSPACE,没有就用 ~/Documents/deepseek-harness/default-workspace
~/.dshDSH 自己的记忆、人设、技能(profiles 目录除外)
会话记录~/.dsh/sessions 和 ~/.dsh/profiles/*/sessions,见下
追溯树~/.dsh/profiles/*/trace,也就是「根源追溯」的 md

只读 .md / .markdown / .txt,不碰 node_modules、附件、日志、缓存。

会话也会进球里

每次启动都会重新扫一遍会话文件,把每个会话解成:

  • 一个会话节点(标题取 DSH 记的会话名,没有就取你说的第一句话)
  • 最多 8 条条目节点(你说过的话,去掉了系统注入的说明文字)

会话文件是追加式多帧 zstd,插件按帧切分逐个解压,解析结果按「大小 + 修改时间」缓存到 ~/.dsh/dsh-hippo/session-cache.json,没变的文件不重复解。

所以每次重启 DSH,新会话和相关文件都会自动重新整理进去,不用手动触发。

标题一律做成中文短句:剥掉盘符路径、文件后缀、XML 标签和聊天记录时间戳;英文占比太高时按内置词表翻译;翻不出来的用「会话 · 日期」兜底。

配置

~/.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 关掉自动重扫。

权限说明

这个插件只读文件、只注册自己的 HTTP 路由,没有杀进程、没有启动外部程序的接口。

  • /dsh-hippo/add-source 只会把「家目录 / ~/.dsh / 工作区 / 已有数据源」底下的目录写进配置,其他路径直接 403。
  • /dsh-hippo/node 只读图里已经扫到的文件,不接受任意路径。

和「根源追溯」联动

装 dsh-reason-tree 之后,在追溯面板里点「定位至海马体」,海马体会自动飞到对应的文件或那一条结论上。如果那条 md 不在扫描范围内,海马体会把它所在的目录补进数据源再重拉一次图。

联动走 localStorage + window 自定义事件,不需要两个插件互相 import。

数据不出本机

所有解析都在本地内存里做,不上传任何东西。插件本身不带任何用户数据,读什么完全取决于你机器上的目录。

许可

MIT

版本与发布记录

dsh-hippo 共发布 9 个版本,首次发布于 2026/11/02;过去 12 个月发布了 9 个版本。

版本发布日期距今
1.0.7latest2026/11/03今天
1.0.6beta2026/11/03今天
1.0.52026/11/03今天
1.0.42026/11/03今天
1.0.32026/11/031 天前
1.0.22026/11/031 天前

关于 dsh-hippo 的常见问题

dsh-hippo 是什么?

海马体:把工作区文件、DSH 记忆和会话记录画成一张可交互的神经元网络,挂在侧栏随时翻。

如何安装 dsh-hippo?

在项目目录运行 npm install dsh-hippo,或使用 pnpm add / yarn add / bun add。

dsh-hippo 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-hippo 是否存在。

dsh-hippo 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-hippo 可以商用吗?

dsh-hippo 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-hippo 还在维护吗?

最新版本 1.0.7 发布于 2026/11/03(今天);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/11/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。