SEONexus/docs/gpt-template-seo/11-GPT模板导入模板中文化与自动样本补全交接-2026-04-18.md

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

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

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

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

一、本轮改动目标

本轮主要解决两个问题：

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

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

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

二、已经完成的改动

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

文件：

• DomainBatchImportTemplateHelper.php

已完成：

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

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

文件：

• Site.php

已完成：

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

3. GPT 供料模板中文化

文件：

• DomainSupplyBatchTemplateHelper.php

已完成：

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

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

文件：

• DomainSupplyBatchHelper.php

已完成：

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

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

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

自动样本发现

文件：

• 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

会用自动样本继续验证：

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
2. 10-GPT模板运营导入模板使用说明-2026-04-18.md
3. 08-GPT模板其它服务器更新交接-2026-04-18.md

一句话交接

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