文档站维护与发布

这个站点用于解释 CubeLand 当前的玩法实现、编辑方式、资源组织和开发工具。源文件保存在游戏仓库的 docs/，由 VitePress 构建为静态网页，发布到 Cloudflare Pages。

阅读与内容分类

分类	内容与来源
开始阅读	guide/overview.md：玩法概览、模块边界与阅读路线
玩法原理	gameplay/：攻击、可达范围、子弹、旋转、停滞与工具
关卡与调参	index/levels/level-editor.md、index/gameplay/runtime-tuning.md
视觉与资源	art/、assets/：关内表现、目录规范、资源依赖
开发与验证	index/gameplay/helper.md、gameplay-editor-roadmap.md
维护方式	本页；协作执行要求见仓库内 AGENTS.md 和 docs/AGENTS.md

docs/index/registry.yml 是供代码协作使用的模块词典，不作为面向读者的文章。索引卡保持简短，完整解释放到专题正文，双方通过链接关联。

本地预览

在仓库根目录运行：

npm --prefix docs ci
npm --prefix docs run dev

开发服务器地址以终端输出为准。只检查静态产物时：

npm --prefix docs run build
npm --prefix docs run preview

构建产物位于 docs/.vitepress/dist/，缓存、依赖和构建结果不入库。新增或升级依赖时提交 docs/package.json 和 docs/package-lock.json；一般安装使用 npm ci，不要无意升级版本。

Cloudflare Pages 发布

项目	配置
项目名	cubeland-docs
正式入口	cubeland-docs.pages.dev
方式	Wrangler Direct Upload，上传构建后的静态文件
配置文件	docs/wrangler.jsonc
Pages 正式分支标识	main；与游戏仓库当前开发分支独立
输出目录	docs/.vitepress/dist/

先通过本地构建和网页检查，再按本仓库 Git 身份提交、推送本次相关源文件，然后运行：

npm --prefix docs run deploy

该命令先重新构建，再部署到既定 Pages 项目的正式环境。需要本机已经完成 Wrangler 登录，或执行环境注入具备目标账号 Pages 编辑权限的 CLOUDFLARE_API_TOKEN。凭据不得写进配置、脚本或文档。

发布后检查正式首页、改动文章、刷新直达链接、中文搜索与手机布局。仅收到上传成功不等于线上验收完成；遇到错误保留原始原因并修复。

本站采用 Direct Upload，Git 推送本身不会触发 Cloudflare 构建。当前持续同步由 AI 协作规则与上述发布命令落实；没有宣称已配置 GitHub 自动部署。未来如需 CI，可使用 Cloudflare 官方的 Direct Upload CI 指南，单独配置受限令牌。

后续内容如何同步

用户已要求：后续类似的玩法解释和实现变化，也整理进这个站点。执行规则保存在根目录 AGENTS.md 和版本化的 docs/AGENTS.md。

1. 对照实际代码与配置，更新已有文章；确认是新主题时再新增页面。
2. 先解释玩家能看到的行为，再说明判定步骤、例子、参数与实现入口。
3. 标明当前实现、参考推断与计划；给出已验证路径和未覆盖范围。
4. 新增页面补分类导航和必要交叉链接；模块入口变化时同步 index/registry.yml。
5. 构建、检查、提交并推送相关文件，再发布同一个 Pages 项目并确认线上内容。

站点中的攻击交互图是说明规则的示意，不是运行中的 Unity 游戏，也不能替代 Play Mode 验证。文档发布不执行 Unity 游戏构建。