常见问题

每次打开都进入安装流程

当前启动流程会检查加密启动文件和数据库是否存在，已有安装使用简短恢复界面。升级后又出现首次安装时，先核对是否打开了正确的应用、是否保留原用户目录。不要先删数据库或启动凭据。

又要求输入密钥或密码

先确认弹窗来源。模型密钥在设置里配置；macOS 钥匙串弹窗是操作系统授权，Windows DPAPI 则绑定系统用户。未签名包更新后可能改变系统信任。解锁系统凭据存储后重试；读取失败不会清空数据库。

Bot 无法搜索或使用插件

检查 Agent 是否启用、模型是否支持工具、Bot 是否属于频道、对应能力是否配置。插件还需要处于启用状态，并给这位 Bot 分配准确权限。提示词写出工具名或插件声称只读，都不等于获得授权。插件声明改变后需要重新审查。

任务中断或附件失败

打开任务详情查看错误类型。超时、取消或预算耗尽不代表完成。修复原因后重新提交，或把大任务拆小。附件检查类型与大小，先提取所需文字；PDF 密码只在附件处理框输入，部分提供方不能直接读取二进制附件。

反馈问题

使用 问题反馈入口，提供版本、系统、预期行为和最小复现步骤。日志与截图先移除密钥、私人对话和账户信息。安全问题使用 私密报告。