# smartbot

**Repository Path**: xnyld/smartbot

## Basic Information

- **Project Name**: smartbot
- **Description**: 日常开发,万物开源嘛
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 34
- **Forks**: 10
- **Created**: 2022-07-05
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



Based on the code map provided, I can see this is a SmartBot project for Hearthstone. Let me create a comprehensive README.md for this repository:

```markdown
# SmartBot - Hearthstone 智能机器人

SmartBot 是一个功能强大的炉石传说智能游戏机器人，支持多种游戏模式，包括竞技场、战棋、佣兵和对决模式。本项目提供完整的插件系统、API 接口和工具链，支持开发者扩展和定制功能。

## 项目特点

### 多模式支持
- **竞技场 (Arena)** - 智能选牌和竞技场策略
- **战棋 (Battlegrounds)** - 自动战棋游戏决策
- **佣兵模式 (Mercenaries)** - 佣兵挑战自动化
- **对决模式 (Duels)** - 对决模式策略支持

### 插件系统
- 完整的插件 API 接口
- 支持自定义扩展 (Plugin)
- GUI 元素自定义 (Button, Text, Bitmap)
- 数据持久化支持 (PluginDataContainer)

### 核心功能模块
- 数据库管理 (CardTemplate)
- 卡组分析 (Deck)
- 统计分析 (Statistics)
- 录像录制 (Recorder)
- 远程配置 (RemoteProfile)
- 套件分类 (Archetype)

## 工具与文档

### 文档生成工具
- `tools/generate_sbapi_doc.py` - 从 XML 生成 API 文档
- `tools/generate_sbapi_from_html.py` - 从 HTML 生成 API 文档
- `tools/scrape_smartbot_api.py` - 抓取在线 API 文档

### API 文档
- `docs/sbapi_api_flat.md` - 扁平化 API 文档
- `docs/smartbot_api.md` - 完整 API 文档

## 项目结构

```
SmartBot/
├── .gitignore          # Git 忽略配置
├── LICENSE             # 许可证文件
├── log.md              # 更新日志
├── sb-v74.1.zip        # SmartBot 主程序
├── docs/               # API 文档
│   ├── sbapi_api_flat.md
│   └── smartbot_api.md
└── tools/              # 工具脚本
    ├── generate_sbapi_doc.py
    ├── generate_sbapi_from_html.py
    └── scrape_smartbot_api.py
```

## 主要命名空间

### 核心 API (SmartBot.Plugins.API)
- **Board** - 游戏版面信息
- **Bot** - 机器人控制
- **Card/Cards** - 卡牌信息
- **Deck** - 卡组管理
- **GUI** - 界面元素
- **Actions** - 游戏动作
  - AttackAction - 攻击动作
  - ChoiceAction - 选择动作
  - EndTurnAction - 结束回合
  - TargetAction - 目标选择
  - TradeAction - 交易动作

### 战棋 API (SmartBotAPI.Battlegrounds)
- **SBBGBoard** - 战棋版面
- **SBBGCard** - 战棋卡牌
- **Actions** - 战棋动作
  - BuyMinion - 购买随从
  - SellMinion - 出售随从
  - TavernUp - 升级酒馆
  - PlayMinion - 打出随从

### 统计与分析 (SmartBotAPI.Stats)
- 套件统计 (ArchetypeStatEntry)
- 竞技场统计 (ArenaStatEntry)
- 传说排名 (LegendEntry)

## 系统要求

- .NET Framework 环境
- Windows 操作系统
- 炉石传说客户端

## 许可证

本项目采用 [LICENSE](LICENSE) 文件中指定的许可证。

## 更新日志

详细的更新记录请查看 [log.md](log.md)。

## 贡献指南

欢迎开发者贡献代码，请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支
3. 提交您的更改
4. 推送到分支
5. 创建 Pull Request

## 联系方式

- 项目地址: https://gitee.com/xnyld/smartbot
- 问题反馈: 请在 Gitee 仓库提交 Issue

## 鸣谢

感谢所有为 SmartBot 项目贡献代码和文档的开发者！
```

这份 README 包含了项目的核心功能、结构特点，并提供了清晰的使用指南。如果您需要我调整内容或添加更多细节，请告诉我。