capacities-batch

name	capacities-batch
description	Capacities 批量原子化改写工具：把 Zettels 等源笔记按 doto 六要素原子笔记标准， 批量改写为合规的 Atomic note 并回写 Capacities，源笔记只读不写。 封装了 Capacities REST API 的私有调用、frontmatter 规范化坑、429 限流退避、增量落盘等操作性细节。 触发词：批量改写 Capacities、原子化一批 Zettels、batch rewrite notes、 把这批笔记改成原子笔记、capacities 批量创建原子笔记、batch create atomic notes

Capacities 批量原子化改写

把一批源笔记（Zettels 等）按 doto 六要素原子笔记标准，批量改写为合规 Atomic note 并回写 Capacities。 铁律：源笔记全程只读，绝不修改。

何时使用

当用户要求「批量」处理 Capacities 笔记时——把一批 Zettels 改成原子笔记、原子化某个主题下的笔记、 或任何涉及「逐条创建多条 Atomic note」的场景。单条笔记改写用 doto-create 即可，不需要本工具。

前置（首次使用）

1. 确认 CAPACITIES_API_TOKEN / CAPACITIES_SPACE_ID / CAPACITIES_ATOMIC_STRUCTURE_ID / CAPACITIES_ZETTELS_STRUCTURE_ID 已设置（参考 .env.example）。
2. 确认对象类型已存在：Atomic note（主笔记）、Zettels（源）。

标准流程（每批）

1. 准备批次清单 batch_list.json：{"B01":[{"title":..,"id":..}, ...], ...}（见示例）。
2. dump 诊断：python dump_batch.py batch_list.json B01 读源正文， 判断每条是否单主题；仅真正含多个独立想法的源才拆分（一个源 = 一个主题 N，原子笔记 N.1）。
3. 撰写 notes.json：每条 {fid, title, tags, body, src_id, src_title}（见示例）。
   • fid 用 doto Folgezettel：topic.number（如 187.1）；拆分则 187.1..187.K。
   • body 用自己的话写原子想法（完整句子，一个想法）。
   • src_id / src_title 用于生成回链（A 方案：[src_title](url)）。
4. 创建：python batch_create.py notes.json created.json（增量落盘，可断点续跑）。
5. 校验：python verify_batch.py created.json（按 fogglezettelId + 源回链双重检查）。
6. 记账：python mark_batch.py B01 created.json progress.json。

关键坑（脚本已内置，勿重复踩）

• 校验匹配串必须是 fogglezettelId: '{fid}'（规范化后驼峰 + 单引号），不是 Fogglezettel ID。
• 429 限流已内置退避；不要去掉 call() 的重试。
• 源 Zettels 的 structureId 在 CAPACITIES_ZETTELS_STRUCTURE_ID，主笔记在 CAPACITIES_ATOMIC_STRUCTURE_ID。

不要做的事

• 不要修改源 Zettels。
• 不要把真实 Token / spaceId 写进脚本或提交版本库（走环境变量）。
• 不要用 @[..](..)（旧 MCP 语法）；回链用标准 Markdown [..](url)。