用途:X Bug Triage 用于在有限范围内采集公开 X 数据,并演示仓库中已实现的本地启发式、合成证据、路由、草稿与解析等契约。它明确区分实时 X 事实、本地启发式输出、合成记录与操作者提供的数据,不把桩实现当作生产集成。
主要能力:六个 X 采集工具会发起真实的、需认证的 X API v2 请求;本地 Bun 库实现确定性解析、脱敏、启发式评分、去重、聚类与 SQLite 辅助。仓库没有统一运行器把这些库连接到 MCP 采集。仓库扫描、路由和建单是契约桩;Slack 投递与自动严重度计算不存在。
使用方式:先安装依赖并启动内置 triage MCP 服务器;在 MCP 进程环境中设置 X_BEARER_TOKEN,绝不打印。使用账户或搜索工作流前,需先填充已批准账户/搜索;已提交的搜索列表与 surface-to-repo 映射为空。本地持久化前,先选择并备份显式数据库。运行前声明模式:实时采集、离线库测试或契约演示。实时采集需确认公开账户、时间窗口与页数上限,解析用户名后获取提及,max_pages 不超过 8;只运行 approved-searches.json 中已有的命名查询,不创建任意实时搜索;仅对有限样本中选定的具体 ID 获取对话或引用帖。报告端点警告、部分结果与速率限制元数据。
限制:401、429、超时或服务器错误可能返回空/降级结果而非抛出。默认不持久化原始结果;如需本地处理,使用 bug-clustering 并在存储前验证脱敏。分类与可靠性值仅为固定启发式,不是事实或身份检查。repo-scanning 仅作合成 schema 输出,从不查询 GitHub;owner-routing 当前处理器不返回 owner;create_draft_issue 从提供的 cluster JSON 生成文本;check_existing_issues 仅比较调用方提供的标题;confirm_and_file 不建单,返回带 issues/NEW 哨兵 URL 的模拟回执;parse_review_command 仅验证语法,从不执行请求动作。不得基于这些原型回执对真实问题建单、关闭、合并、路由或升级;不得声称六类敏感数据全部被检测,脱敏基于模式;不得因报告者可靠性低而忽略安全、隐私、计费或数据丢失报告;未经明确批准不得运行 bun run db:reset,它会删除配置的数据库。