核心用法
Fulcra Annotations 是 Fulcra 官方提供的生命流数据写入技能，用于在 Fulcra 时间线中创建可复用的标注定义并记录具体事件。该技能通过封装 Fulcra REST API，提供 create（创建定义）、record（写入记录）、list/recent（查询验证）、update/delete（管理定义）等完整 CRUD 能力。
标注类型分为四类：
- moment：纯事件标记，无数值（如「开始深度工作」）
- boolean：是/否状态（如「是否完成晨间冥想」）
- numeric：计数或测量值（如「今日咖啡杯数」）
- scale：主观量表评分（如 1-5 分专注力自评）
所有写入操作均通过 fulcra_annotations.py 脚本执行，该脚本自动处理 OAuth 设备流认证、token 管理、标签 ID 解析、时区转换及写入后 readback 验证，避免敏感凭证暴露于对话记录。
显著优点
1. 安全设计优先：强制使用脚本封装而非裸 curl，token 全程隔离；支持 FULCRA_ACCESS_TOKEN 环境变量或本地 CLI 认证双模式。
2. 写入即验证：每条 record 命令自动执行 readback，仅当 verified_matches >= 1 时确认成功，防止静默失败。
3. 灵活的时间处理：支持 ISO-8601 带时区的时间戳进行历史回填，自动处理 UTC 转换与验证。
4. 标签系统：定义标签（稳定分类）与记录标签（单次上下文）分离，支持自动创建新标签并解析为 UUID。
5. 幂等写入模式：文档提供完整的 ledger-backed 去重方案，适合自动化管道与批量回填场景。
潜在局限与风险
- 功能边界：duration 类型仅部分支持，复杂测量需查阅
measurement-schema或等待上游文档完善。 - 平台依赖：需 Fulcra 账户（免费 5GB 永久存储），重度移动用户需搭配 iOS Context App（Android 待发布）。
- 认证流程：远程代理场景需保持 CLI 进程存活并通过可信通道传递设备授权 URL，操作链路较长。
- 数据隐私：虽脚本隔离 token，但 Fulcra 作为第三方云服务，敏感生理/位置数据仍需用户自主评估合规性。
适合人群
- 量化生活（Quantified Self）实践者，需自定义追踪指标
- 智能代理开发者，构建人机共享记忆与上下文感知工作流
- 研究员与临床工作者，需结构化记录可重复的观察事件
- 自动化爱好者，希望将外部系统事件写入统一时间线
常规风险
- 认证泄露：设备授权 URL 与用户代码若被截获，可能导致账户临时访问权限暴露，必须仅通过活跃可信用户通道传输。
- 误删定义：
delete与update操作不可逆，技能强制要求用户显式确认。 - 时区歧义：省略
--recorded-at时默认使用 UTC 当前时间，历史记录若未带时区偏移可能导致数据错位。 - 验证依赖网络：写入后 readback 若因网络抖动失败，需人工二次确认
recent查询，不可仅凭 HTTP 204 断言成功。