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>
2026-04-28 21:45:52 +08:00
parent d874278bc5
commit 3282a028c4
8455 changed files with 2275248 additions and 36 deletions
--- a/data/raw/oshwhub/b77840665e2e48148c1b04ce84b5f7e7/source/3a1eec1e301a78db.epro2
+++ b/data/raw/oshwhub/b77840665e2e48148c1b04ce84b5f7e7/source/3a1eec1e301a78db.epro2
@@ -0,0 +1,4 @@
+{"type":"DOCHEAD","ticket":9881}||{"docType":"DEVICE","client":"d65f147c8efe27cb","uuid":"3a1eec1e301a78db","updateTime":1759497311629,"version":"1694067602"}|
+{"type":"META","ticket":9882,"id":"META"}||{"title":"TS24CA 250gf 013","tags":[],"source":"fa9d2d9ed7434416a645a0cd523c3f3c|0819f05c4eef4c71ace90d822a990e87","images":["https://alimg.szlcsc.com/upload/public/product/middle/20230314/6B43C306FA64244A69EBACC95134FEA0.jpg"],"attributes":{"LCSC Part Name":"2*4*3.5mm半包小贝贝TS-018小侧按键m165蓝牙耳机开关 250gf","Supplier Part":"C5373430","Manufacturer":"SHOU HAN(首韩)","Manufacturer Part":"TS24CA 250gf 013","Supplier Footprint":"SMD","JLCPCB Part Class":"Extended Part","Datasheet":"https://atta.szlcsc.com/upload/public/pdf/source/20230321/913029B0FB0CD391AF5EFD51697D8EC4.pdf","Supplier":"LCSC","Add into BOM":"yes","Convert to PCB":"yes","Symbol":"66d503a89210f75d","Designator":"SW?","Footprint":"60c9c3cfee8d4682","3D Model":"763936bace60400091d42d91968ac4d8","3D Model Title":"SW-SMD_L4.7-W3.5-H1.9-P3.35-EH","3D Model Transform":"185.039,143.691,0,0,0,0,0,23.974,-15.748","Circuit":"单刀单掷","Actuator Style":"矩形按钮","Operating Force":"250gf","Mounting Style":"卧贴","Switch Length":"4.55mm","Switch Width":"1.8mm","Switch Height":"3.5mm","Strike Gundam":"不带","Contact Current":"50mA","Voltage Rating (AC)":"-","Voltage Rating (DC)":"12V","Power Rating":"0.6W","Insulation Resistance":"100MΩ","Actuator/Cap Color":"黑色","With Lamp":"无","IP Rating":"-","Pin Style":"-","Mechanical Life":"3万次","Operating Temperature":"-40℃~+85℃","Name":"={Manufacturer Part}","Description":"电路结构:单刀单掷;按钮形状:矩形按钮;作用力:250gf;安装方式:卧贴;开关长度:4.55mm;开关宽度:1.8mm;开关高度:3.5mm;带支架:不带;触点电流:50mA;额定电压(AC):-;额定电压(DC):12V;额定功率:0.6W;绝缘电阻:100MΩ;带灯:无;机械寿命:3万次;"}}|
+{"type":"DOCHEAD","ticket":9881}||{"docType":"DEVICE","client":"0fb97aaaf7dbe284","uuid":"3a1eec1e301a78db","updateTime":1759992873615,"version":"1694067602","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|
+{"type":"DOCHEAD","ticket":9881}||{"docType":"DEVICE","client":"0d178074b27f50a0","uuid":"3a1eec1e301a78db","updateTime":1759993193068,"version":"1694067602","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|