帮助
故障排查
展开最接近的故障，完成安全检查；问题仍存在时再联系支持。
你将完成
支持范围包括购买、License Key、激活、下载和产品设置问题。Orqra 无法管理你自己的第三方模型服务商账号中的计费或技术问题。
本指南内容
- 1安装包无法打开、macOS 提示已损坏、设备架构不支持，或者检查更新失败。
- 2Provider 未配置、API Key 无效、Base URL 错误、Test Connection 失败，或者 Sync Models 后没有模型。
- 3模型已经添加但未启用，或者处理节点没有显示预期模型。
先找到最接近的现象
展开最接近的故障，完成安全检查；问题仍存在时再联系支持。
1下载与更新安装包无法打开、macOS 提示已损坏、设备架构不支持，或者检查更新失败。
- 最可能原因
- macOS v1 仅支持 Apple Silicon（arm64），不支持 Intel Mac。
- 用户可执行检查
- macOS v1 仅支持 Apple Silicon（arm64），不支持 Intel Mac。 安装经过验证的构建后启动 Orqra；Free 无需账号或 License。 支持范围包括购买、License Key、激活、下载和产品设置问题。Orqra 无法管理你自己的第三方模型服务商账号中的计费或技术问题。
- 不会删除或修改什么
- 项目、工作流、Prompt、输出、导入文件、模板和模型 API Key 保留在你的设备上。
- 何时联系支持
- 帮助找到正确安装包、发布记录，以及包含更新期内的更新资格。
安全的支持边界
可以发送应用版本、操作系统、支付参考号和简短问题描述。绝不要发送 API Key、完整 License Key、私人 Prompt 或项目文件；只有你另行决定分享具体内容时例外。
2配置并使用你自己的模型Provider 未配置、API Key 无效、Base URL 错误、Test Connection 失败，或者 Sync Models 后没有模型。
- 最可能原因
- 请使用 Provider 或自定义网关官方文档规定的端点与凭证格式。
- 用户可执行检查
- 请使用 Provider 或自定义网关官方文档规定的端点与凭证格式。 支持可以说明 Orqra 设置字段，但服务商 API Key、计费、速率限制和模型可用性仍由你的服务商负责。 把需要的模型加入“我的模型”并启用。Free 最多启用 3 个模型；Personal 不设版本级启用模型数量上限。
- 不会删除或修改什么
- 项目、工作流、Prompt、输出、导入文件、模板和模型 API Key 保留在你的设备上。
- 何时联系支持
- 支持可以说明 Orqra 设置字段，但服务商 API Key、计费、速率限制和模型可用性仍由你的服务商负责。
安全的支持边界
可以发送应用版本、操作系统、支付参考号和简短问题描述。绝不要发送 API Key、完整 License Key、私人 Prompt 或项目文件；只有你另行决定分享具体内容时例外。
3构建第一条可复用工作流模型已经添加但未启用，或者处理节点没有显示预期模型。
- 最可能原因
- 把需要的模型加入“我的模型”并启用。Free 最多启用 3 个模型；Personal 不设版本级启用模型数量上限。
- 用户可执行检查
- 把需要的模型加入“我的模型”并启用。Free 最多启用 3 个模型；Personal 不设版本级启用模型数量上限。 设置项目默认模型，或在处理节点选择兼容的已启用模型。检查请求预览，确认输入、模型和参数正确后再明确运行。
- 不会删除或修改什么
- 项目、工作流、Prompt、输出、导入文件、模板和模型 API Key 保留在你的设备上。
- 何时联系支持
- 支持范围包括购买、License Key、激活、下载和产品设置问题。Orqra 无法管理你自己的第三方模型服务商账号中的计费或技术问题。
安全的支持边界
可以发送应用版本、操作系统、支付参考号和简短问题描述。绝不要发送 API Key、完整 License Key、私人 Prompt 或项目文件；只有你另行决定分享具体内容时例外。
4核对并运行Request Preview 缺少输入，或者 Provider 返回超时、限流、余额或权限错误。
- 最可能原因
- 模型可用性、能力、速率限制和费用由 Provider 决定；Orqra 不包含 AI 模型额度。
- 用户可执行检查
- 插入可复用模板，检查请求预览；确认输入、模型和参数无误后再运行。 测试连接和同步模型是独立的 Provider 网络操作；只有明确运行模型步骤时，Prompt 和所选输入才会发送。
- 不会删除或修改什么
- 项目、工作流、Prompt、输出、导入文件、模板和模型 API Key 保留在你的设备上。
- 何时联系支持
- 支持可以说明 Orqra 设置字段，但服务商 API Key、计费、速率限制和模型可用性仍由你的服务商负责。
安全的支持边界
可以发送应用版本、操作系统、支付参考号和简短问题描述。绝不要发送 API Key、完整 License Key、私人 Prompt 或项目文件；只有你另行决定分享具体内容时例外。
5License 与激活未收到 License 邮件、Email 不匹配、达到设备上限、离线验证过期，或者检查更新失败。
- 最可能原因
- 帮助处理 Email + License Key 激活、设备限制、解绑和 License 状态问题。
- 用户可执行检查
- 打开 Orqra 桌面端，在 Settings -> Account & License 激活。 选择 Check for Updates（检查更新），核对版本和发布记录；确定继续时再选择 Install Update（安装更新），Orqra 会在安装前询问。
- 不会删除或修改什么
- 项目、工作流、Prompt、输出、导入文件、模板和模型 API Key 保留在你的设备上。
- 何时联系支持
- 支持范围包括购买、License Key、激活、下载和产品设置问题。Orqra 无法管理你自己的第三方模型服务商账号中的计费或技术问题。
安全的支持边界
可以发送应用版本、操作系统、支付参考号和简短问题描述。绝不要发送 API Key、完整 License Key、私人 Prompt 或项目文件；只有你另行决定分享具体内容时例外。