核心用法
该技能为纯文档类知识库，用于指导开发者完成紫鸟浏览器与ERP系统的单点登录（SSO）集成。核心使用流程包括：在紫鸟开放平台创建自建应用获取API Key，通过company接口获取企业ID，查询员工列表与账号权限，最终获取用户登录Token（openapiToken），并拼接superbrowser:// Schema URL拉起客户端实现自动登录。技能采用分层文档结构，Level 0说明定位边界，Level 1阐述架构流程，Level 2通过按需路由表指向reference目录下的详细接口文档，避免信息过载。
显著优点
官方权威性：由紫鸟开放平台官方维护（ziniao-open），接口定义与平台实际能力保持同步，避免第三方文档滞后或错误导致的集成返工。架构清晰：明确区分简单鉴权（直接使用API Key）与复杂鉴权（需获取appAuthToken）两种模式，降低开发者理解成本。流程完整：从应用创建到Schema URL调用的全链路文档化，包含mermaid流程图、接口摘要表、公共响应结构等关键信息。安全设计：双层响应结构（网关层+业务层）便于错误定位，API Key以占位符形式呈现，无真实凭证泄露风险。按需加载：通过路由表机制，仅在实际需要时深入参考文档，保持主文档简洁。
潜在缺点与局限性
平台限定：Schema URL协议仅支持Windows客户端，Mac/Linux环境无法使用客户端控制功能。权限门槛：user-login接口需联系紫鸟客服并经过Boss验证才能申请，增加了企业接入的前期沟通成本。无账号管理：明确不包含账号CRUD、标签、授权、设备管理等接口，完整ERP集成需配合ziniao-erp-api-doc技能。无自动化能力：不提供RPA或脚本注入能力，仅支持拉起浏览器，无法在浏览器内进行自动化操作。文档深度分散：详细参数分散在reference目录多个文件中，频繁查阅时需多次跳转。
适合的目标群体
- ERP系统集成工程师：负责企业内部系统与紫鸟浏览器的SSO对接开发
- 电商技术团队：管理多平台店铺账号，需要实现员工免密登录的技术负责人
- SaaS产品架构师：规划电商运营工具与紫鸟生态的集成方案
- 企业IT管理员：评估紫鸟OpenAPI能力边界，制定内部账号管理规范
常规使用风险
依赖服务稳定性：集成效果受紫鸟开放平台API可用性影响，需设计熔断降级机制。Token过期管理：openapiToken具有时效性，需建立自动刷新机制避免登录中断。IP白名单配置：生产环境需提前配置服务器出口IP，变更时需同步更新平台配置。Windows客户端版本：Schema URL调用依赖本地安装的紫鸟浏览器版本，新旧版本协议兼容性需验证。简单/复杂鉴权混淆：错误选择鉴权模式可能导致认证失败，需在架构设计阶段明确模式选型。