飞书公共依赖包，提供统一认证与API请求封装，含Token自动刷新、重试机制，是其他飞书Skill的基础设施组件
说明：
## 核心用法
`feishu-common` 是 OpenClaw 飞书生态的基础依赖 Skill，本身不直接面向终端用户，而是作为其他飞书相关 Skill 的底层支撑。主要暴露三个核心能力：
1. **租户 Token 管理**：`getToken()` 自动获取并缓存飞书 Tenant Token，避免重复调用开放平台接口
2. **请求重试机制**：`fetchWithRetry()` 封装带指数退避的重试逻辑，处理网络抖动
3. **认证请求封装**：`fetchWithAuth()` 组合 Token 获取与请求发送，内置 Token 过期自动刷新
依赖 Skill 通过 `require(“../feishu-common/index.js”)` 或兼容别名 `feishu-client.js` 引入使用。
## 显著优点
– **基础设施定位**：统一封装飞书认证复杂性，避免各 Skill 重复实现
– **可靠性设计**：内置重试、超时、Token 刷新机制，提升下游 Skill 稳定性
– **零配置使用**：依赖 Skill 无需关心飞书凭证管理细节
## 潜在局限
– **非独立运行**：必须配合其他飞书 Skill 使用，单独安装无实际功能
– **隐式耦合**：下游 Skill 硬编码依赖路径，迁移或版本变更时存在兼容风险
– **文档缺失**：未暴露接口参数说明、错误码定义及 Token 缓存策略细节
– **无监控观测**：缺乏日志等级控制、指标上报等可观测能力
## 适合人群
– 开发飞书相关 Skill 的 OpenClaw 贡献者
– 需要集成飞书开放平台的内部自动化场景
## 常规风险
– **凭证泄漏风险**：若 Token 缓存机制不当，可能存在内存泄漏或日志打印敏感信息
– **级联故障**：作为基础设施，本 Skill 异常将导致所有依赖方失效
– **版本兼容性**：飞书开放平台 API 升级时，需同步更新本 Skill，否则下游全面受影响
– **路径依赖风险**：使用相对路径 `../` 引用，在 Skill 目录结构调整时可能断裂
会员专属
