TARP 官网

TARP 官网，包含产品介绍、玩家指南和模组创作文档。使用 Astro、Tailwind CSS、React 和 Bun 构建。

开发

需要 Bun 1.4.0+ 和 Node.js 22.12+，在本目录运行：

bun install --frozen-lockfile
bun run dev

• bun run build：检查并构建，产物位于 dist/。
• bun run preview：预览构建产物。
• bun run format:check：检查格式。

文档位于 src/content/docs/，更新记录位于 src/content/releases/，通过 /releases/ 查看。更新记录列表使用独立时间轴页面，版本详情位于 /releases/<版本号>/，均使用官网布局。环境变量见 .env.example。

素材

• 图片放在 src/assets/，SVG 和网站图标放在 public/。社交分享图是 public/og.png（1200×630）；标语变更时一并更换。
• 首页截图由项目作者提供，位于 src/assets/screenshots/。
• JetBrains Mono 字体和 GSAP 动效库通过 JSDMirror 加载。

模组收录

模组库位于 /modules/。在 src/data/modules/sources.json 添加 GitHub 仓库的 repository（作者/仓库）、file（module.json 或 module.toml）；模组固定放在仓库的 module/ 中。可选的 testedWith 记录实际测试过的 TARP 版本，不填写未经验证的版本。

安装系统 Git 后运行 bun run modules:sync，从公开仓库解析默认分支的最新提交，读取配置并生成 src/data/modules/catalog.json。同步只保存公开展示字段，不运行模组代码；所有来源成功后才替换快照。检查来源、素材授权和快照差异后，将来源与快照一起提交。移除来源后重新同步即可下架。

日常开发与构建读取已提交快照，不依赖外部仓库或相邻本地项目。封面直接使用源地址；模组内相对图片固定到快照记录的提交，加载失败时回退到文字封面。一键导入和手动 Git 导入均取默认分支最新内容；与收录快照不同时，桌面端在导入完成后提醒。

运行 bun test src/lib/modules.test.mjs 检查展示字段提取与封面路径解析。