Memory Star · 记忆星图

把你的 Markdown 笔记变成一张能看、能查、能连的记忆网络。

• 🌌 星图：每块记忆是一颗星；越重要越大越亮，相关的有连线
• 🔍 检索：按意思查，不是关键词匹配（IDF 加权 + 沿连线扩一圈）
• 🧠 认人：你还记得我吗 / 咱们聊过什么 —— 从"这个人"出发找他所有的痕迹，认 20+ 种说法
• 📦 零依赖：只要 Python 3.9+，不用装第三方库
• 🧩 DSH 插件：也能作为 DSH 插件加载（见 docs/DSH.md）

空白星图 → 输入问题 → 结果只落在两边文本里，星图不动 → 点一颗星，它的邻居一起亮起来。

---

它解决什么

笔记越写越多，就会撞上这三件事：

你遇到的情况	常见做法为什么不行	Memory Star 怎么做
明明记过，搜不出来	关键词匹配：你记得的是"意思"，不是原话	按意思查：IDF 加权 + 同义扩展 + 沿连线扩一圈
记了但从没用过	笔记是平的，看不出哪条孤立	星图上孤立点一眼可见，面板还会直说"这块没跟别的连上"
有人问"你还记得我吗"	搜"记得"这种高频词，命中一堆废话	从这个人出发沿连线找他所有痕迹，认 20 多种问法

具体好用在哪

1. 问"你还记得我什么"——不用他自报名字

你还记得我吗 / 你知道我是谁吗 / 咱们聊过什么 / 你把我忘了吧 / 有印象吗 …

这些说法都会走 about.py：先判断是不是在问"我们之间的事"，再按人沿连线找他出现过的地方（原话、事件、哪条视频），越近越靠前。

2. 星图不是装饰，是体检

• 越大越亮 = 越重要（imp 字段）
• 点一颗星 → 邻居高亮 + 右边列出"和它连着的 N 块"
• 没有连线的星 = 记了但用不上，该补内容或删掉

3. 检索不动星图，只在两边出结果

搜索时星图保持原样，结果全在左列表 + 右详情。 这样你能一直看着"整张记忆长什么样"，而不是被高亮冲掉。

4. 零依赖

不需要向量库、不需要 API key、不需要数据库服务。 一个 SQLite 索引 + 一个纯 HTML（数据内嵌，双击就能看）+ 一个 60 行的 HTTP 服务。

---

在 DSH 里打开的样子（点 ★ → 搜「红豆思无期」→ 右边自动出档案和关联）：

---

快速开始（独立运行）

git clone https://github.com/<you>/memory-star.git
cd memory-star/standalone
python mem.py index                                  # 建索引
python build.py --mem ./记忆 --web ./web             # 生成星图
python server.py                                     # 起服务
# 打开 http://127.0.0.1:8777

Windows 用户可以直接右键 install.ps1 → 用 PowerShell 运行，一键完成上面三步。

---

记忆怎么放

按 8 层目录放，星图会自动按层上色：

记忆/
├─ 00_身份/    我是谁、我的规矩
├─ 10_人/      每人一份，文件名就是名字
├─ 20_事件/    对话、日志、发生过的事
├─ 30_知识/    学到的东西、教训
├─ 40_技能/    会做的事
├─ 50_感受/    在意的
├─ 60_任务/    待办
└─ 90_系统/    索引（自动生成）

每篇用 ## 分小节，一节就是一颗星。写具体的句子，不写口号。

---

三个核心能力

1. 星图

点一颗星     右侧出现原文 + 和它连着的 N 块（能一路点下去）
左边搜       只出结果，不点亮星图
删空         还原整张图
拖动         转视角

2. 按意思检索

python query.py "为什么没人看我的视频"

3. 认人（最实用）

python about.py --auto "咱们聊过什么吗" "对方名字"

它先判断这句话是不是在问"我们之间的事"，再按人沿连线找他的一切。

---

作为 DSH 插件（侧栏面板）

装进 DSH 后，侧栏会多一颗星，点开就是星图 —— 不用另开浏览器。

cd ~/.dsh/profiles/<profile>
pnpm add file:/path/to/memory-star/dsh-plugin
# 或从 GitHub
pnpm add github:<you>/memory-star#path:dsh-plugin

然后在 profile 的 YAML 里加：

plugins:
  dsh-plugin-memory-star:
    url: http://127.0.0.1:8777

实现细节、插槽约定、已/未验证项都在 docs/DSH.md。

本地自测（不用装 DSH）：

node test/client.test.mjs

---

接口

GET /api/search?q=      {results:[{id,src,score,text,snippet}]}
GET /api/about?name=    {name, found, related:[...]}
GET /api/node?id=       单块原文
GET /api/meta           块数/边数/词数
GET /retrieval.json     全量节点和边

---

License

MIT