飞书 SDK

Appearance

更新日志 ​

本文档记录了飞书 SDK 的所有重要变更。

[1.1.0] - 2024-12-XX ​

新增 ​

  • 🎯 完整的事件系统，支持监听操作成功事件
  • 📊 可观测性支持，提供完整的监控和日志功能
  • 🧪 测试框架优化，使用 Orchestra Testbench 进行 Laravel 集成测试
  • 📚 完善的事件系统文档和使用示例
  • 🏗️ Laravel Facade 支持，简化 API 访问方式
  • 🔄 缓存机制优化，访问令牌支持缓存
  • 📦 HTTP 客户端复用，提升性能

改进 ​

  • 改进错误处理机制
  • 优化文档结构，采用 Laravel 风格的简洁 README
  • 提升测试覆盖率和稳定性
  • 统一测试框架为 Pest 风格
  • 增强代码质量和类型安全

修复 ​

  • 修复测试环境中的事件系统兼容性问题
  • 修复单元测试的错误和依赖注入问题

[未发布] ​

计划中 ​

  • 支持更多消息类型（音频、视频、位置等）
  • 增加群组管理功能（创建、更新、删除）
  • 添加用户批量操作支持
  • 优化 API 响应时间和错误处理

[1.0.0] - 2024-01-15 ​

新增 ​

  • 🎉 首次发布飞书 SDK
  • 📨 支持发送文本、富文本、图片、文件等多种消息类型
  • 👥 支持群组搜索和管理功能
  • 👤 支持用户信息获取功能
  • 🔐 自动访问令牌管理
  • 🏗️ Laravel 集成支持
  • 🛡️ 完整的类型安全支持
  • 🧪 完整的单元测试覆盖

功能特性 ​

  • Message 类: 支持发送各种类型的消息
  • Group 类: 支持群组搜索功能
  • User 类: 支持根据邮箱/手机号获取用户ID
  • AccessToken 类: 自动获取和管理访问令牌
  • ServiceProvider: Laravel 服务提供者
  • 枚举类型: 完整的类型安全支持
  • 异常处理: 完善的错误处理机制

技术特性 ​

  • PHP 8.1+ 支持
  • 使用 Guzzle HTTP 客户端
  • PSR-12 编码标准
  • 完整的 PHPDoc 注释
  • Pest 测试框架
  • PHPStan 静态分析

文档 ​

  • 完整的使用指南
  • 详细的 API 参考文档
  • 丰富的示例代码
  • Laravel 集成指南
  • 配置指南
  • 常见问题解答
  • 贡献指南

版本说明 ​

我们使用 Semantic Versioning 进行版本管理：

  • MAJOR: 不兼容的 API 修改
  • MINOR: 向下兼容的功能性新增
  • PATCH: 向下兼容的问题修正

支持版本 ​

版本支持状态PHP 版本要求
1.x✅ 活跃支持8.1+

升级指南 ​

从 0.x 升级到 1.0 ​

1.0 是第一个正式版本，没有之前的版本需要升级。

贡献者 ​

感谢所有为这个项目做出贡献的开发者！

许可证 ​

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

Released under the MIT License.

Copyright © 2024-present YuXin Zhai