用途:在搭建或构建前,为某个制品编译生效的 StyleSeed 规则包,或以只读方式检查安装与证据健康度,用于诊断规则漂移。使用前需先完成每会话一次的更新预检。
主要能力:通过随附的 scripts/resolve-context.mjs 解析生效上下文,不手工拼装规则栈。先判定项目边界:若存在 .styleseed/project.json 或 .styleseed/artifacts/index.json,则要求完整有效的注册表,注册表出错时不得回退到 STYLESEED.md;仅当无注册表时才使用该锁文件。旧式单制品项目优先用 --from-lock STYLESEED.md;注册表项目用 .styleseed/project.json 加 .styleseed/artifacts/*.json,并以 --artifact 或 --all 解析,注册表模式下应改项目自有配置而非传选择覆盖项。构建前先读产物:旧式写 .styleseed/effective-rules.md,注册表写 .styleseed/bundles/<artifact-id>.md;清单分别为 .styleseed/manifest.json 与 .styleseed/manifests/<artifact-id>.json。--check 可检测上下文漂移而不改写文件。
用法示例: node <installed-ss-resolve>/scripts/resolve-context.mjs --from-lock STYLESEED.md --agent codex 注册表项目: node <installed-ss-resolve>/scripts/resolve-context.mjs --project-root . --artifact app-dashboard --agent codex 无锁时可用 --grammar、--adapter、--domain、--page、--recipe、--palette、--key-color、--profile 等参数;--list 打印支持的 ID。--recipe auto 将所选 grammar 映射到维护的默认值,--palette auto 将 recipe 映射到经对比度验证的语义调色板。默认输出目录为项目根下的 .styleseed/。项目本地参考语法传 reference:<slug>,并确保 .styleseed/rulesets/<slug>/RULESET.md 存在;注册表项目需完整六文件契约。存在关键色时使用共享 OKLCH 生成器写出 .styleseed/palette.json 与 .styleseed/palette.css。
诊断:安装或项目健康问题先运行只读诊断 node <installed-ss-resolve>/scripts/styleseed-doctor.mjs --project-root . --json,可用 --artifact <id> 缩小注册表检查范围;它不会执行搭建、迁移、重编译、渲染或更新。退出码 0 表示所选制品证据为最新,1 表示需关注,2 表示调用无效。迁移前先看 migrate-project.mjs --dry-run,应用迁移需完整人工审阅计划、当前锁哈希、一对一章节到制品映射及匹配计划哈希的 --confirm-plan。
限制:安装完整性不证明宿主发现、发布者真实性或最新上游版本;旧式项目规则可能最新但证据不受支持。间距建议 recommend-spacing.mjs 仅输出只读起始提案,不检查或改写实现令牌,也不构成设计验收;--measurement 报告过期或不一致会被拒绝,起始值明确为启发式。规则包成功解析后不要再加载 llms-full.txt,仅当包指出需更大源文档时才加载。