SuperAPI AI 工具集

open-knowledge-bug-report

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:当用户反馈 OpenKnowledge(OK)出现问题、请求排障协助,或希望提交缺陷报告时,该技能指导智能体采集一份结构化诊断包,便于定位问题。

主要能力:运行 ok bug-report 命令后,会从 ~/.ok/logs/ 收集 NDJSON 格式(pino)日志;若在 OK 项目目录中执行,则按项目过滤日志;收集系统信息,包括 OK 版本、Node/Bun 版本、macOS 版本、语言环境、时区、可用磁盘空间;在存在项目上下文时收集锁目录内容(server.lock、spawn-error-log);从桌面日志中提取最近的 IPC 错误记录;对所有内容执行自动脱敏;写出 ~/.ok/bug-reports/<timestamp>-bugreport.zip 并把路径打印到 stdout。压缩包内含 MANIFEST.json(清单与脱敏审计)、sysinfo.json、README.md、logs/、lockdir/(如有项目)、recent-ipc-errors.json(最近 50 条结构化 IPC 错误)。

使用方式:快速路径执行 ok bug-report --no-reveal;--no-reveal 用于抑制 Finder 弹出,适合智能体场景,因为需要的是文件路径而非 Finder 窗口。智能体工作流:在用户项目目录(无项目则在主目录)运行该命令,从 stdout 读取路径,解压到临时目录(unzip -o <path> -d /tmp/ok-diag-<timestamp>/),先读 MANIFEST.json 查看 redactions 数组,再读 sysinfo.json 检查版本、磁盘空间与构建渠道,用 grep '"level":50' logs/*.log | head -20 找错误(pino 中 level 50 表示 error),并阅读 recent-ipc-errors.json 排查 IPC 层故障,最后向用户报告发现与可执行的后续步骤。

限制与版本要求:ok bug-report 随 @inkeep/open-knowledge >= 0.7.0 提供。若用户版本较旧,可用 ok --version 检查;低于 0.7.0 时建议 npm install -g @inkeep/open-knowledge@latest 更新;备用方案是手动检查 ~/.ok/logs/ 中最近的 .log 文件(NDJSON,可 grep)。隐私方面,压缩包会自动脱敏 macOS 主目录路径、GitHub PAT 前缀(ghp_、gho_、ghu_、ghs_、ghr_)、AWS 访问密钥、Anthropic 与 OpenAI 令牌、Bearer 授权头;MANIFEST.json 的 redactions 数组会列出每个被清理的文件与模式,用户可安全地将该包附到 GitHub issue。