PVZH 版本服务

本项目已由在线 Mod 工具站收缩为只读版本与更新信息服务。Web 工具服务停止，相关工具能力正在逐步迁往 PVZH Mod 启动器；迁移尚未完成。开发进度见 B 站。

首页 / 只提供调整说明与感谢，不展示工具、下载中心、玩家精选或赞助界面。

保留的客户端接口

内容	GET 路径	配置
DIY 版本	/version、/api/version、/version.txt	data/version.json
历史 R 构建版本与公告	/api/pvzh-launcher/v1/manifest.json	data/launcher.json
正式启动器版本与公告	/api/pvzh-launcher/v2/manifest.json	data/launcher-release.json（身份）＋data/launcher.json（公告）
启动器项目留言与名单	/api/pvzh-launcher/v1/project.json	data/launcher-project.json
DIY 玩家精选	/api/pvzh-diy/v1/featured/version.json、/api/pvzh-diy/v1/featured/manifest.json	data/featured.json
赞助与鸣谢	/sponsors、/api/sponsors、/thanks、/api/thanks、/sponsors.txt、/thanks.txt	data/sponsors.json

既有接口沿用原字段、别名、公开 CORS 与禁止缓存的响应头；DIY 和启动器的版本编号彼此独立。玩家精选和赞助仅保留客户端 API，没有网页展示。项目留言使用新增的独立快照，不修改原四份配置中的版本、公告、作品或赞助数据。DIY 配置损坏或缺失时返回 503，不回退到源码里的旧版本。

正式版 v2 接口从独立十字段发行文件生成原五字段 latest，普通公告复用原文件。旧 v1 的版本与正文保留，防止历史 R 构建收到正式版升级。发行副本来自客户端唯一 release.json，当前对外 v1、内部 R51、独立发布编号 100001；构建默认 development，正式包显式 stable，策略由客户端执行。维护规则见正式版合同。

项目留言、赞赏者与贡献者名单仅提供有界纯文本JSON，由部署快照维护，没有留言提交、编辑、上传或管理接口。新名单默认为空，不从旧赞助接口自动复制。GitHub按钮地址由客户端固定，项目快照不提供可替换URL；合同见项目留言说明。

旧 /unity、/editor、/deck-editor、/phantom、/downloads、/tools 返回 HTTP 410 及说明页；原工具 API 返回 JSON 410，仅读取路由，不解析上传。工具源码、归档底包和专用资源已退出当前树，仍可从 Git 历史找回。完整旧路径见 blueprints/retired.py。

基础请求保护

保留跨接口的单 IP 和全站总量限流，超限返回 429 与 Retry-After。默认每 IP 10 次/秒、120 次/分钟，全站 120 次/秒、1200 次/分钟，额度可通过环境变量调整。只有 GET/HEAD /health 豁免；不按 User-Agent 猜测恶意用户，不依赖数据库审计或假成功响应。单 worker 内存计数不适用于多实例部署，详见部署说明。

本地运行与验证

使用 Python 3.12，无需 Node、Linux resource、UnityPy 或 Supabase。

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
cp .env.example .env
python scripts/validate_snapshots.py
python -m pytest -q
python app.py

访问 http://127.0.0.1:5001。Windows 激活命令为 .venv\Scripts\activate；不再需要 WSL。生产只安装 requirements.txt。

发布

修改对应 data/*.json，运行快照校验和测试，再通过 PR 审阅、合并和部署。没有公共写入接口，不需要数据库或管理令牌。首页文字位于 templates/index.html，样式为本地 static/site.css，无前端脚本或外部字体。

部署与配置清理见 部署说明，组件关系见 架构说明，启动器合同见 通知说明和项目留言说明。