Files
vibemake-pcb-studio/PCB-SERVICE.md
T
2026-11-04 17:12:56 +08:00

7.1 KiB
Raw Blame History

AI PCB 服务接入

这份仓库包含 VibeMake PCB 网站、PCB 任务客户端、启动脚本及同源代理。AI 生成运行在独立的 auto_pcb 服务器上;本仓库不包含 DeepSeek 密钥,也不要求每个浏览器配置模型。

拉取后启动

要求 Node.js 20+(建议 22 LTS)、npm,以及能连接 PCB 后台的网络。

cp .env.pcb.example .env.local  # 可选,默认连接现有 192.168.1.200:8000
./start.sh

首次启动自动安装锁文件指定的依赖并构建,之后复用构建。访问 http://localhost:5180/pcb/ 。REBUILD=1 ./start.sh 强制重新构建。Ctrl+C 停止网站,不会取消已提交给后台的 PCB 任务。

默认服务地址是现有内部共享后台。其他网络/其他服务器需要在 .env.local 中设置 PCB_API_TARGET;没有后台时仍能关闭任务窗口使用编辑器,但不能生成 PCB。仅拉取本仓库不等于安装 EasyEDA、DeepSeek 和自动布线服务。

在已有远程服务器运行

在自己电脑的终端执行下面一条命令(项目已在服务器 ~/auto_pcb/vibemake-pcb-studio 时):

ssh -t -L 5180:127.0.0.1:5180 wpz@192.168.1.200 'cd ~/auto_pcb/vibemake-pcb-studio && ./start.sh'

然后访问 http://localhost:5180/pcb/ 。终端中的 SSH 连接用于访问网页;任务执行不依赖该连接。若服务器网站已在运行,使用 ssh -N -L 5180:127.0.0.1:5180 wpz@192.168.1.200 只建立访问通道。

浏览器编辑器依赖安全上下文中的 Web Crypto 和 navigator.locks。localhost 的 HTTP 可用;直接访问普通 LAN HTTP 地址可能被浏览器能力检测拒绝。LAN 直接访问应配置受信任 HTTPS:HOST=0.0.0.0 TLS_CERT=/path/cert TLS_KEY=/path/key ./start.sh。这两个路径可写入被忽略的 .env.local。

功能和边界

  • 需求、附件上传、补答、方案选择、服务器后台生成、进度事件、断线重连、任务查询、真实图片与 BOM 预览、摘要绑定审核及下载。
  • operation_id 在任务建立前就持久化;刷新后继续查询操作。不能把 operation succeeded 当作设计成功,最终以 task.state 为准。
  • delivery_ready 且 download_ready=true、没有阻塞项时才能审核。draft_ready 可下载草稿,但不开放制造包。后台校验不通过不能通过前端按钮绕过。
  • 当前后台是内部共享工作台,不是多租户服务;任务列表会包含同一后台的其他任务。对公网提供多用户服务前必须增加用户认证和任务/附件/成果归属校验。
  • 上传给 AI 服务器的需求和资料由服务器处理,与 Ziro 的浏览器端加密云项目不是同一数据边界。此接入不自动上传用户已有云项目。

兼容工程导入

Ziro 导入器需要含 project.json 的旧版 .epro,不能通过把 .epro2 改名转换。现有 auto_pcb 默认只导出 epro2;后端可执行以下一次性扩展(不读取/更改 API key):

python3 integration/install-editor-export.py ~/auto_pcb

这只为新生成的任务额外导出 editor_native 成果,旧任务冻结包保持原样。此脚本针对当前 auto_pcb 导出函数,版本不匹配或有任务执行中时会拒绝修改,并保留备份。

有兼容成果时,按钮“导入 编辑器副本”会验证下载摘要,转换原理图和 PCB,保存为新的本地 KiCad 项目。AI-SOURCE.json 记录来源 task_id 和 manifest;导入副本标为 unverified,原有制造检查和放行不延续到转换或编辑后的副本。当前仅支持单板、单原理图工程,多原理图/异常格式会明确拒绝。缺失的 3D 模型不应凭空补成已验证几何。

