微信人格分身 xinghui2628/dsh-wechat-persona

dsh-wechat-persona

一个个人独立开发、免费开源、实验性的 DSH（DeepSeek Harness） 插件：让它按你配置的人格，在你指定的微信小号白名单单聊里，以拟人节奏被动回复消息。
与腾讯 / 微信官方没有任何关系。

当前版本：3.0.0-beta.1（开发者预览版 / Developer Preview，2026-11-01）上一个已发布版本：0.2.8 仓库属性：GitHub 仓库是 public（公开可见）；package.json 的 private: true 仅表示不发布到 npm，不改变仓库公开、也无法撤回公开的历史提交。历史隐私审计见 docs/PRIVACY-REVIEW-PRE-RELEASE.md。

⚠️ 使用前请先读 DISCLAIMER.md：自动化操作微信客户端违反《微信软件许可及服务协议》，可能导致账号被限制或封禁，风险由你自行承担；请只用你自己注册的小号，切勿用于主号、冒充真人、群发、营销、诈骗或读取他人数据。

1. 简介（beta 是什么、不是什么）

是什么

- 一个 DSH 插件，运行在你自己电脑上；配置、记忆、审计日志默认只存本机 dataDir。
- 只处理你在白名单里配置的单聊：非白名单、免打扰时段、超频、敏感话题都会在本地规则层被拦截，不花 token、不发消息。
- 回复由你在 DSH 里配置的 LLM 服务生成；插件不绑定任何模型厂商，也不含遥测。

不是什么

- ❌ 不是微信官方功能，也不是破解/协议逆向/外挂/群控；桌面通道模拟人在 Windows 客户端上的操作。
- ❌ 不是「稳定可用产品」：3.0.0-beta.1 是开发者预览，真实微信环境的读取/OCR/发送尚未实机验收。
- ❌ 不保证账号安全、不规避平台风控；本项目只把行为做得更像人、频率压到最低。
- ❌ 不帮你注册账号、加好友、进群、群发、导流，也不代做扫码/验证码/解封。

2. 实验性警示（beta 必读）

1. 3.0.0-beta.1 的代码、单元测试和离线验收已就绪，但真实微信窗口未实机验收： OCR 准确率只有合成语料数据，真实聊天里的字体/DPI/遮挡/多显示器表现未知。
2. beta 默认安全策略：真实通道的自动发送被关闭（betaSafeMode 默认 true），mock 通道可完整走通；真实通道相关能力请视为「预览，未验证」。
3. 使用 LLM 会产生费用（由你的 DSH 模型配置决定），插件本身不收费。
4. 仓库是公开的：不要在 Issue/PR/日志里贴真实好友名、wxid、手机号、聊天截图、API Key、含用户名的完整路径。

3. 功能矩阵（beta 状态）

| 功能 | 状态 | 说明 |
| mock 通道（入站模拟 / 草稿 / 审计） | ✅ 可用 | 不接触真实微信，适合体验与开发 |
| DSH LLM 生成回复 | ✅ 可用（需你配置模型） | 费用由你的模型/服务商决定 |
| 人格库（4 个内置 + 自定义/导入） | ✅ 可用 | 内置人格含「AI 身份透明」规则 |
| 白名单 / 在线时段 / 频控 / 预算 / 熔断 | ✅ 可用 | 本地规则先拦截，再决定是否调用模型 |
| 发送可靠性（10 态状态机 + sendOperationId 幂等账本） | ✅ 已实现 | 真实故障路径（重启/超时）未实机演练 |
| sendMode（auto / draft / confirm，草稿人工批准） | ✅ 可用 | beta 默认受安全模式限制 |
| OCR 流水线（WinRT 主引擎 + 同帧约束 + 基线/ack + 置信度门禁） | ⚠️ 离线验证 | 真实微信窗口未实机验收 |
| RapidOCR 第二引擎（可选） | ⚠️ 未实测新包 | 缺失时静默跳过，不阻断主流程 |
| desktop 桌面通道自动发送 | ⛔ beta 默认禁用 | betaSafeMode / safeMode 之下拒绝真实发送 |
| phone-adb / windows-vm 通道 | 🧪 代码保留 | 本轮未实机验证，按「实验」对待 |
| 表情包 / 人格广场 / 记忆摘要 | ✅ 可用 | 表情仅部分通道支持，见 docs/BETA-LIMITATIONS.md |
| 融合/对齐/跨帧差分（fusion/align/tracker） | 🧪 离线实验 | 已实现+单测，未接入生产读取路径 |
| 插件市场 / 长期记忆 / 视觉模型 | ⚠️ 未来规划 | 不是 beta 功能 |

完整矩阵与已知问题见 docs/BETA-LIMITATIONS.md。

4. 环境要求

| 项目 | 要求 |
| 操作系统 | Windows 10/11（desktop 通道）；mock 验证在任何平台均可 |
| Node.js | 22 及以上（构建与测试） |
| DSH 桌面版 | 0.2.1-rc.3 及以上 |
| 微信 PC | 仅 desktop 通道需要，4.x（未验证更早版本） |
| 中文 OCR | Windows「中文（简体）」OCR 语言包 + 分辨率 ≥ 1366×768（desktop） |
| PowerShell | Windows PowerShell 5.1（脚本用 -NoProfile 调用） |
| Python | 可选，仅 RapidOCR 第二引擎与 OCR 基准需要 |

5. 五分钟 mock 快速开始（不碰真实微信）

