Knowit
3282a028c4
打通 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>
4 lines
2.2 KiB
Plaintext
4 lines
2.2 KiB
Plaintext
{"type":"DOCHEAD","ticket":786}||{"docType":"DEVICE","client":"0bb2c9fe-c897-4bff-b46c-eaa1f7c27461","uuid":"71cef950d13140339563f15554aa5e9c","updateTime":1752133856000,"version":"1654893740","editVersion":"3.2.91","user":{"uuid":"16555ec60452466ea4dbaa7c6b92cd89","nickname":"乐鑫小铁匠","username":"esp-college","avatar":"//image.lceda.cn/avatars/2023/7/DgnM9iWggXtWZa70BQwJnpb1x7P2etO5s7i6vqxp.png"}}|
|
|
{"type":"DOCHEAD","ticket":787}||{"docType":"DEVICE","client":"0bb2c9fe-c897-4bff-b46c-eaa1f7c27461","uuid":"71cef950d13140339563f15554aa5e9c","updateTime":1752133856000,"version":"1654893740","editVersion":"3.2.91","user":{"uuid":"16555ec60452466ea4dbaa7c6b92cd89","nickname":"乐鑫小铁匠","username":"esp-college","avatar":"//image.lceda.cn/avatars/2023/7/DgnM9iWggXtWZa70BQwJnpb1x7P2etO5s7i6vqxp.png"}}|
|
|
{"type":"META","ticket":788,"id":"META"}||{"title":"TSD4A 250gf-DZ","tags":["按键/开关","轻触开关"],"source":"d6cd6f676fdf486284e898447dd503e1|0819f05c4eef4c71ace90d822a990e87","images":["https://alimg.szlcsc.com/upload/public/product/middle/20230103/B1E8FA0245B469CE30D44D5F6979723B.jpg"],"attributes":{"LCSC Part Name":"4.7*4.5*1.6mm 卧贴 轻触开关","Supplier Part":"C431531","Manufacturer":"SHOU HAN(首韩)","Manufacturer Part":"TSD4A 250gf-DZ","Supplier Footprint":"SMD,3.5x4.7mm","JLCPCB Part Class":"扩展库","Datasheet":"https://atta.szlcsc.com/upload/public/pdf/source/20190925/C431531_0900C3010D7F342754DB2882E2E37F05.pdf","Supplier":"LCSC","Add into BOM":"yes","Convert to PCB":"yes","Symbol":"9de0cc0bd5604e39949fdee86e3b00f6","Designator":"SW?","Footprint":"72fb59b861bf43048203f67e12c26a10","3D Model":"5a21ef5f199e45e4baf2214389c063d7","3D Model Title":"SW-SMD_TSD4A","3D Model Transform":"251.968,177.165,0,0,0,0,0,-19.606,-19.685","Circuit":"单刀单掷","Actuator Style":"矩形按钮","Mounting Style":"卧贴","Switch Length":"4.7mm","Switch Width":"4.5mm","Switch Height":"1.6mm","Contact Current":"50mA","Voltage Rating (DC)":"12V","With Lamp":"-","Mechanical Life":"-","Name":"={Manufacturer Part}","Description":"电路结构:单刀单掷;按钮形状:矩形按钮;安装方式:卧贴;开关长度:4.7mm;开关宽度:4.5mm;开关高度:1.6mm;触点电流:50mA;额定电压(DC):12V;带灯:-;机械寿命:-;"}}|
|