GUNDAM / ABOUTV3.7.1 / 2026.11.16
ABOUT / 关于本档案

关于 GUNDAM Archive

一个非商业的粉丝考据项目。目标是把设定整理成可验证、可追溯、可继续生长的结构。

VERSION 3.7.1DATA CUT 2026.11.16148 MS / 69 EVENTS
01 / THESIS

为什么做这件事

高达系列横跨多个纪元与作品,资料分散在动画、设定集、模型说明书和社区 Wiki 中。机体参数口径不一,纪元年表彼此割裂,技术演进往往要翻十几部作品才能比对。GUNDAM Archive 用结构化数据解决这个问题。

02 / ARCHITECTURE

当前实现

本仓库是当前版本的静态档案应用:Next.js 15 静态导出、内容全部来自 content/ 下的 JSON、构建期通过 zod 校验。3D 查看器使用程序化占位资产,glTF LOD0 可按 asset-manifest 接入而无需改动页面代码。

L1表现层Next.js 15 App Router · 静态导出 · R3F已落地
L2应用层React Server Components · 构建期数据装载已落地
L3服务层目标:NestJS + Zod · 当前由构建期校验替代规划
L4数据层content/*.json + Zod · 目标 PostgreSQL 16 + JSONB已落地
L5资产层程序化 LOD-P · 目标 glTF 2.0 + KTX2 + CDN部分
L6运营层npm run validate · GitHub Actions · 内容 PR 门禁已落地
01

内容与代码分离:新增一台机体只需新增 JSON 文件,不改任何页面代码。

02

单一真相源:src/lib/schema.ts 同时约束数据结构与 TypeScript 类型。

03

构建即校验:schema、外键、谱系无环、双向关联任一失败都会阻止发布。

04

三语路由:/zh、/ja 与 /en 前缀,内容字段按语言回退并显式标注缺失。

03 / PIPELINE

内容更新链路

新增一台机体不改页面代码:放入 JSON,跑一次校验,重新构建即可。

01CONTENT

content/*.json 新增或修改条目

02SCHEMA

zod 校验字段、外键与引用

03BUILD

静态导出,生成 zh/ja 双语页面

04SHIP

CDN / GitHub Pages,缓存哈希失效

单一真相源

src/lib/schema.ts 同时约束数据结构与 TypeScript 类型。构建期通过 zod 解析每个文件,任何字段、外键或谱系环问题都会让构建失败,而不是带着错误上线。

src/lib/schema.ts
04 / GOVERNANCE

数据治理

来源分 S/A/B/C 四级;参数缺失即留空,不以同类机体估算;争议条目并列多种口径并标记 disputed;谱系边必须有出处;事件、人物与技术词条必须有长解释。当前不开放公众直接编辑,只接受带出处的建议稿。

S
官方资料官方动画 / 设定集 / 官网
A
权威佐证权威百科 / 授权出版物
B
社区线索社区 Wiki,仅作线索
C
写作参考个人参考,不录入数据
05 / ROADMAP

路线图

当前版本是“可运行的档案骨架”,不是最终形态。下一步优先接入真实 glTF 资产与后端内容服务。

M0

M0 立柱:仓库、CI、设计 Token、Schema 定型

DONE
M1

M1 单机打通:3D 查看器、拆解、量子形态、机体详情

DONE
M2

M2 数据骨架:12 台机体、年表、谱系、三语框架

DONE
M3

M3 关联完备:人物、势力、地图、检索、动画系统

WIP
M4

M4 内容扩量:147 台机体、谱系全局图、性能达标

NEXT
M5

M5 上线:无障碍、移动端、SEO、监控、公测

NEXT
06 / CONTRIBUTE

如何参与

内容修订请附出处与页码;新增机体请先阅读 docs/CONTENT_GUIDE.md,运行 npm run validate 后再提交。代码贡献遵循 Conventional Commits。

GitHub Repository
仓库入口
  • docs/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出处分级、争议与版权规则
07 / LICENSE

版权与许可

代码以 MIT 许可发布;本项目原创文本与图表以 CC BY-NC-SA 4.0 发布。高达系列及相关名称、设定的权利归创通・Sunrise 与 Bandai Namco 所有。本项目为非官方粉丝作品,不使用官方美术素材,不从事商业销售。

非官方粉丝项目,与 Bandai Namco / 创通・Sunrise 无关联。

GUNDAM ARCHIVE / V3.7.1首页