git clone https://github.com/xinghui2628/dsh-wechat-persona.git
cd dsh-wechat-persona
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm run verify:api # 离线 harness：鉴权 / 配置 / mock / 草稿 / 暂停恢复
把插件以开发方式链接进 DSH 配置档（详见 docs/BETA-QUICKSTART.md），启动后：

1. 设置页 → 微信分身 → 通道选 mock、白名单加一个虚构联系人（如 张三）。
2. 注入一条消息：

curl -X POST http://127.0.0.1:<DSH端口>/dsh-wechat-persona/api/test/inbound \
-H "x-dsh-wechat-persona: 1" -H "Content-Type: application/json" \
-d ""

3. 查看结果：GET /status、<dataDir>/outbox.jsonl（mock 发送记录）、<dataDir>/audit.jsonl（审计）。
4. 草稿模式：设置 sendMode=draft，重复第 2 步 → GET /drafts 查看草稿 → POST /drafts/approve 人工批准后再发送。

没有真实 LLM 也能完成 mock 验证（默认回复只走本地规则/persona 流程可选）；需要模型时使用你 DSH 里已配置的模型，并自行承担费用。

6. 安装、配置与运行

- 安装/更新/卸载/首次配置：见 docs/使用说明.md 与 docs/BETA-QUICKSTART.md。
- 配置项、10 个设置标签页、6 个运维工具（wechat_persona_status/pause/resume/send_test/clear_memory/clear_audit）：见使用说明。
- 安全模式（safeMode）与只读测试模式（readOnlyTestMode）：设置页可切换；只读模式下发送在 引擎 / 桌面通道 / HTTP API / PowerShell 脚本 四层被拒，mock 不受影响。详见 docs/READ-ONLY-MODES.md。
- 从 0.2.8 升级：见 docs/MIGRATION-v3.md。
- 排障：见 docs/TROUBLESHOOTING.md。

7. 隐私与费用

- 本机数据：<dataDir>（默认 <工作区>/.dsh-wechat-persona/）保存 state.json、memory/、audit.jsonl、drafts.json、send-ledger.json、desktop-ack.json 等；详细清单与保留期见 docs/PRIVACY.md 与 docs/PII-INVENTORY.md。
- 会离开本机的数据：只有「生成回复所需的消息内容 + 最近上下文 + 联系人偏好」会发给你自己配置的 LLM 服务商（以及可选的搜索服务）；不发送完整聊天历史、不发送截图。
- 无遥测：项目不包含统计上报/跟踪。
- 费用：插件免费；LLM 调用按你的模型服务商计费。
- 不要用本项目处理验证码、密码、支付、他人隐私等敏感信息；敏感话题会被本地规则拦截。

8. 已知问题与限制

- 真实微信环境（读取/OCR/发送）未实机验收；OCR 数字来自合成语料 + 离线等价，不代表真实聊天准确率。
- betaSafeMode 默认开启：真实通道发送被拒；mock 正常。
- fusion/align/tracker 未接入生产路径；rapidocr 新包未实测。
- 4 个通道中仅 mock 在本轮做过完整离线验收；phone-adb / windows-vm 未验证。
- 完整列表见 docs/BETA-LIMITATIONS.md 与 docs/TROUBLESHOOTING.md。

9. 发布说明

- 当前为 v3.0.0-beta.1 开发者预览：未打 tag、未在 npm 发布、未创建正式 Release（发布动作需维护者批准，见发布草稿 docs/releases/v3.0.0-beta.1.md）。
- 版本语义：修 bug → patch；行为/配置变化 → minor；破坏兼容 → major。
- 发布门槛与四类状态（已验证 / 待验证 / 需用户授权 / 不得发布）：见 docs/RELEASE-CHECKLIST.md。
- 变更记录：见 CHANGELOG.md。

10. 贡献与安全反馈

- 欢迎 Issue / PR；提交前请先看 docs/CONTRIBUTING.md。
- 安全漏洞请勿公开披露：使用 GitHub 的 Private vulnerability reporting（仓库 Security 页），说明见 SECURITY.md。
- 反馈时请遵守模板：不要贴真实好友名/wxid/手机号/聊天截图/API Key/含用户名的完整路径。

11. 许可与免责

- 代码以 MIT 许可证开源（见 LICENSE）。
- 使用即表示你已阅读 DISCLAIMER.md：非官方、账号风险自担、AS IS 无担保、禁止诈骗/冒充/群控/营销等用途。

文档导航

| 文档 | 内容 |
| docs/使用说明.md | 安装、配置、登录、白名单、通道选择、卸载 |
| docs/BETA-QUICKSTART.md | beta 五分钟快速开始（mock / 干净配置档演练） |
| docs/BETA-LIMITATIONS.md | beta 功能矩阵、已知限制、公开问题 |
| docs/BETA-FAQ.md | 常见问题（封号/费用/数据/卸载） |
| docs/ARCHITECTURE.md | 架构、模块、数据布局、HTTP API |
| docs/OCR-DESIGN.md | OCR 设计、融合/置信度、纠错边界 |
| docs/OCR-BENCHMARK.md | OCR 合成语料基准数字与限定 |
| docs/PRIVACY.md | 数据流、存储、删除 |
| docs/SECURITY.md | 威胁模型、鉴权、SSRF、残余风险 |
| docs/TROUBLESHOOTING.md | 排障手册 |
| docs/MIGRATION-v3.md | 从 0.2.8 升级与回滚 |
| docs/RELEASE-CHECKLIST.md | 发布门槛与状态表 |
| docs/releases/v3.0.0-beta.1.md | beta 发布草稿 |
| docs/CONTRIBUTING.md | 开发与 PR 规范 |
| CHANGELOG.md | 版本变更记录 |