密钥与部署

DeepSeek API key 继续使用后台现有配置。禁止把 key 填入 VITE_*、源码、示例或 Git。本仓库不需要 provider key。.env.local 已被 Git 忽略;对接新后台只需配置其地址,不需要复制其模型凭据。

start.sh 启动的是 production 构建和固定目标的 /pcb-api/ 代理;Cookie、上传、SSE 和文件下载通过同源通道。代理不缓存 API,PWA 不拦截 API 导航。代理对后台使用 PCB_API_ORIGIN(默认 http://127.0.0.1:5173);后台须允许这个来源。

保留上游 GPL-3.0-or-later 许可与 NOTICE。当前 Git remote 保持该 VibeMake 仓库配置;提交和推送由维护者执行。

子路径与现有设置

默认构建和启动地址是 /pcb/,任务接口使用同源 /pcb/pcb-api/v1/。构建产物中的 pcb-service-config.json 会通知启动服务器使用同一 base;设置 VITE_BASE=/ 重新构建时亦能使用根路径。已有品牌、中文 JSX 运行时、云同步/遥测/旧 AI 关闭开关均保留。新的 PCB 任务入口独立使用服务端 API,不启用原来的本地 AI agent。

生产反向代理可以把整个 /pcb/ 转发到 http://127.0.0.1:5180,保留原始路径。API 流式响应需要关闭代理缓冲并保留长连接;参考 integration/nginx.example.conf。

使用 HTTPS 反向代理终止 TLS 时,在服务器 .env.local 显式设置 PUBLIC_ORIGIN=https://cadworld-studio.robotquan.com(更换域名时对应修改),用于校验浏览器请求来源。默认 localhost 测试不需要配置此项。

开发环境与测试记录

网站开发需要 Git、Bash、Node.js 20+ 和 npm。仓库通过 packageManager 固定 pnpm 10.33.0;start.sh 会用 npm 启动这个版本。依赖安装使用锁文件,不需要全局安装 TypeScript 或 Vite。

npm exec --yes --package=pnpm@10.33.0 -- pnpm install --frozen-lockfile
npm exec --yes --package=pnpm@10.33.0 -- pnpm -C designer dev
# 生产构建及同源 API 代理:
./start.sh

本地开发服务器默认端口由 Vite 配置决定;连接 AI 任务仍需要能访问 PCB_API_TARGET 指定的后台。使用支持 WebAssembly、Web Crypto 和 navigator.locks 的现代浏览器,并通过 localhost 或受信任 HTTPS 访问。

仅开发网站、接口客户端和编辑器,不需要在电脑上安装 Python、EasyEDA、Java、自动布线器或 DeepSeek key。独立部署生成后台则需要另外取得 ai_service_api、deliver_pack 及其运行资产,安装 Python 依赖、EDA SDK/CLI、模型调用运行器、Java/布线器和渲染工具,并配置后台凭据。本仓库没有打包这些后台源码和运行环境;它不是完整生成服务器的离线安装包。

网站历史来自后台的 runtime/web-v3/api.sqlite3 和 runtime/web-v3/core/;不存放在本仓库。.gitignore 排除了本地运行记录、日志、数据库和私有环境配置。qa/unittests/ 是应保留的自动化测试源码,不是用户测试任务记录。浏览器中已导入的编辑器项目属于本地用户数据,清空后台任务不会删除这些项目。

现有服务器的模型配置在 /home/wpz/.config/ai-pcb-codex/config.toml,通过 AI_PCB_CODEX_HOME 引用,独立于网站仓库。共享同一后台可以继续使用同一后台 key;开发者不需要拿到该 key。自建后台时应在仓库外的配置文件或部署密钥中提供各自的凭据,避免上传真实 key。