Files
Knowit 3282a028c4 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

41 lines
10 KiB
Plaintext

{"type":"DOCHEAD","ticket":10142}||{"docType":"SYMBOL","client":"0189349a42729895","uuid":"7bddcb1886b5e9b2","updateTime":1759507164292,"version":"2000b6d6ccc5f2afda4b093c2a7f9f58"}|
{"type":"META","ticket":10143,"id":"META"}||{"title":"CRYSTAL_2","description":"","tags":[],"docType":2,"source":"ba6f777f70587026c56214fee966239c|5980bffcf5b8460bb9378df5856f3e50"}|
{"type":"DOCHEAD"}||{"docType":"SYMBOL","client":"571c8141eb34867e","uuid":"7bddcb1886b5e9b2","updateTime":1752632858225,"version":"2000b6d6ccc5f2afda4b093c2a7f9f58"}|
{"type":"CANVAS","ticket":1,"id":"CANVAS"}||{"originX":0,"originY":0}|
{"type":"PART","ticket":2,"id":"CRYSTAL_2.1"}||{"BBOX":[-0.5,-20.5,20.5,0.5],"title":"CRYSTAL_2.1"}|
{"type":"ATTR","ticket":3,"id":"ie1"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"","key":"Symbol","value":"CRYSTAL_2","keyVisible":false,"valueVisible":false,"x":null,"y":null,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM"}|
{"type":"ELE_PLACEHOLDER","ticket":4,"id":"236b438c9f91ea33"}||{"dataType":"POLY","max":1}|
{"type":"POLY","ticket":5,"id":"ie2"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":0,"y":5},{"x":0,"y":15}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":6,"id":"ie3"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":4,"y":0},{"x":4,"y":20}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":7,"id":"ie4"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":4,"y":20},{"x":16,"y":20}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":8,"id":"ie5"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":16,"y":20},{"x":16,"y":0}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":9,"id":"ie6"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":16,"y":0},{"x":4,"y":0}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":10,"id":"ie7"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"points":[{"x":20,"y":5},{"x":20,"y":15}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":11,"id":"20679480b8795495"}||{"dataType":"PIN","max":7}|
{"type":"PIN","ticket":12,"id":"ie8"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"display":true,"x":-10,"y":10,"length":10,"rotation":0,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":13,"id":"ie9"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie8","key":"NAME","value":"1","keyVisible":false,"valueVisible":false,"x":6,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_MIDDLE"}|
{"type":"ATTR","ticket":14,"id":"ie10"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie8","key":"NUMBER","value":"1","keyVisible":false,"valueVisible":true,"x":-8,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_BOTTOM"}|
{"type":"ATTR","ticket":15,"id":"ie11"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie8","key":"Pin Type","value":"Passive","keyVisible":false,"valueVisible":false,"x":-10,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":null}|
{"type":"ELE_PLACEHOLDER","ticket":16,"id":"4b9b1097763428b4"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":17,"id":"ie12"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"display":true,"x":30,"y":10,"length":10,"rotation":180,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":18,"id":"ie13"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie12","key":"NAME","value":"2","keyVisible":false,"valueVisible":false,"x":18,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_MIDDLE"}|
{"type":"ATTR","ticket":19,"id":"ie14"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie12","key":"NUMBER","value":"2","keyVisible":false,"valueVisible":true,"x":28,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM"}|
{"type":"ATTR","ticket":20,"id":"ie15"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie12","key":"Pin Type","value":"Passive","keyVisible":false,"valueVisible":false,"x":30,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":null}|
{"type":"ELE_PLACEHOLDER","ticket":21,"id":"7fe63a3cb43e1ef2"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":22,"id":"ie16"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"display":true,"x":10,"y":-10,"length":10,"rotation":270,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":23,"id":"ie17"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie16","key":"NAME","value":"3","keyVisible":false,"valueVisible":false,"x":10,"y":6,"rotation":90,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_MIDDLE"}|
{"type":"ATTR","ticket":24,"id":"ie18"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie16","key":"NUMBER","value":"3","keyVisible":false,"valueVisible":true,"x":10,"y":-8,"rotation":90,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM"}|
{"type":"ATTR","ticket":25,"id":"ie19"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie16","key":"Pin Type","value":"Passive","keyVisible":false,"valueVisible":false,"x":10,"y":-10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":null}|
{"type":"ELE_PLACEHOLDER","ticket":26,"id":"8edfdbd847589058"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":27,"id":"ie20"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"display":true,"x":10,"y":30,"length":10,"rotation":90,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":28,"id":"ie21"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie20","key":"NAME","value":"4","keyVisible":false,"valueVisible":false,"x":10,"y":14,"rotation":90,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_MIDDLE"}|
{"type":"ATTR","ticket":29,"id":"ie22"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie20","key":"NUMBER","value":"4","keyVisible":false,"valueVisible":true,"x":10,"y":28,"rotation":90,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_BOTTOM"}|
{"type":"ATTR","ticket":30,"id":"ie23"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie20","key":"Pin Type","value":"Passive","keyVisible":false,"valueVisible":false,"x":10,"y":30,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":null}|
{"type":"ELE_PLACEHOLDER","ticket":31,"id":"0215941129a98f0e"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":32,"id":"ie24"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"display":true,"x":20,"y":20,"length":0,"rotation":0,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":33,"id":"ie25"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie24","key":"NAME","value":"5","keyVisible":false,"valueVisible":false,"x":18,"y":20,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_MIDDLE"}|
{"type":"ATTR","ticket":34,"id":"ie26"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie24","key":"NUMBER","value":"5","keyVisible":false,"valueVisible":true,"x":28,"y":20,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM"}|
{"type":"ATTR","ticket":35,"id":"ie27"}||{"partId":"CRYSTAL_2.1","groupId":"","locked":false,"zIndex":null,"parentId":"ie24","key":"Pin Type","value":"Passive","keyVisible":false,"valueVisible":false,"x":20,"y":20,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":null}|
{"type":"DOCHEAD","ticket":10142}||{"docType":"SYMBOL","client":"0fb97aaaf7dbe284","uuid":"7bddcb1886b5e9b2","updateTime":1759992873615,"version":"2000b6d6ccc5f2afda4b093c2a7f9f58","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|
{"type":"DOCHEAD","ticket":10142}||{"docType":"SYMBOL","client":"0d178074b27f50a0","uuid":"7bddcb1886b5e9b2","updateTime":1759993193068,"version":"2000b6d6ccc5f2afda4b093c2a7f9f58","user":{"uuid":"215caa123bec401fba5bbdb222b0e772","nickname":"一只不爱吃鱼的猫","username":"liuxiaotao","avatar":"//image.lceda.cn/avatars/2022/8/W4GUor1tCl7FLtACkLdILGxmVP32cSSHlLXizbhS.png"}}|