用途
hypermnesic 面向希望为自己拥有的 AI 智能体提供持久记忆的开发者和重度笔记用户。它的核心理念是「一个大脑，服务所有 AI」：你的第二大脑以纯 Markdown 形式存放于你自行托管的 Git 仓库中，ChatGPT、Claude、编码智能体（无论笔记本还是手机）都通过同一个端点读写这份大脑，Obsidian 则用于浏览。
与将记忆保存在厂商托管存储中的方案不同，hypermnesic 让文件本身成为记忆，搜索索引只是可随时删除并重建的一次性投影，重建索引永远不会丢失记忆。每一次记忆写入都是一次可审查、可回滚的真实 Git 提交。
主要能力
- 共享与复利式记忆：因为所有 AI 都在维护同一份笔记，记忆不只是持久，还会不断积累。任一 AI 都可以捕获一条笔记（某个决定、事实、人物、会议），其他 AI 可以关联、纠正或补充上下文，之后每个 AI 在回答时都能检索到它。
- 单一端点，多客户端接入：任何支持 MCP 的应用指向你的端点 URL 即可使用，OAuth 自动完成。支持 ChatGPT、Claude（桌面、移动、网页）通过自定义连接器接入；Claude Code / Codex 使用捆绑插件；自研智能体可用任意 MCP 客户端访问同一 URL；Obsidian 可通过 tailnet 只读伴侣进行浏览。
- 混合检索：使用 SQLite FTS5（词法）与 sqlite-vec KNN（稠密，采用 OpenAI text-embedding-3-large 1536 维）经 RRF 融合；当嵌入服务不可用时优雅降级为纯词法模式。
- 读取时收敛：每次读取会先将索引追赶至 HEAD，使召回保持新鲜，无需手动重建索引。
- Git 优先写入路径：commit_note 接收调用方提供的仓库相对路径，经 diff-or-die 前置元数据门禁、阻止列表写入守卫、单写入者锁以及仅追加审计日志，将笔记提交到 git。
- 记忆管理：memory 命令可列出与检查已记忆文件、导出 Markdown 及来源信息、预览并应用基于 git 的遗忘/删除、回滚近期安全的单文件写入、查看审计与拒绝历史。
- 客户端管理：clients 命令可列出不含凭证的 OAuth 授权元数据并撤销授权，不暴露任何令牌或密钥。
- 人类界面：提供思考模式、显著性加间隔复习摘要、意外连接、始终井井有条的导航界面、多格式附件提取（PDF/DOCX/XLSX/PPT）等。
使用方式
资料提供了分阶段的使用路径：
- 本地验证：在存放 vault 的机器上，准备一个 Markdown 笔记的 git 仓库即可。配置 OPENAI_API_KEY 可启用稠密嵌入以改善排序，离线词法模式也可完成验证。验证路径会校验 git 支持的 vault、将已提交的 Markdown 文件投影到可丢弃的 .hypermnesic/ 索引、回答自然语言问题并返回仓库相对源路径，还会展示 commit_note 的试运行 diff。
- 自托管端点：需要安装并登录 Tailscale（tailscale up），hypermnesic 使用 Tailscale Funnel 提供公网 HTTPS 与自动 TLS，无需反向代理或证书管理。setup 会生成并启动用户服务、生成仅属主可读的 consent secret、配置 funnel 并验证 HTTPS 发现链。
- 连接客户端：将应用的 MCP 服务器指向端点 URL，首次连接时应用会通过浏览器完成一次 OAuth 授权，之后静默刷新。默认授予读权限，写权限需在同意页面批准。
- 本地使用：运行引擎的主机可跳过网络直接使用 CLI。
- 日常循环：资料建议采用 capture -> triage -> recall -> write -> review -> clean up 的日常流程，并提供每日审查仪表板。
适用场景
适用于需要持久项目记忆的场景：有来源依据的事实、决策、流程、原始捕获、带引用的生成摘要，以及应跨越当前会话的当前状态镜像。
不适用于短命的会话状态或行为偏好（例如“用户喜欢简洁回复”默认应放在 Honcho 等行为记忆层），也不应写入机密、凭证、私钥、令牌或未经审查的敏感材料。
限制
- 当前为公开 v0.1.0 版本。
- 引擎采用 AGPL-3.0-only 许可；配套插件来自独立的 GPL-3.0 hypermnesic-companion 仓库，首个配套版本为 0.3.0。
- 默认情况下启用写入的服务要求 OAuth 认证。高级选项 --allow-tailnet-write 允许仅以 tailnet 成员身份作为写入边界，但仅在 Tailscale CGNAT 地址上生效，非 tailnet 绑定仍会被拒绝。
- 写保护会拒绝 .git/、.github/、CLAUDE.md / AGENTS.md 等智能体指令文件、scripts/ / hooks/ / skills/ 以及构建/CI/凭证文件，无论是否配置允许列表。
- 云访问令牌默认有效期 48 小时，刷新为 30 天。
- 与 mem0 / Zep（托管记忆服务）、Hindsight（自有向量存储）、Honcho（行为记忆层）定位不同，hypermnesic 优化的是自有、可审计、复利式文件，而非排行榜排名。
- 具体性能数据、收费信息、价格与完整安装命令步骤暂未提供。
