11 KiB
PCB 前端交付验证记录
2026-11-05:按已发布后端文档接入真实接口
当前接口契约和运行方式见 PCB API 接入说明。本节只记录本轮实际验证,不将测试用 HTTP 响应当作真实 OSS 服务。
pcb_http_api.test.ts14 项、pcb_platform_auth.test.tsx3 项、既有pcb_platform.test.ts11 项,共 28 项通过。- 覆盖文档规定的最小 JSON 字段、平台 Bearer、OSS 不携带平台凭证、multipart 字段及字节、无时区上海时间、无服务端 hash 的 ZIP 校验和重开、同源共享登录、401 与断网区分、429 冷却、账号变化后的延迟响应、重复确认、OSS 响应丢失、签名过期/大小不符后的替代批次和版本冲突。
pnpm -C designer typecheck、本轮新增/修改模块的 Biome 检查、两个仓库git diff --check通过。- 独立 Vite 生产构建通过,产物写入
/tmp/vibemake-pcb-real-build.xokcwi,未覆盖既有主站或 PCB 部署产物。仍有既有 OCCT 浏览器模块及大 chunk 提示;PWA 预缓存 24 项。显式 mock 生产构建按预期被拒绝。 - 一次扩大回归运行 12 个文件、162 项:159 通过,
ui_font_tokens.test.ts的 3 项字体统计失败,指向本轮未修改的assets/site-brand品牌样式。没有为适配接口而改动字体样式或放宽断言。 - QA 类型检查仍有既有 3 个诊断:
dialog_about.test.tsx两处旧 reportBug 参数和viewer3d_chrome.test.ts一处隐式 any。本轮新测试没有额外类型诊断。 - 8091 主站开发服务已重启为真实接口模式;未登录请求
/api/pcb/workspace/projects收到 dev 后端 401/UNAUTHORIZED、JSON 信封及 Cache-Control:no-store。 - 实际浏览器打开
/pcb/,确认无模拟标识;点击登录后真实邮箱/图片验证码弹窗能加载验证码。没有代用户解答验证码、登录或创建远端项目。
尚未完成真实账号下的 OSS 上传/确认、跨设备打开和服务端双标签并发联调;这些需要实际账号及启用后的存储环境,不能由上述契约测试推断通过。
日期:2026-11-04。环境:macOS、Node/pnpm、本地浏览器、开发模拟接口。基于 7e01147 的 PCB 仓库实施。
配套:实施与部署、后端接口要求。模拟接口持久化到浏览器 IndexedDB,本记录没有把它当作真实云服务或跨设备验收。
自动检查
| 检查 | 结果 | 范围和限制 |
|---|---|---|
| 相关测试 | 10 个文件、148 项通过 | 平台 11 项,以及原生保存、子页路径、旧任务隔离、设置、PWA 和界面契约 |
| 正式构建 | pnpm -C designer build 通过 |
包含 designer TypeScript 检查,产物 designer/dist,base /pcb/ |
| 模拟包保护 | 预期拒绝构建 | VITE_PCB_API_MODE=mock pnpm -C designer exec vite build 返回开发模式禁止生产构建 |
| 新增模块格式和 lint | 通过 | designer/src/platform、两个公共快照模块、平台测试 |
| Hook 依赖 | 平台无诊断 | 修改范围全量扫描与原基线一致,既有 53 个警告没有增加;未使用依赖自动修复 |
| 仓库 biome | 9 个错误 | 与原基线相同的 9 个既有格式错误,没有新增错误 |
| 递归类型检查 | 未全绿 | 产品包通过;QA 有 3 个既有错误,详见下文 |
| 递归测试 | 未全绿 | 1544 个文件通过、34 个失败、9 个跳过;22666 项通过、87 项失败、757 项跳过 |
| 差异空白检查 | 通过 | git diff --check |
可重复运行相关测试:
pnpm -C qa exec vitest run \
unittests/designer/pcb_platform.test.ts \
unittests/designer/pcb_frame_needs_pgm.test.ts \
unittests/designer/project_sync_provider.test.ts \
unittests/designer/reload_keeps_edits.test.ts \
unittests/designer/settings_cloud_sync.test.ts \
unittests/designer/sw_update.test.ts \
unittests/designer/ui_font_tokens.test.ts \
unittests/eeschema/sheet_edit.test.ts \
unittests/designer/menu_ellipsis.test.ts \
unittests/common/wx_controls_ratchet.test.ts
平台用例实际解析并序列化 KiCad 原生文件,验证完整 ZIP 二次往返、图片/模型二进制、走线宽度、过孔钻孔、封装位置、区域间距和原理图属性。另覆盖同名子页、路径攻击、hash 篡改、缺失模型、账号隔离、同名项目、创建/确认幂等、并发冲突、删除后保存、安全命令边界、异步文件写队列、保存中新修改和未知确认恢复。
变异验证
把实现中的确认 revision 临时改为当前最新 revision,designer 类型检查通过,only acknowledges 用例按预期失败。再单独把该用例中“上传期间继续编辑后仍有未保存修改”的期望改为 false,用例也按预期失败。QA 类型检查仍只有同样的 3 个既有错误,无新增类型诊断;因此 QA 整体编译不能记为通过。两次变异都核对修改已生效,随后用补丁还原,平台 11 项及相关 148 项重新通过。
仓库既有失败
QA 类型错误:
qa/unittests/common/dialog_about.test.tsx:173、:184仍传入组件已不接受的reportBug。qa/unittests/designer/viewer3d_chrome.test.ts:276存在隐式 any。
递归测试中,多项旧测试直接使用 URL.pathname 读取含中文的工作区路径,把百分号编码当成文件路径,导致 ENOENT。其余失败涉及既有 About、Linux libm 对照、计算器、制造输出、界面常量统计、旧 SW 根路径断言及源码映射规则。
另将原提交提取到纯 ASCII 临时路径进行基线对照,结果为 1562 个文件通过、15 个失败、9 个跳过,23157 项通过、28 项失败、755 项跳过。该目录没有工作区 Git 元信息,且路径不同,两个总数不能作为逐项回归差值;对照只用于确认既有失败和路径依赖。本轮没有修改制造内核或将失败断言改成当前输出。
浏览器实际操作
| 操作 | 观察结果 |
|---|---|
| 模拟账号 A 新建空工程 | 生成原生主文件,进入 PCB,显示尚未保存 |
| 修改原生页面属性、模拟确认丢失、重试 | 保留工程和原批次,重试后显示已保存 |
| 返回列表并重新打开 | 已保存属性恢复,仍可进入原生属性编辑 |
| Arduino_Uno 模板创建非空工程 | 板框、焊盘、封装、飞线加载,首次保存成功 |
| 重开 Arduino 工程并修改标题 | 新修改标为未保存;“保存并离开”成功返回列表 |
| 再次重开并检查 Title | 恢复 Arduino saved and reopened,表单仍可编辑 |
| 三维查看 | 从已恢复工程加载板体、钻孔、焊盘和丝印;外部模型转换有现有 WRL 提示,未据此宣称全部模型成功 |
| 中英文切换 | 列表、网站外壳、原生菜单与保存/离开交互切换,不重建当前文档 |
| 切换模拟 A/B | B 不显示 A 项目,切回 A 后可见原项目 |
| 编辑中宽度缩至 820px | 显示电脑端遮罩,画布仍挂载;恢复宽度后继续编辑 |
界面按 ui-ux-pro-max 的弹窗焦点、输入锁、加载反馈和可达操作指导检查,品牌颜色以 VibeMake/CAD 为准。修正了网站菜单被原生工具栏覆盖、三维视图占据网站导航区域和窄桌面外观面板不能滚动的问题。
截图:
主站导航对齐
PCB 导航从 vibemake/css/style.css 同步导航、按钮、头像和账号弹出层样式,并复用主站的本地 Sora / JetBrains Mono 字体、四档 Logo、菜单配置、SVG 图标和头像配色。React 外壳仅接入 PCB 的登录、语言和离开保护回调。
主站品牌调整后,在 PCB 仓库运行 pnpm -C designer sync:site-navigation;源目录不在默认相邻位置时使用 pnpm -C designer sync:site-navigation /绝对路径/vibemake。同步后的资源随 PCB 仓库独立构建,构建和部署不依赖主站源码目录。生成资源位于 designer/src/assets/site-brand 和 designer/public/brand,不应手工修改生成样式。
浏览器对照主站默认 1280px 视口:Logo 均为 112×42,导航内容最大宽度 1240、左右内边距 40,菜单间距 30;六项菜单的坐标、14px 字号、23.1px 行高及字体栈一致。PCB 当前项使用主站的白色文字和 4px 荧光绿圆点。账号为同款 36px 胶囊按钮。
窄桌面保留字体尺寸,通过折叠次要操作防止菜单换行及账号溢出;英文长菜单使用同款折叠菜单。导航中的社区搜索、发布入口前往主站页面,并经过现有工程离开保护。PCB 不运行主站业务脚本。
本轮针对变更执行类型检查、构建、格式与 Hook 检查、11 项平台测试,以及浏览器账号菜单、Escape 焦点恢复、语言切换和工程导航检查。上文记录的全仓既有失败不据此标记为解决。
截图:对齐主站后的项目列表。
CAD 列表与编辑器栏对齐
项目列表直接使用从 vibemake/css/cad.css 同步的样式,复用 cad-main、标题、独立搜索框、卡片预览区、图标操作按钮及分页。同步脚本同时保存主站的标题字体规则、按钮禁用规则和 SVG 图标。列表的外层只处理 React flex 布局,保留 CAD 的 1240px 最大宽度和 48px 40px 72px 内边距。
编辑页复用同一个账号组件,以 CAD 的 42px 顶部栏、92×34 Logo、32px 保存图标呈现。移除全站菜单、项目名称、语言入口和原生“文件”左侧的旧 Logo。新 Logo 点击后经过现有离开保护返回项目列表;工程内工具、视图切换和保存入口仍可使用。旧独立入口保留原有 HomeLink,平台模式由外层统一提供 Logo。
浏览器实际打开已保存的非空 PCB,确认以上元素和尺寸、PCB 选中状态、账号菜单无语言入口、Escape 关闭菜单,以及 Logo 返回列表。编辑器加载前后,列表的字体、卡片和顶部位置保持一致。类型检查、11 项平台测试、变更文件格式检查、Hook 依赖检查及生产构建通过。构建仍有既有 OCCT 浏览器模块和大体积 chunk 提示。
截图:CAD 同款项目列表、紧凑编辑器顶部栏。
尚需真实环境验收
前端真实适配已实现,业务后端和主站/CAD 功能代码未改动。真实环境还需验证同源 vm.auth、邮箱和图片验证码接口、OSS 签名/CORS、服务端 hash 与归档校验、账号权限以及跨浏览器持久化。
最终联调流程:主站登录后进入 /pcb/,浏览器 A 保存,浏览器 B 以同一账号打开并继续修改保存,A 重新读取新版;另一账号不得读取或覆盖该工程。断网、冲突、删除后保存和确认响应丢失也须在真实服务验证。
大工程峰值内存、全部第三方格式转换、完整制造输出和不同浏览器 GPU 表现尚未逐项回归。当前模拟验收不覆盖这些范围。发布配置及资源挂载由服务器联调阶段完成,本轮没有执行服务器部署。