# C端内容来源收敛与原型核对记录

> **历史核对记录（2026-08-09）。** 本文中的“24 个 Widget”对应当时范围，不作为当前开发依据。当前唯一正式基线为 22 个 Widget；WALK、VR 为关联内容类型，详见 [`02-全部Widget清单.md`](../02-Widget体系/02-全部Widget清单.md) 与 [`2026-08-13-C端全量Widget需求评审台账.md`](2026-08-13-C端全量Widget需求评审台账.md)。

版本：v0.1

状态：Codex 全量核对、原型修正与 DeepSeek PM 复核已完成，待人工评审

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-09 | v0.1 | 初始创建 / 跨模块内容收敛 | 全量核对 17 个页面 PRD、24 个 Widget PRD、14 个组件 PRD及当前 P0/P1 原型，建立顾客可见内容白名单并清理无来源内容。 |

## 1. 核对目的与判定口径

本记录回答三个问题：正式 PRD 是否允许 AI 自行补内容；当前原型哪些内容没有正式来源；修正后页面是否只保留已定义内容与交互。

顾客可见内容仅允许来自：

1. 页面 PRD 明确定义的页面级内容；
2. 单项 Widget PRD 明确定义了名称、来源、必需性或显示条件的内容；
3. 调用方 PRD 明确定义并传入通用组件的内容；
4. 组件 PRD 或正式共享规则固定的状态与操作文案。

通用组件声明可承载“摘要、标签、元信息、说明或动作”，不等于页面或 Widget 自动拥有这些字段。Demo、旧页面、设计装饰、原型说明、实现注释、评审备注和 AI 生成内容均不是正式来源。

## 2. 全量 PRD 核对

### 2.1 页面 PRD：17 个

| 核对对象 | 核对结果 | 本轮处理 |
| --- | --- | --- |
| 项目概览页 | 原文以“等内容”引用 Widget，可能被解释为页面可扩展字段。 | 已改为精确字段白名单，并明确禁止页面增加营销标题、英文栏目名、章节编号及其他项目事实。 |
| 户型浏览页、周边地图页、建筑与楼层页、共有部页、样板间与空间体验页、住户比较页、眺望与日影页、项目资料页、住户展示页 | 页面职责与引用对象明确；原文未要求页面自行增加业务字段，但此前缺少统一的顾客内容来源约束。 | 已由《页面开发清单》v0.9 统一约束：页面只组织已定义内容，不替 Widget 补写内容。 |
| 日影页、色彩选择页、家具摆放页、活动日历页、费用与贷款试算页、来场预约页、外部服务页 | P2 页面本轮不制作原型；页面 PRD 已限定承载对象，未发现必须立即删除的自创字段。 | 同样继承页面白名单规则；待进入制作范围时按本记录复核。 |

结论：17 个页面 PRD 已全部纳入统一来源规则；仅项目概览页需要详细字段修订，其余页面无需新增顾客内容。

### 2.2 Widget PRD：24 个

| 核对对象 | 核对结果 | 本轮处理 |
| --- | --- | --- |
| 项目概览 | “开发主体/竣工等补充信息”是开放式定义，允许继续增加未列明事实。 | 已收敛为可选“开发商名称”，并补充完整顾客内容白名单。 |
| 户型卡片列表、周边地图、断面图与立面图、楼层信息、共有部列表、3D大楼、WALK、VR、样板间列表、户型卡片、住户表、眺望集、资料集、单个文件夹展示、360转大楼、日影、活动日历、来场预约、平面色彩切换、3D色彩切换、平面家具摆放、购置费用与贷款试算、住户展示 | 均已定义自身业务对象、可见字段或条件；未发现要求 AI 补写新字段的条款。但此前缺少统一规则阻止原型依据通用槽位、Demo 或“演示完整”自行扩写。 | 全部继承《Widget 产品需求定义规范》v0.12：只有单项 PRD 白名单内容可展示；通用组件槽位不能扩大内容范围。 |

结论：24 个 Widget PRD 已全部核对；项目概览 Widget 的开放式补充信息已修正，其余 23 个 Widget 不新增内容字段。

### 2.3 通用组件 PRD：14 个

