Linear SDK 41.0.0版本发布：客户状态管理与AI增强功能升级

Linear是一款现代化的项目管理工具，专注于为技术团队提供简洁高效的issue跟踪和工作流管理解决方案。其SDK为开发者提供了与Linear平台深度集成的能力，支持构建自定义工作流和扩展功能。

重大变更与架构调整

本次发布的41.0.0版本对客户状态管理进行了重构，移除了按类型分组的机制。CustomerStatus.type字段从必填类型变更为可选类型，并标记为废弃状态。这一变更反映了产品设计思路的转变，客户状态不再需要强制分类，为业务场景提供了更大的灵活性。

Dashboard模块的布局系统进行了简化，移除了layout字段，转而采用更直观的sortOrder排序机制。这种设计变更降低了实现复杂度，同时保持了用户体验的一致性。

在Mutation操作方面，customerNeedUpdate的返回类型从CustomerNeedPayload变更为CustomerNeedUpdatePayload，为后续扩展预留了空间。

新增功能与增强

智能建议系统

本次更新引入了全面的智能建议功能，为issue管理提供了AI驱动的辅助决策能力：

• 新增了hasSuggestedAssignees、hasSuggestedLabels等过滤条件，支持快速查找有待处理建议的issue
• 扩展了Issue模型，新增suggestions和incomingSuggestions字段，支持双向建议追踪
• 定义了完整的IssueSuggestion类型体系，包括状态机(IssueSuggestionState)和类型分类(IssueSuggestionType)

项目标签收藏功能

在Favorite系统中增加了projectLabelId支持，用户现在可以将项目标签加入收藏，快速访问常用分类。这一功能通过新增的projectLabel字段实现关联查询。

客户状态管理API

全新设计了客户状态管理接口：

• 新增CustomerStatusCreateInput和CustomerStatusUpdateInput输入类型
• 提供customerStatusCreate、customerStatusUpdate等Mutation操作
• 引入displayName字段替代原有的类型分类机制

Salesforce集成增强

扩展了集成能力，新增Salesforce专用支持：

• 增加attachmentLinkSalesforce Mutation操作
• 定义SalesforceSettingsInput配置类型
• 在通用集成设置中添加Salesforce配置项

组织与权限管理改进

组织级配置新增了多项控制选项：

• aiAddonEnabled：启用/禁用AI附加功能
• restrictLabelManagementToAdmins：限制标签管理权限仅限管理员
• personalApiKeysEnabled：控制个人API密钥的生成权限

项目模型新增facets字段，支持多维度的项目属性分类和筛选。同时扩展了项目过滤条件，新增activityType支持，便于按活跃度分类查询。

开发者体验优化

统一了OAuth应用的actor模式命名，将文档中的actor=application更新为更简洁的actor=app表述。同时完善了各类create操作的createAsUser和displayIconUrl参数的文档说明。

用户模型新增gitHubUserId字段，增强了第三方账号体系的集成能力。废弃了不再使用的inviteHash字段，清理了过时功能。

技术架构演进

本次更新反映了Linear平台向智能化、集成化方向的发展趋势：

1. AI深度集成：通过智能建议系统将机器学习能力融入核心工作流
2. 状态管理简化：用更灵活的客户状态模型替代原有的严格分类体系
3. 扩展性增强：新增的facet系统和集成选项为复杂业务场景提供支持
4. 开发者友好：统一的命名规范和更完善的文档提升集成体验

这些变更既保持了API的稳定性，又为未来的功能扩展奠定了坚实基础。开发者可以基于这些新特性构建更智能、更贴合业务需求的定制化解决方案。