前言¶

处理 QQ 聊天记录时，常见的做法是自己写脚本解析数据库、再拼一套查询命令，过程中还要反复处理编码、路径和导出格式。下面介绍的这个 Skill 把这类操作打包成一个可直接调用的技能：Agent 拿到用户的自然语言需求后，转成 qq-cli 命令执行，把结果整理后返回。

这是什么¶

这个 Skill 名为「读取和分析 qq 聊天记录」，坐标为 @user_de02a30f/qq-cli，由社区开发者 user_de02a30f 发布并维护，属于 community 来源，分类为 dev-programming，当前版本 1.4.0。

它解决的问题是：在 Agent 对话过程中，帮用户查看、搜索、导出或分析自己的 QQ 消息、好友和群聊，而不需要用户自己去记命令行参数。

它基于通用的 SKILL.md 格式，不需要 API Key（页面标签为 requires_api_key=false）。

核心功能¶

根据官方页面给出的简介，这个 Skill 的能力范围是：

• 查看 QQ 消息、好友、群聊
• 搜索消息
• 导出消息
• 分析聊天记录

实现方式是通过 qq-cli 这个命令行工具完成实际读写。Skill 本身负责理解用户意图并组织调用，属于命令行能力的封装层。

安装与启用¶

已抓取的资料中没有给出安装命令、目录约定或配置字段，因此这里不推测具体的安装步骤。

可以直接确认的两点：

• 使用前需要本机已经具备可用的 qq-cli，Skill 是否附带该工具的安装说明，需要到官方页面核对。
• 该 Skill 标注为不需要 API Key，启用时不必准备密钥。

页面地址为 https://www.skillhub.cn/skills/user_de02a30f/qq-cli ，API 地址为 https://api.skillhub.cn/user_de02a30f/qq-cli 。安装方式请以这两个地址当前的内容为准。

典型用法¶

官方简介中给出的调用场景是：当用户想查看、搜索、导出或分析 QQ 消息、好友、群聊时调用此技能。

也就是说，触发方式是直接描述需求，例如「帮我看看上周某个群里的消息」「导出和某个好友的聊天记录」。具体的命令参数和输出格式在已抓取资料中没有列出，这里不补写。

适用场景与注意¶

适合的场景：需要在 Agent 对话里快速查 QQ 消息、整理群聊记录、把聊天内容导出成文件或做统计。

需要注意的几点：

1、聊天记录属于本地敏感数据，Skill 会在本机执行 qq-cli 读取本地数据库，使用前应确认环境安全、授权范围清楚。
2、该 Skill 来自 community 来源，功能正确性和 qq-cli 本身的稳定性由发布者维护，接入前建议先在测试环境验证。
3、页面显示评分 100000、下载 2187 次、安装 0 次（抓取时间 2026-10-30），下载量不高意味着可参考的公开使用反馈较少，踩坑时可能需要自行排查。
4、qq-cli 的可用性依赖 QQ 客户端的数据导出方式，客户端版本更新可能导致路径或格式变化。

结尾¶

这个 Skill 的价值在于把「读 QQ 聊天记录」这件事从手写脚本变成一句自然语言指令，适合已经在用 Agent 处理本地数据、又不想自己维护解析脚本的开发者。它的能力边界取决于 qq-cli，安装和参数细节请以官方页面为准。

官方地址：https://api.skillhub.cn/user_de02a30f/qq-cli