dsh-eda-review
嘉立创EDA专业版（EasyEDA Pro）工程文件（.epro2 / .epru）解析与电路/图形审查技能，打包为标准 DSH（DeepSeek Harness）Skill Bundle。
只读技能包：不联网、不写文件、不执行外部命令、无任何安装脚本。
完整项目说明（定位 / 能力 / 兼容性 / 许可）见 docs/PROJECT.md。
能力
- 解析
.epro2（ZIP 容器）与.epru（逐行记录流），重建权威网表； - 区分编辑历史残留与当前状态（同元素多记录取最大 ticket）；
- 引脚 / 封装 / 数据手册逐脚核对（CD4067、DW01、ME6211 等实战规则）；
- PCB 几何检查：板框、叠层、线宽、过孔、铺铜、丝印、阵列朝向；
- 板型/层数通用化：2/4/6+ 层叠层自适应、盲埋孔/HDI、拼板与工艺边、表面处理（§15）；
- 版本增量审查（元素级语义 diff，剔除重存/重编号噪声）；
- BOM 与立创官方库三方对齐（位号集合、封装名、引脚表）；
- 官方 PDF 数据手册本地提取（纯 Python 标准库，按坐标还原表格）。
完整方法论见 skills/eda-project-review/SKILL.md。
安装
本地 link（开发调试）
D:\plugin\link-plugin.cmd dsh-eda-review-plugin
等价于：
dsh plugin --profile desktop add link:D:/plugin/dsh-eda-review-plugin
GitHub 源
dsh plugin add github:chaser-star/dsh-eda-review
安装后重启 DSH 生效。卸载：
dsh plugin --profile desktop remove dsh-eda-review
若 profile 中残留旧链接（悬空符号链接），先
remove或手动删除%USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-eda-review再重新链接。
使用
安装后技能以 eda-project-review 出现，在用户提供 .epro2 / .epru 文件，或要求 EDA 工程审查、网表审查、原理图检查、PCB 图形检查、打样前检查、版本对比时触发。
安全与权限
| 项目 | 取值 |
|---|---|
| 文件写入 | 无 |
| 网络访问 | 无 |
| 子进程 / 命令执行 | 无 |
| 安装脚本（preinstall/install/postinstall/prepare） | 无 |
| 读取范围 | 仅本包内 skills/**/SKILL.md |
| 凭据 / 用户文件 / 环境变量 | 不访问 |
| 解析输入上限 | frontmatter ≤ 64 KiB；单个 SKILL.md ≤ 1 MiB |
依赖 yaml 仅用于 frontmatter 解析；当它不可解析时自动降级为内置纯文本解析器，插件不会因缺依赖崩溃。详见 SECURITY.md。
使用范围与免责声明
本技能面向自有或已获授权的工程项目文件提供辅助审查，不提供任何形式的保证。
- 禁止处理加密或受保护文件：不解析、不解密、不绕过任何加密文件、受加密保护或访问受限的工程文件；
- 禁止处理他人保密文件：请勿将第三方保密资料、公司内部工作文件或未获授权的工程数据提交给本技能处理；
- 输出仅为基于工程数据的分析建议，不构成设计正确性、可制造性或安全性的保证或验收结论；
- 使用者应自行确认对相关文件的合法使用权并遵守所在地法律法规；因超出上述范围、侵犯第三方权利或违反法律法规产生的一切后果由使用者自行承担，作者不承担任何责任；
- 本软件依据 Apache-2.0 许可证「按现状」提供，不附带任何明示或默示担保。
目录结构
dsh-eda-review-plugin/
├─ package.json
├─ index.js # ctx.skills 技能提供者
├─ lib/frontmatter.mjs # frontmatter 解析（yaml 优先，内置兜底）
├─ cordis.patch.yml # bundle 补丁：insert 唯一 entry
├─ skills/eda-project-review/SKILL.md
├─ test/ # run-all + 5 套测试（共 77 项）
├─ docs/ # TESTING / MARKETPLACE / candidate-entry
├─ README.md SECURITY.md LICENSE
开发与测试
npm test # 单进程全量 79 项
node --experimental-test-coverage test/run-all.mjs # 覆盖率
测试体系（三轮，见 docs/TESTING.md）：契约 11 + 安全 9 + 黄金用例 39 + 差分精度 300 例（误差 0.00% < 5%）+ 健壮性 17；行覆盖率 96.11%、分支 89.91%。
兼容性
- 已实测：
0.2.1-rc.3（一次性 Profile 中 link 安装 →--dump-config组装出条目 → 技能注册成功，且yaml缺失仍正常）； - 契约验证：
0.1.5-rc.3的dsh-skill暴露同名registerProvider扩展点与相同 provider 字段； - 降级策略：宿主无
skills服务时不加载；无registerProvider时保持惰性并通过ctx.logger.warn说明； - 详见 docs/COMPATIBILITY.md。
参考
- 官方格式说明（嘉立创 EDA 专业版 V3 工程文件格式）：https://github.com/easyeda/easyeda-file-format
- 更新版格式文档（官方）：https://github.com/easyeda/easyeda-format-skill
- 社区格式整理：https://github.com/eggfly/easyeda-agent-skills/blob/main/spec/epro2-format.md
许可证
Apache-2.0，见 LICENSE；版权声明见 NOTICE。
SPDX 标识：Apache-2.0（SPDX-License-Identifier: Apache-2.0）。仓库内全部源文件均带 SPDX 头标记，兼容 REUSE 规范与 SPDX 识别工具。
市场状态
- dsh-market / dsh.so：Declared（作者声明），尚未 Verified；
- 上架步骤、证据门与兼容性矩阵见 docs/MARKETPLACE.md。
No comments yet. Be the first to write one.