Files
vibemake-pcb-studio/PCB-SERVICE.md
T
2026-11-13 17:21:35 +08:00

5.1 KiB
Raw Blame History

PCB website service

当前 AI 入口使用新的持久化 Codex 会话服务 codex_pcb.app。架构、运行依赖、审核和交付协议见 CODEX-SESSION.md。旧 backend/ 中的固定设计流程及 backend/providers/codex.py 不再是网站默认执行入口,旧任务不会自动迁移到新会话。

本地前端与代理

要求 Node.js 20+(建议 22 LTS)、npm,以及可访问的新会话后台。

cp .env.pcb.example .env.local
# 按实际部署修改 PCB_API_TARGET,默认 http://39.105.93.138:8003
./start.sh

普通 ./start.sh 保留跨平台前端构建和静态服务器启动方式,默认访问 http://localhost:5180/pcb/。它不启动 AI 后台;后台缺失时仍可使用项目列表和原编辑器。开发时可运行 pnpm -C designer dev,默认端口 5173;代理配置通过启动进程的环境变量传入。REBUILD=1 ./start.sh 强制构建。

AI 请求使用同源 /pcb/pcb-api/sessions 等路径,代理转发为后台 /api/sessions,默认目标为 http://39.105.93.138:8003。旧后台 /api/v1/tasks 与新协议不同,不应把新入口指向旧 8000/8002 服务。修改目标时同时核对 Vite、静态服务器和反向代理配置。

账号与平台工程接口 /api/ 独立转发至 API_TARGET,默认开发平台 API;保留 Authorization,移除 Origin/Referer。统一登录、项目封面、工程保存和重新打开继续使用平台流程,不与 AI 会话记录混为同一数据集。

AI 入口仅在打开项目且项目工作台加载完成后显示,返回项目列表时隐藏。默认收起,点击“Codex AI 自动绘板”打开;项目 URL 显式带 ?ai=1 可直接打开。当前本地构建使用 VITE_ENABLE_PCB_AI=true;仍可在 designer/.env.local 中设置 VITE_ENABLE_PCB_AI=false 关闭 AI,关闭时不挂载 AI 组件、不轮询会话。修改此构建配置需重启开发服务器或重新构建。关闭工作台不取消服务端已提交的任务。

新会话后台与现有 Linux 部署

新服务代码在 codex_pcb/。当前部署模板为 integration/vibemake-pcb2-session.service,使用 Uvicorn 在 loopback 8003 运行;网页模板见 integration/vibemake-pcb2-web.service。迁移时需按目标服务器修改模板中的用户、源码、运行目录、显示环境、认证和证书路径,不能照搬原开发者机器上的绝对路径。

在已正确安装并配置这两个 systemd 用户服务的 Linux 主机上:

./start.sh --services

原开发环境的网页地址是 https://192.168.1.200:15182/pcb/?ai=1,不是通用可达地址。本地未部署 Codex/嘉立创 EDA 及对应服务时,合并代码或打包前端不会使 AI 自动具备执行能力。具体依赖、持久化目录、原生会话和认证要求以 CODEX-SESSION.md 为准。旧版 KiCad 的 macOS 适配保留在 backend/,不代表新持久化会话引擎已在 macOS 验收。

部署 Freerouting 前请阅读 无交互部署注意事项。生产会话统一使用 codex_pcb/freerouting.py,避免错误帮助参数和默认确认倒计时导致停顿。

独立静态发布包

根目录执行 ./build.sh,使用固定版本 pnpm 安装缺失依赖、构建 /pcb/ 前端,生成 dist/vibemake-pcb.zip 和 dist/vibemake-pcb/。ZIP 根目录直接包含 index.html、assets/ 等文件,不包含额外的 pcb/ 目录。构建失败时不会用旧产物生成新包。

unzip -o /path/to/ziro-designer-main/dist/vibemake-pcb.zip -d /path/to/vibemake/pcb

结果应为 <网站根目录>/pcb/index.html。不要解压到网站根目录、再套一层 pcb/,或只放 ZIP 而不解压。保留主站、CAD 和旧 PCB 资源,不要清空网站或 PCB 目录;三者分别发布。通过 /pcb/build-info.json 核对发布版本,包内 DEPLOY.md 包含部署说明。

静态包只包含浏览器前端,不包含 backend/、codex_pcb/、模型凭据或运行数据。保留账号 API 和 /pcb/pcb-api/ 反向代理;AI 代理必须先于页面回退规则匹配,不能将 API 请求回退为 HTML。部署到其他路径时,构建 base、路由、代理和 PWA scope 必须保持一致。

数据与访问边界

AI 后台继续使用服务端私有认证,不将密钥或登录文件放入 VITE_*、前端源码或 Git。会话数据与生成文件应位于仓库外的持久化目录。当前会话 API 是共享后台,平台前端登录并不等于后端已具备逐用户任务隔离;对外开放前需要接入服务端认证和归属校验。

当前新会话入口按上游协议提供方案审核、进度、三维预览和交付下载。旧 PlatformPcbService 适配代码保留用于兼容与回归测试,但不会同时挂载旧工作台或向新服务重放旧命令。

浏览器编辑器依赖安全上下文;localhost HTTP 或受信任 HTTPS 可用。使用 HTTPS 反向代理时配置 PUBLIC_ORIGIN,API 不缓存;参考 integration/nginx.example.conf。