feat: codemao-cli v1.0.0

- 62 个 API 端点 (13 个域名)
- BCM 文件格式解析
- 示例作品下载
- 模板下载
- 端点搜索
- MIT 开源

README.md

@@ -0,0 +1,160 @@
+# Codemao CLI
+
+编程猫 (Codemao) 社区命令行工具。无需登录即可访问公开 API，解析 BCM 作品文件。
+
+## 安装
+
+```bash
+npm install -g codemao-cli
+```
+
+或直接运行:
+
+```bash
+npx codemao-cli help
+```
+
+## 功能
+
+| 命令 | 说明 |
+|------|------|
+| `codemao sample list` | 列出 14 个官方示例作品 |
+| `codemao sample download <id>` | 下载示例 BCM 文件 |
+| `codemao bcm info <file>` | 解析 BCM 文件摘要 |
+| `codemao bcm actors <file>` | 列出所有角色 |
+| `codemao bcm blocks <file>` | 列出所有积木 |
+| `codemao bcm extract <file>` | 提取资源 URL |
+| `codemao work list` | 列出用户作品 (需登录) |
+| `codemao download <template>` | 下载 BCM 模板 |
+| `codemao endpoints [filter]` | 搜索 62 个 API 端点 |
+| `codemao domains` | 显示 13 个域名 |
+| `codemao api <path>` | 直接调用 API |
+
+## 快速开始
+
+```bash
+# 列出示例作品
+codemao sample list
+
+# 下载 "脸萌" 示例
+codemao sample download 2
+
+# 查看作品结构
+codemao bcm info 脸萌.bcmkn
+
+# 提取所有图片/音频 URL
+codemao bcm extract 脸萌.bcmkn
+
+# 下载默认模板
+codemao download default-v
+```
+
+## BCM 文件格式
+
+BCM (Block Code Metadata) 是编程猫的积木作品文件格式，纯 JSON 结构:
+
+```json
+{
+  "projectName": "我的作品",
+  "version": "0.18.0",
+  "toolType": "KN",
+  "stageSize": { "width": 562, "height": 900 },
+  "scenes": {
+    "scenesDict": { "scene-uuid": { "name": "背景", "actorIds": [...] } }
+  },
+  "actors": {
+    "actorsDict": { "actor-uuid": { "name": "角色", "nekoBlockJsonList": [...] } }
+  },
+  "styles": {
+    "stylesDict": { "style-uuid": { "name": "造型", "url": "https://..." } }
+  },
+  "audios": { "audiosDict": {} },
+  "variables": { "variablesDict": {} },
+  "broadcasts": { "broadcastsDict": {} },
+  "procedures": { "proceduresDict": {} }
+}
+```
+
+### 积木结构
+
+```json
+{
+  "type": "sprite_on_tap",
+  "id": "block-uuid",
+  "fields": { "type": "mouse_click", "sprite": "actor-uuid" },
+  "parent_id": "",
+  "next": { "type": "self_prev_next_style", "id": "..." }
+}
+```
+
+### 已知积木类型
+
+| 类型 | 说明 |
+|------|------|
+| `sprite_on_tap` | 角色点击事件 |
+| `event_when_run` | 绿旗点击 |
+| `event_when_key` | 按键事件 |
+| `move` | 移动 |
+| `turn_right` / `turn_left` | 转向 |
+| `goto_xy` | 移到坐标 |
+| `show` / `hide` | 显示/隐藏 |
+| `say` | 说话 |
+| `wait` | 等待 |
+| `repeat` | 重复 |
+| `forever` | 重复执行 |
+| `if` / `if_else` | 条件判断 |
+| `self_prev_next_style` | 切换造型 |
+
+## API 端点
+
+完整端点列表 (62 个):
+
+```bash
+codemao endpoints          # 全部
+codemao endpoints ranking  # 搜索
+codemao search 作品         # 搜索
+```
+
+### 公开端点 (无需登录)
+
+| 端点 | 说明 |
+|------|------|
+| `GET /neko/sample/list` | 示例作品列表 |
+| `GET /neko/sample/detail` | 示例作品详情 |
+| `GET /coconut/clouddb/currentTime` | 云数据库时间 |
+| `GET /tiger/online/check` | 在线检查 |
+
+### 需认证端点
+
+设置环境变量:
+
+```bash
+export CODEMAO_COOKIE="your_cookie_value"
+```
+
+从浏览器开发者工具获取 Cookie。
+
+## 域名
+
+| 名称 | 域名 | 用途 |
+|------|------|------|
+| creation | api-creation.codemao.cn | 创作服务 |
+| api | api.codemao.cn | 主 API |
+| open | open-service.codemao.cn | 开放服务 |
+| ai | cr-aichat.codemao.cn | AI 服务 |
+| cdn | creation.codemao.cn | CDN 资源 |
+| staticCdn | static.codemao.cn | 静态资源 |
+| bcmcdn | creation.bcmcdn.com | BCM CDN |
+
+## 开发
+
+```bash
+git clone https://github.com/user/codemao-cli
+cd codemao-cli
+npm install
+npm test
+```
+
+## License
+
+MIT