Files

Claw e1fbd31c64 完整 AgentSkill：词库外部化 + 全部脚本/Skill 脱敏上传

- 高危词库从 process.py 抽到 config.toml [security] section
- process.py 改为 _get_high_risk_words() 动态加载（配置优先）
- 新增 15 个 QQ 操作脚本（已脱敏：QQ号/IP/Token → 占位符）
- 新增 8 个 SKILL.md（qq-messenger/management/resolver/napcat-extras 等）
- 新增 SKILL.md 入口（完整部署方案文档）
- 保留 SDK 框架（plugin_modules.py, file_store_api.py, package.py 等）

2026-05-04 16:23:59 +08:00

3.2 KiB

Raw Blame History

qq-resolver Skill

QQ 信息查询能力 — 群列表、好友列表、ID 转名称、历史消息回溯、文件接收。通过 NapCat (OneBot) HTTP API 直接查询。

什么时候用历史消息工具： 当用户提到某个话题、人物或事件，而你在当前 session 里找不到相关信息时，说明这个信息来自其他聊天（其他群/私聊），或者 session 重启过导致记忆丢失。这时应该调用 qq_get_history.py 查看相关群/私聊的历史消息来补全上下文。

脚本清单

所有脚本都在 YOUR_WORKSPACE_PATH/scripts/ 目录下。

脚本	调用方式	说明
`qq_get_groups.py`	`--json` `[--keyword 关键词]`	返回所有群聊列表
`qq_get_friends.py`	`--json` `[--keyword 关键词]`	返回好友列表
`qq_resolve_name.py`	`--uid <QQ号>` 或 `--gid <群号>`	QQ号/群号 ↔ 可读名称
`qq_get_history.py`	`--gid <群号>` 或 `--uid <QQ号>` `--num <条数>` `--json`	历史消息（时间倒序）
`qq_get_file.py`	`--file <file_id>`	下载文件到 `files/` 目录

用法

所有脚本用 subprocess.run(cmd, capture_output=True, text=True, timeout=10-15) 即可，输出直接读 result.stdout。

查群列表

python3 YOUR_WORKSPACE_PATH/scripts/qq_get_groups.py --json
python3 YOUR_WORKSPACE_PATH/scripts/qq_get_groups.py --json --keyword "我的世界"

查好友列表

python3 YOUR_WORKSPACE_PATH/scripts/qq_get_friends.py --json
python3 YOUR_WORKSPACE_PATH/scripts/qq_get_friends.py --json --keyword "张三"

解析 QQ 号 / 群号

python3 YOUR_WORKSPACE_PATH/scripts/qq_resolve_name.py --uid YOUR_ADMIN_QQ
python3 YOUR_WORKSPACE_PATH/scripts/qq_resolve_name.py --gid 812704915
python3 YOUR_WORKSPACE_PATH/scripts/qq_resolve_name.py --uid YOUR_ADMIN_QQ --uid 12345678 --gid YOUR_GROUP_ID

获取历史消息 ⭐ 回顾

python3 YOUR_WORKSPACE_PATH/scripts/qq_get_history.py --gid 812704915 --num 10 --json
python3 YOUR_WORKSPACE_PATH/scripts/qq_get_history.py --uid YOUR_ADMIN_QQ --num 20 --json

返回 [{ "time": "...", "sender_name": "...", "sender_card": "...", "message": "...", "message_type": "..." }]

什么时候该用：

用户说"上次我们聊到的那个事" → 查历史看看上次聊了什么
用户问"你还记得XX吗" → 你不记得，查历史
提到一个不熟悉的人/群 → 先查群列表/好友列表确定身份，再查对应聊天历史
session 刚启动时对之前对话没印象 → 主动查最近历史恢复认知

接收文件/图片 ⭐ 从QQ获取文件

python3 YOUR_WORKSPACE_PATH/scripts/qq_get_file.py --file <file_id>
python3 YOUR_WORKSPACE_PATH/scripts/qq_get_file.py --file <file_id> --info --json

执行后自动下载到 files/ 目录，输出：保存路径、文件名、大小、类型（图片/文件）。

注意： file_id 来自消息中的 [image:xxx.jpg] 或 [file:xxx.zip] 标记，冒号后面就是 file_id。

工作流程

遇到不认识的内容 → 查群列表/好友列表确定身份 → 查历史消息看上下文 → 回复用户

需要看文件内容（如图片识别、文档处理）→ 用 qq_get_file.py 下载到 files/ 目录后读取

3.2 KiB Raw Blame History