# PROGRESS · 星盘页开页不再整页阻塞（2026-09-15）

工作树：`.worktrees/chart-page-blocking-open-20260915`  
分支：`codex/chart-page-blocking-open-20260915`  
任务书基线：`origin/staging` @ `8caa2a2b`（任务书本身；代码基线 `2533d5a3`）  
本机 Windows。

Skill **未 bump**。未改 `scripts/**`、`deploy/**`、`vendor/**`、`frontend/src/app/page.tsx`、`vedic-chart-svg.tsx`。未放宽 `HEAVY_COMPUTE_PATHS` / `JYOTISH_HEAVY_COMPUTE_CONCURRENCY`。

## 开工基线

| 项 | 数字 |
| --- | --- |
| `frontend/src/app/page.tsx` | **1951** 行 |
| 最大 BUG 号 | **BUG-714**（本单占用 715–717） |
| `tsc --noEmit` | 收尾 0 错 |
| `npm run lint` | 0 error（全仓既有 warning 119；本单新文件 0 warning） |

`frontend/node_modules` 用 junction 指向主仓。

## 任务状态

| 任务 | 状态 | 说明 |
| --- | --- | --- |
| 1 BUG-715 失败可诊断 | 完成 | `ok / busy / http_error / timeout / bad_payload`；非 ok 打 `console.warn`（路径、状态码或错误名、耗时；不含资料）；429 与其它分档文案；`catch {}` 去掉 |
| 2 BUG-716 开页不阻塞 | 完成 | `/chart` 改为静态壳；进页只算 `/api/chart`；四个后续按 tab / 非 D1 chip 按需；超时 **10 秒** |
| 3 BUG-717 配额与文案 | 完成 | 开页不再打 western / qizheng；内存缓存 5 分钟，键含 ayanamsa + `node_mode`；失败页无眉标；成功眉标去掉「打开即有」 |
| 4 测试与文档 | 完成 | BUG-715/716/717、DESIGN、VOICE、CHANGELOG、真人清单、PROGRESS |

## 实现要点

- `postEngine` 不再 `return null`。分类在 `chart-view-engine.ts`，日志在 `assembleChartView` 的 `callEngine` 包装层，mapper `catch (error)` 记 `errorName` + `message`。
- `/chart` 不再 `force-dynamic`、不再 `await loadChartView()`。`ChartPageRoute` 先画外壳，再 `GET /api/chart-view`。未登录仍跳 `/login`。
- `GET /api/chart-view?layers=varga,chara,western,qizheng` 按需取后续。缺省 layers 只有 `/api/chart`。
- 等待态沿用星历页静态句：「这一张盘还没拿到。」「这一栏还没拿到。」「这一分盘还没拿到。」揭幕后无 spinner / 骨架 / 「正在加载」。
- 引擎结果缓存在 Next 进程内存（与 rate-limit / feature-flag 同一做法）。`api_scratch` 在 API 容器上，BFF 没有这个卷，没有新依赖。失败不写缓存。TTL 5 分钟。

## 超时取值

`CHART_VIEW_ENGINE_TIMEOUT_MS = 10_000`。任务书实测 `/api/chart` 0.60 秒、五个合计 0.75 秒。45 秒大两个数量级，只会让人盯空白。10 秒大约是实测的 16 倍，给冷启动和跨容器网络留余量；挂起时十秒内落到失败文案。

## 既有断言改动

| 文件 | 原值 | 新值 | 原因 |
| --- | --- | --- | --- |
| `chart-page-view.test.tsx` 成功页眉标 | `直接计算 · 打开即有 · 不消耗点数` | `主盘直接算 · 分盘按需 · 不消耗点数` | BUG-717：打开即有是速度承诺，且曾印在失败页上 |
| `chart-view-route.test.ts` western/qizheng 是否被调用 | 无 layers 也会打 `/api/western` 与 `/api/qizheng` | 只有请求对应 layer 才打；无 layers 时路径只有 `/api/chart` | BUG-716/717 开页不得占满重计算配额 |
| `assembleChartView` 的 `postEngine` 形状 | `Record \| null` | `EngineCallResult` | BUG-715 失败必须带原因 |

