paper-ds-tokens 用于在所选设计系统令牌来源与 Paper 之间维护令牌，避免抹除用户编辑或修订历史。
用途
该技能负责保持设计系统令牌在来源（代码或 Figma）与 Paper 之间的一致性。开始前需加载 paper-ds-canvas 以及 ../paper-ds-manage/references/versioning.md，并在比较数值之前读取清单（manifest）中的来源权威（source authority）与令牌快照。
同步方向
技能区分三种方向：
- sync：所选来源具有权威性，读取代码或 Figma 并更新 Paper。
- pull：用户明确希望将 Paper 提议的值写回来源。
- generate：尚不存在系统时，提出一套方案，并在写入前获得批准。
不得仅因代码不同就覆盖 Paper 中的编辑。如果自上次快照以来双方都发生了变更，应展示冲突并询问以哪个值为准。
比较与冲突处理
读取来源令牌、Paper 令牌、受支持的主题以及上一次快照，比较名称、值、别名和类型，区分缺失、变更、冲突和 Paper 独有的条目。展示拟定的方向及受影响的令牌组。保留 Paper 独有的令牌，包括画布（canvas）与评论（comment）角色。删除、重命名或改变共享语义需要明确批准。
变更前的保护
在做出变更前，捕获现有令牌和相关图稿。共享令牌可能改变规范（canonical）与归档（archived）节点，因此需通过检查引用来确定其影响，并用原始令牌快照保护历史截图与图稿。
应用与核验
使用 create_tokens 和 set_tokens 应用所请求的同步，或为 pull 执行获得授权的来源编辑。检查每个条目的结果；一次工具调用可能部分失败。回读令牌，并使用归一化 CSS 单位（而非字符串相等）对照预期来源进行核验。将已报告的精度损失（例如被舍入的 OKLCH 色相）记录为分歧，并保留原始来源；不要声称精确的往返保真度，也不要无限次重新同步。对于 pull，还要运行来源适用的现有检查。如果结果不同或检查失败，记录失败并在宣布成功快照之前停止。
快照与状态更新
保存新快照，更新 tokenSnapshot 与 tokensHash，刷新受影响的 Foundation 展示而不抹除使用说明，并将受影响的主题标记为 needsReview。一次同步绝不会静默地递增或批准所有组件。
保留来源
保持令牌值与别名关系精确。如果来源使用原始值或不等距的色阶（ramp），不要为让展示看起来更整洁而臆造最接近步进的别名。应改为提议单独的系统变更。当名称必须不同时，记录来源到 Paper 的名称映射；不要因导入而顺带重命名代码。
类型与命名
将类型映射到 Paper 的令牌类别，并保留受支持的 CSS 变量。现有命名空间可用时使用它。新生成的令牌可以使用 Tailwind v4 名称：--color-、--text-、--leading-、--tracking-、--font-、--font-weight-、--spacing-、--radius-、--breakpoint-、--container- 和 --opacity-*。
主题
对于单一主题，角色使用普通名称，例如 --color-ground，其值可能为深色。对于两种主题，浅色使用普通名称，深色使用 --color-dark-*。记录映射以及用于反向同步的选择器或 Figma 集合。应从来源解析继承的深色值，而不是将每个缺失的覆盖都视为缺失角色。如果来源显式地对非颜色令牌做了区分，不要假设它们完全相同。
保留的评论颜色
为每个已发布主题保留或提议一个霓虹粉评论色（neon-pink comment）和一个 comment-subtle 角色。保持它们与品牌色和状态色区分开。它们仍记录在 Foundations 中，但选项或审查表中不出现绘制的图钉、评论卡或发现项。未经许可，不要将这些 Paper 展示角色写入产品代码。
比较与生成
读取 ../paper-ds-options/references/comparisons.md。调色板覆盖使用色阶；语义选择使用角色表；对比度使用相同文本在真实表面上的效果。字体选择在标题、正文、控件和数字中使用匹配的文案。
对于生成，询问品牌方向、主题和字体偏好。提议 OKLCH 色阶、语义角色、较小的字号阶梯以及间距/圆角。在请求批准前先验证对比度。这些选择仅适用于新系统，绝不适用于导入的系统。
不支持的效果或未解析的值归入分歧（divergences）。不要臆造替代方案并报告零漂移。