用途
paper-ds-setup 用于把一套已经存在的设计系统连接到 Paper，使其能够在后续工作中被持续维护和迭代。它的定位是建立基线，而不是发明新的设计系统。
主要能力
- 读取 paper-ds-canvas 与 ../paper-ds-manage/references/versioning.md，确认 Paper MCP 可用，并确定要操作的文件。
- 复用已有 paper-ds.json 与文件页面；对旧版清单遵循迁移流程，不重置节点、修订号或页面 ID。
- 定位真实来源：token 文件、组件目录、stories、设计系统文档、素材，以及提供的 Figma。仅在来源互相冲突或不清楚时，询问哪个来源具有权威性。
- 若没有 token 来源，提议使用 paper-ds-tokens 生成，并先获得批准。
- 将未确定的设置选项合并为一条消息集中询问，包括已发布的主题、logo 文件、数字或字母、舞台背景、可选的权衡与反馈槽位。默认采用紧凑的 DS token 间距，而不是大型配置表。
- 使用 ../paper-ds-manage/references/manifest-example.json 创建清单，只填写观察到的值，未知 ID 或版本留为 null，写入 schemaVersion: 2 与已安装技能版本。该连接记录让后续步骤复用文件，而无需递归执行 setup。
- 用 paper-ds-tokens 同步 token，并依据 references/foundations.md 构建或协调 Foundations。保留用户已有作品；应用协调前先展示方案。
- 依据 references/template.md 构建或复用 TEMPLATE，将提供的 logo 放到 Logo foundation 并克隆到 header 槽位；没有素材时省略槽位，除非用户要求占位符。不得硬编码示例系统名称。
- 单一主题系统按每个选项一个舞台构建，使用该主题的普通角色名称；选项宽度由剩余舞台与解析后的 DS 间距计算，不能对包含配对间距的宽度做减半。
- 用 paper-ds-pages 组织，用 paper-ds-components 只导入下一个任务所需的组件，不要求先导入整库才能开始。
- 截取初始 token 快照与导入的对象基线；用截图验证画板，并对照实际节点 ID 检查清单；报告连接情况、支持的主题、来源以及任何未验证的导入。
使用方式
使用已有 URL 或 ID 而非再次询问；仅在明确要求时创建文件。已给出的答案会被直接使用。已存在的设计规则、字体、比例尺度、logo 与组件 API 来自源或用户选择，绝不用示例值替换。Foundation 说明用于解释实际用法，用户可编辑，不是评审意见。未经批准的范围，不覆盖已有 Foundations 或 TEMPLATE 画板；后续 sheet 克隆用户当前模板。
适用场景
适用于已有设计系统、需要持续迭代并与用户协作维护的项目，尤其是已有 token、组件库、文档或 Figma 来源，并希望在 Paper 中建立统一基线与模板的情况。
限制
单独执行 setup 不会将组件标记为已批准或已实现；导入的基线只记录实际捕获到的证据。MCP 无法锁定画板，需用户按需手动锁定已完成的规范画板。不提供来源时需先批准生成方案。