用途:在 Linear 集成出现失败需要可复现证据时,组装最小化且脱敏的诊断包,供内部或供应商升级使用;除已请求的实现外,诊断保持只读。
主要能力:收集操作名称、时间戳、状态、GraphQL 错误码与路径、SDK 版本、脱敏后的速率头、webhook 投递 ID 等允许字段;通过 Read、Glob、Grep 检查代码与配置,WebFetch 仅用于 Linear 官方文档与包元数据;在已知目标文件时才使用 Write/Edit。
使用方式:先确定接收方、目的、事件时间窗与已批准的数据类别;记录包与运行时版本、端点主机、认证模式(不含令牌)及最小失败操作名;只提取白名单字段;脱敏 authorization、cookie、密钥、含令牌 URL、GraphQL 变量、issue 文本、评论、邮箱与用户名;发送前审查清单并抽样每个文件;记录接收方、保留期限、删除责任人与安全传输渠道。
认证:个人 API 密钥仅用于所有者控制的脚本,Authorization: <API_KEY>;用户委派应用用 OAuth 加 PKCE,Authorization: Bearer <ACCESS_TOKEN>;已批准的自动化可用客户端凭据授权。凭据存于批准的密钥管理器。
限制:未经责任所有者明确批准,不得创建、泄露、轮换或吊销凭据,不得授权 OAuth 应用、更改作用域或团队访问、变更工作区数据、配置或重新启用 webhook、导入导出数据、更改角色/SCIM/审计流、传输诊断、变更付费权益或执行其他生产变更。若被要求无限制环境转储应拒绝;若需原始负载,用合成复现或所有者批准的最小摘录;检测到密钥应停止、必要时轮换、清理并重新审查;接收方不明确时保留在本地不传输。