跳转到内容

SEO_FEEDBACK_RUNBOOK

本机链路已跑通:每周只读采集 → 24 页生产检查 → 来源/覆盖校验 → 每月机会与整改草案 → 人工审核合并发布 → 固定 28 天效果回看。普通周只保存本机记录,月度集中反馈;确认的网站故障或持续采集失败在发现后提前提醒。六语言研究记录已建立;免费排名样本、当地 SERP 和原生审核尚有缺口,不能称为六市场完整流量研究。

工作流

优先英语、简中、繁中。六语言分为七组,国家与搜索引擎独立保存:

页面语言市场/引擎自身搜索来源当前研究状态
enUS / GoogleGSC12 候选;Semrush 10 行;3 组 Trends
zh-CNCN / 百度百度搜索资源平台官方导出12 候选;当地页面措辞;官方数据待导出
zh-CNSG / GoogleGSC12 候选;Semrush 10 行;3 组 Trends 未返回可用曲线
zh-TWTW / GoogleGSC12 候选;Semrush 10 行;3 组 Trends,其中新闻无曲线
jaJP / GoogleGSC12 候选;Semrush 根域 10 行为多语言旅游词,已排除;3 组 Trends
koKR / GoogleGSC12 候选;3 组 Trends;排名报表等待免费额度
viVN / GoogleGSC12 候选;3 组 Trends;排名报表等待免费额度

84 条均为待审核假设,0 条已采用验证词。每组覆盖新闻阅读、带文本的听力、视频字幕三个任务。日语页面面向使用日语界面的学习者;日本国家数据库不能代表日语母语用户,台湾数据库也可能有日文原词。

  1. 本机开机、保持唤醒,Codex 桌面运行。此为当前聊天的本机定时任务,关机或退出应用期间不能保证执行;恢复后先查最后一次有效记录,不补造缺失结果。
  2. Node 22+(本次 v24.16.0)、现有 Clash 出站可连接 Google API、生产 Web 与 GitHub。浏览器和终端分别验证。Codex 的受限终端本次不能直连;经批准的普通本机进程可读 API。网络错误不能当成权限错误或无流量,不改系统路由来绕过限制。
  3. ~/.config/yomiya/web-growth.json 与 ga4-readonly.json,0600。GA Viewer、GSC Restricted,三个 API 已启用;只用 analytics.readonly / webmasters.readonly。凭证不进 Git、报告或浏览器。
  4. 工程路径保持存在:/Users/cc/Documents/root-remote/.worktrees/seo-six-locales/product/YomiyaProductAnalytics/engineering/yomiya-service-analytics。PR #429 合并后可迁到 Root/main;先确认提交、配置及受限缓存迁移,再更新定时任务路径。不可自动回退到有其他改动的主 checkout。
  5. 免费竞品研究需要已登录 Semrush、可用浏览器连接和实际剩余额度。2026-10-03 看到每日 10 次额度已用完;下一轮先读 research-queue.json 的 KR/VN。表格的目标域、根域/子域模式、国家、Google、桌面、自然排名及数据日期均要可见。停止于升级、付费、试用或需要人工确认的验证码;拒绝示例行和筛选不匹配行。
  6. 原生审核与目标地区网络出口仍需配合。保存地区出口、Google 结果页底部地区、查询语言、结果意图、审核人和日期;API/模型翻译不能替代这些证据。百度使用官方导出,Google Trends/GSC 不替代百度。

在上面的分析工程目录运行,不安装新依赖:

Terminal window
node scripts/seo-cycle.mjs doctor
node scripts/seo-cycle.mjs run
node scripts/seo-cycle.mjs status
node scripts/seo-experiments.mjs

run 自动调用已有 collect-web-growth.mjs collect。GA 固定属性 552033117、流 15522999439、主机 web.yomiya.cc;读取属性时区 America/Los_Angeles,以 T−2 截止。首轮 56 天,28 天对照;GA 窗口用户去重不按天相加,GSC 重读近 7 天和此前 pending/失败日期。Google 自然落地会话与学习启动额外固定 google / organic,不混进 Direct 或其他搜索引擎。

