From 0a1a87b06e788bbf05790e13e28e11cfe14119fb Mon Sep 17 00:00:00 2001 From: Jesse_Chen Date: Fri, 18 Sep 2026 09:40:33 +0000 Subject: [PATCH] =?UTF-8?q?docs(tasks):=20=E8=81=8A=E5=A4=A9=E6=AD=A3?= =?UTF-8?q?=E6=96=87=E6=8E=92=E7=89=88=E4=B8=A4=E6=9D=A1=E6=A0=B9=E5=9B=A0?= =?UTF-8?q?=EF=BC=8C=E5=87=BA=20BUG-962/963=20=E4=BB=BB=E5=8A=A1=E4=B9=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用仓库自己的渲染管线 + next build 的 CSS chunk + headless Chrome 复现： 列表无项目符号（preflight 清 list-style，.markdown-list 没恢复）； promoteDefinitionLists 把四标题口语体散文误判成并列项，三段正文被 改写成列表项。收紧判据而非删除，BUG-356 的并列短项场景要继续工作。 Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P --- docs/tasks/README.md | 1 + .../tasks/TASK-chat-markdown-list-20260918.md | 82 +++++++++++++++++++ 2 files changed, 83 insertions(+) create mode 100644 docs/tasks/TASK-chat-markdown-list-20260918.md diff --git a/docs/tasks/README.md b/docs/tasks/README.md index befde896..f626fdaa 100644 --- a/docs/tasks/README.md +++ b/docs/tasks/README.md @@ -140,6 +140,7 @@ | `TASK-consult-pass4-streaming-20260918.md` | `PROGRESS-consult-pass4-streaming-20260918.md` | 验收 review 三轮：Pass 4 一 hold 正文就整段蹦出、逐字流式消失（BUG-950 产品拍板按句放行）；无出生分钟模式整段被一句拒绝顶掉、一般知识句一起丢（951 改按句丢弃）；该模式下日期不留痕（952）；校正流 token 级 thinking 是死链，按 P2 删除并把测试翻转成否定合同（953）。基线 `1e553976` | 待验收 | `cd4775ae` | | `TASK-window-consult-contract-20260918.md` | `PROGRESS-window-consult-contract-20260918.md` | **P0 线上**：申报时段模式**自 2026-08-21 起每轮秒败**（69ms、0 token、模型从未被调用）。服务端日志实证根因：窗口 Agent attach 了 `jyotishSkillBinding()`，但 `windowJyotishInstructions` 从来不含方法块 marker，输入处理器直接 abort（BUG-954）。abort 与「模型没调工具」同码，是它藏四周的原因（955）；另含合同未绿不得丢正文（956）、计算不该由模型触发（957，须等 954 上线后另轮）、窗口指令应期冲突（958）。基线 `9cdcf96b` | 已验收通过（Claude：tsc 0 / lint 0 error / npm test 3501 条 31 红同基线 / `/` Static / gzip 无变化；实跑确认窗口 Agent 指令已含 marker）；review 另出 BUG-959~961 见下一行 | `5b6abc23` | | `TASK-contract-degraded-pass4-20260918.md` | — | 验收 review：BUG-956 新增的降级交付路径绕过 Pass 4，保证句原样送达（BUG-959）；`uncontractedText` 跨 attempt 不清零，同一轮正文说两遍（960）；降级后还空跑一轮 compose（961）。基线 `877128ce` | 待领取 | — | +| `TASK-chat-markdown-list-20260918.md` | — | 真机排版反馈：聊天正文列表**没有项目符号**（Tailwind v4 preflight 清了 `list-style`，`.markdown-list` 没恢复，BUG-962）；`promoteDefinitionLists` 把四标题口语体的散文误判成并列项，三段正文被改写成列表（BUG-963，判据太松，收紧而非删除——BUG-356 的场景要留）。基线 `ea0280c1` | 待领取 | — | | `TASK-first-paint-dead-screen-fallback-20260917.md` | — | 真机：首页永远停在「正在载入账户」，兜底全在没跑起来的 bundle 里（BUG-936 investigating）。根 layout 加与 bundle 无关的内联兜底 + 去掉本仓正则后行断言 | 待领取 | — | | `TASK-consultation-answer-start-anchor-20260917.md` | `PROGRESS-consultation-answer-start-anchor-20260917.md` | 主会话回答落在结尾：`useConversationScrollAnchor` 是贴底跟随，流式期间视口钉在最后一个字，回答开头滚出视口；改为发送后问题钉顶、回答向下长、长出视口显示「跳到最新」、末尾动态留白；产品追加拍板：校正面同一语义（推翻 BUG-041/048 贴底），本轮开头 = 用户行或新助手行。BUG 段 930 起 | 已验收（经修复单） | `worktree/green-harbor-5be3` | | `TASK-consultation-answer-start-anchor-fix-20260917.md` | `PROGRESS-consultation-answer-start-anchor-fix-20260917.md` | 验收修复单：F1 头就是留白行时留白按整视口算（BUG-931）；F2 留白只在钉住期间存在（BUG-932）；前置：先修 e4e73f56 的两处 TS 错否则门禁不过 | 已验收 | `cc1a8980`（Claude 验收：tsc 0 / lint 0 error / npm test 3457 条 39 红与 11c0028d 逐条一致、新增 2 条绿 / `next build --webpack` 通过、`/` Static、首屏 gzip 591,242（较 09-16 基线 582,800 +1.45%，含会话列表单）/ Chrome 真实布局 S1–S6 全部通过，S6 新助手行距顶 16px 且增高不动，S5 不再写留白）；真机六条欠 | diff --git a/docs/tasks/TASK-chat-markdown-list-20260918.md b/docs/tasks/TASK-chat-markdown-list-20260918.md new file mode 100644 index 00000000..7b4de1d2 --- /dev/null +++ b/docs/tasks/TASK-chat-markdown-list-20260918.md @@ -0,0 +1,82 @@ +# TASK · 回答正文的列表渲染（2026-09-18 第六轮） + +> 基线：`origin/staging` @ `ea0280c1`（代码部分 = 已部署的 `877128ce`）。 +> 触发：产品在 staging 真机看申报时段回答，反馈「排版没对齐、看起来很难受」。 +> BUG 编号起点：`docs/BUG_HISTORY.md` 当前最大号 **BUG-958**；`TASK-contract-degraded-pass4-20260918.md` 已占 959~961，本单占 **BUG-962 ~ BUG-963**。 + +## 0. 复现方式（已在本机用真实构建复现） + +1. 取 staging 真实一轮的回答原文（申报时段 / 「未来半年我事业如何？」）。 +2. 用仓库自己的渲染管线跑：`renderChatMarkdown(answer)`（`src/components/chat-markdown-view.tsx`）。 +3. 用 `next build --webpack` 产物里的 CSS chunk 套上 `.message-markdown` 容器，headless Chrome 截图。 + +产出的 HTML（节选，**这是渲染器真实输出**）： + +```html +

