play-any-game

Category: Tools & Productivity | Uploader: CGandGameEngineLearner | Downloads: 0 | Version: v1.0（Latest）

AI游戏伴侣助手 - 当你在游戏中遇到困难、卡关、不知道怎么操作时，AI可以帮你分析游戏画面、解答问题、甚至简单操作界面帮你解决问题。不是全自动代肝，而是你的游戏伙伴，在你需要的时候伸出援手。当用户提到"帮我看下这个怎么过"、"这个怎么操作"、"卡关了"、"不知道怎么弄"时使用此技能。支持原神、崩坏星穹铁道等各类游戏。

Changelog: Source: GitHub https://github.com/CGandGameEngineLearner/play-any-game

Directory Structure

Current level: tree/master/

📁 games/
- 📁 genshin-impact/
  - 📄 SKILL.md 2.3 KB
  - 📄 SOUL.md 3.6 KB
- 📁 honkai-starrail/
  - 📄 SKILL.md 2.4 KB
  - 📄 SOUL.md 3.5 KB
📁 references/
- 📄 game-patterns.md 2.4 KB
📁 screenshots/
- 📄 .gitkeep 79 B
📁 scripts/
- 📄 __init__.py 431 B
- 📄 click.py 10.5 KB
- 📄 keyboard.py 3.6 KB
- 📄 screenshot.py 6.0 KB
- 📄 window.py 2.3 KB
📁 templates/
- 📄 .gitkeep 0 B
📄 .gitignore 142 B
📄 AGENTS.md 6.9 KB
📄 CLAUDE.md 5.6 KB
📄 LICENSE 1.2 KB
📄 LICENSE.tmp 2.1 KB
📄 main.py 9.2 KB
📄 README.md 2.7 KB
📄 requirements.txt 28 B
📄 SKILL.md 6.8 KB

SKILL.md

---
name: play-any-game
description: AI游戏伴侣助手 - 当你在游戏中遇到困难、卡关、不知道怎么操作时，AI可以帮你分析游戏画面、解答问题、甚至简单操作界面帮你解决问题。不是全自动代肝，而是你的游戏伙伴，在你需要的时候伸出援手。当用户提到"帮我看下这个怎么过"、"这个怎么操作"、"卡关了"、"不知道怎么弄"时使用此技能。支持原神、崩坏星穹铁道等各类游戏。
---

# Play Any Game - AI游戏伴侣助手

## 项目定位

**不是游戏代肝助手，而是游戏伴侣助手。**

当你玩游戏时遇到困难：
- 🤔 不知道这个机关怎么解？
- 😵 卡在这个Boss打不过？
- 🤷 找不到NPC在哪？
- 😕 不知道这个界面怎么操作？

AI可以：
1. **截图分析** - 看到你的游戏画面，理解当前状态
2. **解答问题** - 告诉你该怎么解决
3. **简单操作** - 帮你点击界面、解决问题

## 核心设计理念

**每次操作都有截图，让 AI 能看到操作后的效果，然后继续下一步操作。**

