用途
ss-restyle 用于为一个 StyleSeed 项目应用一个可选的美学配置(aesthetic profile),在不改变已选输出文法(output grammar)、产品职责或核心设计判断的前提下,协调视觉表现。它把美学配置与输出文法分开处理:配置是协调的视觉轴,输出文法组织注意力、信息与行动。
主要能力
- 从 PRESETS.md 中选择恰好一个配置,或选择不使用任何配置;禁止叠加多个配置。
- 在输出文法允许的范围内,应用配置协调后的半径、密度、字体、配色温度、层次、动效、构图强调和标志性动作。
- 在兼容时保留刻意的品牌值和必需字体;若与输出文法不兼容,则输出文法和核心不变量优先,并解释冲突原因。
- 更新 STYLESEED.md 中的“Aesthetic profile”及受影响的边界值,不重写输出文法或参考编译的规则集。
- 支持运行 /ss-score 达到 ≥80,并在可渲染时运行 /ss-verify。
使用方式
- 前置:遵循每会话一次的更新预检。
- 校验锁(lock)中只有一个输出文法;若不是,先运行 /ss-setup。
- 从 PRESETS.md 选择恰好一个配置,或不选;绝不叠加配置。
- 在输出文法允许范围内应用该配置。
- 处理品牌值与字体的兼容性;冲突时以输出文法和核心不变量为准并说明。
- 更新 STYLESEED.md 中的美学配置及受影响边界值。
- 运行 /ss-score(目标 ≥80);若可渲染,运行 /ss-verify。
- 报告完整生效规则集,而不仅是配置名称。
读取顺序与构件边界:当 .styleseed/project.json 与 .styleseed/artifacts/index.json 存在时,先解析请求的 artifact ID,然后只读取 .styleseed/bundles/<artifact-id>.md 和 .styleseed/manifests/<artifact-id>.json。注册表项目绝不回退到全局 legacy bundle。仅当不存在注册表时,legacy 项目才可使用 .styleseed/effective-rules.md。此外需阅读 PRODUCT-PRINCIPLES.md、RULESETS.md、PRESETS.md 和 STYLESEED.md。
适用场景
- 需要在不改变产品定位与输出文法的情况下,统一调整项目整体视觉协调性。
- 需要在既有品牌值与必需字体基础上,套用一个成体系的美学配置。
- 需要单轴微调时改用 /ss-dial;需要基于新证据衍生语言时改用 /ss-reference。
限制与规则
- 配置只是可选的外观协调,不是设计方法的豁免。
- technical 配置不会把电商页面变成可观测性控制台。
- editorial 配置不能成为交易流程中不可读衬线正文的理由。
- brutalist-lite 仍要求状态一致、对比度合格,并保持一种边框语言。
- 一次只选一个配置,不得叠加。