# HOMEVISTA 模块化展示产品方案：AI 与 Codex 融合补充说明

## 一、需求背景

HOMEVISTA 模块化后，项目内容会从一个固定展示系统，变成大量可组合、可比较、可演示的销售信息资产。

如果这些内容只存在于页面里，后续每次调整项目介绍、销售话术、讲解路径、比较说明、多语言版本时，仍然会依赖人工重新整理，效率不高。

因此，产品需要进一步和 AI / Codex 融合，让系统内容能被快速读取、理解、编辑和复用。

这份文件不是独立于产品、UI 和技术之外的新需求，而是对前三份报告中 AI / Codex 相关要求的系统补充说明。

这项需求的核心不是简单增加一个 AI 聊天框，而是让 HOMEVISTA 的项目资料、模块配置、讲解路径和比较逻辑具备“AI 可读、可编辑、可回写”的结构。

## 二、核心目标

**让 HOMEVISTA 成为一套可以被 AI / Codex 快速读懂并持续再编辑的房地产销售资料系统。**

第一版核心目标只做四件事：

| 第一版事项 | 说明 |
|---|---|
| 资料结构化 | 项目、模块、户型、房源、眺望、讲解路径、比较页都有清楚字段 |
| 可导出给 Codex 读取 | 支持导出 Markdown、表格或 JSON，让 Codex 快速读懂当前项目 |
| Codex 辅助编辑 | Codex 帮忙改文案、整理讲解路径、生成推荐理由和多语言版本 |
| 人工确认后回写 | AI 只负责辅助生成，最终由销售、产品或配置人员确认后回到系统 |

后续可以再扩展“快速检查”“客户行为摘要”“销售跟进建议”“自动生成新路径”等能力，但这些不作为第一版重点。

版本规划原则：

**产品架构一次想清楚，开发分两版落地。**

第一版不开发完整智能辅助能力，但必须在资料字段、行为数据和版本记录上提前预留。这样第二版做快速检查、客户行为摘要、销售跟进建议、自动生成新路径时，不需要推翻第一版重做。

| 版本 | 名称 | 开发范围 |
|---|---|---|
| 第一版 | AI 可读与再编辑基础版 | 资料结构化、导出给 Codex、Codex 辅助编辑、人工确认后回写、版本记录 |
| 第二版 | AI 辅助销售运营版 | 快速检查、客户行为摘要、销售跟进建议、自动生成新路径草稿、管理复盘摘要 |

## 三、产品原则

| 原则 | 说明 |
|---|---|
| AI 不是孤立功能 | AI 不应只是额外按钮，而应嵌入资料整理、路径配置和内容编辑流程 |
| 先结构化再智能化 | 第一阶段先做字段、导出、辅助编辑、人工回写，不急于自动推荐 |
| 人工确认后发布 | AI / Codex 生成的内容必须经过配置人员或销售人员确认 |
| 保留版本记录 | 每次修改要知道来源、时间、修改人和修改内容 |
| 面向销售结果 | AI 编辑不是为了炫技，而是帮助客户看懂项目、帮助销售讲清楚推荐理由 |
| 先预留再扩展 | 第二版能力可以暂不开发，但第一版字段和数据关系要提前预留 |

## 四、AI 需要读懂哪些内容

| 内容对象 | AI 需要理解的信息 |
|---|---|
| 项目 | 项目名称、位置、主卖点、销售阶段、目标客群、展示目标 |
| 模块 | 3D 大楼、虚拟样板间、眺望集、户型图、住户表、资料集、预约等启用状态 |
| 资产 | 每个户型、样板间、楼层视野、房源、资料文件的名称、字段和说明 |
| 讲解路径 | 路径名称、适用客群、客户阶段、页面顺序、每一步讲解目的 |
| 比较页面 | 比较对象、比较字段、差异说明、推荐理由、下一步动作 |
| 销售话术 | 面向首次客户、预算客户、改善客户、投资客户等不同讲法 |
| 客户行为 | 看过哪些页面、比较过哪些对象、是否预约、关注点是什么 |

## 五、建议的数据组织方式

为了让 Codex 快速读懂，后续应尽量把内容沉淀为结构化资料，而不是只放在页面文案里。

### 1. 项目说明结构

```text
项目名称
项目位置
销售阶段
目标客户
项目主卖点
启用模块
推荐讲解路径
重点户型 / 房源
资料文件
预约方式
```

### 2. 模块说明结构

```text
模块名称
模块类型
启用状态
对应资产
展示目的
适用客户
入口页面
关联转化动作
```

### 3. 讲解路径结构

```text
路径名称
适用客户类型
客户决策阶段
路径目标
页面顺序
每页讲解重点
可跳转页面
结束动作
```

### 4. 比较页面结构

```text
比较页面名称
比较对象
比较字段
视觉资料
差异说明
推荐结论
下一步动作
```

## 六、第一版产品流程

### 1. 资料结构化

```text
项目
→ 模块
→ 户型 / 房源 / 眺望 / 资料
→ 讲解路径
→ 比较页面
```

第一版先把这些对象整理成字段，而不是只放在页面文案中。

### 2. 可导出给 Codex 读取

导出内容至少包括：

| 导出对象 | 内容 |
|---|---|
| 项目资料 | 项目名称、位置、卖点、销售阶段、目标客群、启用模块 |
| 模块资料 | 模块名称、启用状态、展示目的、关联资产 |
| 讲解路径 | 路径名称、适用客户、客户阶段、页面顺序、讲解目的 |
| 比较页面 | 比较对象、比较字段、差异说明、推荐理由、下一步动作 |

