Add EasyEDA Pro EPRO2 source ingestion (3/5 batch test)

打通 oshwhub origin=pro 现代 Pro 3.x 工程的 EPRO2 源抓取链路。3/5
modern Pro 项目完整解出(共 8423 docs / 542 MB plain):

- X86 主板        7374 docs / 481 MB plain (chain=85, editor=3.2.15)
- 220V 桌面电源     771 docs /  26 MB plain (chain=28, editor=3.2.69)
- ESP-VoCat       278 docs / 7.5 MB plain (chain=12, editor=3.2.91)

剩余 2/5 是 legacy Pro 2.x(立创泰山派 RK3566、梁山派),项目 meta
返回 branch_uuid=null + editorVersion="2.1.40",没有 git-style chain
模型,文档直接挂在 boards[].sch/pcb 字段上,访问端点暂未挖通;元
数据落库 metadata.json,source/ 留空。

实现要点:
- fetch_pro_source(): 4 步流程(project → branch HEAD → structures
  → /branches/<B>/histories/<HEAD> 即返完整 chain,无需 ?limit 批量
  端点)+ 逐 history 走 AES-128-GCM 解密(16 字节 IV,pycryptodome
  原生支持)+ gunzip + 按 DOCHEAD 切 per-doc EPRO2 流
- EPRO2 解析坑:行末单 `|` 是行终止符不是字段分隔符,必须先
  rstrip("|") 再 split("||"),否则 payload JSON 解析失败 silently
  swallow 导致 cur_doc 不设 → 第一轮 X86 板 7374 docs 抽出来只剩 2 个
- docType 实测远不止 BOARD/PCB/SCH/SCH_PAGE,还含 SYMBOL /
  FOOTPRINT / DEVICE / BLOB / FONT / CONFIG —— Pro 把组件库快照也
  随项目存到 history,下游做 EPRO2→KiCad 转换时必须先把这些 lib
  doc 加载进 symbol cache
- Pro 2.x vs 3.x 是不同存储模型 —— 3.x 走 branch 模型(已打通),
  2.x 走 boards[] 直链(未打通);判别条件:project meta 的
  branch_uuid 是否为 null

CLI 新增 --with-pro-source / --backfill-pro-source / --pro-cookie /
--origin(按 origin 字段服务端过滤 listing API),crawl_one() 按
origin=pro 自动 dispatch 到 Pro fetcher。

schema:docType 类型从 integer 放宽到 [integer, string, null]
(兼容 Std 的 1/3 + Pro 的 BOARD/SCH 等),新增 message_count 字段。

License 注意:本批 5 个项目全是 NC-SA / GPL,未达 Pro source doc
§4.2 Forge 白名单(MIT/BSD/Apache/CC0/CC-BY/CERN-OHL-P/Unlicense)。
按 CLAUDE.md "研究用、不再分发" 原则 raw 入库无碍;Forge 投影时
另过白名单。

详细技术细节见 docs/sources/easyeda_pro_source.md rev 3 + log.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-28 21:45:52 +08:00
parent d874278bc5
commit 3282a028c4
8455 changed files with 2275248 additions and 36 deletions

View File

@@ -0,0 +1,120 @@
{
"boards": {
"2f348e157b79d75e": {
"uuid": "2f348e157b79d75e",
"title": "300W四路彩屏桌面电源彩屏版",
"zIndex": 4
},
"55d329066a371871": {
"uuid": "55d329066a371871",
"title": "300W桌面电源显示板",
"zIndex": 5
},
"874dac59be3e8678": {
"uuid": "874dac59be3e8678",
"title": "165W三路桌面电源指示灯版",
"zIndex": 1
}
},
"schematics": {
"e050b183592d4acf9a83ebf63cc19dfc": {
"uuid": "e050b183592d4acf9a83ebf63cc19dfc",
"name": "165W指示灯版三路桌面电源",
"board": "874dac59be3e8678",
"source": "",
"version": "1745376239000",
"updateTime": 1768983858069
},
"be3b22fd1cb9e850": {
"uuid": "be3b22fd1cb9e850",
"name": "300W 四路多协议快充电源",
"board": "2f348e157b79d75e",
"source": "",
"version": "1768983748681",
"updateTime": 1768983748681
},
"f64af4ff565cbec3": {
"uuid": "f64af4ff565cbec3",
"name": "显示板",
"board": "55d329066a371871",
"source": "",
"version": "1768982996462",
"updateTime": 1768982996462
}
},
"sheets": {
"0368f464e25a4ac4aaf0ef114f1aa430": {
"uuid": "0368f464e25a4ac4aaf0ef114f1aa430",
"title": "P1",
"schematic_uuid": "e050b183592d4acf9a83ebf63cc19dfc",
"zIndex": 1,
"version": "1745376239000",
"updateTime": 1768983858069
},
"6388787db16cbd0f": {
"uuid": "6388787db16cbd0f",
"title": "1A1C",
"schematic_uuid": "be3b22fd1cb9e850",
"zIndex": 1,
"source": "",
"version": "1751091643000",
"updateTime": 1768983640047
},
"dd611e8ed344091d": {
"uuid": "dd611e8ed344091d",
"title": "2C",
"schematic_uuid": "be3b22fd1cb9e850",
"zIndex": 2,
"source": "",
"version": "1751086661000",
"updateTime": 1768983640047
},
"b0a9e3a9926d239d": {
"uuid": "b0a9e3a9926d239d",
"title": "P1",
"schematic_uuid": "f64af4ff565cbec3",
"zIndex": 1,
"source": "",
"version": "1747649122000",
"updateTime": 1768982922526
}
},
"pcbs": {
"4021b9e545806a0a": {
"uuid": "4021b9e545806a0a",
"title": "PCB_嘉立创8838*150mm铝机壳PCB尺寸15*8.4cm",
"board": "2f348e157b79d75e",
"parent_uuid": "",
"source": "",
"version": "1768983998121",
"updateTime": 1768983998121
},
"b697a83180b38e62": {
"uuid": "b697a83180b38e62",
"title": "300W桌面电源显示板",
"board": "55d329066a371871",
"parent_uuid": "",
"source": "",
"version": "1768982865750",
"updateTime": 1768982865750
},
"f20ca1eb3b7448c5a396baf4e0bad941": {
"uuid": "f20ca1eb3b7448c5a396baf4e0bad941",
"title": "PCB_嘉立创8838*130mm铝机壳PCB尺寸13*8.4cm",
"board": "874dac59be3e8678",
"parent_uuid": "",
"source": "",
"version": "1768981269674",
"updateTime": 1768981269674
}
},
"panels": {},
"blockSymbols": {},
"owner": {
"uuid": "f6d958b048194965970a097419f0f68a",
"username": "cqlcp",
"nickname": "重庆枫叶",
"avatar": "//image.lceda.cn/avatars/2026/1/FneZQD4JKfDDm92UUIa483axw2OD9PF1E07L9Aby.webp",
"team": false
}
}