降为每周运行后仍读取完整窗口。GA 增量从上一覆盖日期往前重读,GSC 遍历窗口内日期、补读没有有效缓存的日期;停机或错过周一不把缺失日期补成零。每周采集同时运行 seo-experiments.mjs,继续补读待处理的固定历史窗口。

status 和 cycle.json 的 schedule 区分每周采集、首个周一的竞品研究以及月度复盘。首次复盘为 2026-11-09,此后每月首个周一;错过时可在当月后续周一补做。普通周 draft-batch.json 不产生整改草案。月报完成后登记反馈月份,重跑同月只保留本机结果;不能仅因采集完成就登记:

Terminal window
node scripts/seo-cycle.mjs review-complete --period 2026-11

此命令不连接 Google,只在月份与最新有效、可复盘周期匹配时更新受限 ledger.json 的 reviewed_periods,保留保护词与已有 PR 记录,重复登记不累计。月报已说明搜索数据待积累也可登记月份;后续周运行继续补读,下一月再次复盘。

已有快照重放与百度入口:

Terminal window
node scripts/seo-cycle.mjs run --snapshot /absolute/run/aggregate.json --website /absolute/run/website.json
node scripts/seo-cycle.mjs run --baidu /absolute/private/baidu-export.json
node scripts/competitor-keywords.mjs import --input data/competitor-keywords/research-input-v4.json --out /tmp/yomiya-competitors-new
node scripts/competitor-keywords.mjs validate --run /tmp/yomiya-competitors-new
node scripts/seo-research.mjs validate --input data/seo-six-locales/seed-records.json

--snapshot 必须属于已通过摘要校验的完整产物目录;历史快照即使刚重新采集也不能推动当期提案。--website 仅用于可追溯重放,日常使用实时检查。百度模板 baidu-export.template.json 必须补官方来源、抓取时间、窗口与真实行;空模板不代表已验证。百度导出放受限目录,不提交原始后台材料。

退出码 0=完整数据通过,2=执行完成但部分来源或检查待就绪,1=执行/校验失败。必须阅读 execution_status、逐来源及 research_status;GSC pending_data 的 2 不等于链路失败。

  • 每周一北京时间 09:00:doctor → 新采集/校验 → 24 页与 robots → 实验观察;记录新 GSC 查询、保护当地原词。普通周不聊天反馈、不形成文案整改 PR。初始竞品缺口未补齐时,按实际免费额度继续 KR/VN 等队列,不额外启动每日任务。
  • 每月首个周一研究:刷新竞品样本、来源日期与缺口,核验当地措辞、SERP、产品适配和同国同图的 Google Trends;免费额度不足的部分留待后续周运行。旧样本不覆盖。再看任务/问题表达,而非机械追逐大站头部词。
  • 每月复盘与整改:2026-11-09 首次,此后每月首个周一。月报集中回答新出现的搜索词、获得流量的页面、自然流量的学习启动和下一批值得改什么。最多 3 个不同页面进入草案,同一页面和已提 PR 去重。发布后的同一页面文案实验至少观察 28 天;确认的技术缺陷可提前提醒、人工决定修复。
  • 故障例外:网站响应/索引配置问题需要有限复查,采集失败先有限重试;单次网络问题、GSC 待积累、低样本、免费额度不足、原生审核待配合均留本机记录并入月报。确认故障以稳定指纹登记到受限 ledger.json 的 fault_alerts,同一未解决问题不重复提醒;恢复后清除对应故障状态。每周检查只在运行时发现问题,不提供全天监控。
  • 人工审核:通过原生用词、SERP 与功能核对后,生成或更新整改 draft PR,记录 decisions.json 的 PR URL 和 proposal_ids。人工合并、人工确认 Release Deployment。定时任务不自动合并、部署、付费或发送 Slack/邮件。

机会阈值(100 展示、平均位置 4–20)只是待复核筛选,不是增长保证。当前 0 草案:搜索数据待积累且 84 条候选均未完成原生/地区核验。没有证据时保留观察状态,不为完成任务硬改标题。

