Skip to content

AnvilWiki v1.0.0 — 正式发布 / First stable release

Choose a tag to compare

View all tags
@PNGTRID PNGTRID released this 12 Aug 16:29
· 49 commits to main since this release
v1.0.0
db10fe5

AnvilWiki v1.0.0 — 正式发布 / First stable release

Status License Lighthouse

🎯 AnvilWiki v1.0 正式发布 —— 从「能用」到「生产就绪」。
AnvilWiki v1.0 — from "works" to "production-ready".

本次发布涵盖自 v0.2.0 以来的全部改动:PRD 路线图(v1.1–v2.0)全部 ✅ 完成,demo 站 anvilwiki.pages.dev Lighthouse 4×100,所有可选功能(搜索、广告、评论、图片优化、换皮 CLI)均已生产就绪。

This release covers everything since v0.2.0: the full PRD roadmap (v1.1–v2.0) is now ✅, the demo site ships Lighthouse 4×100, and all optional features (search, ads, comments, image optimization, skinning CLI) are production-ready.

在线 demo / Live demo: https://anvilwiki.pages.dev

✨ 核心功能 / Key features

💬 评论系统(v1.4)/ Comments (v1.4)

  • 基于 Giscus,评论存 GitHub Discussions,零服务器零数据库
  • 默认关闭(env 空值 = 零 JS,保 Lighthouse 4×100);填好 5 个 env 变量即启用
  • 官方 <script async data-loading="lazy"> + 双 MutationObserver 暗色同步
  • 多语言:不同 locale 自动形成独立评论区;界面语言跟随页面 locale
  • 文档:docs/comments.md

🔍 Pagefind 离线搜索(v1.2)/ Offline search (v1.2)

  • 构建时索引,零运行时 JS(直到打开搜索框)
  • <dialog> 模态,Ctrl/Cmd+K 唤起,精确索引文章正文

🖼️ Astro Image 图片优化(v1.5)/ Image optimization (v1.5)

  • 自动 WebP/srcset,封面图 image() loader + 响应式尺寸防 CLS

🎨 JSON 驱动首页模块(v1.3)/ JSON-driven homepage modules (v1.3)

  • 6 种 displayType:code-cards / step-by-step / tier-grid / card-list / timeline / video-grid
  • 换游戏只改 JSON,不改组件

🔧 换皮 CLI(v2.0)/ Skinning CLI (v2.0)

  • pnpm skin <game-name> 引导式换皮:hex→HSL 主题色、site/navigation/routing/ui/locales/manifest 自动重写
  • --dry-run / --no-clear-content flag

💰 广告就绪 / Ads ready

  • 内置 Adsterra iframe 隔离方案(6 种广告位),填 key 即生效

🌍 多语言 / Full i18n

  • 英文无前缀(SEO 最优),其他语言带前缀,缺失内容自动 fallback 英文

🔧 seoscout 格式转换(v1.1)/ seoscout converter (v1.1)

  • pnpm convert-seoscout 自动转换 MDX 格式

🐛 重要修复 / Notable fixes

Cloudflare Pages env 注入(wrangler.toml 接管)/ Cloudflare Pages env injection

症状 / Symptom: 在 Cloudflare dashboard 配了 env 变量,但构建时 process.env 一个都读不到,评论组件静默不渲染。
根因 / Root cause: 当项目根目录有 wrangler.toml 时,它成为 Pages 项目 env 的唯一真相源,dashboard 的 Environment variables UI 被完全忽略(Cloudflare 官方文档)。
修复 / Fix: 在 wrangler.toml 加 [vars] 段声明所有构建时 env 变量。
防御 / Prevention: wrangler.toml 顶部加醒目 fork 警告;docs/deployment.md + AGENTS.md Hard Rule 12 详细说明。

SITE_URL 协议要求 / SITE_URL protocol requirement

症状 / Symptom: SITE_URL 配成裸域名(如 anvilwiki.pages.dev)会让 Astro build 报 Invalid url。
修复 / Fix: 强制要求 SITE_URL 含 https:// 协议。.env.example / wrangler.toml / docs/deployment.md / AGENTS.md Hard Rule 9 全部同步更新。

📊 项目状态 / Project status

维度 / Dimension 状态 / Status
PRD 路线图(v1.1–v2.0) ✅ 全部完成 / All complete
Lighthouse Performance / Accessibility / Best Practices / SEO 全 100
测试 / Tests 18/18 passing(typecheck + vitest)
Sitemap 28/28 URLs 返回 200
Demo 站 / Demo site anvilwiki.pages.dev 启用评论 + 搜索 + 广告位

📦 升级 / Upgrading

这是首次正式发布,无升级路径。直接 fork 即可。

This is the first stable release — fork to start.

快速开始 / Quick start: 见 README 的「5 分钟快速开始」/ See README "5-minute quickstart".

🙏 反馈 / Feedback

完整变更日志 / Full changangelog: CHANGELOG.md

Assets 2
Loading