在使用 Zion 开发应用的过程中,很多同学常常遇到调试难、定位慢、不知从哪里下手的问题。
为了解决这些问题,Zion 推出了 AI 小助手 —— 专为 Zion 用户打造的一款智能调试工具,帮助大家更高效地诊断问题、分析原因并快速找到解决方案。
如果确定是 bug 时,你还可以让它创建飞书项目发给官方处理。
🌟 核心功能亮点
1. 自动识别问题类别
AI 会根据你输入的症状、错误信息、日志等,智能判断问题所属的功能模块(如 UI 组件、数据模型、行为逻辑等)。
2. 智能信息检索与关联分析
小助手将查询平台文档、日志记录、社区问答,帮助定位问题根源。
3. 提供明确解决方案
无论是代码修复建议、配置修改指引,还是调转到具体文档页面,AI 都会给出直观、可操作的建议。
4. Bug 上报自动化
当检测结果显示问题极有可能(概率超过 80%)源于平台自身缺陷时,AI 将自动生成飞书项目并上报官方以便后续跟进。
🧭 使用指南:怎么让 AI 小助手为你服务
Step 1 | 打开 AI 小助手界面
登录 Zion,进入项目编辑器后,点击右上角的 “AI 小助手” 图标以启动助手。

Step 2 | 提交你的问题描述
在弹出的 AI 小助手对话框中填写问题并点击发送,建议包含以下信息:
✥ 问题现象(如:“点击按钮无响应”)
✥ 错误信息(可提供截图或报错文字)
✥ 完整的复现步骤(建议按步骤详细描述)
✥ traceId(如有,请提供相关组件的 traceId)
✥ 项目 ID 和组件 ID(可在编辑器界面获取)


Step 3 | 提供日志 traceId 给到 AI 分析
✥ 你也可在日志界面找到错误日志的 traceId 并发送给 AI 让它分析


AI 小助手会迅速反馈:
✥ 影响的功能区域
✥ 可能的根因
✥ 修复建议(如修改配置、替换组件、更新数据模型等)
✥ 如判断为平台问题,自动发起 bug 报告流程。
Step 4 | 上报 bug 给官方
当 AI 认为你的问题大概率是由于官方 bug 导致的,你可以让 AI 提交缺陷给到官方进行处理。

小贴士:提高诊断效率
✥ 问题描述越清晰,AI 诊断越精准;
✥ 提供完整复现路径、日志 traceId、项目/组件 ID 是关键;
✥ 遇到明显平台缺陷时,可直接授权 AI 上报增强问题追踪效率。