# 11 GPT模板导入模板中文化与自动样本补全交接 2026-04-18

这份文档用于交接本轮“模板中文化 + 上传兼容 + 自动样本补全”改动。

目标不是讲所有历史，而是让接手同学快速知道：

1. 这轮改了什么
2. 为什么要改
3. 现在运营该怎么用
4. 后续如果继续改，应该从哪里接

## 一、本轮改动目标

本轮主要解决两个问题：

1. 运营下载的 Excel 模板字段太技术化，英文字段不易理解
2. GPT 供料模板中的样本字段原本看起来像“必须人工填写”，但系统其实已经具备自动发现能力

因此这轮统一做了三件事：

1. 下载模板中文化
2. 上传解析兼容中文表头
3. GPT 供料模板支持样本字段留空后自动补全

## 二、已经完成的改动

### 1. 基础站点导入模板中文化

文件：

- [DomainBatchImportTemplateHelper.php](/www/wwwroot/diff-maccms/SEONexus/code/app/common/helper/DomainBatchImportTemplateHelper.php)

已完成：

1. 模板表头改为中文
2. 字段顺序重排为“主填写区在前”
3. `notes` 改为运营可理解的人话说明
4. `template_summary` 补充：
   - `template_type`
   - `filling_guidance`
   - `operator_notice`

### 2. 基础站点导入上传兼容中文表头

文件：

- [Site.php](/www/wwwroot/diff-maccms/SEONexus/code/app/admin/controller/Site.php)

已完成：

1. `uploadDomain` 不再死绑固定列号
2. 现在会先读取首行表头
3. 再通过 `normalizeHeader(...)` 映射回内部字段
4. 因此中文表头和旧英文字段都能兼容

### 3. GPT 供料模板中文化

文件：

- [DomainSupplyBatchTemplateHelper.php](/www/wwwroot/diff-maccms/SEONexus/code/app/common/helper/DomainSupplyBatchTemplateHelper.php)

已完成：

1. 模板表头改为中文
2. 字段顺序重排为：
   - 运营主填写区
   - 自动样本区
   - 技术参数区
3. `notes` 明确说明：
   - 哪些字段通常先填
   - 哪些字段通常可以留空
   - 哪些字段只有技术同学需要关心

### 4. GPT 供料模板支持自动样本补全

文件：

- [DomainSupplyBatchHelper.php](/www/wwwroot/diff-maccms/SEONexus/code/app/common/helper/DomainSupplyBatchHelper.php)

已完成：

1. 供料模板上传后，如果以下字段为空：
   - `detail_id`
   - `detail_slug`
   - `search_keyword`
   - `category_parent`
   - `category_child`
2. 系统会优先调用自动样本发现
3. 若自动发现成功，则回填并继续处理
4. 若自动发现失败，才把这些字段继续记为缺失

## 三、自动样本补全依赖什么

自动样本补全不是凭空猜，它依赖现有自动化能力：

### 自动样本发现

文件：

- [DomainAutoSampleHelper.php](/www/wwwroot/diff-maccms/SEONexus/code/app/common/helper/DomainAutoSampleHelper.php)

会自动产出：

1. `detail_id`
2. `detail_slug`
3. `search_keyword`
4. `category_parent`
5. `category_child`
6. `play_type`
7. `play_index`

### 轨迹探针

文件：

- [DomainTrajectoryProbeHelper.php](/www/wwwroot/diff-maccms/SEONexus/code/app/common/helper/DomainTrajectoryProbeHelper.php)

会用自动样本继续验证：

1. 首页
2. 搜索
3. 详情
4. 播放

## 四、现在运营应该怎么用

### 1. 只做基础建站

使用：

- 基础站点导入模板

优先填写：

1. 域名
2. 站点名称
3. 模板ID
4. 首页标题
5. 首页关键词
6. 首页描述
7. SEO策略

### 2. 要做 GPT 启动包和供料

使用：

- GPT 供料模板

优先填写：

1. 域名
2. 站点名称
3. 模板ID
4. 首页标题
5. 首页关键词
6. 首页描述
7. SEO策略

下面 5 个字段通常先留空：

1. 详情样本ID
2. 详情样本Slug
3. 搜索样本关键词
4. 父分类Slug
5. 子分类Slug

原因：

1. 域名部署成功后可从真实站点链路自动发现
2. 若当前只是试跑库，只要库里有可用视频，也会优先自动提取
3. 只有自动发现失败时才人工补

## 五、当前边界

这轮虽然已经大幅改善体验，但还要明确边界：

1. 如果域名未部署成功，自动样本不一定能从前台链路补全
2. 如果试跑库本身缺少有效视频样本，也可能自动失败
3. 如果分类 slug 数据本身缺失，`category_parent / category_child` 可能补不全

所以正确口径不是“永远不用填”，而是：

1. 通常先留空
2. 系统优先自动补
3. 自动失败再人工补

## 六、当前推荐口径

以后对运营和接手同学统一这么说：

1. 基础站点导入模板：先做站点基础信息
2. GPT 供料模板：做 GPT 启动包与供料
3. GPT 供料模板里的样本字段通常先留空
4. 系统会优先自动样本发现
5. 只有自动发现失败时，才需要人工补样本字段

## 七、后续如果继续改，优先从哪里接

### 优先级 P1

1. 在后台下载模板按钮旁增加一句提示文案
2. 在上传结果页把 `operator_notice` 更明显展示出来

### 优先级 P2

1. 让基础导入成功后，直接给出“下一步请使用 GPT 供料模板”的入口
2. 在供料模板执行结果页，把“自动样本已补全哪些字段”展示得更直观

### 优先级 P3

1. 如果后续还有别的模板线，也统一改成中文表头 + 人话 notes
2. 把所有模板下载入口的摘要口径统一化

## 八、关联文档

建议接手时一起看：

1. [README.md](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/README.md)
2. [10-GPT模板运营导入模板使用说明-2026-04-18.md](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/10-GPT模板运营导入模板使用说明-2026-04-18.md)
3. [08-GPT模板其它服务器更新交接-2026-04-18.md](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/08-GPT模板其它服务器更新交接-2026-04-18.md)

## 一句话交接

> 本轮已经把 GPT 模板线的导入模板从“技术字段驱动”改成“运营可填写驱动”，并把样本字段从“看起来必须手填”收口成“系统优先自动补全、失败才人工补填”的新口径。