Add EasyEDA Pro 2.x legacy source ingestion (5/5 batch closure)
补齐前一批失败的 2 个 legacy Pro 项目(立创·泰山派 RK3566、立创·梁山派),
打通 Pro 2.x 旧版工程的源抓取链路。结合上一 commit 的 modern Pro 3.x
路径,本仓库 5/5 Pro 项目 EPRO2/dataStr 全部端到端打通。
Pro 2.x 与 Pro 3.x 是两个完全不同的存储模型:
- Pro 3.x:git-style branch + linear history chain,AES-128-GCM 加密的
EPRO2 增量消息流,按 history 重放(已在前一 commit 打通)
- Pro 2.x:无 branch / 无 history。文档以 EasyEDA Std plaintext dataStr
存储(同 ["DOCTYPE","SCH","1.1"] 格式),按 doc UUID 通过
/api/v2/documents/lists 批量 GET,主体无加密,只组件库走 AES
Pro 2.x 抓取链由 HAR (tmp/prodownload3.har, 178 请求) 反推:
GET /api/v4/projects/<P> → boards: [{sch, pcb, name}]
GET /api/projects/<P>/ticket?uuid=&g_ticket=-1
→ 完整项目 manifest
POST /api/schematic/lists {uuids:[<sch>]} → sort: [{uuid:<sheet>}]
POST /api/v2/documents/lists {uuids,docType:1} → schematic plaintext
POST /api/v2/documents/lists {uuids,docType:3} → PCB plaintext
POST /api/coppers/search {paths} → 铺铜层
POST /api/textpath/search {paths,project_uuid}→ 字体/文字
POST /api/v2/resources/search {hash,project_uuid} → BLOB 图片
实现:
- crawlers/oshwhub/crawler.py:
- fetch_pro_source() refactor 成 dispatcher,先 GET project meta
检查 branch_uuid,null 即旧版走 _fetch_pro_legacy(),非空走
_fetch_pro_modern()
- _fetch_pro_legacy() 新增(按上面 9 步流程拉所有 doc + 辅助层)
- _pro_post_json() POST helper(与 _pro_get_json 对称)
- schemas/project.schema.json: source_format enum 加 easyeda-pro-legacy
- docs/sources/easyeda_pro_source.md rev 4: §1.1 旧版 vs 新版判别表更新、
§2.7 新增旧版抓取流程 + 实测数据
落盘约定(旧版):
source/ticket.json 完整 manifest
source/<sheet_uuid>.json 每张原理图(含 dataStr)
source/pcb_<pcb_uuid>.json 每块 PCB
source/coppers.json/textpath.json/blobs.json 辅助 PCB 层资源
source/manifest.json 索引
实测:
立创·梁山派 editor=2.1.30, 2 sheets+1 pcb, 1.0 MB, 78 sym/191 fp/128 dev
立创·泰山派 RK3566 editor=2.1.40, 29 sheets+1 pcb, 0.8 MB, 299 sym/524 fp/295 dev
旧版项目体量比新版小两个数量级(梁山派 1 MB vs RK3576 66 MB)—— 没有
增量 history,组件库走单独端点,本身就是当前快照。
5/5 Pro 项目终极汇总:
X86 主板 easyeda-pro 3.2.15 7374 docs / 481 MB
泰山派 RK3566 easyeda-pro-legacy 2.1.40 30 docs / 0.8 MB
梁山派 easyeda-pro-legacy 2.1.30 3 docs / 1.0 MB
220V 桌面电源 easyeda-pro 3.2.69 771 docs / 26 MB
ESP-VoCat easyeda-pro 3.2.91 278 docs / 7.5 MB
共 8456 docs / ~516 MB plain。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
71
log.md
71
log.md
@@ -4,6 +4,77 @@
|
||||
|
||||
---
|
||||
|
||||
## 2026-04-28 22:00 Pro 2.x 旧版工程源抓取链路打通,5/5 Pro 项目全部 ✅
|
||||
|
||||
**Claude 会话**
|
||||
|
||||
承接刚做的 3/5 modern Pro 批量。用户录了第三份 HAR(`tmp/prodownload3.har` 103 MB / 178 请求,目标是登录态打开**梁山派** legacy Pro 2.x 项目),让我把 RK3566 / 梁山派两个旧版项目也补上。
|
||||
|
||||
### HAR 反推:Pro 2.x 用一套完全不同的端点
|
||||
|
||||
旧版(`editorVersion: 2.1.x`)没有 git-style branch + history 模型。HAR 里看到的关键端点:
|
||||
|
||||
| 端点 | 作用 |
|
||||
|---|---|
|
||||
| `GET /api/projects/<P>/ticket?uuid=<P>&g_ticket=-1` | 完整项目 manifest(schematics / schs / pcbs / coppers / textpath / blobs / symbols / footprints / devices / block_symbol) |
|
||||
| `POST /api/schematic/lists {uuids:[<sch>]}` | 父 schematic 容器,含 `sort: [{uuid: <sheet>, ticket}]` 即子图 UUIDs |
|
||||
| `POST /api/v2/documents/lists {uuids:[...], docType:1}` | 抓 schematic 子图(**plaintext** dataStr,跟 Std 一样的 `["DOCTYPE","SCH","1.1"]\n[HEAD,...]` 格式) |
|
||||
| `POST /api/v2/documents/lists {uuids:[...], docType:3}` | 抓 PCB(同样 plaintext dataStr) |
|
||||
| `POST /api/coppers/search {paths:[...]}` | 铺铜层数据(PCB 上独立分发的增量层) |
|
||||
| `POST /api/textpath/search {paths, project_uuid, path}` | 字体 / 文字路径(同上) |
|
||||
| `POST /api/v2/resources/search {hash, project_uuid}` | BLOB(嵌入图片) |
|
||||
| `POST /api/v2/components/searchByIds` / `/api/devices/searchByIds` | 元件库 metadata(其 `dataStrId` 仍走 modules.lceda.cn AES 加密 blob) |
|
||||
|
||||
**关键差异**:旧版的工程**主体 plaintext**(无加密 / 无 history 重放),只有元件库走 Pro 3.x 的 AES 方案。这反而比 3.x 简单很多。
|
||||
|
||||
**判别规则**:`/api/v4/projects/<P>` 返回的 `branch_uuid` 是不是 null。null 即旧版。
|
||||
|
||||
### 实现
|
||||
|
||||
`crawlers/oshwhub/crawler.py` refactor:
|
||||
- `fetch_pro_source()` 拆成 dispatcher(先 GET project meta → 检查 `branch_uuid`)
|
||||
- `_fetch_pro_modern()` —— 原 EPRO2 chain 流程,去掉重复的 project meta 调用
|
||||
- `_fetch_pro_legacy()` —— 新增,按上面 9 步流程拉所有 doc + 辅助层
|
||||
- `_pro_post_json()` —— POST helper(与 GET helper 对称)
|
||||
|
||||
落盘约定(旧版):
|
||||
- `source/ticket.json` —— 完整 manifest(保留备 lib 重建)
|
||||
- `source/<sheet_uuid>.json` —— 每张原理图
|
||||
- `source/pcb_<pcb_uuid>.json` —— 每块 PCB
|
||||
- `source/coppers.json` / `textpath.json` / `blobs.json` —— 辅助 PCB 层资源
|
||||
- `source/manifest.json` —— 索引 + structure_summary
|
||||
|
||||
schema:`source_format` enum 加 `easyeda-pro-legacy`。
|
||||
|
||||
### 实测:2/2 legacy 项目打通
|
||||
|
||||
| 项目 | editor | sheets | pcbs | sym | fp | dev | coppers | textpath | blobs | size |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| 立创·梁山派 | 2.1.30 | 2 | 1 | 78 | 191 | 128 | 29 | 3 | 1 | 1.0 MB |
|
||||
| 立创·泰山派 RK3566 | 2.1.40 | 29 | 1 | 299 | 524 | 295 | 0 | 0 | 32 | 0.8 MB |
|
||||
|
||||
**旧版项目比新版小两个数量级**(梁山派 1 MB vs RK3576 66 MB)—— 没有增量 history、组件库走单独端点、本身就是当前快照。
|
||||
|
||||
### 5/5 Pro 项目终极汇总
|
||||
|
||||
| # | 项目 | source_format | editor | docs | size |
|
||||
|---|---|---|---|---|---|
|
||||
| 1 | X86 主板 | easyeda-pro | 3.2.15 | 7374 | 481 MB |
|
||||
| 2 | 立创·泰山派 RK3566 | easyeda-pro-legacy | 2.1.40 | 30 | 0.8 MB |
|
||||
| 3 | 立创·梁山派 | easyeda-pro-legacy | 2.1.30 | 3 | 1.0 MB |
|
||||
| 4 | 220V 桌面电源 | easyeda-pro | 3.2.69 | 771 | 26 MB |
|
||||
| 5 | ESP-VoCat 喵伴 | easyeda-pro | 3.2.91 | 278 | 7.5 MB |
|
||||
|
||||
合计 8456 docs / ~516 MB plain 源数据,5/5 端到端打通。
|
||||
|
||||
### 下一步
|
||||
|
||||
1. EPRO2 → KiCad 转换器(仍是 Forge 投影硬门槛,ESP-VoCat 7.5 MB 是不错的小样本起手)
|
||||
2. 旧版 dataStr → KiCad 复用 Std 转换链(同格式,已有 `easyeda2kicad.py` 支持)
|
||||
3. 阶梯放量到 50 / 500 项目时做风控压测
|
||||
|
||||
---
|
||||
|
||||
## 2026-04-28 21:35 Pro 工程源(EPRO2)批量抓取打通:3/5 modern Pro 项目 ✅,2/5 legacy 2.x ❌
|
||||
|
||||
**Claude 会话**
|
||||
|
||||
Reference in New Issue
Block a user