Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

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.md
index 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.mjs
index 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.mjs
index 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.mjs
index 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;静态入口发现不表示已迁移或已实机验证。`,
'',