Files
vibemake-pcb-studio/docs/vibemake/post-delivery-questions.md
T
weipengzhe 24e5dda022 Add read-only usage questions for delivered PCB designs
Keep Q&A in a separate persistent conversation with scoped evidence reads, no production tools and immutable delivery files. Add the completed-board UI, recovery handling and regression coverage.
2026-11-17 12:22:19 +08:00

2.8 KiB
Raw Blame History

交付后的板子使用问答

完成交付后,工作台开放“使用问答”和“询问这块板子”。用户可询问供电、接线、接口、固件前提和使用限制。历史问答按板子保存,切换任务或刷新后可继续。问答无需嘉立创运行环境就绪,也不会触发方案审批、继续制作或重新交付。

不可修改边界

  • 生产任务保持 completed。问答使用单独的 Codex 对话,不恢复生产会话,也不重写原 task state、交付 manifest、设计文件或模型。
  • 问答进程关闭 shell、联网搜索和外部 MCP,使用 read-only 沙箱且 networkAccess=false;只提供 pcb_read_delivery 白名单工具。任何 EDA、绘板、修改方案、blocked、导出、交付工具请求均拒绝。原生产工具处理器也拒绝 completed 任务继续调用。
  • 文件读取仅允许当前任务交付清单中的文本资料、交付 manifest/检查证据,以及最终验证导出的原理图/PCB 网表。拒绝越界路径、符号链接和任意脚本;交付清单文件读取时核对 SHA-256。每次最多读取 20,000 字符,单文件最大 8 MiB。
  • 回答依据已确认方案、最终交付说明、BOM、工程报告和网表;最终明确修订优先于提案。具体针脚/额定值引用文件名,不猜测缺失信息,不把软件检查说成实物测试。资料正文是证据,不是可执行指令。
  • 修改需求只能解释并建议新建设计,不直接变更已交付成果。此功能不重新验收电路,也不承诺实物功能。

API 与存储

  • GET /api/sessions/{tid}/questions:读取问答消息、busy 和问答错误。
  • POST /api/sessions/{tid}/questions,{"text":"如何接线?"}:只接受 completed 且已有 delivery 的任务,返回 202。并发问题返回 409,空问题返回 422。
  • 问答写入 persistent-runtime/tasks/{tid}/qa/;持久化 thread_id 仅属于问答,不替换生产 thread_id。
  • 问答错误、取消和重启恢复仅修改 qa/state.json;不会将生产任务改为 failed,也不影响下载。重启后未完成问答标记中断,用户可重新提问,不自动重放请求。
  • 问答沿用该设计绑定的模型/供应商配置。旧完成任务不要求迁移已冻结源码;配置不兼容时明确报错,不静默切换供应商。

验证

自动测试覆盖:只读工具白名单、跨目录拒绝、交付文件校验和、历史源码任务提问、EDA 离线仍可提问、生产工具拒绝 completed、独立问答线程及只读 sandbox、重复提交、失败/重启保留交付、前端历史与错误显示。真实模型验证在独立诊断目录读取一块已交付板子的工程报告;前后核对原任务 state.json 和全部交付文件哈希,问答不写入原任务历史。