文档版本 v2026.05.16.0

下载 PDF

冒烟路径

页面目标

用最短步骤验证“资料库 -> 工作区 -> Viewer -> 导出”主链路是否可用。

推荐最小样本

• 优先使用内置 h730duino 或 BluePhil
• 如果要验证导入链路，再补一个自己的 DSN 或 KiCad 文件

最小冒烟链路

1. 启动并进入资料库。
2. 确认资料库首页可交互。
3. 打开一个文档进入工作区。
4. 在 2D 中完成一次平移、缩放和对象选中。
5. 右键或长按对象，点一次 查看信息。
6. 打开 Workbench，完成一次显隐或对象搜索。
7. 切到 Data，确认摘要页可显示。
8. 如果当前文档已经形成 board session，切到 3D 并等待板级场景加载完成。
9. 打开 AI。若当前没有配置任何 AI 服务密钥，确认只会出现一张设置提示卡，并按提示前往 Settings > AI；若已经配置过密钥，确认当前 Chat / Structured 能力路由指向可用 provider。切换 Diagnose Selection / Chat，在有选中对象时完成一次诊断；随后在 Chat 中执行一次简单工具型请求，确认工具调用、工具结果回灌、最终回答和 AI 活动记录都可在高级信息折叠卡中追踪；若最终回答包含 Markdown，结果区应显示为排版后的标题、列表、粗体或代码块。
10. 回到 2D，完成一次导出；如果未解锁，则确认会先弹出购买中心。
11. 返回资料库，再次打开同一文档。

通过标准

• 资料库与工作区均可进入
• 2D 和 Workbench 基础交互无阻断
• Data 可显示当前文档摘要
• 板级设计文档的 3D 可进入
• AI 工作区可进入；无密钥时提示设置正常，已配置后能力切换、问题主链与 Chat 工具调用 / 工具结果回灌 / 最终回答正常
• 2D 导出成功并可验证结果，或未解锁场景下购买中心弹出正确

建议记录

• 测试平台
• 样本类型
• 是否使用了内置示例
• 3D 是否为适用路径
• 失败步骤与提示文本

常见问题

为什么把 Data 也放进冒烟路径？

因为当前导入和场景准备过程会用到 Data 视图作为过渡和摘要页，它已经属于真实用户路径的一部分。

如果样本缺少 board session，3D 失败算不算阻断？

不算。3D 需要当前文档已经形成 board session，并包含足够板级几何；不满足这个条件的样本应跳过这一步。