WechatFerry_Freshjiaaa

一个面向个人微信用户的本地自动回复管理工具。它使用 Windows 桌面微信作为桥接入口，通过 WeChatFerry / wcferry 接收消息、执行规则匹配，并在本地网页里完成联系人 allowlist、规则、额度和日志管理。

本项目基于 WeChatFerry 生态和 wcferry Python 客户端能力扩展完成，核心微信连接能力归功于原 WeChatFerry 项目及其贡献者。本仓库主要提供一个面向普通个人微信场景的本地管理台、规则引擎、额度控制和安全默认配置。

功能

• 本地 FastAPI 服务和移动端友好的网页控制台。
• 关键词、精准词、正则、任意消息规则。
• 支持多关键词分隔：分号、逗号、顿号或换行。
• 支持分支会话状态，例如主菜单后 10 分钟内继续选择分支。
• 联系人搜索、批量加入 allowlist、单个好友启用/暂停。
• 每个真实好友和全局每日回复额度。
• 文件传输助手自测不占用真实好友额度。
• SQLite 本地存储，不上传联系人、聊天记录或配置。
• Windows 一键安装依赖、启动服务、运行环境检查脚本。

安全默认值

• 自动回复默认关闭。
• 未加入 allowlist 的联系人默认不回复。
• 自己发给普通好友或群的消息不触发自动回复。
• 文件传输助手仅作为本地测试例外。
• 无群发、无联系人采集、无绕过登录流程。
• 所有日志保存在本机 SQLite 数据库中，data/ 不应提交到公开仓库。

运行环境

• Windows
• Python 3.10+
• WeChatFerry / wcferry 兼容的 Windows 桌面微信版本
• 已手动登录的个人微信账号

WeChatFerry 对微信版本比较敏感。如果网关无法连接，优先确认当前桌面微信版本与 wcferry 版本是否匹配。

快速开始

cd WechatFerry_Freshjiaaa
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple
python -m app.main

如果 PowerShell 禁止运行 .ps1，可以用批处理：

install-deps.bat
start-server.bat

检查运行时：

check-runtime.bat

打开管理页：

http://127.0.0.1:8787

同一局域网手机访问：

http://你的电脑局域网IP:8787

基础配置流程

1. 打开 Windows 桌面微信，手动扫码登录个人微信。
2. 启动本项目服务。
3. 打开管理页，点击 Start 连接 WeChatFerry。
4. 用 Contacts 搜索联系人，加入 Allowlist。
5. 新建 Rule，配置触发条件和回复内容。
6. 先在 Test 面板验证规则。
7. 打开 Auto reply 开关。

目录

app/
  main.py          FastAPI API
  db.py            SQLite schema and repository
  rule_engine.py   Deterministic matching engine
  wcf_adapter.py   WeChatFerry / wcferry adapter
  worker.py        Background receive/reply worker
  static/          Web console
docs/
  usage-zh.md      中文使用说明
scripts/
  *.ps1, *.bat     Windows helper scripts
tests/
  unittest tests
data/
  runtime SQLite files, ignored by git

发布前隐私检查

公开到 GitHub 前，请确认没有提交以下内容：

• .venv/
• data/*.sqlite3
• logs/
• injector.log
• 真实 wxid、好友备注、聊天记录
• 本机绝对路径
• GitHub token、API key 或其他密钥

本通用版已排除运行数据库、日志和虚拟环境。

致谢

Based on and inspired by the WeChatFerry project.

Thanks to the original WeChatFerry authors and contributors for the underlying personal WeChat bridge capability. This repository adds a local personal auto-reply console and rule workflow on top of that ecosystem.

License

The upstream WeChatFerry project is MIT licensed. Keep the original license and attribution when redistributing derivative work. Add your own license terms only if they are compatible with the upstream license.