已观测有效词保存在受限 ledger.json;英文文案更新前核对当地保护词与既有采用记录,不批量重译覆盖。未来新增 PR 要在 decisions.json 登记;发布后登记精确 SHA、实际 Web 完成时间、页面、市场、改动和观察窗口。

#1722 实际 Web 完成于 2026-10-03 15:03:05 北京时间。发布日按 GA 时区为 10-03,排除这一天:

阶段固定窗口(America/Los_Angeles)处理方式
发布前2026-09-05—10-02T−2 可读后首次冻结带哈希快照;09-04—10-01 的当前快照只是预发布背景
发布后2026-10-04—10-31完整 28 天且 T−2 可读后再冻结,不能提前拿短窗口对比
首次周采集/冻结前窗2026-10-05 北京时间 09:00处理完成时冻结前窗;未完成则记录待处理并留待后续周运行
首次完整回看11-02(GA 当地日期)起符合日期门槛每周任务安排北京时间 2026-11-09 首次完整效果复盘,仍以实际 API 出数为准
后续月度复盘2026-12-07 起,每月首个周一集中反馈;有完整固定实验窗口时合看,没有则继续观察

seo-experiments.mjs 自动等待窗口、复用已冻结快照并校验哈希;来源 pending 时每周重试该历史窗口。精确页面/国家/设备对照 GSC 点击、展示、CTR/排名背景及 GA Google 自然会话、互动会话、学习启动事件。脚本目前自动比较点击、展示、会话、互动会话和学习启动;CTR/排名仍查原始页面/查询报表,避免将名次变化简单相减当作效果。

韩/越页面继续 noindex:它们的搜索表现不纳入增长验收预期。index-policy.json 只在精确页面审核、合并并发布后与 Web 的 seoPageReviews.ts 同步。百度观察采用官方原生窗口,单独回看,不复用 Pacific/Google 数值。

缺行、低样本、截断、隐藏查询仍为未知。learning_start 是学习启动;不是完成、安装或某关键词用户的转化。发布前后比较是观察关联,不能直接归因。回看结果先供人工决定保留、继续观察或建立下一实验,不自动回滚或再次改写。

页面汇总与播放分类(2026-11 修订)

Section titled “页面汇总与播放分类(2026-11 修订)”

每个 28 天窗口分别直接读取 reports.gsc[period].page_totals(仅 page 维度), 同时保留 totals、queries 与 pages。该公开页面样本不从高维明细相加, 也不要求与站点汇总相等。JSON、gsc-*-page_totals.csv、采集报告及周期报告 列出页面点击、展示和前后变化;缺行保持未知。API 分页、截断、私人路径和未验证 路径的过滤行数在 report/manifest 保留。仅发布已知静态公开路由及本轮公开 sitemap 证明的内容页,不能把过滤后的样本称为全站分布。

reports.ga[period].playback_errors 是可选分类报表,按事件级参数 error_code、error_phase、media_provider、playback_trigger、analytics_version 分组,仍固定目标流及主机。维度不存在时标 pending_configuration,存在但无行时 标 pending_data;基础采集继续。低用户单元仍抑制,历史未分类事件不补造原因。 成功分类报表另存 latest-playback-errors.json 指针,失败或等待不会覆盖该指针。 acceptance.playback_v2 单独记录新版生产事件验收,不沿用旧 Realtime 记录。

GA 的上述五个维度由已有 Editor 账号在属性 552033117 建立为 Event scope; 采集服务账号不加写权限。新维度、参数和已处理报表需要分开验收,实际可读性由 Data API metadata/报表确认。Web 人工发布后再进行受控真实播放,先核对请求与 Realtime/DebugView,处理后读回标准报表;每个阶段独立保留状态。

此修订不重写冻结快照、不重置 #1722/#1748 窗口。旧快照没有 page_totals 时显示 not_collected;补读使用独立 config/output 留附件,不回填旧文件。新源码合并前 不改已有锁定 runtime;合并后验证源码提交与文件摘要,再更新 runtime manifest 及原 ledger 的来源锚点,继续显式使用原受限 --out、缓存和测量索引。 周一 09:00 及月度复盘频率保持原样。

