# dygame

**Repository Path**: freechful/dygame

## Basic Information

- **Project Name**: dygame
- **Description**: 抖音小游戏开发skill，cli一键安装
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dygame-cli — 抖音小游戏开发 AI Skill 安装器

[![npm version](https://img.shields.io/npm/v/dygame-cli.svg)](https://www.npmjs.com/package/dygame-cli)
[![license](https://img.shields.io/npm/l/dygame-cli.svg)](https://gitee.com/freechful/dygame/blob/master/LICENSE)

CLI 工具，一键安装**抖音（TikTok 中国）小游戏开发技能**到 AI 编程助手（Claude Code、Cursor、Codex、Windsurf 等 14 种）。

安装后，AI 助手将自动获得抖音小游戏平台的完整开发知识：登录授权、排行榜、激励广告、支付结算、合规审核、tt.* API 等。

---

## 快速上手

```bash
# 全局安装
npm install -g dygame-cli

# 在项目目录下运行
dygame init --ai claude

# 或使用 npx（无需全局安装）
npx dygame-cli init --ai claude

# 交互式选择 AI 助手（自动检测当前项目已有配置）
dygame init

# 安装到所有 AI 助手
dygame init --ai all
```

## 支持的 AI 助手

| AI 助手 | 安装路径 | 命令 |
|---------|----------|------|
| Claude Code | `.claude/skills/douyin-minigame/` | `dygame init --ai claude` |
| Cursor | `.cursor/skills/douyin-minigame/` | `dygame init --ai cursor` |
| Windsurf | `.windsurf/skills/douyin-minigame/` | `dygame init --ai windsurf` |
| Codex | `.codex/skills/douyin-minigame/` | `dygame init --ai codex` |
| RooCode | `.roo/skills/douyin-minigame/` | `dygame init --ai roocode` |
| Kiro | `.kiro/steering/douyin-minigame/` | `dygame init --ai kiro` |
| GitHub Copilot | `.github/prompts/douyin-minigame/` | `dygame init --ai copilot` |
| Antigravity | `.agent/skills/douyin-minigame/` | `dygame init --ai antigravity` |
| Gemini CLI | `.gemini/skills/douyin-minigame/` | `dygame init --ai gemini` |
| Trae | `.trae/skills/douyin-minigame/` | `dygame init --ai trae` |
| OpenCode | `.opencode/skills/douyin-minigame/` | `dygame init --ai opencode` |
| Continue | `.continue/skills/douyin-minigame/` | `dygame init --ai continue` |
| CodeBuddy | `.codebuddy/skills/douyin-minigame/` | `dygame init --ai codebuddy` |
| Qoder | `.qoder/skills/douyin-minigame/` | `dygame init --ai qoder` |

## 功能覆盖

| 模块 | 能力 |
|------|------|
| **登录授权** | tt.login → code2Session 完整流程、匿名登录降级 |
| **排行榜** | 好友/世界排行、日/周/月周期、内置 UI 和自定义 UI |
| **激励广告** | 激励视频、Banner、插屏广告集成与降级 |
| **支付结算** | 游戏币购买、道具直购、服务端回调验签、结算规则 |
| **数据分析** | tt.reportAnalytics 事件埋点 |
| **服务端** | getAccessToken、签名算法、SDK 集成 |
| **反作弊** | 服务端验证、内容安全 API |
| **合规审核** | 自审标准 P0/P1/P2、ICP 备案、广告合规 |

## 触发关键词

安装完成后，在 AI 助手中输入以下关键词即可激活技能：

**中文：** 抖音小游戏、小游戏开发、小游戏登录、小游戏排行榜、小游戏激励广告、小游戏支付、小游戏合规

**English：** douyin mini-game, ByteDance mini-game, TikTok mini-game, mini-game login, mini-game leaderboard, mini-game payment

## 安装后的目录结构

以 Claude Code 为例：

```
.claude/skills/douyin-minigame/
├── SKILL.md                        # 主技能文件
├── references/                     # 详细参考文档（按需加载）
│   ├── api-reference.md            # tt.* 完整 API 参考
│   ├── features.md                 # 9 大功能模块详解
│   ├── payment.md                  # 支付结算接入指南
│   ├── compliance.md               # 合规政策与审核规则
│   ├── architecture.md             # 平台分层架构
│   ├── runtime.md                  # 运行时引擎详解
│   ├── cli-reference.md            # dygame CLI 参考
│   ├── templates.md                # 模板系统详解
│   └── sources.md                  # 官方文档 URL 索引
├── examples/                       # 示例代码
│   ├── login-basic.ts              # 登录集成
│   ├── rank-monthly-top3.ts        # 排行榜
│   ├── incentive-revive.ts         # 激励广告复活
│   ├── payment-gamecoins.ts        # 游戏币支付
│   └── project-scaffold/           # 项目脚手架
└── scripts/                        # 实用脚本
    ├── validate-project.sh         # 项目结构校验
    └── check-compliance.sh         # 合规快速检查
```

## CLI 命令参考

```bash
dygame --help               # 查看帮助
dygame --version             # 查看版本
dygame init --help           # 查看 init 命令帮助
dygame init                  # 交互式选择 AI 助手
dygame init --ai claude      # 安装到指定 AI 助手
dygame init --ai all         # 安装到所有 AI 助手
dygame init --ai claude -f   # 强制覆盖已有文件
```

## 开发

```bash
# 克隆仓库
git clone https://gitee.com/freechful/dygame.git
cd dygame

# 安装依赖
npm install

# 构建
npm run build

# 本地测试
node dist/index.js init --ai claude
```

### 项目结构

```
├── src/                    # TypeScript 源码
│   ├── index.ts            # CLI 入口
│   ├── commands/init.ts    # init 命令
│   ├── types/index.ts      # 类型定义
│   └── utils/              # 工具函数
├── assets/                 # Skill 数据（随 npm 包发布）
│   ├── SKILL.md
│   ├── references/
│   ├── examples/
│   └── scripts/
├── dist/                   # 编译输出（gitignore）
├── build.mjs               # esbuild 构建脚本
├── package.json
└── tsconfig.json
```

## 许可证

[MIT](LICENSE)