agentleFS
ykjshenzhen2008-ship-itykjshenzhen2008-ship-it/commercial-real-estate-skills/skills/wechat-manager/SKILL.md

wechat-manager

Skill0 starsChanged 35 days agoMITView on GitHub

本地只读微信聊天管理。自动识别 Windows / macOS,按当前系统选择不同本地只读后端,用自然语言查询"看看微信 / 谁找我 / 某群聊了什么 / 搜索关键词 / 导出记录"。严格只读、本地、可验证、失败不编造。

The file

Files
SKILL.md

wechat-manager

统一 WorkBuddy 微信本地只读管理能力。上层自然语言统一,底层取钥与数据库读取按操作系统分流。

安全边界(第一原则,永远优先)

本 Skill 使用第三方开源工具,不是腾讯/微信官方功能。仅允许在:自己的电脑、自己的微信账号、最小范围数据 中测试。

  • 只允许:读取、搜索、分析、总结、统计、导出。
  • 禁止:自动发送/回复、修改/删除/撤回消息、增删联系人、改群、自动点击、上传数据库/密钥/masterkey/完整聊天历史、为排错向 AI 粘贴密钥或 all_keys.json 内容。
  • 出现错误:先停下来保留错误,不要为"跑通"而反复 init、降级微信、关闭系统安全机制或泄露密钥。
  • 永远不报告密钥内容(见 references/privacy.md)。

后端选择规则(第十三节)

macOS
├─ 已有有效 ~/.wechat-cli 历史配置 → 直接复用,不 init
├─ 无历史配置 → 原 wechat-cli 首次 init 仅尝试一次
│   ├─ 成功 → 使用 wechat-cli
│   └─ 0 keys / 提取失败 → 停止旧路线
└─ 用户明确同意高级模式 → 重签名 + 重启 + sudo init(见第十节安全门)

Windows
└─ 优先课程实测版 wcdb_key_tool_windows.py
    → readonly_config_cipher_scan → HMAC → 本地快照 → wechat_local.py → 真实验收

操作系统识别

入口 scripts/backend_router.py 自动识别 platform.system():

  • Windows → 调用 scripts/wechat_local.py(Windows 快照查询层)
  • Darwin(macOS) → 调用 scripts/wechat_cli.py(wechat-cli 查询层)
  • 其他 → 停止,不套用任一平台方法

自然语言 → 命令映射(第十四节)

用户意图macOS (wechat-cli)Windows (wechat_local.py)
最近消息sessions读快照最近会话
未读/新消息unread / new-messages最近 N 小时新增(不冒充真实未读)
搜索search "关键词"search
历史history "聊天名"history
导出export "聊天名" --format markdownexport

统一命令(经 backend_router 转发):

python scripts/backend_router.py doctor
python scripts/backend_router.py sessions --limit 3
python scripts/backend_router.py history --chat "名称" --limit 20 --hours 24
python scripts/backend_router.py search --keyword "词" --chat "名称" --hours 168
python scripts/backend_router.py export --chat "名称" --format markdown --output out.md
python scripts/backend_router.py unread

大量消息处理(第十五节)

超过约 200 条:本地读取 → 存临时文件 → 分段 → 分别摘要 → 合并结论。优先总结:主要讨论、重要信息、与用户相关、需回复、时间敏感、客户反馈、Bug、建议、文件/链接、待办;降低:表情刷屏、重复、寒暄、系统通知、纯闲聊。

成功标准(第三/十八节)

至少完成真实验收:doctor 通过、能列真实会话/群、history 返回≥1条真实消息、search 返回真实匹配。不能因"安装成功/找到数据库/找到密钥"就宣布完成。

最终只返回(禁报密钥):

系统 / CPU架构 / 微信版本 / 后端 / 是否复用历史配置 /
密钥验证 / 本地数据库或快照可读取 / Skill路径 / 已验证能力 / 最终状态 READY|NOT READY

依赖

  • macOS:需 wechat-cli(@canghe_ai/wechat-cli,且已通过 init 取得 ~/.wechat-cli/all_keys.json)。
  • Windows:需 wcdb_key_tool_windows.py + Python + 固定依赖(见课程 install_windows.ps1)。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.