| 核对对象 | 核对结果 | 本轮处理 |
| --- | --- | --- |
| 页面导航 | 可选摘要/图标没有明确要求调用方同时定义来源。 | 已限定为页面发布对象与调用方 PRD 均有定义时才展示；原型只保留页面标题。 |
| 内容对象卡片、详情面板 | 摘要、标签、元信息、说明与动作是通用槽位，可能被误当作可自由填充字段。 | 已明确所有槽位都须由调用方 PRD 定义内容名称、来源和显示条件。 |
| 状态反馈 | 顾客可读信息未明确来源，存在按技术错误或 AI 推测原因的风险。 | 已限定为调用方 PRD、Widget PRD 或正式共享状态规则。 |
| 同意与表单校验 | 原文允许配置错误文案和按钮标签，但未禁止调用方临时补写。 | 已要求字段、同意、错误与提交文案均来自正式调用方规则。 |
| 顾客登录 | 登录流程明确，但认证外壳与通用错误文案未固定。 | 已固定认证标题、说明、通用标签、提交、必填、安全返回、用途说明及无来源完成状态文案。 |
| 外部内容承载 | 原文要求顾客可理解的失败反馈，但未在单项组件中明确文案来源。 | 已要求加载、失败、重试、退出等文案均来自调用方 PRD 或正式共享规则，不得暴露技术原因。 |
| 项目识别、项目联系、媒体查看器、筛选与结果摘要、选择器与时间轴、沉浸内容承载与控制、分享与语言切换 | 内容或动作边界已有明确来源；未发现需要新增业务字段的条款。 | 全部继承《通用组件开发清单》v0.6，不得自行生成内容。 |

结论：14 个组件 PRD 已全部核对；7 个组件补充了详细来源限制，其他 7 个组件由目录级规则收敛。

## 3. 原型核对与修正范围

| 原型页面/区域 | 发现的无来源内容 | 本轮修正 |
| --- | --- | --- |
| 全部正常业务页页尾 | `Prototype`、当前页面名称等原型标记混入顾客页。 | 已删除；页尾只保留项目 Logo、电话、邮箱、官网和“登录 / 验证访问”。 |
| 页面导航 | 每个页面的原型摘要、内部编号和“仅显示……”说明。 | 已删除；只保留已发布页面标题与切换动作。 |
| 项目概览 | 两层营销标题、英文栏目、章节编号、用途、总户数、预计交付等未定义事实。 | 已删除；只保留项目名、区域、主视觉、核心介绍、核心卖点及其已定义操作。 |
| 户型浏览 | 英文栏目名和页面营销说明。 | 已删除；保留页面名、筛选、结果、户型字段、空状态与媒体操作。 |
| 周边地图 | 英文栏目名、页面营销说明和 `SELECTED PLACE`。 | 已删除；保留项目锚点、分类、POI、距离、路线及局部失败。 |
| 住户展示 | 英文章节、编号、`Widget` / `iframe`、配置限制与“关于本页面”等内部说明。 | 已删除；保留 1208 已定义字段、户型图、楼层位置、眺望、一个关联 WALK 入口。 |
| 建筑与楼层 | 英文栏目、页面说明、线框/实现注释、P2 范围提示及无来源楼层事实。 | 已删除；保留 3D/图纸切换、楼层选择和楼层平面操作。 |
| 共有部 | 英文栏目、页面说明、`SELECTED SPACE`、未关联体验的内部解释。 | 已删除；保留分类、设施字段、图片及有效 VR 入口。 |
| 样板间 | 英文栏目、`Widget` / `iframe`、类型切换限制、供评审使用的不可用入口和技术说明。 | 已删除；无有效体验的样板间只展示基础资料，不显示体验入口。 |
| 住户比较 | 英文栏目、实现范围说明；原型最多 2 户与 PRD 最多 3 户不一致。 | 已删除说明并改为最多 3 户。 |
| 眺望 | 英文栏目、P2 日影范围提示、媒体查看器实现名称和未固定免责声明。 | 已删除；保留楼层、朝向、拍摄位置、筛选、媒体与空状态。 |
| 项目资料 | 英文栏目、页面说明；未支持的外部链接被当作可打开资料。 | 已删除；移除外部链接样例并同步文件夹数量，只保留图片、视频、PDF。 |
| WALK / VR 共用承载 | `iframe`、拒绝嵌入/网络原因、类型切换限制等技术说明。 | 已改为顾客可理解的加载、失败、重试、退出与返回原页面文案，不猜测失败原因。 |
| 顾客登录、403、404 | 项目 Logo、项目名称、英文副标题、自创说明与自创动作。 | 已改为 HOME VISTA 通用识别及正式 PRD 固定文案；状态页不显示项目内容。 |
| 组合验证台与左侧页面列表 | 含 Widget、优先级、线框和评审说明。 | 保留。两者是原型工作台，不属于右侧 `.customer-page` 顾客页面。 |

