Jesse_ChenandClaude Fable 5
e7016551db
/chart 从 ƒ Dynamic 变回 ○ Static——外壳预渲染、数据客户端取，整页不再阻塞
在五个引擎调用上。引擎超时 45s → 10s（实测单次最慢 0.60s）。postEngine 返回
ok/busy/http_error/timeout/bad_payload 并各留一条只含路径、状态码、耗时的
console.warn，不含出生资料。用户文案分两档：429 说「正忙，稍等几秒」，其它说
「算不出来，已经记录下来了」，不再把可能永不恢复的情况说成暂时的。eyebrow
只剩成功分支一处，改成「主盘直接算 · 分盘按需 · 不消耗点数」，去掉速度承诺。
引擎结果缓存也落地了，任务 3.2 未走让步。
门禁：tsc 0 错；lint 0 error / 119 warning；全量 fail 31 → 30 且零新增，总数
3275 → 3288；build exit 0、/ 仍 ○ Static；首屏 gzip +0.003%。
红线复核：page.tsx 未增长；限流名单与配额未动；四个体系数据一个没删。
欠：浏览器走查；staging 仍停在 2533d5a3 未部署。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0155nFCgCHtoA7jhSDGmZmMu
93 lines
6.6 KiB
Markdown
93 lines
6.6 KiB
Markdown
# 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` 尚未上线。
|
||
|