旧版冻结快照可能把含 pending 报表的 GSC 来源标成 ok。校验时继续验证其原始文件 哈希,返回兼容警告与 source_assessment.gsc=partial,不重写历史声明。周期报告和 实验比较采用重新评估的状态,不能因此提升有效指针或宣称数据完整。带日期覆盖或 新页面汇总的现代快照仍严格拒绝伪造完成状态;旧格式兼容不放宽新采集验收。

针对性回归:

Terminal window
node --test scripts/lib/web-growth.test.mjs scripts/lib/web-growth-page-totals.test.mjs scripts/lib/seo-cycle.test.mjs

GA/GSC 产物:~/Library/Application Support/YomiyaAnalytics/web-growth/runs/。自反馈:工程的 analytics/private/seo-cycle/runs/,目录 0700、文件 0600,Git 忽略。

每轮保存 cycle/report/website/draft-batch 和 SHA 清单;清单包含快照、候选、市场、证据、决策与索引策略摘要。run.lock 阻止并发;遗留锁必须确认无进程后人工处理,不自动夺锁。latest-valid 只在 GA 可读、GSC 可读或待积累、网站检查通过且产物校验成功时更新(数据仍可能 partial);latest 只在所有来源及网站完整可用时更新。失败仅更新 latest-attempt,保留上一有效结果。测量状态在 measurements/latest.json,固定窗口索引 measurements/windows.json。

业务数据、后台截图、凭证不进 Git。允许入 Git 的是来源明确的竞品样本、任务候选、脱敏验收、脚本、文档与用户要求的工作流图。

当前验收见 SEO_FEEDBACK_ACCEPTANCE.md,研究结论与下一批整改见 SEO_SIX_LOCALES.md。

工作流图片更新记录与提示词

2026-10-03 使用内置 imagegen 编辑原图,保存为 docs/assets/seo-feedback-workflow.png。原始生成文件仍保留在本机;图中 #1722、84 候选及 GSC 状态是当日快照,实时状态以每轮数据为准。图片表达周采集、月研究/复盘、人工合并发布与满 28 天观察;首轮效果复盘例外安排 11-09。

提示词:

Use case: text-localization. Asset type: Chinese workflow infographic, edit target is the supplied Yomiya SEO 自反馈工作流 bitmap. Preserve the existing clean white background, navy Chinese typography, six-card clockwise loop, blue automated collection/research cards and orange human approval/publishing cards, market banner, title and broad layout. Update the operating cadence consistently to 每周采集、每月复盘. Replace every mention of daily collection or weekly opportunity research: Card 1 heading exactly ‘每周采集’; time row exactly ‘每周一 09:00 北京时间’; keep ‘GA · GSC · 24 页技术检查’. Card 2 heading exactly ‘每月找机会’; date row exactly ‘每月首个周一’; keep ‘竞品免费样本 · 当地说法 · Trends’. Top right monthly callout exactly ‘每月首个周一:’ and ‘竞品 · 措辞 · Trends’. Card 3 keep evidence screening and missing not zero. Card 4 heading exactly ‘月度整改 PR’; supporting text exactly ‘每月最多 3 页草案’ and ‘人工审核与合并’. Card 5 keep formal release human confirmation. Card 6 heading exactly ‘满 28 天复盘’; keep clicks/impressions/organic sessions/learning starts and the feedback arrow. Add an easy-to-read bottom strip with exactly ‘普通周仅保存本机记录 · 月度集中反馈 · 确认故障提前提醒’ and beneath it ‘首次周采集:10 月 5 日|首次完整效果复盘:11 月 9 日’. The green #1722 already live, 24 page pass and amber 84 candidate/GSC pending boxes describe the existing 2026-10-03 snapshot and may remain. Keep all 6 languages and 7 markets including CN/百度. Remove all old ‘每日采集’, ‘每周找机会’, weekly PR instructions; no raw scheduler strings, no extra brand assets, no watermark. Chinese text must be legible and accurate. Landscape, same 3:2 aspect ratio, expand bottom whitespace as needed without cutting labels.