Bugly 集成
Bugly 集成目前为内测功能，需要在 设置 → 内测功能 里开启 Bugly 后使用。
HiFox 在这条链路里是 Bugly 的下游缺陷系统：在 Bugly 控制台提单后，提单通过 Webhook 推进 HiFox 自动建任务；配置出站凭据后，还可以把任务状态变化回写 Bugly。它不属于导入 / 同步类集成：没有项目发现、导入向导、增量同步或成员目录同步，界面里也不会出现「导入」「同步」这类入口。
1. Bugly 提单 Webhook
- 打开 外部应用集成，进入 Bugly 详情页；
- 复制 Webhook 地址；
- 在 Bugly 控制台打开 设置 → 产品配置 → 缺陷管理，创建项目并把该地址粘贴到项目的 Webhook 配置里；
- 回到 HiFox 点 启用 Bugly 提单。
之后在 Bugly 提单，HiFox 就会自动建任务。Webhook 地址自带密钥参数，是这条链路的唯一凭证，不要外传；泄露时用 轮换密钥 换新地址，旧地址立即失效。不再使用时可以 断开 Bugly。
2. 产品与绑定
在「产品与绑定」里把 Bugly 产品接到 HiFox 空间。每个绑定包含：
- ProductID：Bugly 产品的 ID（Bugly 设置 → 产品信息里查看）；
- 项目名称：这条绑定的显示名；
- 建单空间：提单在哪个空间建任务；
- 默认任务类型：留空则使用空间默认；
- ProductKey（回写用）：可选，仅状态回写需要。
每个绑定可以用 映射 单独配置 状态回写（HiFox 任务状态 → Bugly 处理状态）和 优先级 映射；组织默认映射 为没有单独配置的绑定提供默认值。绑定的映射优先于组织默认。
3. 状态回写（可选）
不配置出站凭据时为仅入站模式：只建任务，任务状态变化不会回写 Bugly（页面会明确提示）。
需要回写时配置两层凭据：
- apiID / apiKey：公司级 OpenAPI 凭据；
- ProductKey：产品级密钥，写在对应绑定的 ProductKey（回写用） 里。
凭据为申请制，请联系 Bugly 助手开通；首期仅使用国内域名 api.bugly.tds.qq.com。保存后可用绑定上的 测试回写 验证连通性。回写只做一件事：任务状态变化时，按状态映射把新的处理状态写回 Bugly 对应工单。
常见问题
重复提单会重复建任务吗？
不会。同一组织、同一连接、同一绑定下的 ProductID + IssueKey 只对应一个任务；Bugly 重发同一条提单时，HiFox 直接返回已建任务，不会建第二个。
提单人会映射成 HiFox 成员吗？
不会。Bugly 没有成员接口，提单人和处理人以外部身份显示在任务上，需要时可由管理员人工关联。
为什么任务状态没有回写 Bugly？
依次检查：是否已保存公司级 apiID / apiKey 和该产品的 ProductKey（缺任一项就是仅入站模式）；该绑定的状态映射是否覆盖了当前任务状态；组织默认映射里是否补上了对应状态。