AnvilWiki README

The project's README from github.com/PNGTRID/AnvilWiki. As one markdown file: README.md.

AnvilWiki ⚒️

带 AI 内容工作流的游戏 wiki 模板——广告收入 100% 归你。 开源、Cloudflare Pages 原生优化、零成本免费部署上线。 fork 后 5 条命令 + 一次点选部署上线;唯一必要开销是一个域名——不会编程也走得完(双手册带路)。

The game wiki template with an AI-native content workflow — 100% of your ad revenue. Open source, natively optimized for Cloudflare Pages, free to deploy. Five commands and one dashboard click from fork to live; the only required spend is a domain — no coding needed.

📖 中文文档 · English Documentation

License: MIT Astro Cloudflare Pages Release CI Live Demo Docs Works with

Demo site homepage

Boss stat card Codes page — tap to copy Weapon tier list

Boss 数据卡 · 兑换码一键复制 · 武器强度榜——wiki 级呈现的其中三页,点图直达对应页面。Boss stat cards, tap-to-copy codes, tier lists — three of the wiki-grade page types; click through to the live pages.

Lighthouse 4×100 — 实测于 anvilwiki.pages.dev(2026-09-03)

Performance 100 Accessibility 100 Best Practices 100 SEO 100


🚀 快速链接

你想… 去这里
零基础从零做一个赚钱的游戏站 📚 学习手册——每步写明「做什么/怎么做/你会看到什么」,含可复制的 AI 提示词
看「从零到赚钱」的全部工作量 🗺️ 文档中心首页——10 件事全景清单,逐项点入
深度定制 / 给模板写代码 🔧 开发手册
看看做出来长什么样 🎮 在线 Demo——虚构游戏「Anvil Quest」的完整 wiki
对比 Fandom / Wiki.js / 其他方案 ⚖️ 完整对比页——三种物种、自托管引擎数据表、什么时候不该选 AnvilWiki

📖 中文文档

5 分钟快速开始

跑完这一节你会得到:一个跑在 Cloudflare 免费版上、属于你自己的 wiki 站(先以 demo 内容上线,换成你的游戏、清掉 demo,随时可以做)。

开始前需要:Node.js 22+ 和 pnpm(没装 pnpm?终端跑 npm install -g pnpm;或跟着学习手册「装好 6 样工具」一课把 6 样工具一次装齐)。

# 1. Fork 本仓库(仓库右上角 Fork 按钮),然后克隆你的 fork(换成你的 GitHub 用户名)
git clone https://github.com/<你的用户名>/AnvilWiki.git
cd AnvilWiki

# 2. 安装依赖并本地预览
pnpm install
pnpm dev            # 打开 http://localhost:4321,能看到 demo 站 = 环境通了

# 3. 一条问答式命令,把 demo 站换成你的游戏(游戏名/主题色/域名/语言…)
pnpm apply-template

# 4. 把改动推回你的 fork
git add .
git commit -m "Apply my game"
git push           # 第 5 步 Cloudflare 连的是 GitHub 远端仓库,不推上去它连到的还是 demo

# 5. 部署:cloudflare.com → Workers & Pages → Create → Pages → Connect to Git → 选你的 fork
#    构建命令 pnpm build、输出目录 dist 会自动识别;环境变量加 NODE_VERSION=22

