用途：在 Figma 节点上读取和写入设计师标注。标注是附着于节点的设计规格，可携带纯文本或 labelMarkdown 备注、一组被固定的属性（fills、width、fontSize 等）以及可选分类（interactions、accessibility、dev notes 等）。标注随节点保存、可撤销，适合放动画时序、缓动曲线、交互行为与无障碍要求等不属于组件描述的内容。
主要能力：列出与读取节点标注；写入标注；支持 replace（默认，覆盖全部）与 append（保留已有）两种模式；replace 时传 ANNOTATIONS = [] 可清空；读取时可设 INCLUDE_CHILDREN 遍历组件树。
使用方式：先加载官方 figma-use 技能。脚本用纯 JS、顶层 await 加 return，输入以 const 内联在顶部，颜色取值 0–1，文本操作前先加载字体，用 await figma.getNodeByIdAsync(...) 取节点，脚本失败为原子操作、不产生部分改动。获取节点 ID 后，写带分类的标注前先运行 categories 片段拿到真实 categoryId（分类名按文件而定）；用 scripts/get-annotations.js 读取，用 scripts/set-annotations.js 写入并选择 MODE；写入后重跑读取脚本校验数量与标签。
限制：标注仅适用于支持它的节点类型（frame、component、instance、shape、text，不含 page）。Figma 读取时会同时填充 label 与 labelMarkdown，但写入时两者只能选其一，append 时优先 labelMarkdown。properties 只固定备注指向哪些属性，不设置属性值，须使用 references/annotation-properties.md 中的精确字符串。文件级评论请改用 figma-comments 技能。需 Figma 桌面版，浏览器中无 Plugin API。