游戏名称 - 游戏花园

# 接口文档 — 粉色妖精小姐的秘密基地 > 本文档说明如何向网站添加新内容（游戏、资源等）。所有扩展均基于 **manifest.json** 配置文件实现，无需修改页面代码。 --- ## 目录结构 ``` ├── index.html # 首页 ├── explore.html # 妖精工坊（内置工具页） ├── games.html # 游戏花园（动态加载） ├── resources.html # 资源宝库（动态加载） ├── common.css # 公共样式 ├── common.js # 公共脚本 ├── assets/ │ └── music/ # 背景音乐 ├── games/ │ ├── manifest.json # ⭐ 游戏清单 │ ├── README.md # 游戏添加指南 │ └── / # 每个游戏一个文件夹 │ └── index.html └── resources/ ├── manifest.json # ⭐ 资源清单 └── README.md # 资源添加指南 ``` --- ## 1. 游戏接口 (games/manifest.json) ### 文件位置 `games/manifest.json` ### 数据格式 JSON 数组，每个元素为一个游戏对象： ```json [ { "id": "game-id", "name": "游戏名称", "description": "游戏简介，一句话描述", "icon": "fas fa-puzzle-piece", "category": "休闲", "url": "games/game-id/index.html", "version": "1.0.0", "author": "作者名" } ] ``` ### 字段说明 | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | string | ✅ | 唯一标识，与文件夹名一致 | | `name` | string | ✅ | 显示名称 | | `description` | string | ✅ | 简短描述 | | `icon` | string | ❌ | FontAwesome 图标类名，默认 `fas fa-gamepad` | | `category` | string | ❌ | 分类标签，用于筛选，默认"未分类" | | `url` | string | ✅ | 游戏入口页面的相对路径 | | `version` | string | ❌ | 版本号 | | `author` | string | ❌ | 作者 | ### 添加新游戏步骤 1. 在 `games/` 下创建文件夹，如 `games/my-game/` 2. 在文件夹内创建 `index.html` 作为游戏入口 3. 编辑 `games/manifest.json`，添加一条记录： ```json { "id": "my-game", "name": "我的游戏", "description": "一个有趣的小游戏", "icon": "fas fa-star", "category": "益智", "url": "games/my-game/index.html", "version": "1.0.0", "author": "YourName" } ``` 4. 提交到 GitHub，游戏花园页面会自动显示新游戏 ### 游戏模板每个游戏的 `index.html` 建议包含返回按钮： ```html 游戏名称 - 游戏花园返回游戏花园 ``` > **注意**：游戏页面通过 `../../` 回到根目录引用公共文件。 --- ## 2. 资源接口 (resources/manifest.json) ### 文件位置 `resources/manifest.json` ### 数据格式 ```json [ { "id": "resource-id", "name": "资源名称", "description": "资源描述", "icon": "fas fa-gem", "category": "素材", "type": "link", "url": "https://example.com", "tags": ["标签1", "标签2"] } ] ``` ### 字段说明 | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | string | ✅ | 唯一标识 | | `name` | string | ✅ | 显示名称 | | `description` | string | ✅ | 简短描述 | | `icon` | string | ❌ | FontAwesome 图标类名，默认 `fas fa-gem` | | `category` | string | ❌ | 分类标签，默认"未分类" | | `type` | string | ❌ | 资源类型：`link`（外链）/ `file`（本地文件）| | `url` | string | ✅ | 资源链接或文件路径 | | `tags` | string[] | ❌ | 标签数组，用于展示 | ### 添加新资源步骤 1. 如果是本地文件，放入 `resources/` 或子目录 2. 编辑 `resources/manifest.json`，添加记录 3. 提交到 GitHub --- ## 3. 妖精工坊工具 (explore.html) 工具直接内嵌在 `explore.html` 中，通过 JavaScript 对象定义。 ### 工具注册在 `explore.html` 的 `