核心用法
Zoho 技能通过统一的 zoho CLI 封装，提供对 Zoho CRM、Projects、Meeting 三大核心产品的 API 集成能力。用户完成 OAuth 2.0 授权流程后，可执行以下操作：
CRM 模块：支持 Deals（商机）、Contacts（联系人）、Leads（线索）等标准模块的增删改查，内置高级搜索语法（equals/contains/between 等运算符），可快速筛选 pipeline 状态。
Projects 模块：覆盖项目列表、任务管理（支持优先级、完成度、起止日期）、里程碑追踪、Bug 列表及工时记录，适合敏捷开发团队的日常 standup 与进度同步。
Meeting 模块：自动获取会议录制列表，支持 MP4 下载及转录文件提取，内置 standup-summarizer.sh 脚本实现「下载→提取音频→Gemini 转录→Claude 总结」的自动化 pipeline。
技术亮点：CLI 自动处理 access_token 的 1 小时生命周期刷新，缓存 refresh_token；支持多数据中心（US/EU/IN/AU/JP/UK/CA/SA）的域名自动适配；所有命令返回 JSON，便于与 jq 等工具链集成。
显著优点
- 全栈覆盖：单一技能打通销售（CRM）、交付（Projects）、协作（Meeting）三大业务流，避免多工具切换
- 自动化管道：会议录制→AI 摘要的完整工作流已脚本化，大幅降低手动处理成本
- 企业级认证：基于标准 OAuth 2.0，refresh_token 长期有效，符合企业安全合规要求
- 灵活扩展：
zoho raw命令允许直接调用任意 API 端点，应对官方未封装的新功能
潜在局限
- 配置门槛高：需独立完成 Zoho API Console 的 Server-based Application 注册、授权码抓取、双 Org ID 配置（CRM/Meeting 分离），对非技术用户不友好
- 地域复杂性：8 个数据中心的账户 URL 和 API 域名必须严格匹配，配置错误导致「invalid_client」等 cryptic 报错
- 权限粒度粗：OAuth scope 以
ALL级别授权，无法精细控制到模块字段级；Meeting 录制下载依赖公开链接，存在潜在泄露风险 - 速率限制：CRM 100 请求/分钟，高频自动化场景需自行实现退避逻辑
适合人群
- 已使用 Zoho One/Zoho CRM/Zoho Projects 的中小企业技术团队
- 需要自动化销售 pipeline 报告或每日 standup 摘要的 Engineering Manager
- 具备 curl/OAuth 调试能力、熟悉 jq 数据处理的开发者/运维人员
常规风险
- 令牌泄露风险：
.env文件存储 refresh_token，需严格限制文件权限（建议 0600）；泄露后可长期访问全部授权数据 - 数据跨境：默认 US 数据中心，欧盟/中国用户需显式切换至
.eu/.in域名，否则存在 GDPR/数据主权合规隐患 - 录制隐私：Meeting 录制下载 URL 为公开可访问的 Zoho 托管链接，分享后无法撤销，敏感会议需额外加密或本地存储
- 供应商锁定：深度集成 Zoho 专有 API，迁移至 Salesforce/HubSpot 等竞品时需重写全部业务逻辑