# 项目记录

## 线上环境

- **地址**: `https://tool.890805.xyz/opencode/`
- **服务**: Caddy file_server
- **对应目录**: `/data/`（项目根目录）

访问方式：
- 游戏首页：`https://tool.890805.xyz/opencode/game/`
- 躲避方块：`https://tool.890805.xyz/opencode/game/躲避方块/`

## 项目结构

```
/data/
├── agents.md               # 项目总览记录
└── game/                   # 游戏合集
    ├── index.html          # 游戏导航首页（仿 iPhone 17 / iOS 26 Liquid Glass 主屏幕）
    ├── agents.md           # 游戏合集详细记录（含需求规范）
    ├── 2048/               # 自研浅色版
    │   └── index.html
    ├── 俄罗斯方块/         # 源码部署：sinedied/mobiletris（5按钮+画布手势）
    │   └── index.html      # Google Fonts → font.im
    ├── 贪吃蛇/             # 自研单文件（自适应+穿墙+Nokia方波BGM+♪开关+屏蔽下拉/滑退）
    │   └── index.html      # 11.1KB，HTML+CSS+JS 内联，零外部资源
    ├── 扫雷/               # 源码部署：freeopensourcegames/minesweeper（touch 长按红旗）
    │   ├── index.html
    │   ├── game.js
    │   └── style.css
    ├── 记忆翻牌/           # 源码部署：99fk/memory-html（CSS Grid 响应式 + localStorage）
    │   └── index.html
    ├── 五子棋/             # 源码部署：yangfanconan/gomoku（AI 3难度 + 国风/简约主题 + 移动控件）
    │   ├── index.html
    │   ├── css/style.css
    │   └── js/{chessAI,chessRules,chessUI,sound,storage,interaction,main}.js
    ├── 消灭星星/           # 源码部署：bigbrochan/popstar（Hammer.js tap + rem 响应式 + 10×10五色连消）
    │   ├── index.html
    │   ├── index.js
    │   ├── index.css
    │   ├── hammer.min.js
    │   └── imgsrc/{star5,ui5,bg3,anim4,etc,4unused}23
    └── flappy-bird/        # 源码部署：nolanjp/flappybird-web（完整 sprite + 4 音效）
        ├── index.html
        ├── game.js
        ├── style.css
        └── assets/{images/9,sound/4}
```

## 合集列表

| 合集 | 路径 | 状态 | 说明 |
|------|------|------|------|
| 游戏 | `/game/` | 进行中 | 9 款小游戏（2048 + 贪吃蛇 + 躲避方块自研 + 6 款源码部署），全部为真正的手机友好版本 |

---

## 添加新合集

1. 在根目录下创建新文件夹（如 `/tool/`、`/demo/`）
2. 在新文件夹中创建导航页 `index.html`
3. 在新文件夹中创建 `agents.md` 记录该合集信息
4. 更新本文件，添加新合集到合集列表

## 添加新游戏（游戏合集内）

详细规范见 `game/agents.md`，核心原则：

1. 在 GitHub 找**手机适配或触屏友好**版本源码
2. `curl` 下载压缩包 → `unzip` → 复制到 `game/<游戏名>/`
3. 替换中国不友好的 CDN（`cdn.bootcdn.net` / `fonts.font.im`）或下载到 `vendor/`
4. 源无触屏则在 `index.html` 末尾追加最小 touch 监听
5. 不修改源 HTML/CSS/JS，不强制统一风格
6. 在 `game/index.html` 网格中追加新游戏图标
7. 更新 `game/agents.md` 记录新游戏信息