先回答你的问题

+

这是你出生窗口内的稳定结构，不是某一分钟的盘。……

+ + +``` + +模型写的是**三段散文**，渲染出来变成了**三条列表项**，而且和结尾真正的行动清单用同一种样式。 + +## 1. BUG-962（P1）聊天正文的列表没有项目符号 + +`src/app/globals.css:1336-1349` 的 `.markdown-list` 设了 `display: grid`、`gap`、`padding-inline-start: 1.35em`，**但没有恢复 `list-style`**。项目是 Tailwind v4，`@import "tailwindcss"` 的 preflight 把 `ul, ol` 的 `list-style` 清成 `none`。 + +结果：所有列表项只是「往右缩进一段的孤行」，看不出是清单；正文段落靠左、列表块缩进，页面出现两级左边界——这就是产品说的「没对齐」。 + +已验证：在同一份编译 CSS 上加一行 `list-style: disc` 后，`display: grid` 下 `::marker` 正常渲染，**不需要改布局方式**。 + +**要求**： + +1. `.message-markdown .markdown-list` 恢复项目符号：`ul` 用 `disc`、`ol` 用 `decimal`；`::marker` 颜色取次级文字色（不要纯黑）。 +2. 顺带核对同一文件里其它被 preflight 清零又没恢复的列表（`personal-report-markdown-view` 走的是另一套样式，本单不动）。 +3. 验收标准：新增一条渲染测试断言 `.markdown-list` 的计算样式 `list-style-type !== "none"`（或源码级断言该选择器块内含 `list-style`）；进度记录附改前改后截图。 + +## 2. BUG-963（P1）散文被自动提升成列表 + +`src/lib/chat-definition-lists.ts` 的 `promoteDefinitionLists`：连续 ≥2 个「X：Y」形式的段落会被改写成 `- **X**：Y` 列表。 + +它是 BUG-356（2026-08-23）的修复，当时要治的是「行运 / 适合推进这类**并列短项**被挤成一坨段落」。但 BUG-943（今天）把本命正文改成四标题口语体之后，正文散文**本来就长这样**——「你这半年的事业是 X：……」「推的是火星：……」——于是整段正文被误判成并列项。 + +现在的判据太松： + +- `DEFINITION_LINE = /^(.{2,80}?)[：:](.+)$/` 的 term 允许含句号，所以「……也别去应土星弱位的「拖」。去扮演太阳的「署名」」整串都成了 term； +- body 只要求 `length >= 4`，一段一百多字的多句散文照样算「解释」。 + +**要求**（收紧，不是删除——BUG-356 的场景要继续工作）： + +1. term 不得含句末标点（`。！？；!?;`）与换行。 +2. body 必须是**单句**：不含句末标点，或仅以一个句末标点收尾。 +3. body 长度上限（建议 ≤ 40 个字符，实现方可按 BUG-356 的真实样例校准），超过就是散文，不提升。 +4. 三条**全部**满足才提升，且仍要求连续 ≥2 段。 +5. 验收标准： + - 回归 fixture 用**两份真实正文**：BUG-356 的并列短项（仍然提升）与本轮申报时段回答（**不再提升**，保持三个 `

