Linear SDK v45.0.0 发布：项目管理和协作工具的重大更新

Linear 是一款现代化的项目管理与协作工具，专为软件开发团队设计。它提供了简洁直观的界面，帮助团队高效地跟踪任务、管理项目和规划工作流。Linear SDK 则是开发者与 Linear API 交互的重要工具包。

本次发布的 Linear SDK v45.0.0 版本带来了多项重要更新，主要集中在项目管理和工作流自动化方面的功能增强。以下是对本次更新的技术解析：

核心变更

1. 项目管理体系重构

本次更新对项目管理相关的数据结构进行了重大调整：

• 移除了 ProjectNotification 类型中的 initiative 和 initiativeUpdate 字段
• 新增了 InitiativeNotification 类型，包含 comment、document、initiative 等字段
• 为 CustomView 类型增加了 facet 和 updates 字段

这些变更反映了 Linear 正在重构其项目管理体系，将"计划(initiative)"和"项目(project)"的概念更加清晰地分离。

2. 代理(Agent)功能增强

SDK 引入了全新的代理相关类型，为自动化工作流提供了更强大的支持：

• 新增了 AgentActivity 及相关类型，用于跟踪代理活动
• 增加了 AgentContext 类型，支持代理上下文管理
• 提供了 agentActivityCreate、agentContextCreate 等新的 Mutation 操作

这些功能使得开发者能够更好地构建基于 Linear 的自动化工作流和智能代理。

3. 项目标签系统完善

项目标签功能从"内部"状态转为正式功能：

• 新增了 ProjectLabelCreateInput、ProjectLabelPayload 等类型
• 提供了完整的 CRUD 操作接口
• 增加了 lastAppliedAt 字段跟踪标签使用情况
• 支持标签层级关系（通过 children 字段）

这使得项目分类和组织能力得到显著提升。

其他重要改进

1. 邮件接收功能增强

• 新增了 EmailIntakeAddressType 枚举
• 增加了邮件转发地址、发件人名称等配置选项
• 支持 SES 域名身份验证

2. 排序与过滤优化

• 为各种资源类型新增了丰富的排序选项
• 增强了过滤能力，特别是对子团队、子计划的支持
• 改进了自定义视图的查询能力

3. 通知系统改进

• 新增了 feed 通知类别
• 完善了各类通知的关联数据
• 改进了通知偏好设置

向后兼容性说明

本次更新包含了一些破坏性变更，主要涉及：

• 移除了 ProjectNotification 中的字段
• 部分内部功能转为公开API
• 部分已弃用接口标记为DEPRECATED

开发者升级时需要注意检查相关变更对现有代码的影响。

总结

Linear SDK v45.0.0 通过重构项目管理体系、增强代理功能和完善标签系统，为开发者提供了更强大的项目管理能力。这些改进使得 Linear 不仅是一个任务跟踪工具，更成为一个完整的项目协作平台。对于正在使用或考虑使用 Linear 的团队来说，这次更新值得关注和评估。