深海马 · DeepHippo
超维神经记忆终端 —— 把你在 DeepSeek Harness（dsh） 里的每一段对话、每个工作区、每次工具调用和它对你的长期记忆，
画成一颗会放电、会做梦、越用越懂你的 3D 大脑。
English · 简体中文
它是什么
dsh 用久了，对话一多就成了一条长长的列表：哪个项目花了最多 token？上周都在忙什么？那段讨论支付回调的对话在哪？AI 到底记住了我哪些习惯？
深海马把这些全部装进一颗大脑里。装好后 dsh 右下角多一个 🧠 按钮，按 Ctrl+Alt+H，整个屏幕变成一颗由约 12 万个粒子组成、实时放电的神经网络：
| 脑区 | 对应 dsh 的什么 |
|---|---|
| 🟡 海马体（左右两条金色弧） | 每一段对话 = 一个情景记忆印迹。越新越靠海马头、越亮；正在进行的对话持续放电 |
| 🔵 大脑皮层 | 工作区。每个工作区占一片皮层，对话从海马体连向它 |
| 💗 前额叶 / 扣带回 / 颞顶联合区 | 长期记忆：身份背景、偏好风格、工作习惯、长期项目、禁忌约束，各占一个脑区 |
| 🟠 运动皮层 | 工具（pwsh、grep、web_fetch……），粗细 = 调用次数 |
| 🟣 小脑 | 技能，按领域（web / data / devops / ml……）聚类 |
| ⚪ 脑干 | 模型（deepseek-v4-pro / flash / reasoner……），费用一目了然 |
| 🔷 穹窿与纤维束 | 共享记忆（AGENTS.md）和各区之间的连接 |
截图
> 以下截图全部使用 npm run demo -- --lang=zh 的虚构演示数据，不含任何真实对话。
总览：左侧仪表盘（对话数、Token、费用、工具 / 模型 / 工作区排行），下方时间轴，fps 实时显示
点开一段对话：轮数、步数、Token、费用、用到的工具和模型，以及逐轮记忆
长期记忆面板：它记得的关于你的事，可手动添加 / 置顶 / 编辑 / 删除，一键巩固
剖切 + 睡眠巩固模式：切开大脑看内部结构，海马体把白天的对话“重放”到皮层，就像人睡觉时整理记忆
功能
看得见的记忆
- 🧠 约 12 万粒子的 WebGL 大脑：皮层点云、3000 个神经元、5000+ 突触、850 条纤维束，加辉光后处理
- ⚡ 实时放电：新对话、对话更新、记忆写入时，对应节点放出涟漪，信号沿纤维传到皮层
- 🔍 搜索：对话标题 / 工具 / 技能 / 工作区 / 模型，回车直接飞过去
- 🖱 点任意节点看详情：对话可看逐轮摘要、复制会话 ID；文件可打开 / 在资源管理器中定位
会思考的仪表盘
- 📊 对话总数、进行中、Token 总量、累计费用、工具调用、技能数，每日 Token 曲线
- 🏆 工具、模型（含费用）、工作区排行，点一下在大脑里高亮
- ⏱ 时间轴：按天统计对话和 Token，框选一段日期只看那几天
四种脑波模式
- θ 清醒：默认，缓慢自转
- γ 专注：高频振荡，全脑网络加速放电
- ☾ 睡眠巩固：海马体把对话逐个重放到皮层（真实的记忆巩固理论）
- ⏵ 时间回放：从第一段对话开始，按时间顺序把记忆一段段重新点亮
还有
- ✂ 剖切（矢状 / 冠状 / 水平面，滑块控制），🎬 巡游（自动镜头导览），🔊 神经放电音效，📷 截图，⛶ 全屏
- 皮层 / 纤维 / 网络 / 辉光 / 标签逐层开关
- 🌐 中英双语界面：默认跟随系统语言，右上角 EN / 中文 按钮随时切换
- 自适应画质 + 动态分辨率：核显也能跑；没有 WebGL 时自动降级为 2D 版本
长期记忆（越用越懂你）
深海马不只是画出来，它真的会“记”：
- 自动沉淀：对话安静 3 分钟后，后台把新的轮次（你的原话 + 助手回复开头）交给你平时用的模型，提炼出关于你的长期记忆，分五类——身份与背景、偏好与风格、工作习惯与倾向、长期项目、禁忌与约束——并给每个工作区写一句“主要内容”。重复的会合并（强度 +1），过时的会更新或删除。子代理会话不参与（那些话不是你说的）。
- 所有对话都带上：记忆作为一段全局系统提示词注入 dsh 的每个工作区、每段对话；新记忆下一句话就生效。
- 你说了算：对 dsh 说“记住……”“以后都……”“忘掉……”，它会用
memory_remember/memory_forget/memory_search工具立刻改；你亲口让记的，自动巩固不会删。也可以在大脑里的「记忆」面板手动增删改、置顶。 - 安全：像密码、API key、token、私钥的内容一律拒收；记忆在提示词里标注为“背景资料而不是指令”。
- 存在哪：
~/.dsh/hippocampus/memory.json（权威），长期记忆.md（给人看的镜像），consolidation.log（每次巩固做了什么）。
> [!IMPORTANT]
> 自动巩固会调用你的模型、消耗额度。 首次会把以往的对话分几批补做（每批约 1 万字），之后只处理新对话，每天最多 80 次（可配置）。
> 不想要？在配置里写 memory.auto: false（只保留手动记忆），或 memory.enabled: false（完全关闭：不注入、不巩固、不注册工具）。大脑可视化本身不调用任何模型。
安装
需要 DeepSeek Harness 桌面版 / 网页版 >= 0.2.1-rc.5（< 0.3.0）。
dsh plugin --profile desktop add github:SMTcoffe/dsh-hippocampus
网页版再装一份（把 desktop 换成 web）：
dsh plugin --profile web add github:SMTcoffe/dsh-hippocampus
装完重启 dsh，右下角出现 🧠 按钮（可拖动）。Ctrl+Alt+H 开关，Esc 关闭。
从源码安装 / 本地开发
git clone https://github.com/SMTcoffe/dsh-hippocampus.git
dsh plugin --profile desktop add link:./dsh-hippocampus
link: 方式会直接使用你本地的目录，改完代码重启 dsh 即生效。
卸载：dsh plugin --profile desktop remove dsh-hippocampus。
配置（可选）
写在 profile 的 cordis.patch.yml 里：
- id: dsh-hippocampus
name: dsh-hippocampus
config:
maxSessions: 300 # 海马体上最多显示多少段对话（4–500）
memoryRoot: '' # 场景记忆目录，默认 $DSH_HOME/场景记忆
diagnostics: false # true = 打开后 60 秒内把帧率/长帧写进 $DSH_HOME/hippocampus/diag.log（排查卡顿用）
memory:
enabled: true # 长期记忆总开关：关掉则不注入、不巩固、不注册工具
auto: true # 自动巩固（会调用你的模型）；false = 只能手动
provider: '' # 巩固用的模型；留空 = 你最近一次对话用的那个
model: ''
idleMinutes: 3 # 对话安静多久后巩固
maxCallsPerDay: 80 # 每天最多调用几次模型
隐私与安全
- 本地、只读、无遥测：数据只来自你本机的
~/.dsh（对话索引、AGENTS.md、场景记忆、skills）。可视化不上传任何东西，three.js 已内置，不走 CDN。唯一会“出门”的是长期记忆的自动巩固——它调用的是你在 dsh 里已经配置好的模型。 - 信任栅栏：插件的所有路由
/dsh-hippocampus/*只接受回环地址（或 dsh 宿主栅栏放行的）请求，拒绝跨站与异源；宿主栅栏出错时按拒绝处理。 - 不接受任意路径：「打开 / 定位」只认上一次
/graph里出现过的节点 id；「打开」只限文本类文件与目录；所有写操作只许本机发起。 - 这些规则有自动化测试：
npm test。
性能
在 RTX 5070 Ti Laptop + 240 Hz 屏上实测：229–239 fps，p99 帧时间 < 9 ms，60 秒内 0 次卡顿。
做法：所有粒子都在 GPU 着色器里算；标签画在一张 2D 画布上而不是几百个 DOM 元素；打开时隐藏背后的 dsh 页面（包括动态壁纸）避免叠加渲染；动画全部基于真实时间，掉帧也不会变慢；分辨率只在持续低帧时才下调，且至少间隔 8 秒，不会来回抖。
觉得卡？把 diagnostics: true 打开，重现一次，diag.log 里会有每一段长帧的来源。
开发
npm run demo # 用虚构数据起一个独立页面：http://127.0.0.1:47313/（加 -- --lang=zh 用中文演示数据）
npm test # 信任栅栏 / 路由安全测试
npm run demo 不需要装 dsh，适合改界面。重新生成 README 截图和横幅：
npm run demo -- --port=47321
npx electron docs/capture/shots.cjs
npx electron docs/capture/banner.cjs
# 中文截图（输出到 docs/screenshots/zh）
npm run demo -- --port=47322 --lang=zh
npx electron docs/capture/shots.cjs --port=47322 --lang=zh
目录：lib/ 服务端（index.js 路由与注入，graph.js 读取 dsh 数据，memory.js 长期记忆），assets/ 前端（hippocampus.js 外壳与 2D 版，brain3d.js WebGL 大脑，vendor/ 内置 three.js），test/ 演示数据与测试。
☕ 请我喝杯咖啡
如果深海马让你的 dsh 更好玩了，欢迎请我喝杯咖啡，完全随意，谢谢！给项目点个 ⭐ Star 也是很大的支持。
微信支付 · 支付宝
致谢
- three.js（MIT）—— WebGL 渲染、OrbitControls、UnrealBloom 辉光
- DeepSeek Harness 的插件系统
许可
MIT
