# Prompt — CANONICAL-004 Progress track token fix (1 行 CSS swap)

> **角色**：executor
> **范围**：精确 1 行 CSS 改 `src/components/Progress/Progress.vue` line 66 — 让 Progress track 在 dark + light theme 下与 figma 视觉真源对齐
>
> ⚠️ **不要 commit / 不要 git add**——与 A4.2 ProgressPage sample 累积同一 commit
> ⚠️ 完成后 **STOP**，按 §4 完成报告格式回报；§4 必须含 §4.X 完整改动清单段
> ⚠️ **不扩范围**：只动 `src/components/Progress/Progress.vue` 1 行 + 重跑 audit / typecheck

---

## §0 — Plan owner 已定裁定

### 现状（实证）

| 层 | 当前值 | 来源 |
|---|---|---|
| canonical Progress track | `--progress-track-bg: var(--bg-layer3)` = `#262626` | `src/components/Progress/Progress.vue:66` |
| docs `.docs-demo-card--dark` cell bg | `var(--bg-layer2)` = `#1f1f1f` | `playground/docs/pages/ProgressPage.vue:225-227` |
| **Δ** | **7 单位 RGB 差肉眼几乎不可见** | — |

### Figma 视觉真源（用户截图实证）

- dark/M default size track 是清晰可见深灰 ≈ `#353535`（对应 `--line-deep`）
- ⚠️ Figma extract pipeline 顶层 fills `opacity: 0`（T1c PAUSED 那批 figma-data-missing 8 组件之一），sub-node fill 真源未抽到 → fix 值依据用户截图视觉推测，不是 100% 真源驱动
- 残留 caveat 入 backlog CANONICAL-004，等 T1c 复活后用 figma extract recurse children 拿真源 verify

### Fix（精确 1 行）

`src/components/Progress/Progress.vue` line 66:

```diff
.progress {
  display: flex;
  align-items: center;
  gap: 8px;
  width: 100%;
  min-width: 0;
  min-height: 16px;
- --progress-track-bg: var(--bg-layer3);
+ --progress-track-bg: var(--line-deep);
  --progress-label-color: var(--color-grey-5);
  --progress-label-width: 32px;
}
```

### 副作用核查（plan owner 已 verify token 实际值）

| Theme | Before track | After track | Cell context | Δ 可见性 |
|---|---|---|---|---|
| Dark | `#262626` | `#353535` | `--bg-layer2`/`--bg-layer3` | ✅ 改善（深一档可见）|
| Light | `#f0f0f0` | `#dbdbdb` | `--bg-layer3` | ✅ 改善（深一档可见）|

无 regression。Light theme 也对齐 figma 真源逻辑（深一档可见 vs 父容器）。

### 不动

- `src/canonical/Progress.vue`（wrapper，纯 prop 转发，无关）
- `src/components/Progress/Progress.vue` 除 line 66 之外
- `src/tokens/variables.css`（不改 token 定义，只 reference）
- `playground/docs/pages/ProgressPage.vue`（A4.2 已改造，本 fix 不动）
- 任何其他 page / generator / audit 脚本
- `docs/internal/backlog.md` / 任何复盘 / `AGENTS.md` / 真源 `.md`（plan owner 自己改）

### 预期 audit verdict

- 18 page audit reports：**全部仅 timestamps 改动**（CSS token swap 不触发 audit 5 verdict 的任何 finding）
- ProgressPage 5+1 verdict 保持全 pass · findings=0

### 预期 dev 视觉

- Dark Theme Members 段 8 cells：track 后 40% 区域**可见深灰** ✅（之前几乎纯黑）
- Figma Coverage 段 grid 8 cells：同上
- Runtime Value 段 4 cards (0%/35%/60%/100%) + Try It slider：track **可见**
- Light theme 不在 docs 站显示（dark-only 规则），但理论 light consumer 也改善

---

## §1 — 必读输入

按顺序：

