把「贴日志 → 等人肉排障」变成「@ 一下 → 卡片报告」。以 Minecraft / 启动器 / 渲染器崩溃排障为主要场景,背后是带工具调用、知识库与学习记忆的多 Agent 系统,UI 为 WPF 托盘应用。
- 日志理解工具链:群文件 / LogShare 链接完整落盘(不省略中间),模型用
read_file(按行精读)、search_file(正则定位)、run_shell(白名单沙箱)自行取证,报告精确到行号 - Plan-Execute + Reflection:根因分析带自检评审;证据不足时列出还需补充的信息,不臆测
- 合并转发卡片:长报告按【结论】/【原因分析】/【解决方法】/【相关建议】分节渲染为一张转发卡片,失败自动回退普通发送
- 知识库 + 学习记忆:RAG 检索命中带引用编号回答;对话沉淀候选知识,审核后复用;会话自动切段摘要
- 多模态:群里发崩溃截图,直接看图定位问题
- 技能系统 + MCP:SKILL.md 指令型技能(渐进式披露)、HTTP 工具技能、标准 MCP 服务器
- 命令沙箱:白名单 / 黑名单 + 超时杀进程树 + 全量审计 + 路径守卫
- 用量统计:按日 × Provider × 模型 × 任务持久化聚合(上图仪表盘即真实数据)
- 多模型路由:Provider 优先链 + 故障切换 + 熔断,任意 OpenAI 兼容端点
git clone https://github.com/anylyralabs/LogAgent-for-QQ.git
cd LogAgent-for-QQ
dotnet build LogAgent.slnx
dotnet publish src/LogAgent.App/LogAgent.App.csproj -c Release -r win-x64 --self-contained -p:PublishSingleFile=true
./publish/win-x64/LogAgent.App.exe首次启动进入配置向导:填模型通道 → 选 QQ 接入方式 → 完成。
| 依赖 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 |
| .NET SDK | 10.0(仅构建需要;发布产物已内嵌运行时) |
| 模型端点 | 任意 OpenAI 兼容 API(本地代理 / 聚合平台 / 自建网关) |
| QQ 接入 | NapCat(OneBot 11)或 QQ 官方 Bot,二选一 |
- 源码构建:见上方快速开始
- 二进制安装包:见 Releases(首次发布后提供,当前请走源码构建)
模型通道在「模型路由」页添加,或直接编辑 %AppData%\LogAgent\config.json:
| 字段 | 含义 | 默认值 |
|---|---|---|
Endpoint |
OpenAI 兼容 API 地址 | — |
ApiKey |
鉴权密钥(仅存本机) | — |
ChatModel |
模型 ID | — |
ReasoningModel |
思考模型(推理 token 与输出共享预算,预算全量给足) | false |
ProviderChain |
任务级 Provider 优先链,按序故障切换 | — |
QQ 接入二选一:NapCat 反向 WS 填 ws://127.0.0.1:6701/onebot/v11/ws(端口可在「OneBot11」页改);官方 Bot 在 QQ 开放平台创建后填 AppID / AppSecret。
进阶配置(知识库、技能、MCP、沙箱白名单、触发规则)见 docs/03-快速上手.md。
群内 @ 机器人并发送日志链接:
@小炎 https://logshare.cn/AbCdEf 这个崩了帮我看看
机器人:抓取日志全文落盘 → search_file 搜崩溃标记 → read_file 精读崩溃区段 → run_shell 命令交叉验证 → 回复合并转发卡片:
📋 日志分析报告(文件:latest_game.log) ← 卡片首页(概览)
├ 【结论】原生图形层段错误,崩在 libng_gl4es.so
├ 【原因分析】SIGSEGV @ 202906 行(附原文证据)…
├ 【解决方法】1. 切换渲染器 …
├ 【相关建议】…
└ 【需要补充】hs_err_pid27662.log 完整堆栈
直接发崩溃截图也可以,机器人读图定位问题。
Q1:机器人 @ 了没反应? A:看「仪表盘」连接状态与「运行日志」页。高频原因:NapCat 反向 WS 地址不对、消息未命中触发规则(默认需 @)、模型 Provider 熔断中。
Q2:怎么换模型? A:「模型路由」页增删 Provider 并调整优先链,支持多厂商混布,切换无需重启。
Q3:run_shell 会不会乱执行命令?
A:沙箱默认启用——首 token 白名单(grep / findstr / type / python 等)、黑名单拦截危险命令、30 秒超时杀进程树、文件操作限制在数据目录内、全量审计。
Q4:长回复为什么没变成卡片? A:合并转发仅走 NapCat 通道;回复需含 ≥2 个分节标题(【结论】等或独立成行的裸标题),否则按普通消息发送。
Q5:数据都存哪?
A:%AppData%\LogAgent\——config.json 配置、data\ SQLite(会话/知识库/用量)、files\ 群文件暂存(7 天自动清理)。密钥只存本机。
LogAgent.App WPF 主程序(托盘 / 向导 / 功能页)
LogAgent.Core AgentRuntime / GroupContextAgent / LogAnalysisAgent
LogAgent.Connections OneBot11Connection / OfficialBotConnection / QrConnect
LogAgent.Routing 多模型路由(优先链 + 熔断 + 计量事件)
LogAgent.Knowledge 知识库(RAG + 审核流)
LogAgent.Memory 会话存储 / 学习提炼 / 模型用量持久化
LogAgent.Skills 技能注册 + 内置工具宿主(read_file / search_file / run_shell)
LogAgent.Sandbox 命令沙箱(白名单 + 审计 + 路径守卫)
LogAgent.Shared 消息模型 / 配置 / 提示词集中管理
tools/ docs/ 运维测试脚本 / 设计文档
设计细节见 docs/:构建工作流笔记 · 日志分析 Agent 规划 · 快速上手 · 分发与首启体验。
欢迎提 Issue 反馈问题、PR 参与开发;提交前请跑 dotnet test 确保用例通过。
本项目基于 MIT 发布——使用时请保留版权声明。
⚠️ 免责声明:本项目仅供学习研究。通过 NapCat 等非官方协议接入 QQ 存在账号风险,请自行评估;模型生成的内容不代表任何官方立场。
最近更新:2026-10-17 · v0.7.0

{ "Providers": [ { "Id": "my-model", "Endpoint": "https://<你的 OpenAI 兼容端点>/v1", "ApiKey": "<你的 API Key>", "ChatModel": "<模型 ID>", "ReasoningModel": false, "Enabled": true } ], "Rules": [ { "TaskType": "Chat", "ProviderChain": ["my-model"] }, { "TaskType": "LogAnalysis", "ProviderChain": ["my-model"] } ] }