Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(repo): drop snapshot date from design inventory GENERATED block
Kai Ningcda710c108b4
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 2d04262744..e427165c0d 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -9,7 +9,7 @@本区块由 `scripts/design-inventory.mjs` 生成,请勿手改。重新生成:`pnpm design:inventory`;校验:`pnpm check:design-inventory`。-计数快照日期:2026-10-14。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。+生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。登记 surface 数:52。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。diff --git a/scripts/__tests__/design-inventory.test.mjs b/scripts/__tests__/design-inventory.test.mjsindex a383f0ca5e..feb6a71912 100644--- a/scripts/__tests__/design-inventory.test.mjs+++ b/scripts/__tests__/design-inventory.test.mjs@@ -81,7 +81,6 @@ function tinySurface(id = 'desktop.test.surface') {function renderWithCoverage(surfaces, routerSource, extra = {}) {return renderGeneratedBlock(surfaces, {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: productionRouterCoverage(routerSource, extra.catalog ?? catalogSurfaces()),redirects: listRedirectExclusions(routerSource),@@ -262,7 +261,6 @@ test('排序用码点序而非 localeCompare——跨平台字节一致', () =>test('人工区块被改后 merge 仍原样保留', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],@@ -271,7 +269,6 @@ test('人工区块被改后 merge 仍原样保留', () => {'\n## 人工标注\n\n| ID | owner | 迁移状态 | protected | 目标道路 | 下一动作 |\n| --- | --- | --- | --- | --- | --- |\n| `desktop.test.surface` | kiro | pilot | 手改标签 | 手改道路 | 手改动作 |\n';const existing = `# Cindy 生产 UI 台账\n${generated}${human}`;const nextGenerated = renderGeneratedBlock([{ ...tinySurface(), bareColors: 99 }], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],@@ -286,7 +283,6 @@ test('人工区块被改后 merge 仍原样保留', () => {test('compareGenerated: 最新通过、过期失败', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],@@ -338,13 +334,12 @@ test('router.tsx 每条生产路由都能映射到 surface,布局壳在排除清test('GENERATED 含 §2.1 六项字段,裸颜色与 audit 共用匹配器', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],});assert.equal(generated.includes('| ID | 平台 | 标题 | 生产入口 | 可达组件 | 样式来源 | Token 数 | 裸颜色 | 裸圆角 |'), true);- assert.equal(generated.includes('计数快照日期:2026-08-30'), true);+ assert.equal(generated.includes('计数快照日期'), false);assert.equal(generated.includes('生成命令:`pnpm design:inventory`'), true);assert.equal(generated.includes('hardcoded-color-match.mjs'), true);@@ -360,7 +355,6 @@ test('GENERATED 含 §2.1 六项字段,裸颜色与 audit 共用匹配器', () =test('孤儿人工行只报告不删除', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],@@ -403,19 +397,16 @@ test('fixture 新增或删除一条生产路由会改变 GENERATED,使 compare];const surfaces = [tinySurface()];const base = renderGeneratedBlock(surfaces, {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: productionRouterCoverage(baseRouter, catalog),redirects: listRedirectExclusions(baseRouter),});const added = renderGeneratedBlock(surfaces, {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: productionRouterCoverage(addedRouter, catalog),redirects: listRedirectExclusions(addedRouter),});const removed = renderGeneratedBlock(surfaces, {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: productionRouterCoverage(removedRouter, catalog),redirects: listRedirectExclusions(removedRouter),@@ -1134,7 +1125,6 @@ test('真实台账文件含 GENERATED 标记,人工区覆盖全部 surface ID',test('ensureHumanRows 补行后人工表仍按 surface ID 有序', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],@@ -1213,8 +1203,7 @@ test.describe('CLI', { concurrency: false }, () => {);});- test('CLI generate 刷新快照日期为当天;--check 沿用文件内既有日期不跨日假红', () => {- const today = new Date().toISOString().slice(0, 10);+ test('CLI generate 不写日期:连续生成字节一致,--check 通过', () => {// 在临时目录拷贝上跑 CLI(CINDY_INVENTORY_DOC 重定向写读):统计仍扫真实源码,// 但 generate 不再改写受版本控制的真实台账——跨日跑 test:runner 不留脏工作区。const sandbox = fs.mkdtempSync(path.join(os.tmpdir(), 'design-inventory-cli-'));@@ -1227,27 +1216,17 @@ test.describe('CLI', { concurrency: false }, () => {env: { ...process.env, CINDY_INVENTORY_DOC: sandboxDoc },});try {- // generate 用当天日期写盘。+ // GENERATED 只取决于源码树:不写生成日期,不同日期各自重新生成的分支+ // 不会在日期行上合并冲突。const gen = run([]);assert.equal(gen.status, 0, gen.stderr || gen.stdout);const doc = fs.readFileSync(sandboxDoc, 'utf8');- assert.match(doc, new RegExp(`计数快照日期:${today}。`));- // 把日期改成 2020(早于任何真实快照),--check 必须沿用文件里的日期重渲染- // → 不因跨日误报。- const aged = doc.replace(- /计数快照日期:\d{4}-\d{2}-\d{2}。/,- '计数快照日期:2020-01-01。',- );- fs.writeFileSync(sandboxDoc, aged, 'utf8');- const agedCheck = run(['--check']);- assert.equal(agedCheck.status, 0, agedCheck.stderr || agedCheck.stdout);- // 再 generate 一次,确认写回的是当天(证明日期不是从旧文件继承的)。- const restore = run([]);- assert.equal(restore.status, 0, restore.stderr || restore.stdout);- assert.match(- fs.readFileSync(sandboxDoc, 'utf8'),- new RegExp(`计数快照日期:${today}。`),- );+ assert.doesNotMatch(doc, /计数快照日期/);+ const again = run([]);+ assert.equal(again.status, 0, again.stderr || again.stdout);+ assert.equal(fs.readFileSync(sandboxDoc, 'utf8'), doc);+ const check = run(['--check']);+ assert.equal(check.status, 0, check.stderr || check.stdout);} finally {fs.rmSync(sandbox, { recursive: true, force: true });}@@ -1256,7 +1235,6 @@ test.describe('CLI', { concurrency: false }, () => {test('os.tmpdir 仅作隔离证明:测试不得把绝对路径写进 GENERATED', () => {const generated = renderGeneratedBlock([tinySurface()], {- snapshotDate: '2026-08-30',generateCommand: 'pnpm design:inventory',routerCoverage: { mapped: [], missing: [] },redirects: [],diff --git a/scripts/design-inventory.mjs b/scripts/design-inventory.mjsindex 4760ecd64b..b808c8353d 100644--- a/scripts/design-inventory.mjs+++ b/scripts/design-inventory.mjs@@ -54,8 +54,8 @@ const MAIN_ENTRY_PATH = path.join(repoRoot, ...MAIN_ENTRY_REL_PATH.split('/'));const RENDERER_INDEX_PATH = path.join(repoRoot, ...RENDERER_INDEX_REL_PATH.split('/'));/**- * 生成模式用当天日期快照计数事实;--check 用文件里已有日期重渲染,避免跨日假红。- * 日期只在生成时求值(不进 shared 纯函数),保证同一天内连续两次生成字节一致。+ * GENERATED 区块不写生成日期:它只取决于源码树,跨日重新生成字节一致,+ * 不同日期各自重新生成的分支也不会在日期行上合并冲突。事实变化时间以 git 历史为准。*/const GENERATE_COMMAND = 'pnpm design:inventory';@@ -65,12 +65,7 @@ function readExisting() {return fs.existsSync(DOC_PATH) ? fs.readFileSync(DOC_PATH, 'utf8') : '';}-function snapshotDateFromExisting(existing) {- const match = /计数快照日期:(\d{4}-\d{2}-\d{2})/.exec(existing);- return match?.[1] ?? new Date().toISOString().slice(0, 10);-}--function buildGenerated(existing) {+function buildGenerated() {const routerSource = fs.readFileSync(ROUTER_PATH, 'utf8');const { surfaces, missingStyleRoots, danglingExtraStyleRoots } = buildGeneratedSurfaces(repoRoot,@@ -82,9 +77,7 @@ function buildGenerated(existing) {if (mobileCoverage.missing.length || mobileCoverage.stale.length) {throw new Error('Mobile route inventory mismatch: ' + JSON.stringify(mobileCoverage));}- const snapshotDate = checkOnly ? snapshotDateFromExisting(existing) : new Date().toISOString().slice(0, 10);const generated = renderGeneratedBlock(surfaces, {- snapshotDate,generateCommand: GENERATE_COMMAND,routerCoverage,redirects,@@ -97,7 +90,7 @@ const catalog = catalogSurfaces();const existing = readExisting();const { surfaces, routerCoverage, generated, missingStyleRoots, danglingExtraStyleRoots } =- buildGenerated(existing);+ buildGenerated();const orphanIds = findOrphanHumanIds(splitInventoryDocument(existing).suffix,surfaces.map((surface) => surface.id),diff --git a/scripts/shared/design-inventory.mjs b/scripts/shared/design-inventory.mjsindex bac252854a..9684bfdc55 100644--- a/scripts/shared/design-inventory.mjs+++ b/scripts/shared/design-inventory.mjs@@ -1122,7 +1122,6 @@ function renderTable(headers, aligns, rows) {export function renderGeneratedBlock(surfaces,{- snapshotDate = 'UNSET',generateCommand = 'pnpm design:inventory',routerCoverage = { mapped: [], missing: [] },redirects = [],@@ -1144,7 +1143,7 @@ export function renderGeneratedBlock('本区块由 `scripts/design-inventory.mjs` 生成,请勿手改。','重新生成:`pnpm design:inventory`;校验:`pnpm check:design-inventory`。','',- `计数快照日期:${snapshotDate}。生成命令:\`${generateCommand}\`。裸颜色匹配与 \`scripts/hardcoded-color-audit.mjs\` 共用 \`scripts/shared/hardcoded-color-match.mjs\`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(\`rounded*\` class、\`border-radius:\` 与 React style 对象的 \`borderRadius:\`)。Token 计数为样式源里 \`var(--token)\` / \`hsl(var(--token)\` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。`,+ `生成命令:\`${generateCommand}\`。裸颜色匹配与 \`scripts/hardcoded-color-audit.mjs\` 共用 \`scripts/shared/hardcoded-color-match.mjs\`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(\`rounded*\` class、\`border-radius:\` 与 React style 对象的 \`borderRadius:\`)。Token 计数为样式源里 \`var(--token)\` / \`hsl(var(--token)\` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。`,'',`登记 surface 数:${surfaces.length}。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。`,'',