dsh-pcbagent
Manifest validView KiCad schematics and PCBs side by side with local KiCanvas rendering and optional routing through separately installed KiCad and Freerouting tools.
DSH PCB agent
English · 一个独立的 DeepSeek Harness 电子设计插件。
在 DSH 中同时查看 KiCad 原理图和 PCB,并通过外部 KiCad、Freerouting 工具进行本地自动布线。

功能
- 原理图和 PCB 并排显示;窄窗口自动上下排列,也可切换单视图。
- 打开
.kicad_pro自动配对同目录同名.kicad_sch和.kicad_pcb,也可分别打开。 - 使用本地 KiCanvas:原理图 Canvas2D、PCB WebGL2,支持缩放、图层、对象与网络查看。
- DSH 标准控件、主题、工程选择、布线设置及结果窗口,不改动宿主品牌和聊天界面。
- 独立的 Host、Client 和 Typert Remote;通过正式 bundle 安装,无需修改 DSH 源码。
- 模型无关的 Freerouting 布线、KiCad DSN/SES 转换、实际 KiCad CLI DRC,原始板文件保留。
当前渲染是只读查看,不能代替 KiCad 编辑器。这个发行版不包含 PCBWorld 原生引擎或付费模型重规划。
安装
需要 Node.js 24.9+、DSH 0.2.2-rc.1 和 Python 3.12+。此版本仅对这个 DSH 版本声明兼容;Python 查看功能只需标准库。布线还需要自行安装 KiCad(测试版本 10.0.7,包含 pcbnew 的 Python)和 Freerouting 原生 CLI(测试版本 2.5.0)。
在已安装 DSH 的电脑上运行:
dsh plugin --profile web add github:NiuVector/dsh-pcbagent#v0.1.0
仓库提交了预构建的 lib/,没有 prepare、postinstall 或自动下载引擎的安装脚本。也可从 GitHub Releases 下载 dsh-pcbagent-0.1.0.tgz,再运行:
dsh plugin --profile web add ./dsh-pcbagent-0.1.0.tgz
Windows 启动
下载源码后,在 PowerShell 中运行:
.\scripts\Start.ps1 -Workspace 'D:\PCB\my-project' -Python 'C:\Python312\python.exe'
默认使用 web 配置。打开 DSH 后选择一个已有会话或工作区,再进入侧栏「电子设计」→「打开工程」。允许目录里需有 KiCad 工程文件;输出也必须在允许目录内。
要启用布线,额外指定工具路径:
.\scripts\Start.ps1 -Workspace 'D:\PCB\my-project' `
-Python 'C:\Python312\python.exe' `
-KiCadRoot 'C:\Program Files\KiCad\10.0' `
-Freerouting 'D:\Tools\freerouting-cli.exe'
本插件不附带上述第三方程序,也不自动安装或修改系统设置。
其他平台与手动配置
启动 DSH 前设置 PCBROUTE_ALLOWED_ROOTS 为绝对目录的 JSON 数组,以及可选的 PCBROUTE_PYTHON。布线额外设置 PCBROUTE_ROUTER=freerouting、PCBROUTE_FREEROUTING_EXE、PCBROUTE_KICAD_PYTHON、KICAD_CLI 为可信的可执行文件路径。然后运行 dsh web。
Windows 路径、停止进程树和原生工具组合已实测;其他平台未完成本插件的端到端验收。Freerouting 的 Java JAR 不是此适配器接受的原生可执行程序。
也可在 profile 的 cordis.patch.yml 覆盖 pcbagent 行,配置 allowedRoots、pythonExecutable 和可选的外部 pcbRoot。空的 allowedRoots 不开放任何文件目录。
数据与结果
查看器不向 KiCanvas 网站上传板文件;原始 KiCad 文本经允许目录检查后发送到本机浏览器,在禁止联网的隔离 iframe 内渲染。模型工具不会返回完整原理图或 PCB 原始源码。此发行版的布线不发起模型请求;DSH 自己的聊天提供商配置仍独立生效。
每次布线创建新的结果目录,保存板文件、DRC JSON、转换日志和带哈希的报告。界面区分错误、警告和未连接项。合格状态来自实际 KiCad DRC,不是 PCBWorld 基准得分;不做原理图一致性检查。Specctra 不能表达全部 KiCad 规则,生产前仍需人工检查原始约束和最终 DRC。
本机 Host 拥有者控制文件和任务。LiveShare 的默认拒绝策略不授予远端观看者这些接口。允许目录限制仅针对插件,不改变 DSH 其他工具的权限。
开发与许可证
本项目是独立集成,不是 DeepSeek、KiCad、KiCanvas 或 Freerouting 的官方产品。插件和 DSH 派生界面使用 MIT;PCBRouteAgent 后端部分使用 BSD-3-Clause;KiCanvas、描边字体及 Material Symbols 的许可证均在 licenses/。KiCad 与 GPLv3 Freerouting 作为独立外部工具使用,不随本包分发。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.1.0 | — | — |
Comments
Loading…
Similar plugins
Read-only CAD tools that inspect, extract and export DWG/DXF drawings, including SVG and PNG previews and DXF conversion.
★ 0
↓ 46/wk
dsh plugin --profile web add dsh-cad-pluginAdds a 无界画布 page to the DSH left sidebar with a bundled front-end, local workbench status/start, and DSH Agent tools that read and edit the open canvas; the canvas has no built-in Agent. Requires a lo
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-wujie-canvasby skillre
Zero-core-change vision capability for DeepSeek Harness: the describe_image tool + profile bundle, installable via 'dsh plugin add'
★ 0
MIT
TypeScript
Aug 15, 2026
dsh plugin --profile web add dsh-bundle-visionby NormanFxxkingRockwell
DSH Web GUI 插件:把 Think 与连续工具调用压成一条可折叠的横向胶囊工具链,模型说话才截断。
★ 0
MIT
JavaScript
Oct 20, 2026
dsh plugin --profile web add dsh-tool-graphic-chainby Mrdifferent2022
Parametric CAD tools for DeepSeek Harness (dsh) — agent-driven mechanical design: CadQuery modeling, geometry validation, preview rendering, STEP/IGES/STL/3MF export
★ 0
MIT
TypeScript
Oct 9, 2026
dsh plugin --profile web add dsh-cadby lzhphantom
DSH(DeepSeek Harness)组合包插件:只读扫描任意项目目录,自动构建**模块级 + 文件级知识图谱**,帮助快速理解项目整体架构与设计思路,为后续进化、优化提供依据。
★ 0
MIT
JavaScript
Aug 16, 2026
dsh plugin --profile web add dsh-kgraph-plugin