claudeers.
// Integrations & Connectors

signal-vaults

WeChat group & official-account AI knowledge digest — agent-friendly (Codex/Claude Code), Windows/macOS/Linux

// Integrations & Connectors[ cli ][ api ][ claude ]#claude#integrations◷ Apache-2.0$open-sourceupdated 29 days ago
Actively maintained
100/100
last commit 21 days ago
last release 28 days ago
releases 1
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up signal-vaults (claude-skill project) into my current project.
Found on https://claudeers.com/signal-vaults
Repo: https://github.com/JackyCufe/signal-vaults
Homepage/docs: —
Detected install method: claude-skill → # copy this skill into .claude/skills/signal-vaults/
Category: integrations. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/signal-vaults/   (or ~/.claude/skills/signal-vaults/ for all projects)
// or clone
git clone https://github.com/JackyCufe/signal-vaults

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Signal Vaults

微信群 / 公众号 AI 知识日报 — 本地解密微信数据库 → LLM 提炼知识 → Discord/终端输出。

为 AI Agent(Codex / Claude Code / 任何 CLI Agent) 设计:单命令运行、环境变量配置、JSON 中间产物、零交互。

解密与密钥提取基于 wechat-cli-plus(Apache-2.0),支持 微信 4.1.x,跨 Windows / macOS / Linux 三平台。本仓库在其上实现日报业务层。


它做什么

命令功能
signal-vaults doctor环境自检:数据目录 / 密钥 / LLM / 推送配置
signal-vaults groups [关键词]列出群与会话(供 Agent 选择目标群)
signal-vaults daily [days] [群...]群聊知识日报:分片 LLM 提炼 → 知识点 + 术语科普 + 资源链接,带缓存与重试
signal-vaults mp [days]公众号文章日报:抓取推送 → LLM 写推荐语 → 输出
signal-vaults hn [days]Hacker News 日报:官方 API 拉取 → LLM 精选 → 推送(免费,无需 key)
signal-vaults reddit [days] [r/子版块...]Reddit 日报:Atom RSS 拉取 → LLM 精选 → 推送(需 REDDIT_PROXY/PUSH_PROXY)

输出默认写到 work/know_*.txt;配置了 Discord 环境变量则同时推送(含图片附件与 embed 卡片)。

快速开始

# 0) 前置:微信桌面端已登录过、数据库在本机(微信进程无需常驻)
pip install git+https://github.com/maomao3334/wechat-cli-plus.git

# 1) 提取数据库密钥(微信需处于登录状态;Windows 直接跑,macOS/Linux 需 sudo)
wechat-cli init
#    生成 ~/.wechat-cli/all_keys.json + config.json(数据目录自动检测)

# 2) 安装本工具
pip install .

# 3) 配置 LLM(任何 OpenAI 兼容端点)
export LLM_API_KEY=sk-xxx
export LLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4   # 智谱示例
export LLM_MODEL=glm-4-flash

# 4) 自检 + 运行
signal-vaults doctor
signal-vaults daily 1 "Agentic" "Data Go"     # 群名支持模糊匹配,先 signal-vaults groups 看列表
signal-vaults mp 3                            # 公众号日报
signal-vaults hn 1                            # Hacker News 日报
signal-vaults reddit 1 LocalLLaMA programming # Reddit 日报(指定子版块)
signal-vaults feishu                          # 飞书 Bot 守护(WS 长连接,群里发"日报"触发)

环境变量

变量必填说明
LLM_API_KEY✅OpenAI 兼容 API Key
LLM_BASE_URL默认智谱 https://open.bigmodel.cn/api/paas/v4;DeepSeek: https://api.deepseek.com/v1
LLM_MODEL默认 glm-4-flash
LLM_PROXY可选代理 http://127.0.0.1:7897
SIGNAL_VAULTS_DB_DIR微信 db_storage 目录(默认自动检测)
SIGNAL_VAULTS_KEYS_FILE密钥文件(默认 ~/.wechat-cli/all_keys.json)
SIGNAL_VAULTS_WORK_DIR工作目录(默认 ./work)
DISCORD_BOT_TOKEN / DISCORD_CHANNEL_ID配置后自动推送 Discord
PUSH_PROXYDiscord 推送代理(默认跟随 LLM_PROXY)
FEISHU_APP_ID / FEISHU_APP_SECRET配置后启用飞书 Bot(WebSocket 长连接,可双向交互,与 Discord 可并存)
FEISHU_TARGET_CHAT指定接收日报的飞书群 chat_id(可选)
SIG_VAULTS_TOPIC / SIG_VAULTS_STYLE日报主题聚焦与摘要风格定制(对所有信息源生效)
REDDIT_PROXYReddit 拉取代理(缺省回落 PUSH_PROXY)

📷 从零配置 Discord Bot(拿 Token、开 Intent、邀请进服、拿频道 ID):见 docs/discord-setup.md 手把手图文教程。

平台兼容性

平台密钥提取 (wechat-cli init)本工具备注
Windows✅✅微信 4.1.x Config.Cipher 扫描
macOS✅(需 sudo)✅数据目录:~/Library/Containers/com.tencent.xinWeChat/...
Linux✅(需 sudo)✅