```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│   AI 分析截图 ──→ 执行操作 ──→ 自动截图 ──→ 返回给 AI      │
│        ↑                                           │        │
│        └───────────────────────────────────────────┘        │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

## 支持的游戏

| 游戏 | AI 角色 | 窗口标题 |
|------|---------|----------|
| 原神 | 派蒙 | "原神" |
| 崩坏：星穹铁道 | 三月七 | "崩坏：星穹铁道" |

### 如何选择游戏

OpenClaw 使用此技能时，会根据用户当前玩的游戏自动加载对应的 SOUL.md：

```
用户说：帮我看下原神这个怎么过
→ OpenClaw 加载 games/genshin-impact/SOUL.md
→ AI 化身为派蒙，用派蒙的语气与用户交流
```

## 目录结构

```
.trae/skills/play-any-game/
├── scripts/               # Python 核心模块
│   ├── __init__.py        # 模块入口
│   ├── click.py           # 点击功能
│   ├── keyboard.py        # 键盘功能
│   ├── screenshot.py      # 截图功能
│   └── window.py          # 窗口管理
├── games/                 # 游戏定制目录（按游戏分类）
│   ├── genshin-impact/    # 原神
│   │   ├── SOUL.md        # 派蒙角色设定
│   │   ├── SKILL.md       # 原神子技能说明
│   │   ├── scripts/       # 原神专用脚本
│   │   └── assets/        # 图像资源
│   │       └── buttons/   # 按钮图片
│   └── honkai-starrail/   # 崩坏：星穹铁道
│       ├── SOUL.md        # 三月七角色设定
│       ├── SKILL.md       # 星铁子技能说明
│       ├── scripts/       # 星铁专用脚本
│       └── assets/        # 图像资源
│           └── buttons/   # 按钮图片
├── screenshots/           # 截图存储目录
├── main.py                # CLI 入口
├── requirements.txt       # Python 依赖
├── SKILL.md               # 本文件
├── AGENTS.md              # 项目规则
└── CLAUDE.md              # Claude 配置
```

## 环境要求

- Python 3.8+
- Windows 操作系统
- 依赖：pywin32, Pillow

### 安装依赖

```bash
cd .trae/skills/play-any-game
pip install -r requirements.txt
```

## CLI 命令

| 命令 | 说明 | 示例 |
|------|------|------|
| `screenshot [窗口]` | 截取屏幕 | `python main.py screenshot` |
| `capture <窗口>` | 截取指定窗口 | `python main.py capture "原神"` |
| `click <x> <y> [窗口]` | 点击坐标 | `python main.py click 540 820 "原神"` |
| `click <x> <y> [窗口] --background` | 后台点击 | `python main.py click 540 820 "原神" --background` |
| `key <按键> [窗口]` | 按键 | `python main.py key Space "原神"` |
| `hold <按键> <毫秒> [窗口]` | 按住按键 | `python main.py hold W 1000 "原神"` |
| `windows` | 列出所有窗口 | `python main.py windows` |

### 命令返回格式

所有命令返回标准 JSON 格式：

```json
{
  "action": "click",
  "x": 540,
  "y": 820,
  "windowTitle": "原神",
  "screenshotPath": "screenshots/screenshot_原神_20260405_162958_366.png",
  "timestamp": "2026-04-05T16:29:58.429622"
}
```

## 点击模式

1. **前台点击模式**（默认）
   - 使用 `mouse_event` API 模拟真实鼠标
   - 需要窗口在前台
   - 会移动真实鼠标光标

2. **后台点击模式**（`--background`）
   - 使用 `PostMessage` 发送窗口消息
   - 不抢夺鼠标，可在后台运行
   - 部分游戏可能拦截

## 典型工作流

### 帮玩家操作界面

```bash
# 1. 截图分析当前状态
python main.py capture "原神"
# AI 分析截图，发现需要点击某个按钮

# 2. 点击按钮
python main.py click 540 820 "原神"
# 返回点击后的截图，AI 确认操作成功

# 3. 如需继续操作，重复上述流程
```

### 帮玩家解决问题

```bash
# 1. 截图查看当前状态
python main.py capture "原神"

# 2. AI 分析截图，告诉玩家解决方案
# 例如：你的队伍配置需要调整，建议换上治疗角色

# 3. 如果需要，帮玩家简单操作
python main.py key Escape "原神"  # 打开菜单
```

## 添加新游戏支持

1. 在 `games/` 目录下创建游戏文件夹
2. 创建 `SOUL.md` - AI 角色设定
3. 创建 `SKILL.md` - 游戏子技能说明
4. 创建 `scripts/` 目录 - 游戏专用脚本
5. 创建 `assets/buttons/` 目录 - 按钮图片

### SOUL.md 模板

```markdown
# 角色名 - 游戏名助手

## 基本信息

- **名称**: 角色名
- **身份**: 角色身份
- **性格**: 角色性格
- **口头禅**: "口头禅"

## 核心能力

- 游戏画面实时分析
- 游戏知识问答
- 自动化操作
```

## 注意事项

- **游戏窗口可见**：AI 需要游戏窗口在可见状态才能分析画面
- **辅助性质**：AI 只是辅助玩家解决问题，不是全自动挂机
- **策略判断**：需要真正策略判断的高难度内容仍需玩家自己操作

## 参考资料

- [AGENTS.md](AGENTS.md) - 项目规则
- [games/genshin-impact/SOUL.md](games/genshin-impact/SOUL.md) - 派蒙角色设定
- [games/honkai-starrail/SOUL.md](games/honkai-starrail/SOUL.md) - 三月七角色设定
- [BetterGI](https://github.com/babalae/better-genshin-impact) - 点击实现参考

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

play-any-game

Directory Structure

SKILL.md

Report

Notice