关于 GUNDAM Archive
一个非商业的粉丝考据项目。目标是把设定整理成可验证、可追溯、可继续生长的结构。
为什么做这件事
高达系列横跨多个纪元与作品,资料分散在动画、设定集、模型说明书和社区 Wiki 中。机体参数口径不一,纪元年表彼此割裂,技术演进往往要翻十几部作品才能比对。GUNDAM Archive 用结构化数据解决这个问题。
当前实现
本仓库是当前版本的静态档案应用:Next.js 15 静态导出、内容全部来自 content/ 下的 JSON、构建期通过 zod 校验。3D 查看器使用程序化占位资产,glTF LOD0 可按 asset-manifest 接入而无需改动页面代码。
内容与代码分离:新增一台机体只需新增 JSON 文件,不改任何页面代码。
单一真相源:src/lib/schema.ts 同时约束数据结构与 TypeScript 类型。
构建即校验:schema、外键、谱系无环、双向关联任一失败都会阻止发布。
三语路由:/zh、/ja 与 /en 前缀,内容字段按语言回退并显式标注缺失。
内容更新链路
新增一台机体不改页面代码:放入 JSON,跑一次校验,重新构建即可。
content/*.json 新增或修改条目
zod 校验字段、外键与引用
静态导出,生成 zh/ja 双语页面
CDN / GitHub Pages,缓存哈希失效
src/lib/schema.ts 同时约束数据结构与 TypeScript 类型。构建期通过 zod 解析每个文件,任何字段、外键或谱系环问题都会让构建失败,而不是带着错误上线。
src/lib/schema.ts数据治理
来源分 S/A/B/C 四级;参数缺失即留空,不以同类机体估算;争议条目并列多种口径并标记 disputed;谱系边必须有出处;事件、人物与技术词条必须有长解释。当前不开放公众直接编辑,只接受带出处的建议稿。
路线图
当前版本是“可运行的档案骨架”,不是最终形态。下一步优先接入真实 glTF 资产与后端内容服务。
M0 立柱:仓库、CI、设计 Token、Schema 定型
DONEM1 单机打通:3D 查看器、拆解、量子形态、机体详情
DONEM2 数据骨架:12 台机体、年表、谱系、三语框架
DONEM3 关联完备:人物、势力、地图、检索、动画系统
WIPM4 内容扩量:147 台机体、谱系全局图、性能达标
NEXTM5 上线:无障碍、移动端、SEO、监控、公测
NEXT如何参与
内容修订请附出处与页码;新增机体请先阅读 docs/CONTENT_GUIDE.md,运行 npm run validate 后再提交。代码贡献遵循 Conventional Commits。
GitHub Repositorydocs/CHRONOLOGY.md十二纪元世纪表与阅读路径docs/MACHINE_COVERAGE.md机体覆盖范围与收录规则docs/ARCHITECTURE.md架构与决策记录docs/CONTENT_GUIDE.md新增机体 / 事件 / 人物的操作手册docs/DATA_DICTIONARY.md数据字典与单位规范docs/ASSET_PIPELINE.mdglTF / LOD / manifest 规范docs/GOVERNANCE.md出处分级、争议与版权规则
版权与许可
代码以 MIT 许可发布;本项目原创文本与图表以 CC BY-NC-SA 4.0 发布。高达系列及相关名称、设定的权利归创通・Sunrise 与 Bandai Namco 所有。本项目为非官方粉丝作品,不使用官方美术素材,不从事商业销售。
非官方粉丝项目,与 Bandai Namco / 创通・Sunrise 无关联。