跨平台差异(数据目录检测、路径分隔符、附件目录结构)由上游 wechat-cli 统一处理;本仓库只做业务层,无平台分支代码。

🤖 Agent 启动提示词

把下面这段直接发给 Codex / Claude Code 等 Agent,它就能从零跑通:

任务:用 signal-vaults 生成本机微信群的知识日报。

步骤:
1. 环境自检:运行 `signal-vaults doctor`。任何 [!!] 项按提示修复:
   - 缺数据目录 → 确认微信已在本机登录过,或设 SIGNAL_VAULTS_DB_DIR 指向 db_storage
   - 缺密钥 → 运行 `wechat-cli init`(微信需登录状态;macOS/Linux 加 sudo)
   - 缺 LLM_API_KEY → 向用户索要,或读取本地 .env 文件
2. 选群:运行 `signal-vaults groups` 查看群列表(或 `signal-vaults groups 关键词` 模糊搜索)。
3. 生成日报:`signal-vaults daily <天数> "<群名1>" "<群名2>"`;公众号用 `signal-vaults mp <天数>`。
4. 结果在 work/know_*.txt(Markdown),已配置 Discord 则同时推送。
5. 故障处理:
   - LLM 超时 → 脚本自带 3 次重试;连续失败检查 LLM_BASE_URL/网络代理
   - 首次运行慢属正常(分片 LLM 调用),结果分片缓存在 work/parts/,重跑秒级
   - 解密报错 → 删 work/decrypted/ 重跑(会全量重解)
不要做的:不要读取或上传 all_keys.json、不要修改 ~/.wechat-cli/、不要把聊天记录发给用户以外的服务。

安装为 Agent 技能(可选)

仓库根目录自带 SKILL.md(Agent 可读的使用说明书)。默认不注册——想手动注册时按需复制:

# Codex(注册为全局技能,任意目录可用)
mkdir -p ~/.agents/skills && cp SKILL.md ~/.agents/skills/signal-vaults-SKILL.md

# Claude Code
mkdir -p ~/.claude/skills/signal-vaults && cp SKILL.md ~/.claude/skills/signal-vaults/SKILL.md

不装技能也行:直接把上面的「Agent 启动提示词」粘给 Agent 即可,零安装。

架构

signal_vaults/
├── config.py     # 环境变量配置层(零硬编码、零敏感信息)
├── llm.py        # OpenAI 兼容 /chat/completions(标准库实现,无 SDK 依赖)
├── collector.py  # SQLCipher 解密(mtime增量) + 会话定位 + 消息/图片/文件/公众号提取
├── daily.py      # 分片 LLM 提炼(≤1800字符/片+缓存+重试) + 合并去重 + Discord multipart 推送
└── cli.py        # doctor / groups / daily / mp 四个子命令

性能与缓存

  • 解密:~120 MB/s,mtime 增量跳过(日常 <1s,全量 ~5s)
  • LLM:每片 ≤1800 字符(规避网关非流式超时),分片结果持久缓存于 work/parts/,失败不缓存(下次自动重试)
  • 日常增量运行 25 分钟;冷启动 68 分钟

免责声明

本项目仅用于处理本人自己设备上的微信数据(个人知识管理)。请勿用于监控他人、批量采集或任何违反微信使用条款的场景。密钥文件(all_keys.json)等同于聊天记录的访问凭证,切勿提交到版本库或分享给他人。

License

Apache-2.0(继承上游 wechat-cli-plus)

// faq

What is signal-vaults?

WeChat group & official-account AI knowledge digest — agent-friendly (Codex/Claude Code), Windows/macOS/Linux. It is open-source on GitHub.

Is signal-vaults free to use?

signal-vaults is open-source under the Apache-2.0 license, so it is free to use.

What category does signal-vaults belong to?

signal-vaults is listed under integrations in the Claudeers registry of Claude-compatible tools.

10 views
★ 75 stars
unclaimed
updated 29 days ago

// embed badge

signal-vaults on Claudeers
[![Claudeers](https://claudeers.com/api/badge/signal-vaults.svg)](https://claudeers.com/signal-vaults)

// retro hit counter

signal-vaults hit counter
[![Hits](https://claudeers.com/api/counter/signal-vaults.svg)](https://claudeers.com/signal-vaults)

// reviews

// guestbook

0/500

// related in Integrations & Connectors

🔓

Use claude code and codex for free in the terminal, VSCode extension, and discord like OpenClaw (voice supported)

// integrationsAlishahryar1/⟨Python⟩★ 55,890◷ MIT[ claude ]
🔓

Bridge local AI coding agents (Claude Code, Cursor, Gemini CLI, Codex) to messaging platforms (Feishu/Lark, DingTalk, Slack, Telegram, Discord, LINE, WeChat…

// integrationschenhg5/⟨Go⟩★ 15,703[ claude ]
🔓

All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusli…

// integrationsPiebald-AI/⟨JavaScript⟩★ 12,829◷ MIT[ claude ]
🔓

Claude Code skill/plugin: immersive scroll-scrubbed 'fly through the world' landing pages generated with Higgsfield (Emons-style diorama flights, seamless co…

// integrationsoso95/⟨JavaScript⟩★ 9,673◷ MIT[ claude ]
→ see how signal-vaults connects across the ecosystem