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:
2026-04-28 21:59:25 +08:00
parent 3282a028c4
commit c6279bff08
48 changed files with 2603 additions and 22 deletions

View File

@@ -0,0 +1 @@
{"uuid":"afd056d94ae848c3a866181a4890394b","created_at":"2023-12-01 14:36:51","creator":{"uuid":"c644bf6717124cfe9ae4d22a5ba8d83a","username":"eda_nqhjnjnc","nickname":"15211163466_27"},"dataStr":"[\"DOCTYPE\",\"SCH\",\"1.1\"]\n[\"HEAD\",{\"originX\":0,\"originY\":0,\"version\":\"2.1.39.1e0cbcef\",\"maxId\":120}]\n[\"OBJ\",\"e101\",\"\",10,815,1145,910,0,0,\"blob:1861f0a4e64308e961db12c44385b49127695b46990bb78fa3a92777bfb7c586\",0]\n[\"OBJ\",\"e103\",\"\",10,-90,1149,1535,0,0,\"blob:ffa3c8eb63af65aead1f39bc3470ac4d6c6a5f2fe98dab8d5c3d6e8f66bcbebb\",0]\n[\"OBJ\",\"e105\",\"\",0,-1615,1166,1260,0,0,\"blob:8c90c73fd15a0ce1a09833789aef43d8da4b19aad7f2581e08715f376c80144d\",0]\n[\"OBJ\",\"e107\",\"\",0,-2865,1165,1086,0,0,\"blob:e2d87a4da09ce1ae2d0aead4b6d02d35055efe3a3b7b3fd58d183e53f7922f0e\",0]\n[\"OBJ\",\"e109\",\"\",-5,-3955,1180,840,0,0,\"blob:5cefe8f5df05e95c4f27abb3533795fdd7873411da26b55df51fe84c82aafda0\",0]\n[\"OBJ\",\"e111\",\"\",-30,-4795,1233,985,0,0,\"blob:569bc7e255d26d0b3256827c1f3677592a40738c58b3b3eb5dfbd3da25ee532a\",0]\n[\"OBJ\",\"e113\",\"\",-50,-5780,1255,1251,0,0,\"blob:e02393b31dc68a460c99d067097b833b670d0f6bf1b5062f50b9bbcad53a32b2\",0]\n[\"OBJ\",\"e117\",\"\",-55,-7570,1262,1160,0,0,\"blob:f9775497ecf23a7689451136ff45f366ba1f9ddb862ba708460250f2231cca4d\",0]\n[\"OBJ\",\"e119\",\"\",-55,-7030,1270,551,0,0,\"blob:9016468c5a069f8459a3c9404bc96df7c4bf898aa483132fc157360ee24062cd\",0]","description":"","display_title":"立创·泰山派简介","docType":1,"modifier":{"uuid":"c644bf6717124cfe9ae4d22a5ba8d83a","username":"eda_nqhjnjnc","nickname":"15211163466_27"},"project_uuid":"7360e73de5dd428e9f29e10573f2d8ac","schematic_uuid":"6394f41146404ead95ba248444940c6c","sheet_id":34,"ticket":3,"title":"立创·泰山派简介","updateTime":1701413723,"thumb":"https://image-pro.lceda.cn/pullimages/efc9af7c5482497889504c012db477cf.webp","guest":false,"writable":false}