dsh-wechat-persona
微信小号 AI 人格聊天分身（DSH host 插件）：本地零 token 决策 + 拟人节奏 + 表情包 + 按需搜索 + token 预算 + 风控熔断
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xinghui2628/dsh-wechat-persona#4500bc99ec9ac3a796af05c1717c71735fc469eeWechat Persona 以 dsh-wechat-persona 发布，当前版本为 3.0.0-beta.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个个人独立开发、免费开源、实验性的 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：自动化操作微信客户端违反《微信软件许可及服务协议》，可能导致账号被限制或封禁，风险由你自行承担；请只用你自己注册的小号，切勿用于主号、冒充真人、群发、营销、诈骗或读取他人数据。
是什么
dataDir。不是什么
3.0.0-beta.1 是开发者预览，真实微信环境的读取/OCR/发送尚未实机验收。3.0.0-beta.1 的代码、单元测试和离线验收已就绪，但真实微信窗口未实机验收：
OCR 准确率只有合成语料数据，真实聊天里的字体/DPI/遮挡/多显示器表现未知。betaSafeMode 默认 true），mock 通道可完整走通；
真实通道相关能力请视为「预览，未验证」。| 功能 | 状态 | 说明 |
|---|---|---|
| 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。
| 项目 | 要求 |
|---|---|
| 操作系统 | 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 基准需要 |
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 profile（详见 docs/BETA-QUICKSTART.md），启动后：
mock、白名单加一个虚构联系人（如 张三）。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 "{\"text\":\"在吗\",\"contactId\":\"张三\"}"
GET /status、<dataDir>/outbox.jsonl（mock 发送记录）、<dataDir>/audit.jsonl（审计）。sendMode=draft，重复第 2 步 → GET /drafts 查看草稿 → POST /drafts/approve 人工批准后再发送。没有真实 LLM 也能完成 mock 验证（默认回复只走本地规则/persona 流程可选）；需要模型时使用你 DSH 里已配置的模型，并自行承担费用。
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。<dataDir>（默认 <工作区>/.dsh-wechat-persona/）保存 state.json、memory/、audit.jsonl、drafts.json、send-ledger.json、desktop-ack.json 等；
详细清单与保留期见 docs/PRIVACY.md 与 docs/PII-INVENTORY.md。betaSafeMode 默认开启：真实通道发送被拒；mock 正常。fusion/align/tracker 未接入生产路径；rapidocr 新包未实测。| 文档 | 内容 |
|---|---|
| docs/使用说明.md | 安装、配置、登录、白名单、通道选择、卸载 |
| docs/BETA-QUICKSTART.md | beta 五分钟快速开始（mock / 干净 profile 演练） |
| 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 | 版本变更记录 |