业务适配器与社区配方
业务适配不是把某个厂商的完整后台搬进 BailingHub。它是在源业务系统一侧建立一条薄而明确的边界：声明允许 Agent 使用的操作、验证中枢签名、恢复可信主体，再调用原有服务层做最终权限和业务校验。
| 形式 | 放在哪里 | 适合什么情况 |
|---|---|---|
| 业务侧 SDK | 业务系统代码中 | 需要生成工具 spec、验签、签发身份票据或调用中枢 |
| 独立适配器 | 单独仓库或业务插件 | 某类产品有稳定扩展点，希望单独安装和升级 |
| 社区配方 | 文档、示例 spec 与验证脚本 | 需要参考接入结构，但仍要按自己的版本和权限模型实现 |
业务侧 SDK 不等于 Agent Client SDK。前者服务于业务后端的声明、验签与身份建立；后者服务于本地 Agent 的浏览器授权、连接与工具调用。
当前公开参考
Section titled “当前公开参考”- CRMEB 适配器 是独立项目，发布与 Core 分开管理。
- Core
v0.5.1包含 RuoYi-Vue-Pro 参考配方 和 JeecgBoot 参考配方。它们是社区接入参考，不表示对应上游项目已经内置、认证或推荐 BailingHub。
一条适配路径
Section titled “一条适配路径”- 选择一条可核对结果的读取能力和一条可回滚写能力。
- 为每个动作定义稳定
operationId、参数 Schema 和 ACC 治理声明。 - 在业务后端验证签名、主体、租户、资源归属和实时业务状态。
- 只向中枢发布所需工具 spec，并在路由中再次裁剪允许范围。
- 用固定测试账号验证成功、越权拒绝、重复请求和审批恢复。
- 把适配器版本、兼容业务版本与维护者责任写清楚。
社区项目边界
Section titled “社区项目边界”社区发行版、连接器和配方可以独立命名、发布和维护。公开展示只表示可被发现，不等于官方质量担保、安全审计或客户采用。通用改进可以贡献上游，行业专用逻辑可以继续留在独立项目。