技能介绍

要解决的真实问题

很多人习惯用微信随手记待办、想法或零散信息，但消息会沉到聊天列表底部，过段时间就找不到；想按标签分类、查历史或做简单统计（比如这周记了多少工作相关的事项），只能靠翻聊天记录，费时费力。开发者想做一个能和微信对话交互的记事本工具时，要么用UI自动化工具碰微信个人号协议，面临封号风险；要么选跨平台方案但依赖Node.js生态，对快速落地不友好；要么自建后端，又要处理消息加解密、公网回调等一堆琐事。

技能如何工作

WeChat NoteBuddy 基于企业微信官方API构建，采用五层分层设计，内置一套经过测试的企业微信工程骨架，覆盖消息加解密、主动发消息、存储、统计全链路。核心流程是：

消息适配层：用 bot/enterprise_adapter.py 处理企业微信的消息加解密和API调用；
意图识别层：解析用户指令，比如 记一下：明天要交方案 识别为“记录”，标签工作下周评审 识别为“带标签记录”；
存储层：用SQLite存储消息原文，支持自动打标签，同时生成Markdown备份；
统计层：对记录的事项按日、标签、时段聚合，生成统计报告；
路由层：用FastAPI做回调入口，处理企业微信推送的消息，返回对应结果。

用户给应用发消息后，系统按意图自动处理：记一下：xxx写入SQLite并自动打标签，统计本周生成按日聚合的Markdown报告，找一下 xxx做全文搜索，删除第N条软删除记录，帮助返回指令菜单。所有数据都存本地SQLite，日志只保留脱敏元数据，不记录消息原文。

适用边界与注意点

若需长期稳定使用，必须选企业微信方案——这是官方API，合规无封号风险；wxauto或Wechaty基于个人号模拟登录，仅适合用小号快速尝鲜，绝不能用主号或用于生产。
需准备企业微信的自建应用凭证（corpid、corpsecret、agentid）和回调Token/EncodingAESKey，且公网要能通过HTTPS访问回调地址（可用内网穿透或反代）。
适合个人或小团队做轻量记事本工具，不支持多用户协同或大型知识库管理——这是为个人自用设计的，不是企业级方案。