@dsh-external/dsh-memory-sea

配置

Host 侧读三个环境变量（不传就用默认值）：

环境变量	默认值	作用
DSH_MEMORY_SEA_DIR	D:\QQBot\mem	记忆库目录
DSH_MEMORY_SEA_PYTHON	D:\QQBot\SeedVC\.venv\Scripts\python.exe	跑脚本的 Python
DSH_MEMORY_SEA_STAR	http://127.0.0.1:4173	星图页面地址

它期望的目录结构

/
  memory_config.json     # 参数（本插件会写它）
  memory_status.md       # 体检报告（读）
  longterm.jsonl         # 长期记忆，每行一个 { ts, scope, text, importance, date, tier? }
/../tools/
  mem_nightly.py         # 「跑一次」调的脚本（情绪 → 衰减 → 星图 → 自调 → 体检）
  mem_recall.py          # 「检索」调的脚本，必须支持 `--json --items N`

mem_recall.py --json 需要输出形如：

{ "query": "...", "items": [ { "text": "...", "tier": "decision", "score": 0.47, "energy": 0.7, "date": "2026-10-30" } ], "chars": 117 }

---

使用说明

1. 刷新页面，左侧栏那排图标里点「波浪」图标（找不到就用会话标题栏右侧那颗按钮）。
2. 状态卡先确认两件事：条数对不对、索引是不是「新鲜」。索引不新鲜先点「跑一次」。
3. 检索：像跟人说话一样问（"上次那个修插件的事"），回车。约 5 秒（本地向量模型冷启动），别连点。
4. 半衰期：数字是「多少天后能量减半」。人格/关系 180 天、决策 90 天、偏好 45 天、事实 30 天、事件 10 天是起点值。改超范围会被自动夹回（各档 ±40%、阈值 ±30%），返回里会告诉你夹到多少。
5. 保存参数会写 memory_config.json 并把 version +1；下次脚本运行才生效。
6. 跑一次是后台静默起 mem_nightly.py（不会弹黑框），跑完点「刷新」看结果。
7. 最近记忆只读，用于自查「记忆海里到底灌了什么」。

---