# PCB website service 当前 AI 入口使用新的持久化 Codex 会话服务 `codex_pcb.app`。架构、运行依赖、审核和交付协议见 [CODEX-SESSION.md](CODEX-SESSION.md)。旧 `backend/` 中的固定设计流程及 `backend/providers/codex.py` 不再是网站默认执行入口,旧任务不会自动迁移到新会话。 ## 本地前端与代理 要求 Node.js 20+(建议 22 LTS)、npm,以及可访问的新会话后台。 ```bash 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](integration/vibemake-pcb2-session.service),使用 Uvicorn 在 loopback 8003 运行;网页模板见 [integration/vibemake-pcb2-web.service](integration/vibemake-pcb2-web.service)。迁移时需按目标服务器修改模板中的用户、源码、运行目录、显示环境、认证和证书路径,不能照搬原开发者机器上的绝对路径。 在已正确安装并配置这两个 systemd 用户服务的 Linux 主机上: ```bash ./start.sh --services ``` 原开发环境的网页地址是 `https://192.168.1.200:15182/pcb/?ai=1`,不是通用可达地址。本地未部署 Codex/嘉立创 EDA 及对应服务时,合并代码或打包前端不会使 AI 自动具备执行能力。具体依赖、持久化目录、原生会话和认证要求以 CODEX-SESSION.md 为准。旧版 KiCad 的 macOS 适配保留在 `backend/`,不代表新持久化会话引擎已在 macOS 验收。 部署 Freerouting 前请阅读 [无交互部署注意事项](CODEX-SESSION.md#freerouting-无交互部署注意事项2026-11-11)。生产会话统一使用 `codex_pcb/freerouting.py`,避免错误帮助参数和默认确认倒计时导致停顿。 ## 独立静态发布包 根目录执行 `./build.sh`,使用固定版本 pnpm 安装缺失依赖、构建 `/pcb/` 前端,生成 `dist/vibemake-pcb.zip` 和 `dist/vibemake-pcb/`。ZIP 根目录直接包含 `index.html`、`assets/` 等文件,不包含额外的 `pcb/` 目录。构建失败时不会用旧产物生成新包。 ```bash 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](integration/nginx.example.conf)。