Facere/FacereDataset
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

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

Browse Source 
打通 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:
Knowit
2026-04-28 21:45:52 +08:00
parent d874278bc5
commit 3282a028c4
8455 changed files with 2275248 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
data/raw/oshwhub/dc91a91e669349898d709a5ba02f5b5f/source/cb62e6c927d94387b0664fdfd30b9eda.epro2 Normal file
View File

@@ -0,0 +1,38 @@
{"type":"DOCHEAD","ticket":414}||{"docType":"SYMBOL","client":"5796efe0-71be-4764-a7be-8620972bb90b","uuid":"cb62e6c927d94387b0664fdfd30b9eda","updateTime":1735986453000,"version":"1713934668","user":{"uuid":"f6d958b048194965970a097419f0f68a","nickname":"重庆枫叶","username":"cqlcp","avatar":"//image.lceda.cn/avatars/2026/1/FneZQD4JKfDDm92UUIa483axw2OD9PF1E07L9Aby.webp"}}|
{"type":"DOCHEAD","ticket":415}||{"docType":"SYMBOL","client":"5796efe0-71be-4764-a7be-8620972bb90b","uuid":"cb62e6c927d94387b0664fdfd30b9eda","updateTime":1735986453000,"version":"1713934668","user":{"uuid":"f6d958b048194965970a097419f0f68a","nickname":"重庆枫叶","username":"cqlcp","avatar":"//image.lceda.cn/avatars/2026/1/FneZQD4JKfDDm92UUIa483axw2OD9PF1E07L9Aby.webp"}}|
{"type":"META","ticket":416,"id":"META"}||{"title":"HX DC007B-2.0-J","description":"","tags":["连接器","DC电源连接器"],"docType":2,"source":"c110221d824d4004ad3be7b4834a2ba5|0819f05c4eef4c71ace90d822a990e87"}|
{"type":"DOCHEAD"}||{"docType":"SYMBOL","client":"899d03d243f8773b","uuid":"cb62e6c927d94387b0664fdfd30b9eda","updateTime":1735986453000,"version":"1713934668","user":{"uuid":"f6d958b048194965970a097419f0f68a","nickname":"重庆枫叶","username":"cqlcp","avatar":"//image.lceda.cn/avatars/2026/1/FneZQD4JKfDDm92UUIa483axw2OD9PF1E07L9Aby.webp"}}|
{"type":"CANVAS","ticket":1,"id":"CANVAS"}||{"originX":0,"originY":0}|
{"type":"PART","ticket":2,"id":"HX DC007B-2.0-J.1"}||{"BBOX":[-34.5,-28.5,0.5,16],"title":"HX DC007B-2.0-J.1"}|
{"type":"ATTR","ticket":3,"id":"e1"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":1,"parentId":"","key":"Symbol","value":"HX DC007B-2.0-J","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","version":"2.0"}|
{"type":"ATTR","ticket":4,"id":"e2"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":2,"parentId":"","key":"Designator","value":"U?","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","version":"2.0"}|
{"type":"ELE_PLACEHOLDER","ticket":5,"id":"placeholder1"}||{"dataType":"POLY","max":2}|
{"type":"POLY","ticket":6,"id":"e3"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":3,"points":[{"x":-15,"y":28},{"x":-7,"y":28}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":7,"id":"e4"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":4,"points":[{"x":-17,"y":24},{"x":-4,"y":24}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":8,"id":"e5"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":5,"points":[{"x":-20,"y":20},{"x":0,"y":20}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":9,"id":"e6"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":6,"points":[{"x":0,"y":10},{"x":-10,"y":10},{"x":-10,"y":10},{"x":-10,"y":20}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":10,"id":"e7"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":7,"points":[{"x":0,"y":-10},{"x":-6,"y":-10}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":11,"id":"placeholder2"}||{"dataType":"POLY","max":1}|
{"type":"POLY","ticket":12,"id":"e9"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":9,"points":[{"x":-10,"y":-14},{"x":-30,"y":-14}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"POLY","ticket":13,"id":"e10"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":10,"points":[{"x":-10,"y":-6},{"x":-30,"y":-6}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":14,"id":"placeholder3"}||{"dataType":"POLY","max":1}|
{"type":"POLY","ticket":15,"id":"e12"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":12,"points":[{"x":0,"y":0},{"x":-29,"y":0},{"x":-29,"y":0},{"x":-31,"y":-4},{"x":-31,"y":-4},{"x":-33,"y":0}],"closed":false,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":16,"id":"placeholder4"}||{"dataType":"RECT","max":7}|
{"type":"RECT","ticket":17,"id":"e8"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":8,"dotX1":-10,"dotY1":-4,"dotX2":-6,"dotY2":-16,"radiusX":0,"radiusY":0,"rotation":0,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":18,"id":"placeholder5"}||{"dataType":"ARC","max":10}|
{"type":"ARC","ticket":19,"id":"e11"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":11,"startX":-30,"startY":-6,"referX":-34,"referY":-10,"endX":-30,"endY":-14,"strokeColor":null,"strokeStyle":null,"fillColor":null,"strokeWidth":null,"fillStyle":null}|
{"type":"ELE_PLACEHOLDER","ticket":20,"id":"placeholder6"}||{"dataType":"PIN","max":12}|
{"type":"PIN","ticket":21,"id":"e13"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":13,"display":true,"x":20,"y":-10,"length":20,"rotation":180,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":22,"id":"e14"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":14,"parentId":"e13","key":"Pin Name","value":"1","keyVisible":false,"valueVisible":false,"x":-2,"y":-5.08502,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":23,"id":"e15"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":15,"parentId":"e13","key":"Pin Number","value":"1","keyVisible":false,"valueVisible":true,"x":5,"y":-9.08502,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":24,"id":"e16"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":16,"parentId":"e13","key":"Pin Type","value":"Undefined","keyVisible":false,"valueVisible":false,"x":20,"y":-10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":"LEFT_BOTTOM","version":"2.0"}|
{"type":"ELE_PLACEHOLDER","ticket":25,"id":"placeholder7"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":26,"id":"e17"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":17,"display":true,"x":20,"y":10,"length":20,"rotation":180,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":27,"id":"e18"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":18,"parentId":"e17","key":"Pin Name","value":"3","keyVisible":false,"valueVisible":false,"x":-2,"y":14.91498,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":28,"id":"e19"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":19,"parentId":"e17","key":"Pin Number","value":"3","keyVisible":false,"valueVisible":true,"x":5,"y":10.91498,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":29,"id":"e20"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":20,"parentId":"e17","key":"Pin Type","value":"Undefined","keyVisible":false,"valueVisible":false,"x":20,"y":10,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":"LEFT_BOTTOM","version":"2.0"}|
{"type":"ELE_PLACEHOLDER","ticket":30,"id":"placeholder8"}||{"dataType":"PIN","max":3}|
{"type":"PIN","ticket":31,"id":"e21"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":21,"display":true,"x":20,"y":0,"length":20,"rotation":180,"color":null,"pinShape":"NONE"}|
{"type":"ATTR","ticket":32,"id":"e22"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":22,"parentId":"e21","key":"Pin Name","value":"2","keyVisible":false,"valueVisible":false,"x":-2,"y":4.91498,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"RIGHT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":33,"id":"e23"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":23,"parentId":"e21","key":"Pin Number","value":"2","keyVisible":false,"valueVisible":true,"x":5,"y":0.91498,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":false,"underline":false,"italic":false,"fontWeight":false,"align":"LEFT_BOTTOM","version":"2.0"}|
{"type":"ATTR","ticket":34,"id":"e24"}||{"partId":"HX DC007B-2.0-J.1","groupId":"","locked":false,"zIndex":24,"parentId":"e21","key":"Pin Type","value":"Undefined","keyVisible":false,"valueVisible":false,"x":20,"y":0,"rotation":0,"color":null,"fillColor":null,"fontFamily":null,"fontSize":null,"strikeout":null,"underline":null,"italic":null,"fontWeight":null,"align":"LEFT_BOTTOM","version":"2.0"}|