# 三束光官网 —— AI 修改指南

这份文件告诉任何一位 AI（或人类协作者）如何**读取**和**改写**这个网站。

## 一、站点开放的机器可读文件

| 文件 | 用途 | 大小 |
| --- | --- | --- |
| `llms.txt` | AI 抓取入口索引，先看这个 | ~2KB |
| `content.json` | **全站文案数据源**，改它就改了网站 | ~12KB |
| `llms-full.txt` | 全站正文纯文本，不想解析 JSON 就读它 | ~6KB |
| `site-source.html` | 完整源码（图片 base64 内嵌），单文件可运行 | ~1.5MB |
| `index.html` | 官网页面本体 | ~60KB |

读取方式：`curl <站点根URL>/content.json`，或直接让 AI 访问该 URL。

## 二、修改流程（推荐）

1. 获取 `<站点根URL>/content.json`
2. **只修改其中的值**，不要增删字段、不要改键名、不要改嵌套层级
3. 保存为 UTF-8 编码的 JSON
4. 把文件放回站点根目录，覆盖原 `content.json`
5. 刷新页面（Ctrl+F5）即可看到更新 —— `index.html` 启动时会优先加载 `content.json`

> 不需要改动 HTML、CSS、JS。若确需改版式，再动 `site-source.html` / `index.html`。

### 页面结构（改文案时请对照）

网站自上而下只有五个板块，围绕业主的四个判断展开，不要随意新增一级板块：

| 顺序 | 板块 | 对应字段 | 回答业主的问题 |
| --- | --- | --- | --- |
| 1 | 住宅案例 | `cases` | 效果喜不喜欢 |
| 2 | 设计服务 | `services` + `smartHome` | 服务适不适合 |
| 3 | 关于三束光 | `about`（含 `members`） | 交付靠不靠谱 |
| 4 | 常见问题 | `faq` | 异地、介入时机等顾虑 |
| 5 | 预约咨询 | `contact` | 怎么联系你 |

导航栏固定为：住宅案例 / 设计服务 / 关于三束光 / 常见问题 / 预约咨询。

### 字段明细

- `hero`：首屏 `eyebrow` 品牌行、`title1/title2` 主标题、`sub` 副标题、`btn1` 跳「住宅案例」、`btn2` 跳「预约咨询」
- `services`：`kicker/title/lead` 板块标题；`deliverTitle` + `deliverables[]`（`icon/title/desc`）是**交付成果**卡片；`processTitle` + `process[]`（7 步配合流程，`num` + `title` + `desc`）
- `smartHome`：全屋智能，作为「设计服务」下的模块展示，`items[]` 五大系统（`id/title/desc/icon`，`icon` 限 bulb/shield/curtain/hvac/plug）+ `note`
- `cases.items[]`：`id/cat/catName/title/loc/year/scene/image/desc`，`image` 为 `assets/img/` 下的相对路径
- `cases.craft[]`：施工工艺节点，结构与 cases 相同，`image` 可为空
- `about`：`paragraphs[]`、`quote`、`stats[]`（`num/suffix/label`）、`memberKicker/memberTitle`、`members[]`（`name/role/photo/bio[]/tags[]`）、`philosophy[]`
- `faq.items[]`：`q` 客户提问、`a` 你的回答。回答控制在 80–160 字，直给结论 + 具体做法
- `contact`：`kicker/title/lead` + `items[]`（`icon/label/value/link`）、`qrImage`、`wechatHint`
- `company`：`name`、`footer`

## 四、改写规则

1. 保持中文语境与品牌口吻：专业、克制、有温度，不用浮夸营销词
2. 业务口径固定为「室内住宅灯光设计 + 全屋智能（米家生态）」，不要擅自加入未确定的业务（博物馆、景观、文旅等尚未上线）
3. 核心联系方式等必须原样保留：`188 1411 1885`、地址「广东省广州市南沙区香江国际3号楼2105」
4. `desc` 类描述控制在 60–140 字，适合卡片展示
5. 数组类字段（bio、tags、philosophy、paragraphs）一行一条，不要合并成一段
6. 图片只写 `assets/img/` 下的相对路径，不写外链，不用 base64
7. `faq.items[].q` 必须是**业主真实会问的口语问题**，`a` 先给结论再给做法，不要含糊、不要推销感
8. 已有事实不要编造改动：10 年经验、3000+ 方案、异地落地城市（上海 / 成都 / 悉尼）、备品比例 10%-15%

## 五、给 AI 的现成提示词

```
请读取这个网站的数据源：<站点根URL>/content.json
以及修改指南：<站点根URL>/ai-guide.md

任务：把「XXX」部分改成 XXX 风格，要求：
1. 只改 JSON 的值，字段结构保持不变；
2. 文案专业克制、有温度，不超过 XXX 字；
3. 联系方式与公司名不得改动；
4. 输出完整的 content.json 原文（不是差异片段），方便我直接替换。
```

## 六、本地使用

- 双击 `index.html` 或 `site-source.html` 即可离线打开（双击模式下读不到 content.json，用页面内置的备份数据渲染）
- 需要 `content.json` 生效，请用本地服务器打开，例如：在此目录执行 `python -m http.server 8000`，访问 `http://localhost:8000`
- 页面右下角 ✎ 按钮可打开可视化后台，支持「导出数据 content.json」与「保存并下载新文件」

## 本版新增可编辑内容
services.examples：交付示例（title/desc/image/caption）。feedback：入住反馈（title/lead/items）。案例新增 needs/designNotes/planImage/construction/constructionImage/livingFeedback。缺失资料保持空值，不补造客户评价。团队与这些新增内容可用网页编辑面板上传图片、填写资料并导出 content.json；导出不会自动更新在线站点。

## 多图与合作板块
案例和交付示例的 gallery 是图片列表，每项为 src/title/caption。编辑面板支持批量上传 JPG、PNG、WebP，逐图说明、排序和删除。未上传图集时回退显示 image。partners 为 B端合作内容。落地跟进是基础服务，灯具和智能是可选配套。