## 4. 当前结论

- 正式来源规则已覆盖全部页面、Widget 和组件 PRD。
- 当前 P0/P1 正常业务页与登录、403、404 已按规则清理。
- 代表值只用于映射已定义字段，不构成项目真实资料；后续接入真实项目内容时仍须通过发布状态、项目、语言及各 PRD 显示条件校验。
- 原型工作台可以保留评审信息，但不得把这些内容注入右侧顾客页面。

## 5. DeepSeek PM 复核与 Codex 取舍

评审输入：本记录 v0.1；评审范围只包含内容来源规则、通用槽位、状态文案和原型清理，不扩大 P2 或正式视觉范围。

| DeepSeek 发现 | Codex 本地核对 | 取舍 | 是否需要再次确认 |
| --- | --- | --- | --- |
| 未定义通用槽位可能显示“暂无摘要”等占位文案。 | 页面清单、Widget 规范、组件清单及卡片/详情 PRD 已明确：未定义槽位整体隐藏，标签、分隔符、留白和占位均不显示。 | 已覆盖，不重复修改。 | 否；这是用户本轮已确认原则的直接执行。 |
| 状态反馈可能回退为开发自拟文案。 | 状态反馈组件 v0.2 已要求文案来自调用方、Widget 或共享规则；没有来源时不能显示自拟反馈。当前原型的失败状态均可追溯到对应 PRD。 | 已覆盖。 | 否。 |
| 开发商名称为空时可能显示空项或“未提供”。 | 项目概览 Widget v0.3 已明确缺失时隐藏字段名称、分隔符和留白。 | 已覆盖。 | 否。 |
| 外部内容承载失败可能泄露“拒绝嵌入”等技术词。 | 目录级规则已约束，但单项 PRD 原文仍只写“顾客可理解的反馈”，确有继续收敛价值。 | 采纳；已更新外部内容承载组件 v0.2，要求所有状态文案有调用方或共享规则来源。 | 否；未新增行为，仅落实已确认总原则。 |
| 原型代表值缺少机器标记，可能在真实发版时残留。 | 本仓当前交付物是线框原型，代表值已在正式规则中限定为字段映射，且不构成项目事实；“构建时自动清除”属于未来生产接入控制，不是本轮 C端产品内容。 | 不采纳为本轮 PRD/原型改动；保留为未来真实数据接入检查项。 | 当前不需要；进入生产开发或真实项目接入前再确认实现方案。 |

DeepSeek 未发现原型清理与已确认产品边界冲突。其对 1 至 3 项提出的“再次确认”已由用户本轮“只展示有明确定义内容、AI 不得自主添加”的明确决定覆盖，故不重复上抛。

## 6. 验证结果

| 验证项 | 结果 |
| --- | --- |
| 顾客页文本扫描 | 10 个正常业务页的 `.customer-page` 均未出现 `Prototype`、`Widget`、`iframe`、英文栏目名、P2、线框或评审提示。 |
| 登录与系统页 | 登录、403、404 均使用 HOME VISTA 通用识别；未出现项目名称或英文副标题，固定文案与 PRD 一致。 |
| 关键交互 | 住户比较可选 3 户；C type 无有效体验时不显示入口；有效 WALK 运行时失败只显示“体验暂时无法加载”、重试和返回原页面，不暴露技术原因。 |
| 响应式 | 10 个业务页 × 5 档宽度共 50 次检查，以及 3 个系统页 × 5 档宽度共 15 次检查，均成功渲染且无整页横向溢出。 |
| 视觉检查 | 已检查 320px 与 1440px 项目概览首屏；移动端页面列表与页面区分离，桌面端左侧工作台与右侧顾客页面边界保持独立。 |
| 构建与发布产物 | `pnpm build` 通过；`dist/index.html`、`dist/prototype/index.html`、`dist/docs/index.html`、`dist/docs/` 和 `dist/_headers` 已生成；150 份 Markdown 产物无 UTF-8 BOM。 |
| 差异检查 | `git diff --check` 通过；本轮无未记录的文档—原型内容差异。 |

P0/P1 人工评审仍未完成，本记录不替代人工通过结论。原型代表值不是项目真实资料，进入真实数据接入或生产发布前须另做内容替换与残留检查。