AnvilWiki: Instructions file for Codex

AGENTS.md

Workspace instructions for ZCode agents working on AnvilWiki.

Repository Purpose

AnvilWiki is an open-source (MIT) game wiki site template built with Astro 7 + Cloudflare Pages. It is a static-first Astro setup that deploys to Cloudflare with zero adapters and enjoys free unlimited bandwidth.

Goal: let beginners deploy a game wiki site to Cloudflare Pages for free (unlimited bandwidth) in ~30 minutes, with strong SEO, i18n, and ad-monetization built in.

Status (as of 2026-10-22): 当前最新 v2.38.0(根路径项目门面+遥测门控+作者身份批,2026-10-22,详见 CHANGELOG [2.38.0]——四主线:①demo 根路径改项目门面(/ 301→/zh/landing/、英文 wiki 样品首页迁 /demo/,d4fce65;RootGateway 影子页=🚨 survive 文件永不进删除清单,fork 构建逐字节零变化,redirects.test 契约钉)②手册课页/落地页顶部挂紧凑 native banner(700×240 复用既有单元,实测定档最小横排形态)③VibeCafé 遥测 env 门控化(PUBLIC_VIBECAFE_* 双键,堵 b031948 硬编码 demo 值经 BaseLayout 泄漏给 fork,env 门控+三通道注册+双语隐私披露+CHANGELOG 四件套,开箱零第三方脚本契约恢复)④主理人公开身份落地(落地页「关于作者」AuthorCard 区块+README 中英作者行+authors.ts 过期域名 yuanruiqin.dev→ruiqin.dev 修正);另含第 35 轮以来 24h 审计深挖修复与文档漂移批全量记账;test 401(24 套件)+八门禁绿)。v2.37.0(apply-template 双语界面定版+第五次全项目代码审查全面修复批,2026-10-03,详见 CHANGELOG [2.37.0]——CLI 中文化=交互 TTY 开头问界面语言(1=中文/回车按 LANG 推导/--lang zh|en),非交互永不提问缺省英文、18 项答案位置序与 E2E 英文标记字节不动,新 lib/apply-template-i18n 词典+契约 6 条;审查批=28 文件分片评审+独立复核 10/10 确认,0高+1中+9低全修:中=consent 两字面量 3 组件硬编码零契约(fail-closed=单侧改名同意读不到、广告静默永不加载)→新 tests/consent.test.ts 钉死+四处注释口径统一;低×9=NavigationItem.order 死字段四面根除(navigation/apply-template 生成串/docs「order 必填」误导)/covers.ts replace $ 特殊展开改函数回调($' 可把正文拖进 frontmatter 且 build 不红,v2.7.1 同族)/getUi 模块级缓存/删 t() 死代码/isLocaleSafe 改 routing.isLocale 单源/content.ts 双 import 合并/llms.txt 删与 site.description 双源漂移枚举句/rss language 走 defaultLocale/landing.ts 悬空注释;附带 eslint ignores 补 .zcode/;同版并入 /zh 裸路径 301 四条+文档漂移批+codes 页月锚点门禁(codes-consistency 第三组)。test 375→390(24 套件)+八门禁绿)。v2.36.1(第四次全项目三维代码审查全面修复批,2026-09-27,详见 CHANGELOG [2.36.1]——0高+4中+27低全修:六路审查代理按文件所有权并行+主会话逐条亲验,五路修复代理并行+脚本 world.run 确定性九门禁收口。中×4=①rewriteSiteTs 重跑值感知保留手填可选字段(contactEmail/social./sameAs/defaultAuthor,新 DEMO_SITE_OPTIONAL_VALUES 注册表,unreadable 逐字段 ⚠️,对齐 wrangler 通道 value-aware 哲学,demo 首跑输出字节同形)②rewriteLocaleJson 重跑保留手写 overview+home 覆盖非骨架现值前 ⚠️(rerun 门控=isDemoLocaleContent===false,v2.6.3 首跑防 demo 泄漏语义原样)③check-content 图片包裹链接对规则4/5/6 隐形根治(旧负向后顾正则锚外层 [ 捕获资产 URL——页链不进尾斜杠/locale 前缀检查且资产稀释内链计数;新 lib/link-scan.ts 纯函数剥图后提页链,资产退出计数,行为级测试 spawn 真脚本钉)④sync-codes expired→active 复活独立 reactivated 桶+CLI ⚠️(复活保留,补信号)。低×27=重跑主题色 globals.css 反推默认/askBool scripted toLowerCase/空分类 '[]'/new-post category 规范化+穿越拒绝+yamlQuote/new-locale 改 lib 单源 isLocaleCode+localeIdent+KNOWN_LOCALE_LABELS 超集+新 lib/atomic.ts 原子写(zh-tw/pt-br 不再拒)/authors 正则下沉 stripDemoAuthors 单源+else ⚠️+真实文件双通道契约/wrangler [vars] 未识别行逐行 ⚠️/check-sitemap 子站失败合成结果响亮 exit 1/check-i18n 非默认 locale 坏 JSON 计入 missingUiKeys ❌/资产扩展名单源 lib/asset-extensions.ts(两表并集+mp4/pdf/zip/webm 裁决纳入)/check-config domain 双引号容差+template-audit draft frontmatter-only/navKeys 前置界定+注释剥离/check-config+template-audit 两处同改/gen-assets manifest try/catch+tmp+rename/bulk-new-posts 原子写/表头重复列响亮/parseCodesBlock 重复 code 响亮/新 lib/slugify.ts Unicode 单源/新 lib/fonts.ts Noto 钉 tag Sans2.004(实测四 OTF HEAD 200)/favicon initial XML 转义/authors '/about/'尾斜杠+seo.test 门禁/面包屑 JSON-LD Home 改 homeUrl+断言/CookieConsent z-[60] 层级契约注释/404 五条硬编码进 shared.notFound en+ja 双语/content-pipeline issue close ::warning::/setup.yml concurrency setup-init 排队/ops insights 走 worker offload(新 insights 通道,cliEquivalent 映射)/pnpm 版本单源(删 8 处 version: 输入读 packageManager+契约防回退);ops 1.0.6 随批发 npm;新套件 tests/content-links.test.ts(22→23),test 325→375+九项门禁(含 ops test)全绿+CHANGELOG 记账后复核绿+E2E 绿;安全性维度第四轮零实质发现)。v2.36.0(IndexNow 新 fork 零配置化+文档保鲜批,2026-09-23,详见 CHANGELOG [2.36.0]——核心=#57(cc6f0a2,oyjq0000 Follow-up to #46):IndexNow 站点身份从「Cloudflare+GitHub 双份环境变量」改为仓库根单一 .indexnow-key(Initialize/apply-template 首跑生成 64 位 hex、重跑严格复用;新增 pnpm init-indexnow-key 供旧站迁移/主动轮换;postbuild 与 CI 自动提交均优先读它,legacy INDEXNOW_KEY env 降级兼容通道;indexnow.yml checkout 后探测配置,未初始化 fork 安装依赖前退出零请求;round-21 安全链=等精确部署→验线上 key→读生产 sitemap→429/5xx 退避全保留;单测 322→325+E2E 钉首跑生成→重跑不换 key→postbuild 同名输出);文档保鲜=Adsterra 反欺诈政策边界(docs/ads.md 政策边界条+手册课 22 双语接入主路改写:合规三条件可见/原始尺寸/一份代码一个位,Popunder/Social Bar 不进 iframe)+PRD §3 架构树脚本计数 15→16(init-indexnow-key 入枚举,七天漂移审计发现);八门禁绿)。v2.35.2(第 23 轮 24h 只读风险审计全面修复批,2026-09-22,详见 CHANGELOG [2.35.2]——五类高置信风险零发现(窗口 b1a88fa→18a99c1 单提交=#55 codes 保鲜第四轮),发现×1+信息级×2 全修:①en/ja codes 页正文与 frontmatter 自相矛盾根治(6622d58 翻 ANVIL-DAWN 过期时正文未同步,正文首段「三码有效含 ANVIL-DAWN」+验证日 2026-09-07+奖励表/三实例/兑换第 4 步现在时推荐三个过期码,四轮保鲜只动 frontmatter+summary 不动正文——v2.35.0 中-2 同家族的正文面残留且无门禁;现全面对齐四码口径,过期码过去时+年度复刻框架,验证日 2026-09-22)②首页 en/ja 高亮补 HEARTHFIRE-2026(高亮集==active 集恢复,refresh-audit 缺席方向无检查的空洞由新契约测试补)③新第 22 套件 tests/codes-consistency.test.ts(高亮标签集双向相等+正文验证日句==lastModified,均无时钟依赖,句缺席优雅跳过);test 318→322+八门禁全绿;digest 管道 09-21 夜缺勤第一夜按 round 18 判例观察勿干预)。v2.35.1(第 22 轮 24h 只读风险审计全面修复批,2026-09-21,详见 CHANGELOG [2.35.1]——五类高置信风险零发现(窗口 90a05e7→b1a88fa 八提交,主审 v2.35.0 修复批约 700 行逐 diff+发版+digest T6),信息级×2 全修:①workflows.test python3 契约加可用性守卫(真执行 python3 的五个行为级测试在无 python3 开发机上 spawnSync ENOENT→status null 以费解消息直接红→现 python3 --version 探测后整组明确 skip 带注释,纯字符串契约照跑,CI ubuntu 门禁强度零变化)②buildHomePreset pickHref 按 preferred 键记忆化(codes preset 快开卡+explore 高亮双槽位在 4 类全选不含 codes 时各槽独立选「首个未占用类」分叉两页→substituted Map 同键恒同替换页+警告收敛单次;apply-template.test 新增两槽一致性+codes 入选基线契约);test 316→318+八门禁绿)。v2.35.0(第三次全项目三维代码审查全面修复批,2026-09-20,详见 CHANGELOG [2.35.0]——2高+7中+16低全修,6 路代理按文件所有权并行+编排器集成收口:高①setup.yml [vars] python 通道值感知化(原整段空白模板重置,重跑 Initialize 静默清空用户已填 Giscus/GA/Adsterra/CF beacon/INDEXNOW_KEY——JS 通道 v2.29.0 同类洞残留,双审查代理独立命中;现按 rewriteWranglerVars 同口径解析现值非空非 demo 回填+Announcements 配对规则折入;workflows.test 真执行 python3 行为级契约+DEMO_VALUES↔DEMO_VAR_VALUES 漂移守卫+二跑字节幂等)高②apply-template 新 locale 克隆默认语言重写输出(原从 {} 起步缺 76 个 UI 键=$schema+search.+shared.,fork 首次 CI check-i18n --strict-ui 必红;enOutput 上提循环外防 ja 先序错克隆,footer playGame 入 reset 面堵 demo 身份经克隆链泄漏);中×7=BackToTop(z-40)遮挡移动锚广告 × 钮(z-30)致关不掉→has-mobile-anchor class 上移按钮 78px+env 双行级联/首页 codes 高亮过期码标 Active→en/ja 统一换当前三 active 码逐字对齐 codes 页 frontmatter+refresh-audit 对账门禁(frontmatter expired 而 badge 非过期词汇 P0+label 缺席退化日期检查)/site.ts description 诚实口径(v2.6.0 漏网第二描述源,JSON-LD/RSS/llms 四消费面)+template-audit 措辞扫描/category↔目录不一致零守卫→check-content 规则 7 error 级/astro.config filter 裸 decodeURIComponent 裸 % slug 炸 build→decodeSitemapPath helper 共用+draft/noindex 正则认行内注释/脚手架 description key≥11 字符超 schema 165→buildScaffoldDescription/buildHomePreset 写死 /codes /bosses /guides 死链→pickHref 确定性归一+stderr ⚠️;低×16 含 per-article noindex 退出详情级 hreflang(两表裁决:localeCoverage 含 noindex 继续喂 fallbackDetailPaths 防 v2.27.0 回归+detailCoverage 剔 noindex 喂 alternates)/空 recent+tags 四页空态 noindex/aria 硬编码英文清零(breadcrumbAria×4+新 shared.wikiNavAria 键+Handbook 两处零新键)/E2E 补 check-i18n --strict-ui 步骤(堵『仅 fork 特定输入触发』盲区,恰端到端覆盖高-2)/changelog.test 版本钉 PROJECT_VERSION↔package.json(低-12 入门禁);test 293→316+八门禁绿+test:e2e 绿)。v2.34.0(第 21 轮全项目红队审计全面修复批,2026-09-20,详见 CHANGELOG [2.34.0]——0×P0/P1、3×P2+3×P3 全修,报告 docs/audits/AUDIT-2026-09-20-round21-full-project.md:P2-1 IndexNow key 单源化=删旧代 key 文件 public/39a73e….txt(a536be6 遗留;生产双 key 并存 curl 200 实证+detectCommittedKey 兼容路径曾静默拾取 demo 旧 key,env -u 干跑 Key source: public 复现)+登记 DEMO_PUBLIC_FILES+submit-indexnow 去 public fallback 与本地生成+新 loadLocalEnv 使「本地 .env 双通道」死配置变活(修复后干跑 Key source: env,本地 build 产出 dist/.txt)+轮换文档补第四处=已部署旧 key 文件本身;P2-2 wrangler [vars] 重写双通道(JS+setup.yml python)未知键原样保留+stderr 警告(此前 fork 自定义 env 重跑静默丢失,纯函数复现实证),字节幂等;P2-3 setup.yml gh pr create 改先 pr view 探测(原 || echo 吞一切失败=绿灯无 PR);P3-4 landingLinkEnabled 翻转 CLI no-match ⚠️+sed grep 守卫+e2e 断言;P3-5 template-audit 新增 wrangler [vars] 全 DEMO_VAR_VALUES 扫描(此前 INDEXNOW/GA/Adsterra 十二值零检出);P3-6 clear-demo-content 🗑️ 行改 stderr;test 286→293+test:e2e 真实模式绿)。v2.33.1(第 20 轮 24h 审计全面修复批,2026-09-20,详见 CHANGELOG [2.33.1]——CI actions 三件套 Node24 化:checkout v4→v5.1.0/setup-node v4→v6.5.0/pnpm-action v4→v6.1.0 共 24 pin×6 workflow,runs.using=node24 逐一实证,Node20 弃用警告清零;跨版裁决=checkout 留 v5(v7 封锁 workflow_run fork checkout 与 indexnow.yml 钉 head_sha 的交互无法本地门禁覆盖)/setup-node 跳 v5(packageManager 自动缓存与显式 cache:pnpm 冲突面)/pnpm-action 上 v6(pnpm 11 支持)/create-pull-request v8 实证本就 node24 不动;附带 IndexNow key 四处轮换面文档化(DEMO_VAR_VALUES 注释+deployment.md 轮换节)+roadmap 候选池新增 Pages→Workers 迁移评估定案暂不迁(一票否决=Workers [vars] 不进构建期,正中 apply-template env 单源设计);八门禁全绿 test 286)。v2.33.0(社区贡献批+IndexNow 自动化定版,2026-09-18,详见 CHANGELOG [2.33.0]——核心=IndexNow 环境变量化+CI 成功后自动推送(opt-in,PR #46,+715/-102 20 文件):新增 INDEXNOW_KEY(wrangler.toml 注释态槽位+apply-template 值感知保留+.env.example 双通道),postbuild 有值才产出 dist/.txt;新独立 .github/workflows/indexnow.yml(workflow_run 仅 main push CI 成功且 SITE_URL/INDEXNOW_KEY 两 variables 齐备时运行,checkout 钉 head_sha,经 /.well-known/anvilwiki-deploy.txt 部署标记+headers no-store 确证当前 commit 已上线才读生产 sitemap 提交,429/5xx 三次退避,PR CI 与未配置 fork 严格零请求——合并后 main 首跑正确 skip 实证);pnpm submit-indexnow 升双模式(保留 dist 手工+public/.txt 兼容,新增 --site 生产模式/--wait-for-key/重试,key 规则 8-128 位与协议逐字一致;审查折入:run 步骤 --wait-seconds 150 防 timeout 截断+去 continue-on-error 防 fail 刷绿+生产模式 dry-run 提示语按模式分支);次=fork 重跑保留自有广告单元(public/ads/*.html 改内容感知:DEMO_ADSTERRA_UNIT_MARKERS 六单元 demo key 注册表单源 isDemoPublicFileContent,仍含 demo key 才判 demo,根治保留标准文件名粘自有代码的 fork 被重跑误删+template-audit 误报,真实 fork sandustry.top 反馈;setup.yml rm 清单改调新 scripts/clear-demo-public.ts(单源同规则+--dry-run 对齐姊妹脚本),E2E 已配置 fork 自动跳过+守卫字段序无关,契约测试钉清单↔注册表双向)+VideoObject JSON-LD 补 Google 四必填之 description(videoObjectJsonLd 签名加参,ArticlePage 传文章 frontmatter description,tags.test 钉字段,GSC 视频富结果资格修复)+showcase 第 8/9 站(Warhounds Wiki warhounds.org+Sandustry.top sandustry.top,均 oyjq0000,README 中英两表 main 补行 1c1f490;两站仓库私有回链未公开验证,roadmap 候选池回链标准首例);维护者审查折入批(#46:get-on-google 双语课补 INDEXNOW_KEY 自动推送推荐(第 14 条主课漏面)等四项;#50:GSC token docstring 归位+CHANGELOG 记账+ads.md 措辞+守卫序无关+注册表覆盖契约+逐文件日志);测试 20→21 套件(新增 tests/indexnow.test.ts),test 274→286;附带:当夜 23:00 digest 管道恢复路径曾把全量 12 维写进公开 JSON(契约测试红)+PR 被管道自合并——数据修复 2a3061f 剥离 84 行+管道 prompt CronUpdate 加固(8 键白名单/禁自合并/等 CI/wxid 抓取),属站点数据与管道面不占 CHANGELOG)。v2.32.0(「wiki page templates」模板展示页 en+zh 双语上线,SEO 布局批次 3,2026-09-17,详见 CHANGELOG [2.32.0]——承接 roadmap 候选池记账长尾(SimilarWeb 2026-08:wiki template 约 1,000/月 score 19+wiki page template 约 870/月+wiki template character 约 1,490/月),前置 landing.ts 拆分批(v2.31.1)已完成;六页型卡(Boss 攻略/兑换码/Tier List/新手攻略/装备物品/文档中心)全挂 demo 真实链接(先 ls src/content/wiki/en/ 逐条核实),新文案独立新文件 src/config/landing-templates.ts(自带接口+templatesNavLabel,landing-en/zh 两模块零触碰守住 v2.31.1 拆分),LandingLayout 导航三处(移动菜单/桌面 header/页脚)加 Templates 入口,页面标 data-pagefind-body 进全站搜索,页内对比页互链+fork CTA;🚨 fork 红线三通道同步(apply-template LANDING_PATHS 增 landing-templates.ts 显式条目——新路由已被 src/pages/landing 与 zh 目录级条目覆盖,读现状代码核实不加冗余/setup.yml rm 行/e2e 纯净性断言),test:e2e 绿;一致性扫描 llms.txt 加行+README 中英快速链接表各补一行+roadmap 候选池条目标 ✅ 已交付;移动端验收以 CDP 强制 375px 程序断言为准(resize 钳 468,坑 60/61):en/zh scrollWidth=375 横向零溢出+fullPage 截图留档,八门禁绿 test 274/check-links 11,848 链接)。v2.31.1(landing.ts 拆五模块门面家族+文档修复批,2026-09-17,详见 CHANGELOG [2.31.1]——src/config/landing.ts 63,868B 全仓最大核心文件拆为门面(1,701B,PROJECT_VERSION/类型/COMMUNITY_SITES 全 re-export)+landing-types.ts(8,155B)/landing-shared.ts(5,403B,版本常量落 leaf 防 en/zh→门面循环 import TDZ)/landing-en.ts(26,099B)/landing-zh.ts(25,246B),公共导出与 ~/config/landing import 路径零变化,20 个 importer 零改动,en/zh 文案 sed 逐字节搬移仍 LandingContent 类型注解;八门禁绿 test 274+dist 零漂移钉死(179 html sha256 纯拆分态逐字节一致,v2.27.1 先例);🚨 fork 红线三通道同步(apply-template LANDING_PATHS 补四新文件+setup.yml rm 行+e2e 纯净性断言),test:e2e 真实 fork 模拟绿;文档一致性:PRD showcase 两处/apply-template.md 删除清单表/development.md 版本五处行(PROJECT_VERSION 新址 landing-shared.ts)+体积敏感清单(landing.ts 首例拆分移出)/手册 contribute-back+batch-pages 中英 showcase 指路,SHOWCASE_DATA URL 随定版转指 landing-shared.ts;横幅中英 v2.31.1 通告)。v2.31.0(挖词方法论「泛词噪音核查」判据+roadmap 候选池三条,纯文档批零代码,2026-09-17,详见 CHANGELOG [2.31.0]——docs/sourcing.md 判决框架新增第一道门:搜索量≠需求匹配,先验意图再入决策表,高量泛词(尤其一词多义英文短词)入表前必点开实际 SERP;实例=「wiki game」词族 75,590/月实为维基百科竞速小游戏(66,300 来自 wikipedia game 类变体),与攻略需求零匹配;与第二节「意图满足度」两种错位点破防混(词对供答错=强可做信号 vs 词义本就是另一件事=量再大不是你的需求);anvil-find-keywords Step 2 插同一核查动作,措辞逐字口径对齐(v2.15.1 防漂移先例,标点随各文件惯例)+方法论源头枚举同步+排障序号引用顺改;手册课 5/6 已有等价内容(五步检查表第 1 步+经典错误「只看词面不看目的」)不动避三处重复;roadmap 候选池记账三条(均标数据依据+触发条件)=ja 落地面验证(ゲーム wiki 2,390/月+ゲーム攻略 2,050/月,触发=日文 showcase 站或 ja 社群信号,约束=landing.ts 复杂度预算排拆分批后)/「wiki page templates」展示页(wiki template 1,000/月 score 19+wiki template character 1,490/月,排 landing.ts 拆分批后)/showcase 收录标准补站点 README 回链 anvil.wiki(反向链接实测全站仅 28 引荐域且均为自动收录型,外链最短板);八门禁绿 test 274)。v2.30.0(对比页新增「为什么 Fandom 用户搬家」节,2026-09-17,详见 CHANGELOG [2.30.0]——comparisonPage 接口新增顶层字段 fandomSwitch(title/subtitle/items×4/note,中英同步 typecheck 拦漏译),渲染于核心对比表与自托管引擎之间,现有节文案/结构/URL 零改动保收录;承接 SimilarWeb 2026-08 挖词「how to create a wiki template on fandom」约 1,380/月+「templates fandom」约 610/月的 Fandom 模板受限意图(数据入节内 subtitle);四要点=页面模板布局平台固定/广告平台运营分成不可控/fandom.com 子域锁定无数据主权/无 AI 内容工作流(AnvilWiki 差异点自然带出不硬销);诚实基调保留「大型公开社区百科→MediaWiki 或 Fandom」既有结论(notFor 零改动);全仓一致性扫描两处同步(README 中文导流行枚举+llms.txt 对比页行,英文行无枚举零改动);移动端 en/zh 375px 目检零溢出(坑 60),八门禁绿 test 274)。v2.29.1(第 16 轮审计信息级双项加固+AGENTS 第 14 条收编,2026-09-17,详见 CHANGELOG [2.29.1]——anvil-ops 1.0.5:submit 跨进程锁防 pid 复用死锁(锁文件增写创建时间戳,持锁超 30 分钟≈2 倍最坏合法持有时长即自动盗取,1.0.4 旧格式无时间戳锁 fail-closed 兼容,pidAlive 补 isFinite 守卫);apply-template 重跑 wrangler 裸标量值保留(KEY = 42/true 等无引号标量按字面保留、重写为双引号字符串,空裸值仍重置,引号不闭合损坏行同保留经 tomlStr 转义);AGENTS Engineering Constraints 第 14 条「全仓一致性扫描」升 workspace 契约+deployment Step 5 pages.dev Bulk Redirects 收编记账;test root 272→274、ops 169→172,零 fork 迁移,ops 1.0.5 已发 npm)。v2.29.0(十五轮审计全面修复批+anvil-ops 1.0.4,2026-09-16,详见 CHANGELOG [2.29.0]——🚨 ops submit 私钥安全网引号路径绕过修复(staged 清单改 -z+core.quotePath=false+NUL 分隔:git 默认 quotePath=true 把非 ASCII 文件名 C-quote 成转义串,曾令文件名模式/内容扫描门/.env GSC 比对三层防线全空后照常 commit+push 零警告泄钥,真实 git 集成测试以「谷歌密钥.json」复现钉死)+staged 全文件 64KB 头内容扫描(去 .json 扩展名门,.md/.txt 草稿贴 key 同样拦截)+submit 跨进程文件锁(acquireSubmitLock:site realpath 键控存 tmpdir+owner pid 活性检测盗死锁+finally 释放,包 CLI+MCP+offload worker;进程内 mutex 保留快路径)+PR body GFM 围栏按 summary 最长反引号串自适应+offload worker exit 事件兜底(硬崩不再伪装 watchdog 超时);apply-template 重跑三静默丢失洞(wrangler 值保留解析识别行尾内联注释与单引号 TOML/'Announcements' 移出 DEMO_VAR_VALUES 改 category+ID 配对判定,fork 同名自有 ID 存活/parseSiteTsIdentity 支持手改双引号字面量,重跑不再静默回落 demo 默认);MobileAnchorAd 文末补偿 calc(62px+env(safe-area-inset-bottom)) 双行级联;astro.config extractFrontmatter 剥 UTF-8 BOM;裁决不修四项见 commit 1355984;测试 root 265→272、ops 162→169,ops 1.0.4 已发 npm). v2.28.0(文章页移动端 Adsterra 320×50 底部锚位+誓言 GitHub 链接补挂,2026-09-15,详见 CHANGELOG [2.28.0]——新组件 MobileAnchorAd(env PUBLIC_ADSTERRA_SLOT_STICKY_320X50 转正):底部 fixed 锚条,可关闭且记忆/零 CLS(reveal 时移动端 body 底部内边距)/同意门控(与 AdsterraSlot data-src 同门,拒绝未选连空条不出);仅文章页挂载;env 空全组件零渲染(Astro 提升出条件块→build 期常量门控原始 style);顶部 sticky 维持有意排除,翻案记录入 StickyBanner/wrangler/ads.md 三处;WRANGLER_VARS_TEMPLATE/DEMO_VAR_VALUES 早已含该键值,apply-rewrites 零改动;誓言(lyglzhl)五处署名升链接;验证:带 demo env 与无 env 双构建断言+八门禁+E2E)。v2.27.1(P2 复杂度治理第一刀:类型逃生口收敛,2026-09-15,详见 CHANGELOG [2.27.1]——src/ 16 处 as unknown as 双跳断言全根除(getUi 结构化类型贯通,ui.ts 早已导出但无人用的 SharedUi 启用,shared-ui helper 返回 Partial 契约不变);收敛暴露 3 处被断言掩盖的真实动态访问修正(SiteFooter 循环键 keyof typeof footer+satisfies);约 10 处二次断言删除;nav[category]/overview[category] 动态键访问有意保留归拆分批;新契约测试 src/ 零容忍 as unknown as 扫描(注释剥离+扫描量 sanity);AGENTS 第 13 条复杂度预算+development.md 新 §6;零行为变更,7 代表页 dist 逐字节零漂移,test 265)。v2.27.0(社区审查修复批——群友「誓言」外部代码审查报告 P1+P3,2026-09-15,详见 CHANGELOG [2.27.0]——fallback 页 SEO 信号收敛:英文 fallback 页(demo 站 7 个 /ja/ URL)渲染 noindex,nofollow+新 lib/fallback-paths.ts 纯函数(零 import——astro.config config-time 加载时 ~ 别名尚不存在)从 coverage 推导全部 fallback URL 并入 sitemap noindexPaths(删旧「仅 en-noindex 文章 fs.existsSync 补排」分支,新规则超集)+ArticlePage noindex={entry.data.noindex || isFallback}(LocaleLayout ...rest 透传零新增);fallback URL 人类直达可达不变(PRD §9.3),翻译落地 isFallback 翻转自动恢复索引,Pagefind 1.5.2 尊重 noindex 重复条目出站内搜索,rss/llms 零改动;构建警告清零:astro-icon「Failed to load icons」建 src/icons/.gitkeep 消音+「Entry … was not found.」getEntryWithFallback 改 getCollection 建 id map(strip .mdx);致谢「誓言」(英文署名 Shiyan,社区贡献首例个人署名)五处落位(README 中英 Credits/docs README 致谢节/landing footer credits href 可选化+LandingLayout 纯文本分支/CHANGELOG/roadmap 候选池来源标注),P2 大文件三拆(ArticlePage/BaseLayout/apply-template)与类型逃生口收敛(17 处 as unknown as)进 roadmap 不混批;决策记录 docs/superpowers/specs/2026-09-15-fallback-seo-noindex.md;test 259→264)。v2.26.1(全项目三维代码审查第二轮修复批,2026-09-15,详见 CHANGELOG [2.26.1]——2 高+9 中+约 30 低全修:setup.yml 零终端通道 [vars] 重写正则行首锚定(产出非法 TOML 根治,行为级契约测试按 rewriteWranglerVars 键集钉死)+anvil-ops submit 私钥安全网三层(文件名镜像 gitignore/内容扫描 64KB/.env GSC 路径比对,真实 git 集成测试)+AdsterraSlot 补齐同意门控(与 GA/AdSense 同门,data-src+aw:consent-accepted 事件,拒绝/未选永不加载,开箱零 env 行为不变)+slugifyTag 混合标签走 raw(焰牙 攻略 不再折叠)+apply-template 重跑 value-aware 保留用户 vars+GSC 整请求 30s 超时+template-audit 清单 import 单源+E2E 死断言复活;test 235→259/ops 134→162)。v2.26.0(Adsterra 广告批,2026-09-15,详见 CHANGELOG [2.26.0]——新组件 AdsterraSlot.astro:env 门控 PUBLIC_ADSTERRA_SLOT 空=不渲染(与 AdSense 槽同契约),独立文件 public/ads/.html+iframe sandbox 四权限隔离、省略 allow-top-navigation;诚实边界=allow-same-origin+allow-scripts 素材渲染硬前提下非对抗恶意创意硬边界,真隔离需独立源(docstring/docs/ads.md「诚实的边界」载明);hideOnMobile 固定尺寸创意移动端隐藏只出响应式 Native;demo 挂载:wiki 文章页 728x90+Native/手册课页 4 位(正文后 728x90+文末 Native+目录下粘性 160x300+≥1700px 视口左右页边 fixed 160x600)/主落地页+社群精华+对比页 en+zh(728x90+Native)/文档三目录页仅 Native,隐私页有意不挂;fork 安全=public/ads/.html 六文件入 DEMO_PUBLIC_FILES 双通道清理(setup.yml rm 清单同步+契约测试 basename 归一)+rewriteWranglerVars 注释态变量模板+fork 纯净性 E2E 三道断言(六 html 删净/无未注释 demo key/dist 零广告 iframe);sidebar-300x250 已建未挂载如实标注(WikiSidebar 恒 compact,与 AdSense SidebarAd 同门);法律页英文 LegalContent+zh 中文隐私页广告披露补 Adsterra;线上验证 ads 挂载/consent 门控/单元页 308 pretty-URL 无损)。v2.25.1(apply-template/setup.yml 重跑内容感知化,2026-09-15,详见 CHANGELOG [2.25.1]——「Clear demo content」只删 demo 文章:classifyWikiArticles/isDemoArticleContent 纯函数下沉 lib/apply-rewrites(内容标记 DEMO_GAME_NAMES=['Anvil Quest'],与 isDemoLocaleContent 同规则同哲学;有意不做文件路径清单——模板作者加 demo 文/fork 用户加文都会失真误红),用户文章/脚手架/改写过的 demo 路径文件保留并逐个警告;新 scripts/clear-demo-content.ts 给 setup.yml 单源复用,find -name '.mdx' -delete 全量删除根除(步骤移到 install 后 build 前);E2E 新断言用户文章重跑存活+demo 残留被清+警告可见+4 条新测试 test 231→235)。v2.25.0(全项目三维代码审查修复批,2026-09-14,详见 CHANGELOG [2.25.0]——②9 项发现全修(2高+13中+14低):①CLI 输入边界:apply-template 连字符 locale(zh-tw/pt-br)断站根治(生成器纯函数下沉 apply-rewrites+camelCase import+响亮校验)+delimited 剥 UTF-8 BOM+clear demo content 重跑口径诚实化+setup.yml SITE_URL 反斜杠归一/urlparse 校验;②脚本库收敛:routing.ts 解析六处正则收口新 lib/routing-flags(check-content 静默回退 'en' 根除)+walker 六份收口 lib/walk+refresh-audit 阈值 import content-utils 单源;③src 站点:LandingLayout isRoot 尾斜杠容忍(语言记忆/zh 自动跳转生产死代码复活)+landing 层 SEO 尾斜杠全量收口(landing-paths 套件)+HomePage as any 打穿(HomeUi/SharedUi 类型+home-ui 契约套件)+faq 硬编码英文兜底清除;④CI/部署:release-ops environment: npm 双门(GitHub Environment 已建 owner required reviewer,ops-v* 发布自此需 Actions UI 审批;tag commit main 祖先守卫)+_headers HSTS(无 includeSubDomains)/Permissions-Policy+engines ≥22.13 对齐 pnpm 11+transpile-pagefind 复合 @media prelude 全括号组降级(指纹哈希不变);⑤anvil-ops 1.0.2(已发 npm,经新审批门):submit 中止 unwindBranch 回滚+撞名恢复指引+GSC 精准 fix 在 insights/doctor 存活+CF/GSC HTTP 30s 超时+根 .gitignore 补 ops/+ConfigParseError;⑥gen-covers win32 反斜杠归一(Windows ENOENT 根治)+wireFrontmatter 下沉 lib/covers(CRLF 统一 EOL+tmp+rename 原子写)+apply-template hex↔HSL 改 lib 单源;新增 3 套件 routing-flags/landing-paths/home-ui(AGENTS 清单 17→20),test 188→231)。v2.24.0(GA4 上线+zh 落地横幅收尾批,2026-09-14,详见 CHANGELOG [2.24.0]——①zh 同意横幅本地化+隐私链接 404 根治:zh 是落地页专属语言(wiki UI JSON 只有 en/ja),BaseLayout 兜底横幅在 zh 页=英文文案+/zh/privacy-policy/ 死链,env 空时横幅不渲染故此前不可见,填 PUBLIC_GA_ID 即现形;BaseLayout 加可选 consent 覆盖 prop(labels+隐私链接整组)+fallback 隐私链接按真实 wiki locale 收敛,landing.ts zh 中文文案,LandingLayout 一处下传覆盖全部 zh 页面;en/ja 零变化;②新增 /zh/landing/privacy/ 中文隐私政策页(正文忠实镜像 LegalContent privacy-policy 英文版:GA consent 门控/AdSense/Cloudflare/giscus/YouTube 披露),横幅链接切过去;页面在 LANDING_PATHS 目录内 fork 双通道自动清理;③demo 站 anvil.wiki 接入 GA4:媒体资源建于 PicBoil 账号(属性 554090475/数据流 15775651036/衡量 ID G-X10CG7N6P6 入 wrangler.toml [vars]),端到端实测 consent 门控(未点同意 dataLayer 不存在零请求→点同意 gtag 200+collect 204+GA 实时见活跃用户;zh 同意持久化回访不弹横幅);八门禁全绿 test 188)。v2.23.0(依赖漏洞分层清理 B/C 层收官+Astro 5→7 两跳迁移,2026-09-14,详见 CHANGELOG [2.23.0]——issue #37 终局 audit 27→0:①B 层 astro 5.18.2→6.4.8→7.3.2 两跳(mdx 4.3.14→8.0.1/astro-icon 1.2.0/check 0.9.10),每跳独立提交+八门禁+CI 全绿;astro 系全部通告(1 critical AVIF RCE 修于 7.2.8+2 high+5 moderate/low)清零;fork 常规 merge 零迁移(schema/内容 API/配置契约/命令面零变化,六条 Content Layer gotchas 逐条重验,Rust 编译器严格化零报错,Sätteri 替代 remark 零迁移——本仓零 remark/rehype 插件);视觉零漂移钉死三处:compressHTML 显式 true(v7 默认 'jsx' 剥 inline 空白致单词粘连)/vite.build.cssMinify 钉 esbuild(vite 8 默认 Lightning CSS 把 @media (min-width:…) 重写成区间语法 width>=640px,2023 前内核整条丢弃=Tailwind 全断点失效)/postbuild 渲染期内联 scoped 样式区间语法降级(该路径绕过 cssMinify,landing 四页实证;契约测试钉接线);②C 层:vitest ^4.1.11(mocker path traversal ×2)、esbuild 随 vite 8 达标、extract-zip ×2 随 astro 7 依赖树重排整体消失(A 层判"上游 2.0.2 未发布不可修"意外闭环);overrides 六条回收留 fflate 一条(@iconify/tools 仍钉旧线),sharp 直接依赖 ^0.35.4 地板;③同日期文章平局序根治:demo 三文同日时 astro 6 content layer 基础序变化洗牌首页 Recent Updates 卡序,newestFirst 加 id 字典序 tie-break 导出,五处 date 排序收口+平局复现测试 test 187→188;④⚠️ @astrojs/tailwind 5.1.5 peer 未声明 astro 6/7,实测全功能存活(CSS 规则级对比一致),pnpm install unmet peer 告警无害;产物级回归:六代表页 token diff 全录(generator 串/&→& 等价/CSS 并一)、pagefind 转译指纹哈希全天不变、gen-assets+gen-covers 字节零漂移、E2E apply-template 真实模式绿、template-audit 仅 demo 预期警告)。v2.22.0(十三轮审计修复+A 层依赖漏洞清理定版批,2026-09-14,详见 CHANGELOG [2.22.0]——①wiki 移动菜单搜索键双绑定根除:v2.21.0 直绑后 SiteHeader 旧 .click() 代理脚本未删,同一菜单按钮双 handler 一次点击两次 openModal,第二次 showModal 对已开 dialog 抛 InvalidStateError(功能无损),删 SiteHeader 冗余脚本+openModal 加 modal.open 幂等守卫兜底一切双触发路径;②inline 脚本全仓 ES2018 收口:公告关闭/主题切换/FAQ aria/StickyBanner/BaseLayout no-FOUC 六处 ?. 与可选 catch 绑定全部降级,契约测试从 SearchButton 单文件升为全仓 is:inline 语法门禁(可选链/空值合并/可选 catch 任一即红);③pagefind 指纹替换收窄到模板字面量 URL:盲替换把 ?v= 注进 pagefind.js 内部正则字面量(? 成量词永失配,当前 esbuild shim 使其零功能影响属惰性地雷),收窄为文件名后随反引号才注入(1.5.2 六 bundle 实证 8 URL 位点全后随反引号),契约测试钉收窄形态;④A 层依赖漏洞清理:pnpm-workspace.yaml overrides 钉 sharp ^0.35.4(libheif/libvips×2)/fast-uri ^3.1.6(×4)/js-yaml ^4.3.2/fflate ^0.7.5/svgo 范围限定双条(3.x→3.3.5/4.x→4.1.0 双大版本并存各归各补丁线),audit 27→15(high 13→4/moderate 10→7);🚨 pnpm 11 overrides 必须写 pnpm-workspace.yaml,package.json 的 pnpm.overrides 被 v11 无声忽略;extract-zip(×2 high)advisory 补丁线 2.0.2 任何 registry 未发布,override 不可满足留待上游;sharp 0.35.3→0.35.4 原生小版本跳经 gen-assets 字节级一致。test 187。剩余 15 条全在 B/C 层:astro 系 10 条(1 critical AVIF RCE 修于 7.2.8+2 high+6 moderate/low)随 5→6→7 两跳迁移清,vitest ×2 moderate(4.1.11)+esbuild low(0.28.1)C 层,extract-zip ×2 等上游)。v2.21.0(landing 移动端+全站搜索批,2026-09-14,详见 CHANGELOG [2.21.0]——用户手机回访多轮实测驱动的四大块:①移动端适配修复(hero 被终端 pre 撑爆裁掉 CTA 补 min-w-0/微信 QR 浮卡桌面默认展开手机默认收起/左上角原生 details 移动菜单/头部下全宽移动搜索条(sticky 常驻点开同一对话框,头部 56→104px 连带补偿社群页 chips 与全站 scroll-mt 分档)/公告条 line-clamp-2+可关闭×(localStorage 按公告文本做键,新公告自动重现))②全站搜索(社群精华/对比页/落地页正文 data-pagefind-body 进索引,LandingLayout search 开关默认开,placeholder 改 Search AnvilWiki;Pagefind 子结果只锚带 id 标题→精华五类条目 h3 加内容哈希锚点 hi-- 深链定位,processResult 护 # fragment)③老内核加固(SearchButton inline 脚本 ES2018 化+直接绑定 data-open-search(DOMContentLoaded 后)+dialog 恒在渲染树+fixed 覆盖层回退——官方 bundle 42 处可选链在微信 X5/pre-13.4 Safari 是 SyntaxError→新增 scripts/transpile-pagefind.mjs 接入 postbuild 把 6 个 bundle esbuild 转译到 es2018)④缓存传播(_headers /pagefind/* 改 max-age=0 must-revalidate+每部署 ?v=<bundle哈希> 内容指纹击穿 CF 区域 4h Browser Cache TTL 钳制;挂载失败写 search.loadError 四语可见提示替代空白弹窗)。test 186,契约测试扩:pagefind 标记/inline 无 ?. 语法+直接绑定/转译接线+指纹化。另随版:demo 顶栏模板入口带文字标签(project.ts landingLink 常量))。v2.20.0(AGENTS.md 套件清单一致性门禁,2026-09-13,详见 CHANGELOG [2.20.0]——第 17 套件 tests/agents-consistency.test.ts 把命令表「N suites (a, b, …)」钉到实际 tests/ 目录,套件增删漏更 AGENTS 即 CI 变红;计数十天漂三次(12→14→16)根治,自 #33 复制形态的第二个 meta 一致性门禁,AGENTS 套件计数 16→17 同步;另随版收入 09-12 社群精华日报内容)。v2.19.0(2026-09-12,详见 CHANGELOG [2.19.0]):手册旧 slug 301 重定向+发版门禁收口批——用户报障 /zh/landing/docs/pick-your-game/ 404 根治:9 旧章 slug×中英×两斜杠形态 36 条精确路径 301 进 public/_redirects(v2.8.0–v2.12.0 重构拆 7 slug+v1.14 拆 2,映射按重构 spec 权威表;CF 只对真实目录补斜杠,死路径裸形态单列规则;fork 随 LANDING_PATHS 双通道删除)/第 15 套件 tests/redirects.test.ts 6 条契约(源不遮蔽活页/目标真实存在/无链式/双通道同步)/CHANGELOG 发版契约测试第 16 套件(PR #33,本次发版门禁首考)/docs/comments.md 轻量留言备选节(PR #31,关 #28)/社群日报 JSON 尾换行 ping-pong 根治(PR #32))。v2.18.1(2026-09-10,详见 CHANGELOG [2.18.1]):文档一致性修复批+内容日期戳修复+demo codes 9 月保鲜第二轮——内容日期戳 UTC→本地日五脚本统一收口 lib/today.ts(凌晨管道不再错写昨日,第 14 套件 tests/today.test.ts)/PRD 更新记录表补 v2.14.0–v2.18.0 八行+错序 v2.7.0 归位/开发手册管道课 en+zh 补 auto-content 任务选择器/require-output 表述补全/CHANGELOG [2.18.0] 折入日期切换与第二轮优化/发版清单补 roadmap 头+PRD 更新记录+AGENTS Status 三步防复发)。v2.18.0(2026-09-09,详见 CHANGELOG [2.18.0]):社群精华页 /landing/community 上线+每日 AI 日报管道;24h 审计闭环——课程评价红线清理补漏+digest JSON 契约测试+日报渲染窗口;sync-codes 接入内容管道收官+fan-out 整组修复;codes 页批量同步脚本 pnpm sync-codes;挖词选品技能 anvil-find-keywords;文档中心全站搜索+GSC API 接入引导+顶栏搜索胶囊;学习手册 6 阶段 29 课+3 附录、开发手册 9 课)（发版历史见 Releases；下列批次按时间叠加）。v2.0.0 released — 内容经营操作系统（四件，模板仓库零 breaking，fork 常规 merge 零迁移）: ① auto-content.yml PR 门控内容管道（workflow_dispatch + 确定性生成器 import-csv→pnpm bulk-new-posts → 八道门禁前置（全绿才开 draft PR，GITHUB_TOKEN PR 不自动跑 CI 故验证前置）→ create-pull-request@v8 固定分支幂等；LLM 永不进 CI、secrets 零引用；门禁抽成共享 composite action .github/actions/gates（ci.yml 同源复用，tests/workflows.test.ts 钉契约）；ADR-004）② anvilwiki-ops 0.1.3→1.0.0（多站注册表 ~/.config/anvil-ops/sites.toml（凭据永不入表）+ --site/--all + sites list/add/remove，submit 拒绝 --all；AI 引用追踪三通道：CF Web Analytics AI referrals（referrer host 聚合 chatgpt/perplexity/gemini/claude/copilot）+ GSC AI_OVERVIEWS 探测（experimental）+ metrics --import-aio <csv> 导入 GSC gen-AI 报告；MCP 五工具加可选 site 参数 = 1.0 唯一 breaking；测试 60→111；ADR-005）③ pnpm gen-covers og:image 封面生成（satori+@resvg/resvg-js+subset-font；封面标准 800×450→1200×675（Google Discover 大图 ≥1200px）+ 全站 BaseLayout 补 max-image-preview:large；品牌色运行时读 globals.css；CJK 标题按字符子集 Noto Sans CJK（OTF 缓存 node_modules/.cache/gen-covers/fonts/ 不进 git）+ 内置 OFL Lato（scripts/fonts/）；manifest hash 缓存；demo 5 张封面已重生成 1200×675）④ AffiliateSuggestion 文末建议位（src/config/affiliates.ts 默认空=不渲染；复用 AffiliateLink 卡片 + shared.sponsoredLabel i18n en/ja；config 门控非 env）。文档: docs/content-pipeline.md + docs/multi-site.md 新增并进 docs/README 索引、手册 ai-ops 章双语补多站/管道/AI 引用（章数不变 learn 11/dev 7、提示词 18 不变）、ADR-004/005、staying-up-to-date.md MAJOR 措辞修订（里程碑 major）、roadmap.md 演化表 + v2.0 行、PRD §14.2 消歧旧 v2.0 撞号 + 更新记录补齐、README 中英特性升级 + 修 :226 8-chapter 漂移、CHANGELOG compare 链接补齐 1.15.0–1.19.0。决策记录: docs/superpowers/specs/2026-08-22-v2.0-content-os-design.md。Astro 刻意锁 5.x（7 已 GA，5→6→7 迁移留独立小版本，见 roadmap 候选池）。Prior v1.x 历史: 见 CHANGELOG.md 与 docs/roadmap.md 演化主线表。Live demo: anvil.wiki (Lighthouse 4×100)。次日审计加固批（v2.0.1，详见 CHANGELOG [2.0.1]）:category 改 schema enum 硬门禁（软 404 根除）/check-i18n --strict-ui 让第八道门禁真正能红/setup.yml 开 PR 前跑 build 验证/auto-content add-paths+--require-output（CSV 不再入库、零产出响亮失败）/ci.yml 新增 ops-toolkit job（ops 测试进主 CI）/sitemap hreflang 按真实 MDX 覆盖生成（与页面级声明一致）/ops:MCP 站点解析不再吞错、GSC HTTP 错误带修复指引、audit/submit 走 worker 线程不冻结 stdio、测试 111→125/release-ops tag↔版本守卫。SEO 实战文档批（v2.1.0，2026-08-26，详见 CHANGELOG [2.1.0]，零代码变更）:新增 docs/sourcing.md（挖词 9 渠道 + 第 7 条判断「意图满足度」+ 选词决策管理表）、docs/ads.md（广告时机 + Adsterra 收款 USDT/Payoneer 双路线）、requirements/ 内容准备两模板（事实来源表 + 对标参考表）；seo.md 增外链策略章、deployment.md 增数据复盘指标 + Clarity 热力图、game-selection.md 定调首版 10-15 篇核心页分批上线（生成可 40-60 篇、部署分批）；学习手册第 7 章中英补「先说时机」。手册同步+初始化规范批（v2.1.1，2026-08-26，详见 CHANGELOG [2.1.1]）:学习手册 7 章双语接 v2.1.0 文档层（ch1 挖词 9 渠道+意图满足度/ch4 requirements 准备表+首版 10-15 篇分批/ch6 复盘指引/ch8 四条及格线指标表+Clarity/ch10 翻正节奏/ch11 外链策略/ch7 统计三件套 GA4+CF+Clarity 完整教程）;docs/apply-template.md 新增「初始化清理规范」章节（两通道删除清单首次文档化）;setup.yml zh 删除路径收窄+CLI wrangler vars 对齐（两处通道漂移修复）;en/weekly-ops tldr 超 480 上限修复。变现+外链实操文档批（v2.2.0，2026-08-26，详见 CHANGELOG [2.2.0]，零代码变更）:docs/ads.md 三新节——AdSense 收款完整教程（W-8BEN 10% 协定税率/PIN 明信片 4 次寄送+4 个月期限/电汇绑卡/21 日出账 20 日截点/结汇）、Adsterra 接入教程（五广告格式取舍表+Google 广告投放位置政策「挂 AdSense 的站禁触发 popunder」共存红线+脚本粘贴位置 BaseLayout.astro/ArticlePage.astro）、广告平台全景三档表（2026-08 实时门槛:Journey 1k sessions/Mediavine $5k 年收入门槛/Raptive 25k PV）+ 游戏垂直网络层（NitroPay 100k PV·NET-7·官方定位 niche gaming wikis/Venatus/Playwire/PubNation，全景表 11 平台全挂官网直链）+ 游戏 wiki 五档分阶段路线表;docs/seo.md 外链章扩到操作层（九渠道优先级清单+逐渠道步骤+三份英文 outreach 邮件模板+免费工具箱 Ahrefs/Hunter.io+做多少节奏节;HARO 2024-12 关停 2025-04 复活/Reddit 10% 全站规则调研校准）;手册第 7 章双语「第三步:收款三件事」节+tldr 两步走改三步走;Adsterra 起付信息对齐 2026 官方口径（USDT $100/Paxum $5/首两笔 $20）。新手动线优化批（v2.3.0，2026-08-26，详见 CHANGELOG [2.3.0]）:README 全面重构（新手动线三硬伤修复:pnpm 前置一行安装+快速开始补「push 回 fork」步骤+新增零终端 Actions→Initialize AnvilWiki 通道;wrangler.toml 警告从第一屏下沉到部署步骤提示框;特性区 9→10 条每条≤2 行细节链接化;双语文档导航收敛为 4 入口消除与 docs/README.md 双头漂移;英文区补快速链接表对齐中文区;语言切换锚点+首屏 demo 截图+CONTRIBUTING/CHANGELOG 链接+中文区补 License 行;删指向上游仓库的误导性 Deploy 按钮、Docs 徽章改链英文站;#5-分钟快速开始 锚点保留供 deployment.md 反链）;目录微调（Comments.astro 断链 spec 引用改指 docs/comments.md/PRD §15.2 文档策略表 7→20 项补齐/roadmap.md 版本头 v2.0.1→v2.2.0/ROADMAP-v1.5-v1.6.md 归档至 docs/superpowers/ 含 docs/README+PRD 两处引用同步）;落地页转化批（hero 与 FinalCta 主 CTA 改 Fork 直达 github.com/PNGTRID/AnvilWiki/fork/docsEntry SEO 卡与 devGuide 五步链接全部改站内手册章消除出站泄漏/landing.ts 写死章数 6 处移除（Hub 卡片本就动态计算）/two-digit stars 措辞去时效/公告条压缩一行/hero 副标题压缩;截图链接复用 tertiaryCta 故保持指向 Demo）;手册批（templatize-your-site 与 sync-and-contribute 两章「下一步」补 markdown 链接×双语/HandbookHub 新增 beginnerHint 零基础 start-here 胶囊,landing.ts 接口+en/zh 数据+组件三处联动）。紧急修复批（v2.3.1，2026-08-27，详见 CHANGELOG [2.3.1]）:tailwind.config.mjs 根除 ESM 文件内 CommonJS require() 地雷（插件行自 v0.1.0 写作 require('@tailwindcss/typography'),靠 Tailwind 加载器「原生 require 同步抛错才回退 jiti」侥幸存活;jiti 回退掩盖缺陷多年,但部分 Node 构建 require(esm) 路径把配置内 ReferenceError 以异步 unhandledRejection 上报、catch 接不住,fork 用户下载 ZIP 后 pnpm dev 首次访问即崩——Windows 用户截图报障实证）;改为纯 ESM import typography 导入,双加载路径最小复现+build/typecheck/lint/test 全绿验证,全仓扫描确认无其他 .mjs 含 require()。三站踩坑复盘加固批（v2.4.0，2026-08-29，详见 CHANGELOG [2.4.0]）:依据《Aniimo/No Man's Sky/Steal An Egg 三站生产事故复盘》（48 类问题）审计落地 16 项——trailingSlash never→always 全站翻转（localizePath 龙头/sitemap normalizePath 归一化/Pagefind 保斜杠/SiteHeader 高亮防 ///landing.ts 46 处/demo 内容迁移;⚠️ fork 行为变更,全站内链需跟随,check-content 新规则会拦,_redirects 反向重定向禁用）;空分类/空语言列表页 noindex+移出 sitemap+hreflang 按真实覆盖（config 侧 categoryCoverage 与页面侧 localesForCategory 同真相,防 Google 丢弃冲突簇）;文章级 faq frontmatter 字段（可见 <details> 区块+与 codes FAQ 合并单个 FAQPage JSON-LD;新 i18n 键 shared.faqTitle en/ja）;pageTitle 三分支智能后缀（含游戏名不加/>50 字符用 shortName/BaseLayout 三身份名防双拼）;相关文章三层兜底（tags 交集→同分类→全站最新仅零匹配时;纯函数 selectRelatedEntries 下沉 content-utils 可测）;新脚本 pnpm submit-indexnow（fs 读 dist sitemap→IndexNow 分批 POST,密钥自动检测/生成 public/<key>.txt,--dry-run 零副作用）+ pnpm gen-assets（品牌色原地生成 favicon 全套 svg+5 PNG/hero.webp 1200×630/manifest theme_color 同步,零引用改动;缓存在 node_modules/.cache;favicon.ico 因 sharp 不支持 ICO 有意保留不引用,BaseLayout 改指 svg+png）;check-content 新规则 5（非默认语言正文内链必须带语言前缀,error 级——Aniimo 177 处静默跳英文事故）/规则 6（正文 <3 条站内链接 warning）;文档批（deployment.md「唯一部署源」🚨 警告+「先绑域名→改 SITE_URL→再部署」顺序铁律+Crawler Hints/IndexNow 指引;ads.md Adsterra 教程改写 iframe sandbox 隔离模式+「怎么验证广告真的在展示」;content-format.md 关键词密度 1-3%+≥3 内链+先有文章再进 navigation;手册第 6 章双语 IndexNow 第 4 步+GSC 网页索引四状态灯;两 skill 内链口径反转）;小件（twitter:card 全局 summary_large_image/footer 补 /recent //tags 入口零新增 i18n 键/版权行与免责声明分行渲染修短路/.gitignore 密钥模式 *-secret.json/*.pem/*.key/seo-reports/）。StickyBanner 桌面 sticky 复核后保留（复盘 #37 针对 Adsterra 320×50 移动条桌面误显;本模板为 728×90 AdSense leaderboard+dismiss+CLS 预留,场景不同源）。八门禁全绿（lint/typecheck/test 96/check-config/check-content/check-i18n --strict-ui/build/check-links 3681 链接全通）。spec: docs/superpowers/specs/2026-08-29-retro-hardening-batch.md。CLI 真实模式 E2E 加固批（v2.4.1，2026-08-31，详见 CHANGELOG [2.4.1]）:合并首个外部代码贡献 PR #10（oyjq0000——apply-template removeLandingPage 先 rmSync 后 readdirSync 同路径,真实模式必崩 ENOENT,自 v1.12 存活;删后读模式全仓仅此一处,setup.yml bash 通道无恙）;全仓同类排查再清两处——home 模板 schema 漂移（CLI 写出 home.meta 仅 {watermark} 缺 title/description→HomePage 传 undefined 进 BaseLayout title.includes 崩;hero/closingCta 的 CTA 写 {label,href} 对象而组件按字符串渲染→fork 用户 CLI 初始化后首次 build 必炸;模板全量对齐 demo en.json 形态+HomePage meta 逐字段兜底+authors 清理虚报 ✅ 修为确实移除才打印）;新增 apply-template --answers answers.json 非交互模式（与交互同一 ask/askBool 路径,答案不足/多余均响亮报告;readline 管道驱动会丢行不可用）与 pnpm test:e2e（scripts/e2e-apply-template.mjs:git archive HEAD→临时目录装依赖→真实模式跑 CLI→断言输出形态→对产物完整 build;测的是提交树）+ ci.yml e2e-template job + workflows.test.ts 契约钉防删——八门禁抓不住『仅真实模式触发』类 bug,三个前科全在此类。八门禁全绿（test 97 含新契约）+E2E codes/guides 双预设全绿。生态技能吸收批（v2.5.0，2026-08-31，详见 CHANGELOG [2.5.0]）:向两个开源技能项目致谢并吸收方法论——① 新增 .agent/skills/anvil-adsense-audit（AdSense 申请前逐项体检:22 项 AD-* 清单四态判定+Blocker/High/Medium 分级+完整性门+Blocker 未清零不许建议提交;模板已解决项 ads.txt 占位/法律页路由/env 门控零广告/noindex 空分类预填证据,审计火力集中 fork 用户侧;主动提示模板无 robots.txt、用户自加不得挡 Mediapartners-Google;审计框架 inspired by yantoumu/adsense-site-auditor-skill——该仓库无 LICENSE,清单自 Google 公开文档模板特化重写未复制文本,技能内文末致谢）;② docs/sourcing.md 第四节「判决框架」（搜索需求轨七项打分参考+KD 分档动作表+早期爆发轨+两条防自欺判据「平台内流量≠独立需求/未测≠零」+新词 3/7/14/28 天复查节奏;参考 yan-labs/yan-skills 的 game-opportunity,MIT,节末致谢）+ game-selection.md 第 3 层互链;③ docs/seo.md 外链章新节「怎么验证外链真的生效」（已提交≠已公开≠已收录三态+跳转计数链/rel 属性两暗坑+743 条清单实测 5.5% 可用现实校准+推荐 yan-skills backlink 机读入口库）;④ 手册双语零 tldr 改动小节（enable-ads「懒人通道」接 /anvil-adsense-audit、weekly-ops「复盘纪律:只认面板上的数」）;⑤ 致谢三处（README 中英 Credits 段/官网落地页 footer en+zh 新增致谢行——landing.ts footer 接口加 creditsLabel+credits 字段、LandingLayout 渲染,fork 时 landing 整体移除不受影响/docs README 致谢节）。零代码行为变更。AdSense 审计实证批（v2.5.1，2026-08-31，详见 CHANGELOG [2.5.1]）:按 /anvil-adsense-audit 对 demo 站跑 22 项全项体检——裁决 Not ready(demo),缺口全部在内容经营侧(en 5 篇<15/codes 页 8 天 P0×2/items 空分类/pages.dev 域名),模板机制层零 Fail;据此实证修正技能判定基准——🚨 AD-17 原判定错误已改:法律五页是代码层组件 LegalContent.astro 内置正文(非空壳路由),隐私页本就含 Google AdSense 广告 cookie 披露段(线上渲染确认),默认 Pass,仅 fork 用户改写该组件才复查;docs/ads.md 新节「申请 AdSense 前的体检」六组速查表(canonical 归技能维护)+ demo 审计基线实例。Demo 内容整备批（v2.6.0，2026-08-31，详见 CHANGELOG [2.6.0]）:依据 seo.web.cafe AdSense 预检报告核查整改——9 篇 en 文章全部 800-1284 词(原 170-665),新增 4 篇成型页(items/forging-materials-guide + items/emberforged-armor-set 补齐空 items 分类 + bosses/frostbound-monarch 冰元素镜像 Boss + guides/forging-guide 锻造数学),sitemap 101→120 URL;🚨 页脚 SiteFooter legalLinks 补 contact(页有链无的信任页缺口)+ footer.contact UI 键 en/ja;ads.txt 内置就绪授权行(过审删 # 填 ID 即用,未过审保持注释态);🚨「Updated daily by the community」不实文案(en/ja ×2)改「逐篇标注验证日期」诚实口径——fork 用户 takeaway:不要虚称社区/更新频率,写你能兑现的;预检报告 3 项误判已核查标注(身份漂移=fork 时自动移除的 demo 专属层、ads.txt=设计使然、CMP=env 门控误测)。Fork 路径加固批（v2.6.1，2026-08-31，详见 CHANGELOG [2.6.1]）:完整 fork 模拟（git archive→apply-template --answers→build→产物体检 template-audit/check-config）抓出五个开箱陷阱并全修——① 联系页零渠道(official 不在列表+无邮箱;修:official 恒渲染+可选 site.contactEmail 三处同步+去硬编码 Discord 措辞);② CLI 写出模板虚假承诺(description "Updated by the community"/徽章 "Updated daily"/hero "tested daily");③ rewriteLocaleJson 清空 nav/overview 致 fork 首次 check-config 七项红+导航裸 key(修:按所选栏目自动填 nav+overview,titleCase 对齐脚手架);④ demo ja.json 残留=身份泄漏+check-config 红(「无害孤儿」结论推翻,未选语言 locale 文件直接删);⑤ wrangler [vars] 正则锚点吃到注释里的字样(双 [vars] 段;修:行首锚定;🚨 JS 正则两坑:\Z 是字面量 Z、m 标志下 $ 是行尾;demo FORKER 警示块重写后移除);另 DEMO_COVERS 漏 v2.6.0 新 4 封面+setup.yml 同步;E2E 新增 check-config 步骤+五条断言钉死——修复前 fork check-config ❌7 项/template-audit ❌9/11,修复后 ✅0 项/✅11/11。CLI 输入层修复批（v2.6.2，2026-08-31，详见 CHANGELOG [2.6.2]）:用户报障 issue #12「默认值按回车没反应,输入默认内容才能继续」——根因是 readline/promises 的 rl.question() 每次提问挂一次性** 'line' 监听器,readline 不缓存「没有提问挂起时」到达的行;真 TTY(raw mode 逐键送达)永不触发,但一切缓冲型 stdin 通道(管道/AI agent 终端/多行粘贴/CI)必然触发——多行一个数据块到达,只有第一条被消费,其余静默丢弃;本仓库自己的历史教训「readline 管道驱动会丢行」(v2.4.1 E2E 为此绕道 --answers)正是同一 bug,当时绕过未根治。修复:新增 scripts/lib/prompt.ts 的 LinePrompt 常驻 FIFO 行队列(构造时挂唯一 'line' 监听器,任何时序零丢行;EOF 视为裸回车→printf '' | pnpm apply-template --dry-run 全程默认跑完,Proceed 门(默认 false)EOF 仍安全中止);apply-template/new-post/new-locale 三个交互 CLI 全部迁移,apply-template 顺带收敛单一 readline 实例(原 Proceed 框再开第二个 interface 的并列实例消掉);tests/prompt.test.ts 7 条(5 行为+2 静态契约:三 CLI 禁止再直调 rl.question、必须走 lib/prompt——防接线回退);管道 17 行逐值落位+纯回车全程+expect PTY 交互三通道验证,test:e2e 真实模式绿;另修 CHANGELOG [Unreleased] 指针停在 v2.4.0 连续 6 版漂移;demo ja codes 页补齐 en v2.6.0 扩写结构+lastModified 同步(issue #11 自动审计 P0 清零,refresh-audit 0 items——🚨 双语言 demo 内容批必须两语言同步动 lastModified,否则保鲜审计单边红);八门禁全绿(test 104)。apply-template 重跑安全四连修（v2.6.3，2026-09-01，详见 CHANGELOG [2.6.3]）:当日 24h 只读风险审计（五类:运行错误/数据丢失/权限绕过/资源泄漏/跨端兼容）P1-P4 同日落地——① locale 删分两类(新常量 DEMO_LOCALES=['en','ja'] 自动删;用户上轮或 new-locale 加的改 orphanLocales 响亮警告保留,不加新 prompt 故 --answers 18 项位置序不变);② clearDemoAssets 废 DEMO_ASSET_DIRS 整目录 rm -rf,改 DEMO_GALLERY_IMAGES(6)/DEMO_ARTICLE_IMAGES(2) 按名删(public/images/articles 正是 content-format.md 让用户放内文图的目录),setup.yml 同步 rm -f,静态契约测试钉两通道 .png 集合相等;③ rewriteLocaleJson ownable 过滤未选分类 nav 残留键+覆盖序反转(fixed<占位符<上一轮标签,重跑保用户已译;overview 整体替换有意保留——留旧值会泄漏 demo 游戏文案);④ wrangler [vars] 正则 \r?\n 容错+插入块跟随文件 EOL;配套纯函数下沉 scripts/lib/apply-rewrites.ts(SkinInput/slugify/buildHomePreset/rewriteLocaleJson/rewriteWranglerVars 纯签名+三清单;沿用 lib/prompt.ts 先例,vitest 直测),新增第 11 套件 tests/apply-template.test.ts(test 114),E2E 步骤 4.5 重跑断言(ja 删/ko 保留/二次运行幂等);八门禁全绿+E2E 双预设绿;发版提交 fd8dc23(文档清扫二轮)+cfa43e8(修复)+本定版。🚨 E2E 新坑:spawnSync 断言 CLI ⚠️ 警告须拼 stderr(console.warn 不走 stdout)。视频源工作流批（v2.7.0，2026-09-02，详见 CHANGELOG [2.7.0]）:anvil-new-article 新增 Step 0——素材是 YouTube 视频时抓字幕(用户粘贴/yt-dlp/youtube-transcript-api 三通道,按依赖从少到多)→结构化提取(核心话题→Step 1 判型/kebab-case slug/title/description/summary 直答/5-8 组 faq/问题式 H2 大纲/tags 复用词汇表)→MDX 草稿;双红线(口播数值/兑换码一律视为未验证素材,成品必须 draft:true 人工核实才转正;他人视频字幕只做事实参考、正文必须完全重写——演绎内容的 DMCA/重复内容风险,嵌入原视频为合规做法,缩略图 maxres→hq 仅作 gen-covers 视觉参考);致谢 kennyzir/7deer_skills(MIT)youtube-content-gen 五处同步(技能文内/README 中英 Credits/docs README/landing footer en+zh);实现层四硬伤裁决不抄(生成 Next.js tsx 代码/模板硬编码 Devil Hunter Nexus 站身份/JSON-LD 把 FAQPage 嵌 Article mainEntity 且 Jinja2 变量不转义/关键词模式靠 Google SERP 爬虫且查询硬编码站名);顺手修 PRD 架构树技能列表 v2.5.0 漏更(4→5 补 anvil-adsense-audit);门禁 typecheck/lint/test 114/build 全绿。apply-template 重跑安全加固+文档漂移修复（v2.7.1，2026-09-02，详见 CHANGELOG [2.7.1]）:90147f8 两项——① demo locale 删改内容判定（isDemoLocaleContent 纯函数下沉 lib/apply-rewrites.ts 直测:en/ja 仅在 site.name 仍是 demo 站名时自动删,上一轮已重写成用户游戏的文件警告保留——翻译成果不再被静默销毁,损坏 JSON 一律保留;E2E 加 rebranded ja 存活断言;docs/apply-template.md 两类表述更新为三类）;② rewriteSiteTs 八字段补单引号+反斜杠转义(撇号游戏名不再写出语法错误的 site.ts)+site.ts/navigation/routing/ui 四处替换改函数回调杜绝 $& 展开+domain 补 TOML 转义;文档漂移审计两处(1f9d2ff)——docs/ads.md demo 审计基线同步 v2.6.0 后状态(9 篇仍<15/items 已补齐不再是缺口/codes 页时效性表述/ads.txt 占位→就绪行)+anvil-adsense-audit 技能 ads.txt 行对齐就绪注释行;门禁 typecheck/lint/test 123/check-config/check-content/check-i18n --strict-ui/build/check-links 全绿。手册教学法重构第一批（v2.8.0，2026-09-02，详见 CHANGELOG [2.8.0]）:学习手册重构启动(spec: docs/superpowers/specs/2026-09-02-handbook-teaching-redesign.md,定案 29 课 6 阶段+3 附录,六原则:一课一事/例子先于概念/每课新词≤3 放文末/产出即验收/三个经典错误前置/主线地图)——本批上线阶段 0+1 找词线 8 课×中英(01 这门生意怎么赚钱/02 全程地图与学法含 AI 布置任务三招/03 挖候选/04 看懂 Trends/05 读懂结果页/06 意图满足度完整案例+五步检查表——兑现旧 ch1:77 甩给 docs/sourcing.md 的一句链接/07 打分拍板+决策管理表/08 首日 10 页清单);frontmatter 新增可选 stage 字段(列表页阶段分组+章节页徽标,dev 手册无 stage 渲染扁平);旧第 1 章 pick-your-game 拆除(slug 移除,站内引用改 find-candidates),学习手册 order 重排最终架构(新课 1-8/旧章 9-18),全部 18 章标题去「第 N 章/Chapter N」硬编码编号(编号由 order 渲染,标签 Chapter→Lesson/第…章→第…课);十余处章号互链改课名引用×中英;README/docs README 去「11 章/7 章/18 个提示词」硬编码计数;八门禁全绿(test 123)。剩余批次:阶段 2-5 逐批(含 theme-and-homepage 调入学习手册/GA4 独立成课/外链课拆分/五处折叠随课落地)+开发手册 7 章→9 课+附录三件。手册教学法重构第二批(v2.9.0,2026-09-02,详见 CHANGELOG [2.9.0]):阶段 2「把站立起来」4 课×中英——旧 launch-your-site 一拆二(课 10 run-your-site:fork/clone/pnpm dev 跑通样品站;课 11 rebrand-your-site:apply-template 15 题问答表+--dry-run+Initialize AnvilWiki 警示+图标支线+验收清单);课 09 install-tools 新骨架重写补 GitHub 2FA+恢复码(原零覆盖);课 12 theme-and-homepage 自 dev 手册调入 learn(order 12,选修:apply-template 已自动换色,本课教 8 行规矩+首页文案 JSON 改法);学习手册连续 order 1-20、dev 移出主题课后重编号 1-6;launch-your-site slug 移除,landing.ts 8 处引用+标签(第 3 章/Ch.3→课 N/Lesson N)同步,architecture/categories-and-locales/ai-ops 引用改向;门禁全绿(test 123)。剩余批次:阶段 3 内容生产、阶段 4 上线收录、阶段 5 变现经营+开发手册 9 课+附录三件。手册教学法重构第三批(v2.10.0,2026-09-02,详见 CHANGELOG [2.10.0]):阶段 3「内容生产」5 课×中英——旧 first-10-pages(161 行)一拆五:课 13 first-article(文件夹/笔记/攻略页提示词+意图分类表+frontmatter/质检/draft 三词)、课 14 codes-page(最粗红线:码只来自亲眼所见+⊕视频双红线:draft 核实转正/文案完全重写/嵌入合规)、课 15 tier-list-and-media(排行榜提示词+gameVersion+⊕三合法素材通道:自截自录/官方 press kit/CC 图库)、课 16 quality-gate(三关验收:draft 处置规则+一篇一 commit)、课 17 launch-batch-plan(10-15 分批放+到点就走);7 件不要做拆入各课经典错误;first-10-pages slug 移除(landing 4 处+课 12 链接同步),阶段 4-5 旧章顺延 18-24(学习手册连续 1-24);门禁全绿(test 123)。剩余:阶段 4/5 重构+开发手册 9 课+附录三件。手册教学法重构第四批(v2.11.0,2026-09-02,详见 CHANGELOG [2.11.0]):阶段 4+5 学习手册 29 课收官——新增课 20 计数器(CF beacon env+Clarity 贴脚本,按模板实情 Clarity 无 env)/21 第一周读数(三面板+四及格线+只认面板数)/23 收款三件事(W-8BEN 协定 10%/PIN 4 次 4 个月/电汇拼音+SWIFT,吸收 docs/ads.md 收款节)/24 GA4(延迟哲学+同意横幅门控)/26 clone-your-site(承接 templatize,template-audit+换皮清单+四步)/28 rank-one-keyword 与 29 trust-and-backlinks(seo-traffic 一拆二);enable-ads 重写(统计/收款拆出)、weekly-ops 重写(读数拆出);学习手册连续 1-29;seo-traffic/templatize slug 移除,landing SEO 卡改向;门禁全绿(test 123)。剩余:开发手册 9 课+附录三件+计数收口。手册教学法重构收官(v2.12.0,2026-09-02,详见 CHANGELOG [2.12.0]):开发手册 7 章→9 课——新增课 4「改完怎么自证」(本地七命令+CI 八门禁+三流水线+安全/性能底线,ci-and-security 并入后移除)、课 8「内容管道」与课 9「多站管理」(ai-ops 三拆,ai-ops 重写为纯运营课)、sync-and-contribute 一拆二为「同步上游」+「贡献回流」,dev order 连续 1-9;学习手册附录三件(A 作死红线总表五类/B 排查决策树六症状/C 术语 30+ 术语与 20 命令速查,order 30-32 挂「附录」阶段);README/docs README 计数收口为最终形态;门禁全绿(test 123)。手册重构五批全部完成(v2.8.0-v2.12.0)。阅读体验优化(v2.13.0,2026-09-02,详见 CHANGELOG [2.13.0]):用户反馈两条——①左侧目录标题过长:lib/handbook.ts 新增 shortTitle 纯函数(冒号前段/附录「 · 」后段/回退全称),HandbookNav 两态统一使用,4 单测;②右侧本页目录不跟随滚动:根因是三栏布局 xl(1280) 断点,用户窗口 1268px 差 12px 退化成文首静态折叠块——HandbookChapter 网格下探 lg(1024)窄侧栏三栏,TOC desktopAt lg,≥1024 粘性+spy 跟随(spy 脚本原本工作);第 13 课标题改「第一篇攻略」使短标题达意;test 123→127。文档中心搜索+GSC 引导批(v2.14.0,2026-09-03,详见 CHANGELOG [2.14.0]):用户问『模板有没有 GSC API 接入指引』AI 回答含糊——内容一直在开发手册第 7 课但三层引导失灵(spec: docs/superpowers/specs/2026-09-03-gsc-discovery-docs-search-design.md)。① 引导包:shortTitle 可选 frontmatter 覆盖字段(冒号派生法无法在侧边栏露出只在标题后半段的关键词),第 7 课改名×双语+短标题「AI 运营与 GSC 接入」/"AI ops & GSC setup"+H2 改「GSC API 接入(5 分钟)」露出页内 TOC,slug ai-ops 不动互链零影响;docs/README 决策树/deployment.md 复盘节(显式区分 GSC 站点验证≠API 接入)/anvil-ops README 三处指路;doctor gsc-config 缺配置 detail 追加教程 URL(fix 字段仅 FAIL 渲染,env 门控 ok:true 契约不变)。② 搜索:🚨 Pagefind 规则=站点任一页面标 data-pagefind-body 后未标记页面全部排除出索引——此前仅 ArticlePage 标记,落地页与手册 41 课×双语对站内搜索完全隐形;HandbookChapter 补标记+面包屑/页脚 ignore+H1 meta,SearchButton 增可选 labels 覆盖(zh 非 wiki locale,getUi 会回退英文)+locale 放宽 string,LandingLayout 增 search 开关+8 个 docs 路由(en+zh × hub/learn/dev/[slug]),营销 landing 不进索引;Pagefind 按 html lang 自动分语言索引(zh 页搜出 zh);契约测试钉 data-pagefind-body 防静默退出;产物验证 pagefind 片段 en 57/zh 41/ai-ops 双语各 1。test 127→133,ops 125 全绿。顶栏搜索胶囊(v2.14.1,2026-09-03,详见 CHANGELOG [2.14.1]):用户反馈小图标不显眼——SearchButton 增 variant='icon'|'field' 两态(默认 icon,wiki SiteHeader/404 零改动),docs header 搜索框改加宽胶囊(占位文字 sm+/⌘K 提示 md+/窄屏退化图标)置于品牌组后 flex 撑开 max-w-xs;营销 landing 与 wiki 侧不受影响。挖词选品技能批(v2.15.0,2026-09-05,详见 CHANGELOG [2.15.0]):新增第 6 个 anvil-* 技能 anvil-find-keywords——docs/sourcing.md 9 渠道挖词+意图满足度+判决框架的 agent 可执行版(Step 0 输入收集→1 多渠道挖候选,agent 自助通道:SteamDB 反爬换 steamcharts/二手汇总/Trends RSS/old.reddit/CrazyGames sitemap,用户通道:TikTok 登录墙贴链接+付费工具回填→2 逐候选 SERP 快验→3 判决打分:需求轨 7 项/早期爆发轨/KD 分档,点名未测项→4 落盘 gitignored seo-reports/game-pipeline.md 决策表(3/7/14/28 天复查日,不覆盖用户结论)→5 交接 game-selection 四层漏斗/requirements/anvil-new-article;五条红线:禁编造数据/未测≠零/平台内流量≠独立需求/拍板在用户/不覆盖结论);技能枚举同步 5 处(README 中英技能表/AGENTS 产页章节/PRD 架构树/docs README 阅读路径 A+C);零代码行为变更,test 133 全绿。技能逐字对齐收口(v2.15.1,2026-09-06,详见 CHANGELOG [2.15.1]):24h 风险审计两条低置信观察闭环——① anvil-find-keywords SKILL.md 早期爆发轨阈值自意译「互动达标且在涨」改 sourcing.md 逐字口径(独立发布者 ≥3 非官方非搬运/横跨 ≥2 类平台/非官方互动 ≥20 次或播放 ≥500 且复查时仍在涨);② 方法论来源补英文手册路径 docs/handbook/en/find-candidates.md(原只引 zh);零代码行为变更,门禁 lint/typecheck/test 133 全绿。codes 批量同步脚本批(v2.16.0,2026-09-06,详见 CHANGELOG [2.16.0]):每日自动维护定时任务首跑产出本批全部内容——PR #15 修 roadmap.md 版本头漂移(版本号自此五处:package.json/landing.ts PROJECT_VERSION/CHANGELOG 段+[Unreleased] 指针/roadmap 头)+PR #16 新增第 15 个运维脚本 pnpm sync-codes(读 codes-sync.csv 确定性合并进 codes 页 frontmatter codes 数组:新码前置/过期翻转保留/零改写页不重写/全语言同名页同步——显式语言行优先+无行语言 fan-out 跟随该 slug 首行;all-or-nothing 先全量校验后写+扁平标量解析遇未知字段/行内注释/嵌套结构响亮中止+CRLF 兼容保留原 EOL+单元格换行/控制字符解析期即拒+未知 flag 一律报错;纯函数下沉 scripts/lib/sync-codes.ts 第 12 套件 20 条,CSV/TSV 解析抽共享 scripts/lib/delimited.ts(bulk-new-posts 同源复用);独立审查 Important×4+Minor×6 当日闭环,测试 133→153;管道接入 auto-content.yml 留独立小版本,见 docs/content-pipeline.md 候选)。sync-codes 审计加固批(v2.16.1,2026-09-07,详见 CHANGELOG [2.16.1]):24h 只读风险审计(1 Important + 3 低置信)同日闭环,纯加固零语义放宽——① CSV slug 含路径分隔符(/、)或控制字符解析期即拒(原先 / 在 key.split('/')[1] 静默截断,码写进截断后命中的另一张已有页且 dry-run 计划标签同步失真,demo 站实证;win32 反斜杠上跳同根因);② 混合 LF/CRLF 页响亮中止(原 includes('\r\n') 判定会把混合 EOL 整文件翻转,破坏「块外逐字节保留」);③ 双引号值仅解码 " 与 \ 其余转义响亮拒绝(原一律丢反斜杠误读,误读值会在触碰重写时固化);④ 写页改同目录临时文件+renameSync 原子替换(进程中途被杀不留截断 MDX);测试 153→156,八门禁全绿,审计 smoke 复验 slash 行解析期即拒。sync-codes 管道收官批(v2.17.0,2026-09-07,详见 CHANGELOG [2.17.0]):PR #17(每日自动维护产出)把 pnpm sync-codes 接入 auto-content.yml——Run workflow 任务新增 sync-codes(粘 codes-sync.csv 进 csv_text 或 commit 到仓库根后留空),与 import-csv 完全同契约:--require-output(零改写重跑响亮失败,绝不开空 PR)/add-paths 内容白名单(粘贴 CSV 永不进 PR)/任务级固定分支 chore/sync-codes(与 chore/auto-content 互不干扰)/零 secrets/LLM 永不进 CI/同一 composite action 八道门禁前置;契约测试钉 task 门控+require-output+双任务分支表达式。发版当日实测踩中并顺带修复 fan-out 掉码缺陷:fanOutLocales 原只复制 slug 首个显式行的一行,多码 CSV 在无显式行语言页静默漏掉第 2..N 个码(demo 9 月保鲜实证:en 计划 2 码 ja 只翻 1 码),改为跟随首个语言行的整组行(插入序首语言为准,不跨语言混源;docs/content-pipeline.md 两处表述同步),测试 157→159。同日四件套:showcase 投稿 PR #19(Resonance Wiki,核站+批 CI+squash 合并+README 两表 main 补+致谢)/demo codes 页 9 月保鲜(FORGE-2026/EMBERBORN 过期翻转 en+ja 同步 lastModified,issue #20 清零)/🚨 main 分支保护已开(禁 force push+禁删除,enforce_admins=true——直推/squash/发版不受影响,改历史须先到 Settings 临时关)/issue #21(本地可视化初始化+内容后台)记 roadmap 候选池。社群精华页+24h 审计修复批(v2.18.0,2026-09-09,详见 CHANGELOG [2.18.0]):社群精华页 /landing/community(en+zh)上线——五分类+23 天速览+每日 12 维结构化报告公开子集(未解决/活跃成员/新人/情绪研判属主私有,走 gitignored reports/+PR 正文),数据 community-digest.json(schema v2)由每日 23:00 automation-ed12b284 管道 PR 维护,契约 spec docs/superpowers/specs/2026-09-08-community-digest-pipeline.md;LandingLayout 加 wide 属性+header 导航入口+llms.txt 一行,UI/UX 专家团大宽屏重构(1600/1728 阶梯容器/横滑日报带/scroll-spy)。24h 只读风险审计三发现同日闭环——① 特定课程负面评价禁令历史清理补漏(听涛 888 七处 efbaee8 已清,补清生财航海评价类残留 7 处:负面评价与求评价条目删除/剪除评价子句,事实市场数据与正面引用保留)② digest JSON 契约测试(第 13 套件 tests/community-digest.test.ts 8 条:五分类形状/daily·reports 严格倒序/reports 精确公开键集兼证私有维度零泄漏/隐私正则 wxid+gh_ 公众号 id+11 位手机号;内容级红线有意不做机械校验防误伤)③ 日报区 REPORTS_VISIBLE=14 newest-N 窗口(DOM 不随天数线性增长,窗口外速览卡片优雅不跳转);spec §4 schema v1→v2+§3.5 渲染表述+§7 契约测试节三处漂移同步修正。