未弱化其它既有断言。未改 `page.tsx`（仍 1951 行）。

## 测试

| 命令 | 结果 |
| --- | --- |
| `npx tsx --test tests/chart-view-engine.test.ts tests/chart-view-route.test.ts tests/chart-page-view.test.tsx` | **27 pass / 0 fail**（本单相关；其中新增约 12 条） |
| `./node_modules/.bin/tsc --noEmit` | **0 错** |
| `npm run lint` | **0 error**（119 条既有 warning，本单新文件未新增） |
| `page.tsx` | 仍 1951 行，未改 |
| `npx next build --webpack` | compile + TypeScript 过；Collecting page data 死在既有 `SkillPackageRegistryError`（EPERM symlink `/api/birth-time-guide`），与本单无关。未能从本机构建表确认 `/` 与 `/chart` 的 `○ Static`。源码合同：`chart/page.tsx` 已去掉 `force-dynamic` / `loadChartView`。 |
| `npm test` 全量 | `# tests 3101 / # pass 3014 / # fail 73 / # skipped 14`。失败集中在无 Docker 的 database-*、部署/Caddy、Skill SHA、Windows 路径。失败清单不含本单文件。本机不是 Linux 验收机。 |

## 环境缺口

- 无登录态、无 Chrome：真人走查见 `docs/testing/chart-page-open-20260915.md`。
- `next build` 收集页面数据时 symlink EPERM，无法在本机核对路由表。

## 验收（Claude，2026-09-15，`origin/staging` @ `5a8328e5`）

**通过，零未通过项。**

| 项 | 结果 |
| --- | --- |
| `/chart` 路由类型 | **`ƒ Dynamic` → `○ Static`**，外壳预渲染，数据客户端取 |
| `tsc --noEmit` | 0 错 |
| `npm run lint` | 0 error / 119 warning（全既有） |
| 全量 `npm test` | `a38a9415` fail 31 → **fail 30**，**零新增**；总数 3275 → 3288 |
| `npm run build` | exit 0；`/` 仍 `○ Static` |
| 首屏 JS gzip-9 | 584,494 B（对 584,476 B，+0.003%） |

逐条对照任务书：

- **BUG-716**：`/chart` 变 Static，`ChartPageRoute` 是客户端组件，`useChartPage` 先画外壳再取数。`CHART_VIEW_ENGINE_TIMEOUT_MS` 45,000 → **10,000**（实测单次最慢 0.60 秒，取值合理）。
- **BUG-715**：`postEngine` 返回 `ok / busy / http_error / timeout / bad_payload`；`console.warn("chart_view_engine_failed", …)` 只记路径、状态码或错误名、耗时，**不含出生资料**（合 `AGENTS.md` §8）。用户文案分两档，与任务书 1.3 要求的语义一致：429 →「算盘的服务正忙，稍等几秒再打开就好。」其它 →「这张盘算不出来，我们已经记录下来了。」——后者不再说「过一会儿再打开」。
- **BUG-717**：eyebrow 只剩成功分支一处（`chart-page-view.tsx:84`），失败页不再印；文案改成「主盘直接算 · 分盘按需 · 不消耗点数」，**不含速度承诺**。引擎结果缓存（`chartViewEngineCacheKey` / `readChartViewEngineCache`）已落地，任务 3.2 未走让步。
- 红线复核：`page.tsx` 未增长；`HEAVY_COMPUTE_PATHS` 与 `JYOTISH_HEAVY_COMPUTE_CONCURRENCY` 未动；四个体系数据一个没删；全仓该路径上不再有 `catch {}`。

## 仍然欠着

- **浏览器实测**：`docs/testing/chart-page-open-20260915.md`。代码级已确认「不再整页阻塞」，但「点下去多久看到外壳 / 多久看到主盘 / 切 tab 各自表现」只能真机走查。
- **staging 未部署**：`deployment.gitCommit` 仍是 `2533d5a3`，`5a8328e5` 尚未上线。