feat: improve gpt import templates and seo docs
This commit is contained in:
Your Name
224
docs/gpt-template-seo/11-GPT模板导入模板中文化与自动样本补全交接-2026-04-18.md
Normal file
224
docs/gpt-template-seo/11-GPT模板导入模板中文化与自动样本补全交接-2026-04-18.md
Normal file
@@ -0,0 +1,224 @@
|
||||
# 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 模板线的导入模板从“技术字段驱动”改成“运营可填写驱动”，并把样本字段从“看起来必须手填”收口成“系统优先自动补全、失败才人工补填”的新口径。
|
||||
Reference in New Issue
Block a user