# qipu

**Repository Path**: wangbygitee/qipu

## Basic Information

- **Project Name**: qipu
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-26
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 棋谱仓库说明

## 仓库地址

https://gitee.com/wangbygitee/qipu

## 目录结构

| 目录 | 说明 | 文件数 | 大小 |
|------|------|--------|------|
| `qipaile/` | qipaile.net 棋谱集（原始XQF格式） | 15,512 | 76MB |
| `xqq/` | 象棋桥CCBridge3 CBL转XQF棋谱集 | 65,246 | 295MB |

### qipaile 目录

来源：qipaile.net，包含以下分类：
- 对局与全局
- 布局研究（含中阳HTM文件）
- 中局研究
- 残局研究
- 著名棋谱

### xqq 目录

来源：象棋桥 CCBridge3 的 CBL 格式棋谱，经 XQStudio 的 CblConverter 批量转换为 XQF 格式。保留了原始 CBL 的目录结构，包括：
- 杯赛风云
- 大师棋路
- 古谱棋书
- 棋研探秘
- 象棋丛书
- 等等

转换统计：957个CBL文件，66,713局棋谱，成功导出65,246局，1,467局因格式问题转换失败。

## 上传操作说明

### 首次上传

```bash
# 1. 克隆远程仓库
git clone https://gitee.com/wangbygitee/qipu.git
cd qipu

# 2. 复制文件到仓库目录
cp -r /path/to/qipaile ./qipaile
cp -r /path/to/xqq ./xqq

# 3. 添加、提交、推送
git add .
git commit -m "添加棋谱文件"
git push origin master
```

### 后续增量上传

```bash
cd /path/to/qipu

# 1. 添加新文件
git add <新目录或文件>

# 2. 提交
git commit -m "添加XXX棋谱集"

# 3. 推送
git push origin master
```

### 大批量文件上传注意事项

- 单次提交数千文件时，`git add` 和 `git commit` 可能较慢，属于正常现象
- Gitee 单仓库建议不超过 1GB，当前仓库约 370MB
- 如需上传超大文件（>100MB），需使用 Git LFS

## CBL 批量转 XQF 说明

使用 XQStudio 项目中的 `CblBatchExport` 工具：

```bash
# 构建
dotnet build CblBatchExport/CblBatchExport.csproj

# 运行（源目录为CBL所在目录，目标目录为XQF输出目录）
dotnet run --project CblBatchExport/CblBatchExport.csproj -- <CBL源目录> <XQF目标目录>
```

工具会递归扫描源目录下所有 `.cbl` 文件，保持原有目录结构输出 XQF 文件。