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:
@@ -0,0 +1,52 @@
|
||||
{
|
||||
"source": "oshwhub",
|
||||
"source_url": "https://oshwhub.com/li-chuang-kai-fa-ban/liang-shan",
|
||||
"project_id": "0c46759837334318aa4882d6d37f96fa",
|
||||
"title": "立创·梁山派开发板",
|
||||
"description_short": "立创·梁山派开发板是基于GD32F450ZGT6全国产化开源开发板，完善的配套视频教程、文档教程、实验案例。提供在线编译器，10分钟快速入门。开源技术迭代，项目式学习，让学习更加深入，让创意升华。",
|
||||
"description_path": "description.md",
|
||||
"author": {
|
||||
"username": "li-chuang-kai-fa-ban",
|
||||
"display_name": "立创开发板",
|
||||
"user_id": "e1627234eeda4945b94a409d59d54978"
|
||||
},
|
||||
"license": "GPL 3.0",
|
||||
"tags": [],
|
||||
"created_at": "2022-05-13T08:04:53.000Z",
|
||||
"updated_at": "2026-01-31T08:35:21.000Z",
|
||||
"published_at": "2023-08-30T05:55:15.000Z",
|
||||
"crawled_at": "2026-04-28T13:15:28.385149+00:00",
|
||||
"metrics": {
|
||||
"likes": 760,
|
||||
"stars": 891,
|
||||
"forks": 0,
|
||||
"views": 237019,
|
||||
"watch": 0,
|
||||
"comments": 518
|
||||
},
|
||||
"cover": {
|
||||
"url": "https://image.lceda.cn/pullimage/XkhLil9qE6Vm5m7rlKbdxRK7bvbwvsX8544IKMif.jpeg",
|
||||
"path": "cover.jpeg"
|
||||
},
|
||||
"files": [
|
||||
{
|
||||
"name": "嘉立创在线编译器使用01.mp4",
|
||||
"url": "https://image.lceda.cn/attachments/2022/9/vM1hMHqDXhzb3HPc5JKeNquV9H84jFizuI6dPU12.mp4",
|
||||
"original_id": "9cd89254f4524063910f04f38480254b",
|
||||
"ext": "mp4",
|
||||
"mime": "video/mp4",
|
||||
"size": 13730368,
|
||||
"md5": "71ab469ca6e66f570d7cac895dfd6e15"
|
||||
}
|
||||
],
|
||||
"raw_fields": {
|
||||
"path": "li-chuang-kai-fa-ban/liang-shan",
|
||||
"grade": 5,
|
||||
"origin": "pro",
|
||||
"public": true,
|
||||
"publish": true,
|
||||
"skipped_files": [
|
||||
"pro_source: no branch_uuid in project meta for 0c46759837334318aa4882d6d37f96fa"
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user