Skip to content

v0.1.0 — AI-Memory-Book 首个可用版本

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Afloat16 Afloat16 released this 11 Nov 09:06
· 893 commits to main since this release
v0.1.0
3a10f62

AI-Memory-Book v0.1.0

把项目变成书，把任务变成章，把会话变成节。一次检索，直接返回带出处的记忆页。首个实验性开源版本，采用 MIT 许可证。

已实现

  • 项目 → 任务章节 → 会话小节 → 提问与原文页；显式 task_id 将同一任务的多个会话归入同一章。
  • 自适应分节、900 字符默认分页、原文来源与字符偏移、SQLite FTS5 检索和跨进程查询缓存。
  • 中文本地网页阅读器，支持目录浏览、限定项目搜索、原文展开、导入预览及手机布局。
  • CLI、Python API、官方 SDK 的 stdio MCP；默认六个只读工具，写入需显式开启。
  • canonical JSON、ChatGPT 当前分支、Claude Code JSONL、Codex JSONL 文本导入；规范化 JSON 和 Markdown 记忆书导出。
  • 中英文文档、合成示例、可复现实验及完整逐查询数据。

已验证

  • 83 项 unittest；GitHub CI 覆盖 Python 3.10 / 3.12 / 3.13 和真实 MCP stdio 客户端。
  • 真实 Chrome 测试通过桌面与 390px 手机布局、中文搜索、目录、原文、导入流程、焦点恢复与页面错误检查；截图和 JSON 报告保存在 docs/assets。
  • 两组未参与调参的合成测试各包含 112 个会话、1,408 次提问、168 个查询、约 114 万原文字符。在 8,000 字符预算下，自适应分节证据召回率为 77.27%，完整证据率 78.95%，本地未缓存检索 P95 为 7.42–7.46 ms；平均上下文比整会话基线少约 31.5%。

当前边界

这些是本项目内部的合成检索对照，不是外部产品比较或模型回答正确率。低词面重叠改写召回为零；远距离双事实查询只召回 25% 的证据且没有完整找齐；新旧决定还需要检查来源。目录重排未体现独立的总体召回收益。没有语义向量、自动抓取宿主历史或权威版本裁决。

开始使用

git clone https://github.com/Afloat16/AI-Memory-Book.git
cd AI-Memory-Book
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
memory-book import examples/conversations.json
memory-book recall "搜索缓存为什么改成45秒？" --project atlas
memory-book serve

打开 http://127.0.0.1:8765 。需要 MCP 时安装 python -m pip install -e ".[mcp]"，参见 docs/integrations.md。源码安装可用，尚未发布到 PyPI。

Assets 2
Loading