前言¶
在 DSH（DeepSeek Harness）里做智能体，常见做法是接 HTTP、脚本或 IDE 通道；若你希望在自己电脑上、针对指定微信小号的白名单单聊，按可配置的人格以拟人节奏被动回复，又不想绑死某一家模型或把完整聊天记录外发，就需要一个在 host 内运行的专用插件，并在本地规则层先拦截再决定是否调用 LLM。
dsh-wechat-persona（维护者 xinghui2628，GitHub 仓库 xinghui2628/dsh-wechat-persona，社区目录 SkillHub 条目）即为此设计：个人独立开发、MIT 开源、实验性质；与腾讯 / 微信官方无关。当前文档标注版本为 3.0.0-beta.1（开发者预览，2026-11-01），上一已发布版本为 0.2.8；分类上属于模型推理类插件。
下面介绍它是什么、能做什么、如何在不碰真实微信的前提下用 mock 验证，以及安装与风险边界。
这是什么¶
一句话：运行在你自己电脑上的 DSH 插件，配置、记忆、审计日志默认只落在本机 dataDir（默认 <工作区>/.dsh-wechat-persona/）。
它只处理白名单里的单聊：非白名单、免打扰时段、超频、敏感话题等在本地规则层拦截，不花 token、不发消息。回复由你在 DSH 里配置的 LLM 服务生成；插件不绑定模型厂商，README 写明不含遥测。
它不是微信官方功能，也不是协议逆向或群控；desktop 通道是在 Windows 客户端上模拟桌面操作。README 明确：3.0.0-beta.1 真实微信环境的读取 / OCR / 发送尚未实机验收，不能当作稳定产品使用。
核心功能（与 beta 状态一致）¶
资料中的功能矩阵摘要如下，完整列表见仓库 docs/BETA-LIMITATIONS.md。
| 能力 | beta 状态 |
|---|---|
| mock 通道（入站模拟、草稿、审计） | 可用，不接触真实微信 |
| DSH LLM 生成回复 | 可用，需自行配置模型与承担费用 |
| 人格库（4 个内置 + 自定义 / 导入） | 可用，内置含「AI 身份透明」规则 |
| 白名单、在线时段、频控、预算、熔断 | 可用，本地规则优先 |
sendMode（auto / draft / confirm） |
可用，beta 默认受安全模式限制 |
发送可靠性（10 态状态机 + sendOperationId 幂等账本） |
已实现，真实故障路径未实机演练 |
| OCR 流水线（WinRT 主引擎等） | 离线验证，真实微信窗口未实机验收 |
| desktop 桌面通道自动发送 | beta 默认禁用（betaSafeMode 默认 true） |
| 表情包、人格相关能力 | 部分可用，通道差异见限制文档 |
| 插件市场 / 长期记忆 / 视觉模型 | 文档标注为未来规划，非 beta 功能 |
安全模式：betaSafeMode / safeMode 下拒绝真实通道发送；只读测试模式在引擎、桌面通道、HTTP API、PowerShell 脚本四层拒发，mock 不受影响（见 docs/READ-ONLY-MODES.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 |
安装与启用¶
安装、更新、卸载与首次配置以仓库文档为准，勿凭插件名自行拼接市场命令：
README 说明：将插件以开发方式链接进 DSH profile 的步骤见 BETA-QUICKSTART；配置项、10 个设置标签页、6 个运维工具（如 wechat_persona_status、pause、resume、send_test、clear_memory、clear_audit）见使用说明。从 0.2.8 升级见 docs/MIGRATION-v3.md。
本地构建与离线验收（README「五分钟 mock 快速开始」）在仓库根目录执行：
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm run verify:api
verify:api 为离线 harness，覆盖鉴权、配置、mock、草稿、暂停恢复等路径。
典型用法：mock 通道（不碰真实微信）¶
经过上面的链接与构建后，在 DSH 设置页 → 微信分身 中：通道选 mock，白名单添加虚构联系人（如 张三）。
注入一条测试消息（将 <DSH端口> 换成你本机 DSH 监听端口）：
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，重复注入 → GET /drafts 查看草稿 → POST /drafts/approve 人工批准后再发送。无真实 LLM 也可完成 mock 流程（默认可走本地规则 / persona）；需要模型时使用 DSH 已配置的模型。
数据、费用与隐私¶
- 本机：
state.json、memory/、audit.jsonl、drafts.json、send-ledger.json等，清单见 docs/PRIVACY.md。 - 离开本机：仅生成回复所需的消息内容、最近上下文、联系人偏好会发到你配置的 LLM（及可选搜索服务）；不发送完整聊天历史与截图。
- 费用：插件本身免费；LLM 按你的服务商计费。
适用场景与注意¶
适合谁
- 已在用 DSH，想在本机实验「白名单单聊 + 人格 + 本地风控」链路的人。
- 希望先用 mock 验证配置、草稿、审计，再评估是否接触 desktop 通道的人。
务必知晓
- 使用前阅读 DISCLAIMER.md：自动化操作微信客户端可能违反《微信软件许可及服务协议》，账号风险自担；仅建议自用小号，禁止冒充、群发、营销、诈骗等用途。
- 3.0.0-beta.1 为开发者预览：未打 tag、未 npm 发布、未正式 Release；真实微信 OCR / 发送视为预览、未验证。
- 插件以当前 DSH 进程权限运行；安装前请自行审阅源码与 MIT 许可证，勿在 Issue / 日志中粘贴真实好友名、wxid、API Key 等。
- DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区插件而非官方应用。
结尾¶
dsh-wechat-persona 把「本地零 token 决策、白名单、频控与熔断、人格与可选 LLM 回复」收进 DSH 插件；beta 阶段应优先 mock 与文档中的离线验收，再谨慎看待 desktop 自动发送。
- 目录页：https://www.skillhub.cn/plugins/xinghui2628/dsh-wechat-persona
- 源码与文档：https://github.com/xinghui2628/dsh-wechat-persona
