225 lines
5.9 KiB
Markdown
225 lines
5.9 KiB
Markdown
# 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 模板线的导入模板从“技术字段驱动”改成“运营可填写驱动”，并把样本字段从“看起来必须手填”收口成“系统优先自动补全、失败才人工补填”的新口径。
|