dsh-eda-review

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\\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 工程文件格式）：
• 更新版格式文档（官方）：
• 社区格式整理：

许可证

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。