`）； + - `chat-definition-lists.test.ts` 既有断言若需改动，写「原值 / 新值 / 原因」三栏。 + +## 3. 硬红线 + +1. `tsc --noEmit` 0 错、`npm run lint` 0 error、`npm test` 失败数不超过基线 `877128ce` 实测的 31 条且清单一致；测试总数不低于 3501。 +2. 同一提交更新 `frontend/DESIGN.md`：写明聊天正文里「列表有符号」「散文不自动变列表」两条口径，以及判据阈值。 +3. 不改 `next build` 后 `/` 的 `○ Static`；首屏 gzip 变化在 ±2% 内（本轮只动 CSS 与一个 lib，预期接近 0）。 +4. 不得顺手改个人报告页的 Markdown 样式（那是另一套，未收到反馈）。 + +## 4. 开工前置 + +```bash +git fetch origin --prune +git worktree add -b codex/chat-markdown-list-20260918 \ + .worktrees/chat-markdown-list-20260918 origin/staging +cd .worktrees/chat-markdown-list-20260918/frontend +npm test 2>&1 | grep -E "^# (tests|pass|fail)" # 开工基线：tests 3501 / pass 3455 / fail 31 +``` + +截图复现法（本单验收要用同一套）：把真实回答喂给 `renderChatMarkdown`，套 `next build` 产物里的 CSS chunk，用 headless Chrome 截 `.message-markdown`。 + +收工：`docs/tasks/PROGRESS-chat-markdown-list-20260918.md`（附改前改后截图）+ `docs/BUG_HISTORY.md`（BUG-962/963）+ `frontend/DESIGN.md`，与代码同一批推 `staging`。