用途:在构建或重构类型化 Linear 集成时,提供当前 Linear TypeScript SDK 的查询、变更、分页、原始 GraphQL 与错误处理模式,核心思路是把 SDK 机制限制在边界适配器内,对外暴露领域形状的结果,而非让生成的模型对象贯穿整个应用。
主要能力:当前 SDK 变更采用动词优先命名,如 createIssue、updateUser、archiveProject;连接暴露 nodes、pageInfo、fetchNext、fetchPrevious,可选变量以对象传入;linearClient.client.rawRequest 支持专用 GraphQL,LinearError 暴露解析后的请求、响应与错误证据。
使用方式:先检查已安装 SDK 版本、生成类型、适配器边界、调用点与错误策略;每个已批准认证上下文只创建一个客户端并注入,不在业务代码中到处构造;用领域函数包装 SDK 模型,接收稳定 ID 并返回最小类型投影;对每个连接显式分页,并为长时间同步暴露检查点;仅在能显著减少字段或扇出时使用原始 GraphQL,并保持操作名与变量类型化;将 LinearError 与 GraphQL 部分错误归一为可重试、终止、需对账三类结果。认证上,个人 API 密钥仅用于所有者控制的脚本,用户委托应用用带 PKCE 的 OAuth,已批准的自动化可用客户端凭据授予;个人密钥用 Authorization: <API_KEY>,OAuth 令牌用 Authorization: Bearer <ACCESS_TOKEN>,凭据存于服务端批准的密钥管理器。
限制:创建、泄露、轮换或撤销凭据,授权 OAuth 应用,更改范围或团队访问,创建、变更、归档或删除工作区数据,配置或重新启用 webhook,导入导出数据,更改角色、SCIM 或审计流,传输诊断信息,更改付费权益等生产变更,均需责任所有者明确批准;未请求实现时保持只读诊断。输出需包含工作区与团队范围、不含凭据值的认证模式、检查的文件与契约、确切操作名、证据、验证结果、已脱敏字段、剩余风险、责任所有者、批准状态及回滚或下一步。资料未提供具体价格、平台支持范围与效果数据。