HEROLL/README.md

HEROLL 项目

本仓库保存玩法验证源码、设计规则、配置和阶段证据。

目录

• mvp/：TypeScript 玩法原型、测试与本地启动工具。
• design/、docs/、art-bible/：设计说明与资源规范。
• HEROLL_RULES_v0.2.8/：局内规则和配置。
• HEROLL_OUTGAME_2.0.1/、HEROLL_OUTGAME_DEV_v1.0/：局外设计文档。
• *EVIDENCE/：规则依据及阶段审计记录。

本地运行与资源

参见 mvp/README.md。依赖由 mvp/package.json 和 mvp/pnpm-lock.yaml 管理。

当前源码引用 analysis/visual-study/unity-samples/ 和 design/ue-ui/assets/original/ 中的原作素材。这些素材按原有 README 的授权说明仅保留本地，不进入上传清单。新克隆的仓库尚不能完整还原画面，需要先提供获授权的替代资源并更新引用。

APK、反编译归档、视频、历史发布包、工作副本、依赖和构建产物均由根目录 .gitignore 排除。忽略规则不会删除本地文件。

整理记录（2026-10-26）

本次只新增 Git 忽略规则、目录说明与上传清单，没有移动或删除原文件，没有暂存、提交或推送。

现有核心测试为 23/24 通过，失败项为事件配置数量断言（预期 13，实际 14）。编译检查未完成：当前 mvp/node_modules/typescript/bin/tsc 入口不存在。此次未修改源码或依赖。

完整本地盘点见 git-file-inventory.csv；拟上传清单见 git-upload-candidates.csv；排除清单见 git-upload-excluded.csv。这些 CSV 仅用于本地检查，不上传。当前为体积整理，尚未完成逐文件敏感信息审核。