（1444期）Feishu Common – 飞书生态统一认证基础设施

飞书生态统一认证基础设施 飞书公共依赖包，提供统一认证与API请求封装，含Token自动刷新、重试机制，是其他飞书Skill的基础设施组件 使用说明 核心用法 feishu-common 是 OpenClaw 飞书生态的基础依赖 Skill，本身不直接面向终端用户，而是作为其他飞书相关 Skill 的底层支撑。主要暴露三个核心能力： 租户 Token 管理：getToken() 自动获取并缓存飞书 Tenant Token，避免重复调用开放平台接口 请求重试机制：fetchWithRetry() 封装带指数退避的重试逻辑，处理网络抖动 认证请求封装：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 目录结构调整时可能断裂 原始说明 Provides shared Feishu authentication, tenant token caching, retry handling, and authenticated API request support for dependent Feishu skills.