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,50 @@
{"type":"DOCHEAD","ticket":9349}||{"docType":"FOOTPRINT","client":"d65f147c8efe27cb","uuid":"2eac74f3cf9a8fb1","updateTime":1759497311371,"version":"1666959764"}|
{"type":"META","ticket":9350,"id":"META"}||{"title":"MIC-TH_BD4.0-P1.40-D0.4-L-FD","description":"","tags":[],"source":"383418ea5f18443f86758c26d5167969|0819f05c4eef4c71ace90d822a990e87"}|
{"type":"DOCHEAD"}||{"docType":"FOOTPRINT","client":"b22e94147ef00870","uuid":"2eac74f3cf9a8fb1","updateTime":1759497306101,"version":"1666959764"}|
{"type":"LAYER","ticket":1,"id":"[\"LAYER\",1]"}||{"layerType":"TOP","layerName":"Top Layer","use":true,"show":true,"locked":false,"activeColor":"#FF0000","activateTransparency":1,"inactiveColor":"#7F0000","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":2,"id":"[\"LAYER\",2]"}||{"layerType":"BOTTOM","layerName":"Bottom Layer","use":true,"show":true,"locked":false,"activeColor":"#0000FF","activateTransparency":1,"inactiveColor":"#00007F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":3,"id":"[\"LAYER\",3]"}||{"layerType":"TOP_SILK","layerName":"Top Silkscreen Layer","use":true,"show":true,"locked":false,"activeColor":"#FFCC00","activateTransparency":1,"inactiveColor":"#7F6600","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":4,"id":"[\"LAYER\",4]"}||{"layerType":"BOT_SILK","layerName":"Bottom Silkscreen Layer","use":true,"show":true,"locked":false,"activeColor":"#66CC33","activateTransparency":1,"inactiveColor":"#336619","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":5,"id":"[\"LAYER\",7]"}||{"layerType":"TOP_PASTE_MASK","layerName":"Top Paste Mask Layer","use":true,"show":true,"locked":false,"activeColor":"#808080","activateTransparency":1,"inactiveColor":"#404040","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":6,"id":"[\"LAYER\",8]"}||{"layerType":"BOT_PASTE_MASK","layerName":"Bottom Paste Mask Layer","use":true,"show":true,"locked":false,"activeColor":"#800000","activateTransparency":1,"inactiveColor":"#400000","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":7,"id":"[\"LAYER\",5]"}||{"layerType":"TOP_SOLDER_MASK","layerName":"Top Solder Mask Layer","use":true,"show":true,"locked":false,"activeColor":"#800080","activateTransparency":1,"inactiveColor":"#400040","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":8,"id":"[\"LAYER\",6]"}||{"layerType":"BOT_SOLDER_MASK","layerName":"Bottom Solder Mask Layer","use":true,"show":true,"locked":false,"activeColor":"#AA00FF","activateTransparency":1,"inactiveColor":"#55007F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":9,"id":"[\"LAYER\",13]"}||{"layerType":"DOCUMENT","layerName":"Document Layer","use":true,"show":true,"locked":false,"activeColor":"#FFFFFF","activateTransparency":1,"inactiveColor":"#7F7F7F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":10,"id":"[\"LAYER\",11]"}||{"layerType":"OUTLINE","layerName":"Board Outline Layer","use":true,"show":true,"locked":false,"activeColor":"#FF00FF","activateTransparency":1,"inactiveColor":"#7F007F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":11,"id":"[\"LAYER\",12]"}||{"layerType":"MULTI","layerName":"Multi-Layer","use":true,"show":true,"locked":false,"activeColor":"#C0C0C0","activateTransparency":1,"inactiveColor":"#606060","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":12,"id":"[\"LAYER\",9]"}||{"layerType":"TOP_ASSEMBLY","layerName":"Top Assembly Layer","use":true,"show":true,"locked":false,"activeColor":"#33CC99","activateTransparency":1,"inactiveColor":"#19664C","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":13,"id":"[\"LAYER\",10]"}||{"layerType":"BOT_ASSEMBLY","layerName":"Bottom Assembly Layer","use":true,"show":true,"locked":false,"activeColor":"#5555FF","activateTransparency":1,"inactiveColor":"#2A2A7F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":14,"id":"[\"LAYER\",14]"}||{"layerType":"MECHANICAL","layerName":"Mechanical Layer","use":true,"show":true,"locked":false,"activeColor":"#F022F0","activateTransparency":1,"inactiveColor":"#781178","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":15,"id":"[\"LAYER\",52]"}||{"layerType":"COMPONENT_MODEL","layerName":"Component Model Layer","use":true,"show":true,"locked":false,"activeColor":"#FFFFFF","activateTransparency":1,"inactiveColor":"#7F7F7F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":16,"id":"[\"LAYER\",48]"}||{"layerType":"COMPONENT_SHAPE","layerName":"Component Shape Layer","use":true,"show":true,"locked":false,"activeColor":"#00CCCC","activateTransparency":1,"inactiveColor":"#006666","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":17,"id":"[\"LAYER\",51]"}||{"layerType":"PIN_FLOATING","layerName":"Pin Floating Layer","use":true,"show":true,"locked":false,"activeColor":"#FF99FF","activateTransparency":1,"inactiveColor":"#7F4C7F","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":18,"id":"[\"LAYER\",49]"}||{"layerType":"COMPONENT_MARKING","layerName":"Component Marking Layer","use":true,"show":true,"locked":false,"activeColor":"#66FFCC","activateTransparency":1,"inactiveColor":"#337F66","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":19,"id":"[\"LAYER\",47]"}||{"layerType":"HOLE","layerName":"Hole Layer","use":true,"show":true,"locked":false,"activeColor":"#222222","activateTransparency":1,"inactiveColor":"#111111","inactiveTransparency":0.5}|
{"type":"LAYER","ticket":20,"id":"[\"LAYER\",50]"}||{"layerType":"PIN_SOLDERING","layerName":"Pin Soldering Layer","use":true,"show":true,"locked":false,"activeColor":"#CC9999","activateTransparency":1,"inactiveColor":"#664C4C","inactiveTransparency":0.5}|
{"type":"ACTIVE_LAYER","ticket":21,"id":"ACTIVE_LAYER"}||{"layerId":51}|
{"type":"ACTIVE_LAYER","ticket":22,"id":"ACTIVE_LAYER"}||{"layerId":1}|
{"type":"CANVAS","ticket":23,"id":"CANVAS"}||{"originX":0,"originY":0,"unit":"mm","gridXSize":10,"gridYSize":10,"snapXSize":0.3937,"snapYSize":0.3937,"gridType":"NONE","multiGridType":"NONE","highlightValue":0.5}|
{"type":"ELE_PLACEHOLDER","ticket":24,"id":"7a3eacf394b687eb"}||{"dataType":"FILL","max":1}|
{"type":"FILL","ticket":25,"id":"e1"}||{"groupId":0,"netName":"","layerId":49,"width":0.2,"fillStyle":"SOLID","path":[["CIRCLE",-78.94,-57.28,2.361]],"locked":false,"zIndex":1,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"FILL","ticket":26,"id":"e2"}||{"groupId":0,"netName":"","layerId":13,"width":0.2,"fillStyle":"SOLID","path":[-30,74.997,"L",-30.653,74.954,-31.294,74.827,-31.913,74.616,-32.5,74.327,-33.044,73.964,-33.536,73.533,-33.967,73.041,-34.33,72.497,-34.619,71.91,-34.83,71.291,-34.957,70.65,-35,69.997,-35,54.995,-50,54.995,-50.653,54.952,-51.294,54.825,-51.913,54.614,-52.5,54.325,-53.044,53.962,-53.536,53.531,-53.967,53.039,-54.33,52.495,-54.619,51.908,-54.83,51.289,-54.957,50.648,-55,49.995,-54.957,49.342,-54.83,48.701,-54.619,48.082,-54.33,47.495,-53.967,46.951,-53.536,46.459,-53.044,46.028,-52.5,45.665,-51.913,45.376,-51.294,45.165,-50.653,45.038,-50,44.995,-35,44.995,-35,29.997,-34.957,29.344,-34.83,28.703,-34.619,28.084,-34.33,27.497,-33.967,26.953,-33.536,26.461,-33.044,26.03,-32.5,25.667,-31.913,25.378,-31.294,25.167,-30.653,25.04,-30,24.997,-29.347,25.04,-28.706,25.167,-28.087,25.378,-27.5,25.667,-26.956,26.03,-26.464,26.461,-26.033,26.953,-25.67,27.497,-25.381,28.084,-25.17,28.703,-25.043,29.344,-25,29.997,-25,44.995,-10,44.995,-9.347,45.038,-8.706,45.165,-8.087,45.376,-7.5,45.665,-6.956,46.028,-6.464,46.459,-6.033,46.951,-5.67,47.495,-5.381,48.082,-5.17,48.701,-5.043,49.342,-5,49.995,-5.043,50.648,-5.17,51.289,-5.381,51.908,-5.67,52.495,-6.033,53.039,-6.464,53.531,-6.956,53.962,-7.5,54.325,-8.087,54.614,-8.706,54.825,-9.347,54.952,-10,54.995,-25,54.995,-25,69.997,-25.043,70.65,-25.17,71.291,-25.381,71.91,-25.67,72.497,-26.033,73.041,-26.464,73.533,-26.956,73.964,-27.5,74.327,-28.087,74.616,-28.706,74.827,-29.347,74.954,-30,74.997],"locked":false,"zIndex":2,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"FILL","ticket":27,"id":"e3"}||{"groupId":0,"netName":"","layerId":13,"width":0.2,"fillStyle":"SOLID","path":[30,74.997,"L",29.347,74.954,28.706,74.827,28.087,74.616,27.5,74.327,26.956,73.964,26.464,73.533,26.033,73.041,25.67,72.497,25.381,71.91,25.17,71.291,25.043,70.65,25,69.997,25,29.997,25.043,29.344,25.17,28.703,25.381,28.084,25.67,27.497,26.033,26.953,26.464,26.461,26.956,26.03,27.5,25.667,28.087,25.378,28.706,25.167,29.347,25.04,30,24.997,30.653,25.04,31.294,25.167,31.913,25.378,32.5,25.667,33.044,26.03,33.536,26.461,33.967,26.953,34.33,27.497,34.619,28.084,34.83,28.703,34.957,29.344,35,29.997,35,69.997,34.957,70.65,34.83,71.291,34.619,71.91,34.33,72.497,33.967,73.041,33.536,73.533,33.044,73.964,32.5,74.327,31.913,74.616,31.294,74.827,30.653,74.954,30,74.997],"locked":false,"zIndex":3,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"FILL","ticket":28,"id":"e4"}||{"groupId":0,"netName":"","layerId":13,"width":0.2,"fillStyle":"SOLID","path":[0.2909,-62.4748,"ARC",-77.99557378231314,-81.925,4.097,"ARC",-12.004382617999656,-82.0343,5.137,"ARC",-90.00000000003476,-77.034,10.1373,"ARC",-77.9961214992998,-72.143,6.177,"ARC",77.99638409786058,0.2918,-52.4757,"ARC",90.00000000000153,74.3458,21.5783,"ARC",89.99999999999801,0.2918,95.6323,"ARC",89.99999999999801,-73.7622,21.5783,"ARC",1.3721378250880047,-73.741,19.805,"ARC",-1.1648677290703604,-73.7445,19.9066,"L",-73.7396,19.685,"ARC",-90.00916769143105,-78.74,14.6846,"ARC",-88.62533866634628,-83.739,19.565,"L",-83.739,19.5652,"ARC",-1.3729831118094316,-83.7631,21.5792,"ARC",-89.99999999999827,0.2909,105.6332,"ARC",-89.99999999999827,84.3449,21.5792,"ARC",-90.00000000000136,0.2909,-62.4748],"locked":false,"zIndex":4,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"ELE_PLACEHOLDER","ticket":29,"id":"3b70dbd70bc44c9d"}||{"dataType":"FILL","max":5}|
{"type":"FILL","ticket":30,"id":"e10"}||{"groupId":0,"netName":"","layerId":50,"width":0.2,"fillStyle":"SOLID","path":[["CIRCLE",27.56,0,7.877]],"locked":false,"zIndex":10,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"FILL","ticket":31,"id":"e11"}||{"groupId":0,"netName":"","layerId":50,"width":0.2,"fillStyle":"SOLID","path":[["CIRCLE",-27.56,0,7.877]],"locked":false,"zIndex":11,"isBridgingCopper":false,"networkList":[],"refs":[]}|
{"type":"ELE_PLACEHOLDER","ticket":32,"id":"f2a0a6a4198a8d1f"}||{"dataType":"POLY","max":5}|
{"type":"POLY","ticket":33,"id":"e5"}||{"groupId":0,"netName":"","layerId":48,"width":2,"path":[-78.937,21.654,"ARC",-180,78.937,21.654,"ARC",-180,-78.937,21.654],"locked":false,"zIndex":5,"polyType":"NORMAL"}|
{"type":"POLY","ticket":34,"id":"e6"}||{"groupId":0,"netName":"","layerId":3,"width":10,"path":[30,69.997,"L",30,29.997],"locked":false,"zIndex":6,"polyType":"NORMAL"}|
{"type":"POLY","ticket":35,"id":"e7"}||{"groupId":0,"netName":"","layerId":3,"width":10,"path":[-30,69.997,"L",-30,29.997],"locked":false,"zIndex":7,"polyType":"NORMAL"}|
{"type":"POLY","ticket":36,"id":"e8"}||{"groupId":0,"netName":"","layerId":3,"width":10,"path":[-10,49.995,"L",-50,49.995],"locked":false,"zIndex":8,"polyType":"NORMAL"}|
{"type":"POLY","ticket":37,"id":"e9"}||{"groupId":0,"netName":"","layerId":3,"width":10,"path":["CIRCLE",0,21.65,78.74],"locked":false,"zIndex":9,"polyType":"NORMAL"}|
{"type":"ELE_PLACEHOLDER","ticket":38,"id":"f795bbafd95da246"}||{"dataType":"PAD","max":12}|
{"type":"PAD","ticket":39,"id":"e12"}||{"groupId":0,"netName":"","layerId":12,"num":"2","centerX":27.56,"centerY":0,"padAngle":270,"hole":{"holeType":"ROUND","width":27.56,"height":27.56},"defaultPad":{"padType":"ELLIPSE","width":43.307,"height":43.307},"specialPad":[],"padOffsetX":0,"padOffsetY":0,"relativeAngle":0,"plated":true,"padType":"NORMAL","topSolderExpansion":null,"bottomSolderExpansion":null,"topPasteExpansion":null,"bottomPasteExpansion":null,"locked":false,"zIndex":12,"connectMode":null,"spokeSpace":null,"spokeWidth":null,"spokeAngle":null,"padLen":0}|
{"type":"PAD","ticket":40,"id":"e13"}||{"groupId":0,"netName":"","layerId":12,"num":"1","centerX":-27.56,"centerY":0,"padAngle":270,"hole":{"holeType":"ROUND","width":27.56,"height":27.56},"defaultPad":{"padType":"RECT","width":43.307,"height":43.307,"radius":0},"specialPad":[],"padOffsetX":0,"padOffsetY":0,"relativeAngle":0,"plated":true,"padType":"NORMAL","topSolderExpansion":null,"bottomSolderExpansion":null,"topPasteExpansion":null,"bottomPasteExpansion":null,"locked":false,"zIndex":13,"connectMode":null,"spokeSpace":null,"spokeWidth":null,"spokeAngle":null,"padLen":0}|
{"type":"ELE_PLACEHOLDER","ticket":41,"id":"a8471fb61552c24a"}||{"dataType":"ATTR","max":14}|
{"type":"ATTR","ticket":42,"id":"e14"}||{"groupId":0,"parentId":"","layerId":3,"x":null,"y":null,"key":"Footprint","value":"MIC-TH_BD4.0-P1.40-D0.4-L-FD","keyVisible":false,"valueVisible":false,"fontFamily":"default","fontSize":67.5,"strokeWidth":6,"bold":false,"italic":false,"origin":"LEFT_BOTTOM","angle":0,"reverse":false,"expansion":0,"mirror":false,"locked":false,"zIndex":14}|
{"type":"ATTR","ticket":43,"id":"e15"}||{"groupId":0,"parentId":"","layerId":3,"x":null,"y":null,"key":"Designator","value":"U?","keyVisible":false,"valueVisible":false,"fontFamily":"default","fontSize":67.5,"strokeWidth":6,"bold":false,"italic":false,"origin":"LEFT_BOTTOM","angle":0,"reverse":false,"expansion":0,"mirror":false,"locked":false,"zIndex":15}|
{"type":"ATTR","ticket":4663,"id":"89689c55fd460051"}||{"groupId":"","parentId":"","layerId":3,"x":null,"y":null,"key":"3D Model Title","value":"MIC-TH_BD4.0-P1.40-D0.4-L-FD","keyVisible":false,"valueVisible":false,"fontFamily":"default","fontSize":45,"strokeWidth":6,"bold":false,"italic":false,"origin":"LEFT_BOTTOM","angle":0,"reverse":false,"expansion":0,"mirror":false,"locked":false,"zIndex":-1,"specialColor":"#000000"}|
{"type":"ATTR","ticket":4664,"id":"ce2bcb91ea5a3977"}||{"groupId":"","parentId":"","layerId":3,"x":null,"y":null,"key":"3D Model","value":"8dd4f0cbe6e44287ae3997316d3d922d","keyVisible":false,"valueVisible":false,"fontFamily":"default","fontSize":45,"strokeWidth":6,"bold":false,"italic":false,"origin":"LEFT_BOTTOM","angle":0,"reverse":false,"expansion":0,"mirror":false,"locked":false,"zIndex":-1,"specialColor":"#000000"}|
{"type":"DOCHEAD","ticket":9349}||{"docType":"FOOTPRINT","client":"0fb97aaaf7dbe284","uuid":"2eac74f3cf9a8fb1","updateTime":1759992873615,"version":"1666959764","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|
{"type":"DOCHEAD","ticket":9349}||{"docType":"FOOTPRINT","client":"0d178074b27f50a0","uuid":"2eac74f3cf9a8fb1","updateTime":1759993193068,"version":"1666959764","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|