导出格式可以先支持 Markdown 或表格，后续再支持 JSON。

### 3. Codex 辅助编辑

Codex 第一版主要辅助以下编辑：

| 编辑对象 | Codex 可辅助内容 |
|---|---|
| 页面文案 | 项目介绍、模块说明、卖点表达 |
| 讲解路径 | 整理顺序、补充每一步讲解目的 |
| 比较说明 | 生成差异说明、推荐理由、下一步动作 |
| 多语言版本 | 生成日文、英文或市场适配版本 |
| 管理汇报版 | 把销售展示资料整理成内部汇报表达 |

### 4. 人工确认后回写

AI 输出内容不直接发布，必须经过人工确认。

```text
Codex 生成修改建议
→ 销售 / 产品 / 配置人员确认
→ 回写到对应字段
→ 保存修改记录
```

所有涉及价格、面积、房源状态、交付范围、合同和销售承诺的信息，都以后台确认数据为准，AI 只能辅助表达和整理。

## 七、第一版建议范围

第一版不建议做复杂自动化，应严格围绕“四件事”建立基础能力。

| 范围 | 第一版建议 |
|---|---|
| 资料结构化 | 明确项目、模块、户型、房源、眺望、讲解路径、比较页字段 |
| 导出给 Codex | 支持导出项目说明、启用模块、关键资产、路径和比较页面 |
| Codex 辅助编辑 | 允许 Codex 生成文案、路径、推荐理由和多语言修改建议 |
| 人工确认回写 | 确认后的文案、说明、路径和推荐理由可以回写系统 |
| 版本记录 | 记录修改前后版本、修改人、时间和来源 |

## 八、第一版暂不建议做

第一版不建议一开始就做：

- AI 自动决定推荐房源并直接发布。
- AI 自动改写项目页面并直接上线。
- AI 完全自动生成所有讲解路径。
- AI 替代销售判断客户类型。
- AI 自动承诺价格、交付、面积、可售状态等敏感信息。

所有涉及价格、房源状态、面积、交付范围、合同和销售承诺的信息，都应以后台确认数据为准，AI 只能辅助表达和整理。

## 九、第二版能力预留

第二版不是重新设计，而是在第一版结构化资料和行为数据基础上增强智能辅助。

第一版需要提前预留以下内容：

| 预留对象 | 第一版需要记录什么 | 第二版可支持什么 |
|---|---|---|
| 项目资料 | 项目卖点、销售阶段、目标客户、启用模块 | 检查项目资料是否完整，生成项目摘要 |
| 模块 / 资产 | 类型、标签、适用客户、适用阶段、关联页面 | 自动组合讲解路径，检查资产缺失 |
| 讲解路径 | 客户类型、客户阶段、路径目标、页面顺序、结束动作 | 快速检查路径是否合理，生成新路径草稿 |
| 比较页面 | 比较对象、字段、差异说明、推荐理由、下一步动作 | 检查推荐理由是否清楚，生成比较说明 |
| 客户行为 | 进入路径、查看页面、比较对象、停留、预约动作 | 生成客户行为摘要和销售跟进建议 |
| 修改记录 | AI 输出内容、人工确认人、确认时间、回写版本 | 追踪内容来源，复盘 AI 修改质量 |

## 十、技术评估重点

| 评估项 | 需要判断的问题 |
|---|---|
| 数据结构 | 项目、模块、资产、路径、比较页是否有清晰对象关系 |
| 导出能力 | 是否能导出给 Codex 阅读的 Markdown、JSON 或表格 |
| 回写能力 | 修改后的文案、路径、推荐理由是否能回到系统 |
| 权限控制 | 谁可以导出、谁可以修改、谁可以确认发布 |
| 版本管理 | 是否记录修改历史和来源 |
| 多语言字段 | 中文、日文、英文内容是否能分别管理 |
| 风险控制 | AI 生成内容是否需要审核、敏感信息是否受控 |
| 二版预留 | 第一版字段是否足够支持后续快速检查、行为摘要和自动路径草稿 |

## 十一、验收标准

| 验收项 | 标准 |
|---|---|
| 项目可读 | Codex 能通过导出资料理解项目基本信息、启用模块和展示目标 |
| 路径可读 | Codex 能理解每条讲解路径适合什么客户、按什么顺序讲 |
| 比较可读 | Codex 能理解比较对象、字段、差异说明和推荐理由 |
| 内容可改 | Codex 能基于现有资料生成页面文案、销售话术或推荐说明修改稿 |
| 人工确认 | AI 生成内容不会直接发布，必须经过人工确认 |
| 可回写 | 确认后的内容可以回到系统继续使用 |
| 可追溯 | 修改记录能看到版本、时间、修改人和来源 |
| 二版预留 | 资产标签、路径目标、比较字段、客户行为和修改记录具备后续扩展基础 |

## 十二、最终表达

HOMEVISTA 与 AI / Codex 的融合，不应只停留在“系统里有 AI 功能”。

更重要的是：

```text
让 HOMEVISTA 的项目资料、展示模块、讲解路径、比较逻辑和销售话术，
都能被 AI 快速读取、理解、编辑、检查和再生成。
```

这样，HOMEVISTA 才能从“可组合的展示系统”进一步升级为“可持续编辑和智能复用的房地产销售资料平台”。