Obsidian 记忆系统

Obsidian Memory System 技术解析

要解决的问题

在 Obsidian 中使用本地记忆、开发日志和每日复盘时，付费授权和本地文件操作常常混在一起：要么重复为同一个仓库付费，要么难以确认付费凭证是否只用于授权、没有泄露本地内容。obsidian-memory-system 的目标是把 支付授权 和 本地记忆执行 拆开：每个 Obsidian vault 按指纹识别授权，付过一次后同一 vault 再运行就跳过付费；而所有 Obsidian 读写动作只在付费验证通过后，在本地按用户显式确认逐步执行。

工作原理

付费前置

创建订单前，环境中必须已经安装并配置 clawtip-skill。如果 clawtip-skill 不可用，就不要继续进入创建订单或付费步骤。

按 vault 授权

系统用 vault 的路径和 git remote（如果有）生成自动指纹。运行时先检查服务端 license 表：

• 已付费 → 输出 SKIP_PAYMENT=true，直接进入本地记忆操作；
• 未付费 → 输出 ORDER_NO=xxx，继续创建订单和付费。

同一个 vault 再次使用时会命中服务端记录，跳过重复付费。

付费与验证

远程服务只用于检查 license、创建订单、验证支付凭证和返回授权状态。以下内容不会上传：

• Obsidian vault 内容
• 笔记正文
• 本地记忆文件
• 本地项目文件

未授权 vault 会由 create_order.py 创建订单，输出 ORDER_NO、INDICATOR、AMOUNT，用户可选择 ClawTip 标准支付或扫码支付。支付后先验证凭证、拿到授权状态，再进入本地操作。

本地记忆操作

只有支付验证成功后，才会询问用户当前要执行哪个本地动作，并且只读取该动作需要的文件、只写入用户确认过的文件。当前支持：

• 读取记忆
• 写开发日志
• 运行每日复盘

付费脚本本身不会执行 Obsidian 读写，真正读写由本地操作完成。

适用边界与注意点

• 必须依赖 clawtip-skill；缺失时不能创建订单或付费。
• 只支持 read memory、write dev log、run daily review 三个本地动作。
• 即使授权成功，任何网络传输前仍需要当前步骤的显式本地确认。
• 付费脚本只做订单与授权流程，不应宣称它们执行了 Obsidian 读写。