Jyotisha/docs/tasks/PROGRESS-report-reader-polish-20260929.md

PROGRESS · 报告页打磨 · 2026-09-29

任务书：docs/tasks/TASK-report-reader-polish-20260929.md。执行：Claude（直接执行模式，产品 2026-09-29「请你开始执行」）。 分支 codex/report-reader-polish-20260929，基线 origin/staging = 6e393780。BUG-1092～1094。

交付对照

编号	结论	说明
R1 报告中心改版	完成	标题栏无按钮；.report-center-create 卡片居中放「生成报告」（实心，默认尺寸）；下方「过往的报告」；无报告时一行「还没有个人报告。」。按钮的防重复点击、classifyCreateResponse 未改
R2 到底部	完成	新组件 report-edge-jump.tsx；LazyMarkdownSection 新增 forceVisible，点击时 flushSync 挂载全部章节后滚到 scrollHeight；距底 480px 内变「回到顶部」，一次只显示一个
R3 导出按钮	完成	描边、默认高度、可见文字「导出」，aria-label="导出报告" 保留
R4 目录层级	完成	一级 ink / 600 / 组间 --space-3；二级缩进 --space-5
R5 字段文案与表头	完成	三个标题、field_状态、p6 表头改中文 + 表下说明；状态列经 _dignity_label 去掉双写；同样的去重也用在「宫主（Bhavesh）落宫解释」表（排查时发现的同源问题）
R6 表格底色	完成	只作用于 .personal-report-table-wrap 与 .personal-report-fact-tables；打印 5% / 2.5%
R7 导出大小	完成	exportByteSize = TextEncoder 字节；formatExportSize 显示「约 N KB / 约 N.N MB」；全篇与已选各一个

既有断言改动（原值 / 新值 / 原因）

文件	原值	新值	原因
frontend/tests/personal-report-view.test.ts「ready reports expose only the back link and accessible export icon」	match size="icon"、match <Download aria-hidden="true" />、match title="导出"	doesNotMatch size="icon"、match variant="outline"、match <Download aria-hidden="true" />导出	§3-3：图标按钮改为带文字的描边按钮。aria-label="导出报告"、返回链接、禁用项断言不变
frontend/tests/report-export-drawer.test.tsx「reader actions keep only the accessible export icon」	title 等于「导出」	按钮文字等于「导出」，title 为空	同上。按钮数量仍为 1、对话框开合断言不变
frontend/tests/personal-report-entry.test.ts「entry stays on one line…」	match shrink-0	doesNotMatch shrink-0（whitespace-nowrap 仍 match）	§3-1：按钮移出 46px 标题栏，不再与标题争宽；「一行不折」要求不变
frontend/tests/react-client-lifecycle-test-support.ts（测试宿主）	无 closest / scrollTo	增加按类名的 closest 与记录调用的 scrollTo、scrollTop/scrollHeight/clientHeight	让「到底部」能在宿主里被真实点击验证；不影响其它用例（全量对比见下）

测试名均未改（名字里的 "icon" 保留，避免名单消失；语义以断言为准）。

Golden

frontend/tests/fixtures/report-reader-main-fictional.json：用同一虚构输入（tests/test_report_reader_main.py::FICTIONAL）、同一引擎，分别以改前（origin/staging 的 pl9_reader_export.py）与改后模块渲染，取两者 diff 打到 golden 上。golden 与改前渲染本身只差一行 Shadbala 小数（-18.80 / -18.79，同机两次运行也会抖动，与本单无关，未带入）。golden 改动 = 标题 1 行、表头 2 行、状态列 9 行、说明 2 行、宫主表状态 7 行。

验证（Claude 实跑，Linux，Node 22.14 / Python 3.11 .venv-review）

项	结果
tsc --noEmit	0 错
npm run lint	0 error，126 warning（与基线 6e393780 相同）
npm test（全量）	基线 4,357 / fail 24；本分支 4,364 / fail 24。失败名单逐条相同，全是无 Docker 的数据库 / 部署套件。测试名单只增不减（新增 7 条，消失 0 条）
过程中发现	首版把「到底部」状态放在文章视图里，撞上「article markdown trees are memoized and hold no scroll state」合同；改为外部信号（只由懒渲染章节订阅），合同原样通过，提交 156162f6
next build	/ 仍 ○ Static
首屏 gzip-9（index.html 引用的 26 个脚本合计）	基线 643,258 B → 643,265 B（+7 B，+0.001%）
Python 定向 tests/test_report_reader_main.py	全部通过（含新增 1 条）
Python 快速门 run_quality_gate.py --profile quick	Python 步 1000 passed / 2 skipped；门内 npm test 步用的是系统 Node 20，67 条失败属环境（同一套件用 Node 22 跑见上一行，与基线一致）

环境缺口

• 浏览器级真机验收：无登录态与 Chrome，清单见 docs/testing/report-reader-polish-20260929.md。
• 数据库套件：无 Docker，未跑；本单不动表。

部署核对（2026-09-29 Claude）

Gitea 门禁 validate → publish → migrate → deploy 全部 success；https://staging.jyotisha.chat/api/health 的 deployment.gitCommit = d7772011（含本单的最近一次门禁提交），status: ok；/login 200，未登录 /api/account 401。公开 health 不暴露 swisseph_available（内部项），未核对。