💡 SITE_URL 不用去 dashboard 配:第 3 步已经把它写进 wrangler.toml 的 [vars]——只要这个文件存在,它就是 Cloudflare Pages 环境变量的唯一真相源,dashboard 里配的同名变量会被忽略。以后换域名,改 [vars] 里的 SITE_URL(必须含 https://)即可;也可以删掉该文件改用 dashboard 配置。完整说明 + 踩坑诊断见 docs/deployment.md。

不想碰终端?有一条零命令路径:fork 后打开你仓库的 Actions 页签 → 左侧选 Initialize AnvilWiki → Run workflow(填你的域名)→ 合并它开好的 PR → 直接做上面的第 5 步。游戏名、主题色等之后随时可以让 AI 助手帮你改。

完全新手?别从这里开始——先去学习手册:「选品找词」一个阶段帮你把游戏选对,「装好 6 样工具」把终端、Node、Git、AI 助手怎么装、每步会看到什么全部写清,然后「把站跑起来」才动手建站。手册源码在 docs/handbook/,fork 后依然保留(但站内文档中心页面会自动移除,属正常)。

这是什么?

AnvilWiki 是一个游戏 SEO 内容站模板——用来快速搭建围绕某款游戏(Roblox、Steam 新游等)的攻略内容站,通过 SEO 获取流量,通过广告变现。广告收入 100% 归你:无平台抽成、无收入分成(对比 Fandom 等托管 wiki 的平台分成模式)。

技术栈是 Astro + Cloudflare Pages:纯静态输出、零适配器、免费无限带宽、全球 CDN、零 JS 优先(首屏极快)。

适合谁:想靠游戏内容做副业、会用浏览器但不会编程的人(学习手册就是按这个标准写的),以及想被 AI 工作流加速的内容创作者。

核心特性

用 AI 直接生成内容(无需脚本)

fork 后用 ZCode / Claude Code / Codex / Cursor 打开仓库,直接对话即可产页。Agent 会自动加载仓库里的内容规范,生成后自动跑 pnpm check-content && pnpm build 自检。内置 6 个技能:

技能 用途
anvil-find-keywords 挖词选品:9 渠道自动挖候选 → SERP 快验+意图满足度 → 判决打分,落盘决策管理表(含复查日)
anvil-new-article 任意素材(口述/视频字幕/原始数据)→ 合规 MDX 文章,支持 YouTube 视频转攻略
anvil-batch-articles 关键词清单 → 批量生成一批内页(意图归类 → bulk-new-posts 脚手架 → 统一提示词填充)
anvil-update-codes 新兑换码/过期码 → 更新 codes 页并同步多语言
anvil-refresh 新鲜度巡检 → 输出「该更新什么」优先级清单
anvil-adsense-audit AdSense 申请前逐项体检(22 项政策清单,模板已解决的项自动给证据)

完整的提示词库(选品分析、产页、批量产页、翻译、SEO 体检、关键词选题等模板)在学习手册里,整段复制就能用。

文档在哪里?

入口 内容
📚 站内文档中心 首选:双手册 + 「从零到赚钱 10 件事」全景清单,中英双语
🗂️ docs/README.md 仓库内全部参考文档索引(选品/挖词/部署/SEO/广告/内容管道/多站运营…),按角色与时机分类,附四条阅读路径
📋 requirements/ 建站前素材准备模板:事实来源表 + 对标参考表
🏗️ docs/PRD.md 架构唯一真相源:想知道「为什么这么设计」看这里

为什么不用 Fandom / 自建 Next.js?

AnvilWiki Fandom 类平台 自建 Next.js
广告收入 100% 归你(自带 AdSense 位) 平台抽成 归你,但要自己接
每月成本 ¥0(Cloudflare Pages 免费无限带宽) 免费(代价是失去控制权) Vercel 免费额度有限
Lighthouse 4×100 开箱即得 平台决定 自己调优数周
AI 产页 技能随仓库分发,对话即产页 无 自己搭
上手门槛 零基础引导式双手册 低但受制于人 高

更完整的选型对比——含 Wiki.js、BookStack、MediaWiki、DokuWiki、Docmost 五个自托管引擎的数据表,以及「什么时候不该选 AnvilWiki」:见完整对比页。

常见问题

用 AnvilWiki 建了站?欢迎提交 Showcase

真实案例是这个模板最有力的证明(按提交顺序排列):

站点 游戏 简介
Aniimo Wiki Aniimo(Roblox) 攻略、强度榜与最新兑换码
No Man's Sky Wiki 无人深空(Steam) 机制资料与版本更新攻略
Steal an Egg Wiki Steal an Egg(Roblox) 宠物、蛋、兑换码与玩法攻略
Jujutsu Shenanigans Player Guide Jujutsu Shenanigans(Roblox) 中英日三语玩家 wiki:角色路线、Black Flash、地图、兑换码与版本更新
Mortal Shell II Wiki Mortal Shell II Shell、武器、Boss、地点、物品与 Open Beta 攻略
Sephiria Builds Sephiria 动作肉鸽 Sephiria 的 build 数据库——带版本戳的武器强度榜与证据分级的 build 攻略
Resonance Wiki Resonance: A Plague Tale Legacy 全章节流程攻略、全部收集品位置、奖杯路线图、谜题解法与技能推荐

提 PR 在 src/config/landing.ts 的 COMMUNITY_SITES 追加一条即可——官网(/landing 与 /zh/landing)的「Built with AnvilWiki」区块会自动展示。

交流群 / 技术栈 / 许可

微信扫码添加主理人好友,拉你进群交流讨论(部署问题、功能建议、游戏内容站经验都欢迎;项目官网右下角也有同款悬浮扫码按钮):

微信二维码——扫码添加好友进群交流

技术栈:Astro 5(静态输出)+ Tailwind CSS 3 + MDX 4 + astro-icon/lucide + Content Layer API(Zod)+ Pagefind 搜索 + pnpm 11 / Node 22。

许可:MIT,见 LICENSE。

致谢:选品判决框架(docs/sourcing.md 第四节)参考了 yan-labs/yan-skills(MIT)的 game-opportunity 技能;AdSense 申请前审计技能(/anvil-adsense-audit)的审计框架受 yantoumu/adsense-site-auditor-skill 启发(清单为模板特化重写,未复制其文本);视频转攻略工作流(anvil-new-article Step 0)的管线设计参考 kennyzir/7deer_skills(MIT)的 youtube-content-gen 技能。感谢三个项目把方法论开源出来。


📖 English Documentation

I want to… Go here
Build a money-making game site from zero 📚 Learning Manual — every step a SOP with copy-paste AI prompts
See the whole journey first 🗺️ Docs hub — a 10-job whole-picture checklist
Customize deeply / contribute code 🔧 Development Manual
See what it looks like 🎮 Live demo — a complete wiki for the fictional game "Anvil Quest"
Compare Fandom / Wiki.js / alternatives ⚖️ Full comparison

Quick Start (5 min)

What you'll have when this section is done: your own wiki live on Cloudflare's free tier (it ships with demo content first — rebranding and demo removal come whenever you're ready).

Prerequisites: Node.js 22+ and pnpm (no pnpm? run npm install -g pnpm — or let the "Install the 6 Tools" lesson walk you through all six tools).

# 1. Fork this repo (Fork button, top right), then clone YOUR fork (replace the username)
git clone https://github.com/<your-username>/AnvilWiki.git
cd AnvilWiki

# 2. Install & preview locally
pnpm install
pnpm dev            # open http://localhost:4321 — seeing the demo site means your env works

# 3. One guided Q&A command swaps the demo for your game (name/theme/domain/locales…)
pnpm apply-template

# 4. Push the changes back to your fork
git add .
git commit -m "Apply my game"
git push           # step 5 connects Cloudflare to the REMOTE repo — skip this and it deploys the demo

# 5. Deploy: cloudflare.com → Workers & Pages → Create → Pages → Connect to Git → pick your fork
#    Build `pnpm build` and output `dist` are auto-detected; add env NODE_VERSION=22

💡 No need to set SITE_URL in the dashboard: step 3 already wrote it into [vars] in wrangler.toml — while that file exists it is the sole source of truth for Cloudflare Pages env, and same-named dashboard variables are ignored. To change domains later, edit SITE_URL in [vars] (must include https://), or delete the file and use the dashboard instead. Full explanation + troubleshooting: docs/deployment.md.

Prefer zero terminal? There's a no-command path: open your fork's Actions tab → Initialize AnvilWiki → Run workflow (enter your domain) → merge the PR it opens → jump straight to step 5 above. Game name, theme color and more can be changed later with your AI assistant.

Complete beginner? Don't start here — start with the Learning Manual: the Pick & Validate stage picks your game, "Install the 6 Tools" walks you through every install with "what you'll see" on each step, and "Run Your Site" is where the site gets built. The handbook source lives in docs/handbook/ and stays in your fork (the in-site docs center pages are auto-removed for forks — that's expected).

What is this?

AnvilWiki is an open-source game wiki site template: build a content site around a game (Roblox, Steam new releases…), pull traffic via SEO, monetize with ads — 100% of the ad revenue is yours. Built on Astro + Cloudflare Pages: pure static, zero adapters, free unlimited bandwidth, Lighthouse 4×100 out of the box.

Key Features

AnvilWiki (PNGTRID/AnvilWiki)

Searching Database…

Что это?AnvilWiki — открытый шаблон для создания игровой вики или SEO-сайта с контентом по конкретной игре (Roblox, игры из Steam и т. д.), построенный на Astro и разворачиваемый на Cloudflare Pages. Он привлекает трафик через SEO и монетизируется рекламой, причём 100% дохода от рекламы идут вам.
Это хостинговый вики-сервис или шаблон, который я запускаю сам?Это репозиторий-шаблон: вы делаете форк и разворачиваете его в своём аккаунте Cloudflare Pages, а не управляемая платформа вроде Fandom. На выходе — чисто статичный Astro-сайт, изначально рассчитанный на работу без JavaScript.
Как запустить свой вики-сайт?Сделайте форк репозитория и выполните быстрый старт из 5 команд, чтобы развернуть сайт на бесплатном тарифе Cloudflare Pages. Есть и путь без терминала: откройте вкладку Actions в форке, запустите workflow «Initialize AnvilWiki» с вашим доменом и влейте созданный им PR.
Что нужно установить перед началом?Нужны Node.js 22+ и pnpm (ставится через npm install -g pnpm); Learning Manual также проводит полных новичков через установку терминала, Git и ИИ-ассистента.
Есть ли подводные камни, прежде чем рассчитывать на доход?Сайт поставляется с демо-контентом, который нужно заменить, а нулевой доход в первые 1-2 недели — это нормально; реалистичное окно заработка — 2-8 недель после всплеска популярности игры.
Для кого это сделано?Для людей, которые хотят вести сайт с игровым контентом как подработку, не умея программировать (Learning Manual написан для полных новичков), и для авторов контента, которым нужен ускоренный с помощью ИИ процесс написания текстов.
Какие ИИ-навыки уже встроены в репозиторий?В AnvilWiki входит шесть агентных навыков в .agent/skills/: anvil-find-keywords для подбора ключевых слов, anvil-new-article, чтобы превращать заметки или видео в гайд, anvil-batch-articles для массовой генерации страниц, anvil-update-codes для обновления промокодов, anvil-refresh для пометки устаревшего контента и anvil-adsense-audit для проверки соответствия правилам AdSense.
Чем AnvilWiki отличается от Fandom или самописной вики на Next.js?В отличие от Fandom, вы оставляете себе 100% дохода от рекламы, а не отдаёте платформе долю; в отличие от самописной сборки на Next.js, AnvilWiki из коробки даёт производительность Lighthouse 4x100 и генерацию страниц с помощью ИИ вместо недель ручной настройки.
Можно ли управлять несколькими вики-сайтами сразу?Да — набор инструментов anvilwiki-ops (через npx или как MCP-сервер) позволяет вашему ИИ-ассистенту подтягивать данные Google Search Console и Cloudflare по нескольким сайтам и составлять чек-листы по оптимизации.
Как на этом реально заработать?В шаблон входят три отключённых по умолчанию блока монетизации — рекламные слоты AdSense, компонент партнёрских ссылок и карточки рекомендаций в конце статьи; они открываются через env/конфиг, так что вы включите их, когда сайт будет готов, и весь доход пойдёт вам.
Creator
PNGTRID
Size
5.9 MB
Stars
200
Age
2mo
Commits · 90 Days