Files
2026-11-13 17:21:35 +08:00

56 lines
5.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)。