1. [`AGENTS.md`](../../../AGENTS.md) — 项目约束 + 硬规则 6 条
2. [`docs/meta-rules.md`](../../meta-rules.md) — 反模式 + 触发器
3. [`src/components/Progress/Progress.vue`](../../../src/components/Progress/Progress.vue) — 待改 1 行
4. [`src/tokens/variables.css`](../../../src/tokens/variables.css) — token 定义（只 reference 不改）
5. [`playground/docs/pages/ProgressPage.vue`](../../../playground/docs/pages/ProgressPage.vue) — A4.2 已改造，dev verify 用

---

## §2 — 任务清单

### 任务 2.1 — 改 1 行

按 §0 改 `src/components/Progress/Progress.vue` line 66。

### 任务 2.2 — typecheck

```bash
pnpm exec vue-tsc --noEmit
```

期望：0 错误。

### 任务 2.3 — 跑 audit 全量

```bash
node figma-sync/audit-page-t2-sample.mjs
```

### 任务 2.4 — Verify 18 reports timestamp-only

```bash
git diff --stat docs/internal/t2-sample-audit-report.*.md
```

期望：每个 ~12 行 timestamps 改动，无 verdict / findings 改动。

### 任务 2.5 — dev 启动等 plan owner 截图

```bash
pnpm dev
```

启动后 STOP 等 plan owner 截图确认。**executor 不自评 dev 视觉**。

---

## §3 — 验收清单

- [ ] `src/components/Progress/Progress.vue` line 66 精确 token swap (`--bg-layer3` → `--line-deep`)
- [ ] 不动其他 line / 其他文件
- [ ] vue-tsc 0 错
- [ ] 18 audit reports 仅 timestamps 改动（验过 git diff --stat）
- [ ] ProgressPage 5+1 verdict 仍全 pass · findings=0
- [ ] dev 启动等 plan owner 截图（不自评）
- [ ] 没 commit / 没 git add

---

## §4 — 完成报告

```
## CANONICAL-004 Progress track token fix 完成报告

### 改动文件 (按 prompt 任务的预期 scope)
- src/components/Progress/Progress.vue (1 行 token swap)
- docs/internal/t2-sample-audit-report.<18>.md (重生, 仅 timestamps)

### §4.X 完整改动清单 (All M / A / D, 含 prompt 范围外)
[git status --short 全列表]
[如有范围外改动，标 ⚠️ 解释]

### 改动 hunk
[贴 src/components/Progress/Progress.vue diff]

### typecheck
- vue-tsc: 0 错误

### audit verdict
- 18 reports: 仅 timestamps OK / 偏离 (列出)
- ProgressPage 5+1: pass/pass/pass/pass/pass · findings=0 OK / 偏离

### dev 视觉
- pnpm dev 启动: OK
- 等 plan owner 截图（executor 不自评）

### 验收 self-check
- [ ] 1 行 token swap (line 66)
- [ ] 不动其他 line / 其他文件
- [ ] vue-tsc 0 错
- [ ] 18 baseline 仅 timestamps
- [ ] ProgressPage 5+1 全 pass
- [ ] dev 启动等 plan owner
- [ ] 没 commit / 没 git add
- [ ] §4.X 完整改动清单已列

### 未解决项 / blocker
[如有，列出；无则写"无"]

STOP — 等 plan owner 复审 + 截图确认 → A4.2 ProgressPage + CANONICAL-004 一并 commit → 进 A4.2 batch (8 page 一刀)。
```

---

## §5 — 严守约束总览

- ⚠️ **不要 commit / 不要 git add**
- ⚠️ §0 文件改动**精确 1 文件 1 行** + audit 重跑 + typecheck
- ⚠️ §4 完成报告**必须含 §4.X 完整改动清单段**
- ⚠️ dev 视觉**不自评**——启动 dev 后 STOP 等 plan owner 截图
- ⚠️ 18 audit baseline 必须仅 timestamps（验过 `git diff --stat`）
- ⚠️ 完成 STOP，按 §4 格式回报