Files

T

jesse-uxandClaude Code 10baeb2fa8 docs: split meeting product work into task books

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-22 11:19:35 +08:00

6.2 KiB

Raw Blame History

任务书 · 普通用户报告公开内容分层与导出投影（2026-09-22）

0. 基线与先决条件

基线 commit：1bc6a954c597e2817fe72bfedad93119ab19a527；开工前 fetch 并以最新 origin/staging 重核。
执行分支：codex/report-public-content-20260922；工作树：.worktrees/report-public-content-20260922。
业务已拍板：普通用户导出的报告隐藏内部技法和工作流字段；只保留用户可读正文、结论和必要限制说明。专业参考若保留，另立明确入口和规则。
本单与人物 other 资料无关；不得把报告接入人物切换任务。
本单不与人物选择器共享实现文件；如同批执行，先完成服务端 subject binding，再由报告单独接入其 canonical projection，禁止把两种资料真值边界混在同一 helper 中。

1. 事故实证

会议反馈：网站生成的报告夹带不该展示的内容，具体字段会上未列清。代码调查确认存在公开合同分裂：

普通聊天消息已经按 BUG-011 移除内部证据徽章、Technique Audit、单条回答下载控件。
frontend/src/lib/consultation-report-export.ts 的 consultationReportMarkdown() 仍可能序列化 technique_truth、workflow_route、workflow_status、precise_timing、missing_layers、Claim boundary 等内部字段；现有导出测试仍将其作为预期结果。
frontend/src/lib/personal-report-longform-download.ts 优先使用已有 Markdown，下载前主要去除图盘 fence，没有统一公开内容投影。
frontend/src/app/api/reports/[reportId]/professional-reference/route.ts 会返回已存储的完整 Markdown；接口名是 professional reference，但用户入口可能只是笼统“导出报告”。
frontend/src/components/personal-report/personal-report-markdown-view.tsx 的 HTML/URL/XSS 过滤是结构安全措施，不等于内部字段分类。

相关历史：BUG-011、BUG-058、BUG-086～094、BUG-188。它们已明确内部路由、未执行技法、评分、原始响应和用户敏感内容不得进入普通用户可见层。

2. 根因

报告阅读、咨询导出、个人报告下载和 professional-reference 返回的是不同边界：聊天层隐藏了内部字段，但 canonical Markdown/导出/API 没有统一普通用户 allowlist。因此不能只在 React 下载按钮前用正则删除，也不能凭感觉删除会上未定义的内容。

3. 决策记录（产品已拍板）

普通用户报告只展示：用户可读正文、结论、行动建议（若业务允许）和必要的限制说明。
普通报告禁止：technique_truth、workflow_route、workflow_status、precise_timing、missing_layers、内部评分/权重/执行账本、内部 URL、secret、模型调试字段、raw tool response、job/attempt/provider 元数据。
若专业参考仍需展示部分方法证据，必须单独命名、单独入口、单独权限/标识和单独合同；本单不把它混入普通导出。
旧报告不能因缓存或已存 Markdown 绕过新公开规则；优先在服务端 canonical 投影边界统一处理。

4. 硬红线

不得把普通报告变成内部调试报告；不得把“更专业”当作公开内部执行轨迹的理由。
不得只在客户端用脆弱字符串正则作唯一隐私防线。
不得破坏 Markdown 的既有 XSS、危险 URL、HTML 和 jyotish-chart fence 安全合同。
不新增 PDF/Canvas/jsPDF/Playwright/Puppeteer 导出链路，不升级依赖。
不修改星盘计算、报告生成算法或人物绑定；只治理公开投影边界。
不在 fixture、日志、任务书、BUG 历史中写真实姓名、出生资料、会话原文、凭据、secret。

5. 任务分解与验收标准

T1 · 建立字段级公开投影

在服务端/共享 canonical 层新增明确的普通报告投影 helper；字段白名单优先于黑名单。
区分聊天导出、个人报告详情、普通 Markdown 下载和专业参考文档类型，不用接口名字猜用户可见级别。
内部限制字段若需要保留其产品含义，转成自然语言限制说明，不透出内部 key/value。

验收：每个字段有公开/内部归类；普通报告在同一 synthetic fixture 下只含允许内容；没有字段时不虚构；图盘 fence 规则继续有效。

T2 · 接入所有普通输出边界

consultation-report-export.ts、personal-report-longform-download.ts、报告详情/阅读路径和 API 返回统一使用投影。
/professional-reference 若继续存在，必须显式区分专业参考与普通报告；若本轮不改专业参考，至少阻止它被普通下载路径当作普通报告 fallback。
处理旧缓存 Markdown/已存文档：下载和 API 返回不能绕过投影。

验收：页面阅读、下载文件、直接 API 响应与普通公开合同一致；禁止字段不会因缓存命中、旧报告或备用路径复现；专业参考不会被误标为普通报告。

T3 · 回归与安全测试

覆盖：字段存在/缺失、旧缓存、专业参考路径、图盘 fence、Markdown HTML/script/iframe/object/embed/img、危险 URL、内部 URL/secret/模型字段扫描。保留现有 consultation-report-export、personal-report-longform-md、报告归属/ready 检查测试名；断言变化写原值/新值/原因。

6. 让步顺序

T1 字段合同 > T2 canonical 接入 > T3 回归测试。若专业参考产品边界尚未实现，普通下载必须 fail-safe 使用普通投影，不能以“接口叫 professional-reference”为由透出内部字段。

7. 开工前置命令

git status -sb
git fetch origin --prune
git worktree add -b codex/report-public-content-20260922 .worktrees/report-public-content-20260922 origin/staging
cd .worktrees/report-public-content-20260922/frontend
./node_modules/.bin/tsc --noEmit
npm run lint
npm test
npm run build

8. 交付记录

同轮写 docs/tasks/PROGRESS-report-public-content-20260922.md，更新 docs/BUG_HISTORY.md（关联 BUG-011/058/188；若确认新用户可见回归，按开工时最大号连续编号）和必要的 CHANGELOG.md。视觉/文案变化同步 frontend/DESIGN.md / frontend/docs/VOICE.md。没有登录态的浏览器级导出验收写入 docs/testing/，不得写成通过。

6.2 KiB Raw Blame History Unescape Escape