云端数据文件

这个目录包含需要上传到云端的数据文件，用于减少小程序包体积。

📁 目录结构

cloud-data/
├── images/              # 图片资源（99.7 MB，147 个文件）
│   ├── avatars/        # 头像（2.4 MB，6 个文件）
│   ├── backgrounds/    # 背景图（32.2 MB，7 个文件）
│   ├── icons/          # 图标（7.0 MB，8 个文件）
│   ├── letters/        # 字母图片（9.7 MB，52 个文件）
│   ├── mahjong/        # 麻将游戏图片（44.2 MB，64 个文件）
│   └── mahjong-style/  # 麻将样式（146 KB，3 个文件）
│
├── fables.json         # 寓言故事数据（265 KB，138 条）
├── encyclopedia.json   # 百科数据（112 KB，100 条）
└── jokes.json          # 笑话数据（69 KB，227 条）

📊 文件统计

图片资源

• 总大小: 99.7 MB
• 文件数量: 147 个
• 最大文件: arena-bg.png (7.8 MB)

数据文件

• 总大小: 446 KB
• 文件数量: 3 个

总计

• 总大小: 100.1 MB
• 文件数量: 150 个

---

🚀 上传到 GitHub（推荐）

步骤 1: 创建 GitHub 仓库

1. 访问 https://github.com
2. 点击 "New repository"
3. 仓库名：miniprogram-cdn
4. 设置为 Public（公开）
5. 创建仓库

步骤 2: 上传文件

方法 A: 使用 Git 命令（推荐）

# 在 cloud-data 目录下
cd cloud-data

# 初始化 Git
git init

# 添加所有文件
git add .

# 提交
git commit -m "Add images and data files"

# 添加远程仓库
git remote add origin https://github.com/你的用户名/miniprogram-cdn.git

# 推送
git branch -M main
git push -u origin main

方法 B: 使用 GitHub Desktop

1. 打开 GitHub Desktop
2. File → Add Local Repository
3. 选择 cloud-data 目录
4. Commit 并 Push

方法 C: 网页上传（不推荐，文件太多）

1. 在 GitHub 仓库页面点击 "Add file" → "Upload files"
2. 拖拽整个 cloud-data 目录
3. 提交

步骤 3: 获取 CDN 链接

上传完成后，你的文件可以通过 jsDelivr CDN 访问：

格式：

https://cdn.jsdelivr.net/gh/你的用户名/miniprogram-cdn@main/文件路径

示例：

原路径: /images/mahjong/arena-bg.png
CDN 路径: https://cdn.jsdelivr.net/gh/你的用户名/miniprogram-cdn@main/images/mahjong/arena-bg.png

原路径: /images/avatars/avatar1.png
CDN 路径: https://cdn.jsdelivr.net/gh/你的用户名/miniprogram-cdn@main/images/avatars/avatar1.png

---

🔄 替代方案：微信云存储

如果你有微信云存储权限，可以上传到云存储：

步骤 1: 上传到云存储

1. 打开微信开发者工具
2. 云开发 → 云存储
3. 上传 images/ 和 data/ 文件夹

步骤 2: 获取文件 ID

每个文件会有一个 fileID：

cloud://你的环境ID.xxxx/images/mahjong/arena-bg.png

步骤 3: 配置权限

设置文件夹权限为"所有用户可读"

---

📝 使用说明

图片 CDN 链接

上传到 GitHub 后，在代码中使用 CDN 链接：

// 配置文件 config/cdn.js
const CDN_BASE = 'https://cdn.jsdelivr.net/gh/你的用户名/miniprogram-cdn@main'

module.exports = {
  images: {
    mahjong: {
      arenaBg: `${CDN_BASE}/images/mahjong/arena-bg.png`,
      startPage: `${CDN_BASE}/images/mahjong/start-page.png`,
      // ... 其他图片
    },
    avatars: {
      avatar1: `${CDN_BASE}/images/avatars/avatar1.png`,
      // ... 其他头像
    }
  }
}

数据文件

数据文件已经通过云函数 reading-data 提供，无需额外配置。

---

⚠️ 注意事项

GitHub + jsDelivr

优点：

• ✅ 完全免费
• ✅ 无需实名认证
• ✅ 全球 CDN 加速
• ✅ 无流量限制

限制：

• 单个文件 <100MB（你的最大文件 7.8MB，没问题）
• 仓库总大小 <1GB（你的总大小 100MB，没问题）

缓存：

• jsDelivr 有 CDN 缓存
• 更新文件后，可能需要 24 小时才能生效
• 可以使用版本号强制刷新：@main → @v1.0.0

微信云存储

优点：

• ✅ 更快（微信 CDN）
• ✅ 更新立即生效
• ✅ 更稳定

限制：

• 需要云存储权限
• 免费额度：10GB 流量/月

---

🎯 推荐方案

当前（无云存储权限）

使用 GitHub + jsDelivr：

1. 上传到 GitHub（15 分钟）
2. 使用 jsDelivr CDN 链接
3. 6 人测试完全够用（0 成本）

未来（有云存储权限）

切换到微信云存储：

1. 上传到云存储
2. 修改 CDN 配置
3. 更快更稳定

---

📈 优化效果

优化前

• 小程序包：111 MB（无法上传）
• 状态：无法发布

优化后

• 小程序包：~3 MB（符合规范）
• 图片：99.7 MB（在 CDN）
• 数据：446 KB（在云函数）
• 状态：可以发布 ✅

---

创建时间: 2026-01-28
维护者: Kiro AI Assistant