WeChatAgent 0.3.6
Windows 微信助手与独立桌面控制台。支持白名单好友／群聊、人格预设、独立 DSH 会话、天气查询、网页正文阅读、图片理解、原生文字及表情包发送。内置功能可通过扩展页面管理。
安装使用
普通用户使用 GitHub Releases 附件中的 WeChatAgent-Setup-0.3.6-x64.exe。安装后通过“首次配置”登录自己的微信和 DSH、自动查找账号并连接验证数据库、选择聊天范围，日常操作无需命令行。首次白名单为空。安装器需由维护者上传至 Releases；本源码目录不包含它。
用户数据位于当前用户 AppData 下的 WeChatAgent 工作区。升级保留配置、人格编辑和私有状态；卸载保留用户数据。维护者的账号、密钥、联系人、聊天和运行日志未包含在源码中。
安装完成后，按“首次配置”依次连接微信账号、验证数据库、登录 DSH 并启用本项目插件、选择聊天范围，再启动助手服务。首次聊天范围为空，添加好友或群后保存并重启服务。
升级到 0.3.6 前，停止助手服务并从托盘完整退出匹配微信、助手和 DSH；安装后重新打开，确保加载新版界面与模型插件。账号、读取凭据、聊天范围、人格编辑及背景设置会保留。
版本与预设
- WeChatAgent：0.3.6；DSH 桌面端和插件 SDK 实际验收版本：
0.2.0-rc.2。 - 匹配微信：Windows x64
4.1.10.27；版本可登录性需按实际账号和环境验证。 - 内置预设：傲娇助手、德克萨斯、洛奇希、示例助手、小鲸鱼。首次选中示例助手，可在桌面应用切换。
- 支持人格稳定复用、归档后创建新会话、图片完成后卸载输入、按聊天控制表情发送和标签缓存。
- 首次配置自动识别账号目录、获取并验证读取密钥，验证通过才安全保存；失败显示恢复步骤，保留原配置。
- 支持切换绑定账号：微信辅助进程不再误报为多客户端；读取凭据、聊天范围、消息状态与 DSH 会话按账号保存，切换后需完整重开 DSH。
- 支持人格 Markdown 导入、接收引用消息、按需联网搜索、逐聊天主动聊天与自动上下文压缩；联网及主动聊天默认关闭。
- 天气问题直接通过 DSH 网页搜索查询，缺少城市时先询问；气温、降雨和日期以实际返回的来源资料为准。
- 当前未提供主动拍回、文件发送、语音／视频理解或通用新版微信适配。
0.3.6 更新
- 新增原版 dsh-meme 图库接入：本地选图、按需联网补图、核验后发送到微信，插件仍在 DSH 自行安装启用。
- 新增群友记忆：按稳定成员 ID 保存本机 JSON 标签，按账号、群聊隔离，并支持逐群开关。
- 扩展页改为卡片，提供搜索、分类、启用范围和安装指引；连接设置可复制插件路径。
- 修复提示词在 DSH 上下文重复、满池新表情无法发送及活跃群聊配图丢失等问题。
- 优化发送队列、回执确认、重启恢复和临时上下文清理。详见 发布说明。
使用内置功能
技能与插件在 DSH 安装和管理，人设卡继续在 WeChatAgent 管理。在“聊天范围”或“会话”打开目标聊天的“会话设置”，独立选择人格、群聊回复方式、功能开关；切换到“技能与工具”读取 DSH 清单并分配能力。点击“保存此会话”只提交当前聊天，保留其他页面的草稿。具体步骤见 DSH 技能与群聊授权。
在“扩展”页管理微信功能开关并查看 DSH 能力概览；自主表情素材搜索在目标会话的“技能与工具”中授权。点击卡片查看详情，修改开关或适用聊天后保存。列表显示已开启、已关闭、部分开启及开启范围；详情逐个显示聊天状态和待保存反馈。扩展页与回复设置共用配置，DSH 未连接时仍能查看已保存的开关，实际功能需在服务连接后按条件运行。
| 功能 | 如何使用 | 默认状态 |
|---|---|---|
| 网页阅读 | 在允许的聊天中发送“总结这个网页：链接” | 开启 |
| 联网搜索与天气 | 开启联网搜索后正常提问，模型结合前文按需检索，无需提供网址，例如“上海天气咋样”“最近这个有新消息吗” | 关闭；可为单个聊天覆盖 |
| 自主表情素材搜索 | 在 DSH 授权区域选择 meme-search 技能与 meme-search__search 工具，再发送“找个猫猫无语表情素材” | 关闭 |
| dsh-meme 图库接入 | 在 DSH 自行安装启用 dsh-meme，再在扩展页开启接入并选择聊天；联网补图需额外开启对应开关 | 关闭 |
| 群友记忆 | 按稳定成员 ID 记录有限互动标签，需要时由模型读取；每个账号和群独立保存 | 已允许群聊默认开启 |
| 原生表情发送 | 在允许的聊天中收到表情后，由模型按语境选择使用 | 开启；可为单个聊天覆盖 |
| 主动聊天 | 打开总开关，并逐个选择允许主动发送的聊天 | 关闭 |
| 自动上下文压缩 | 打开总开关，设置阈值和空闲等待时间 | 关闭；会话页另支持手动压缩 |
联网搜索现在由当前模型根据对话按需调用，沿用“扩展 → 联网搜索”的开关与聊天范围；不需要输入网址，也不要求固定搜索句式。模型会从追问中补全公开主题，普通闲聊不必检索。联网搜索直接调用 DSH 网页搜索服务，沿用当前账号和 DSH 搜索配置；天气、热点及普通事实检索使用同一通道。服务未就绪、登录失效、超时或无来源时说明对应原因，不切换其他搜索或天气接口。不必另外填写搜索密钥。本轮查到的来源链接可以交给网页阅读继续核实。仍受每轮 1–3 次检索、结果数、摘要长度和超时限制；仅查询公开关键词，临时说“不要联网”会取消该轮联网。未查到、搜索请求失败和网页正文读取失败会分别说明；已有来源摘要能够回答时，不强制再次读取正文。默认超时 20 秒，可设置 1–60 秒；已有 8 秒等较短配置会保留，可在回复设置调整为 20–30 秒。每次调用只请求 DSH 网页搜索，使用完整的已配置超时，DSH 服务内部检索由其自身设置控制。
网页阅读支持本轮用户提供的公开 HTTP(S) HTML 或纯文本页面，支持 gzip、deflate 和 Brotli 压缩响应。可以发送“总结这个网页：www.bilibili.com”，也可以直接发送网址；www.bilibili.com、bilibili.com、b23.tv/… 等省略协议的网址会自动补全 HTTPS。每轮最多三页、每页最多 12,000 字符。不登录、不执行页面 JavaScript，也不会自动访问正文中的其他链接。取得的页面文字会交给当前模型处理；Bilibili 首页可读取实际返回的推荐条目，视频链接只读取页面文字，不代表观看视频或读取未显示的字幕。登录页、验证码、浏览器提示页、纯动态页面、PDF 等无法读取时会说明原因。
如果提示代理 DNS 返回 Fake-IP，请在代理客户端将 DNS 模式改为 redir-host，或在其 fake-ip-filter 中加入目标域名（Bilibili 可加入 +.bilibili.com、b23.tv），再重启代理和助手服务。这是代理客户端的配置，助手不会自动修改系统网络设置；内网地址保护仍然有效。
0.3.6 安装包的网页阅读支持诛仙世界工具站行情页：通过该站固定公开报价接口读取女娲石和银两，按用户指定区服返回挂单、单位和更新时间；没有区服时先询问。网址后紧接“帮我看看”等中文请求也可识别。本版安装包已包含该修复。
给机器人补充表情
- 在“扩展 → 原生表情发送”或“聊天范围”中开启目标聊天的表情发送。
- 在“回复设置”开启“学习并复用表情标签”；本机资源缺失时，可开启“允许从腾讯下载缺失的表情包”。
- 助手运行后，由好友或群成员在这个允许的聊天中发送微信原生表情包。资源准备完成后，模型可在后续回复中选择使用。
0.3.6 安装包支持同一账号已允许好友与群聊共享统一表情池：后台准备、按内容去重、重启保留，按对话优先匹配标签。池容量最多 50 张，满池新候选由当前 DS 模型查看预览、标签和使用情况后决定替换或拒绝；模型不可用时保持原池。收集与共享开关和计数在“回复设置 → 原生表情发送”，发送仍按聊天控制；普通图片不自动入池，动态 GIF 保留动画。原有 meme-search 技能返回素材来源链接；另行启用 dsh-meme 接入后，可在当前聊天授权范围内核验、入库并发送图片。详见 表情收集与搜索。本版安装包已包含表情池、DSH 按会话授权及配套技能模块。
自主表情素材搜索
项目提供的表情素材能力由 DSH 项目插件注册。在目标聊天的“会话设置 → 技能与工具”中选择 meme-search 技能和 meme-search__search 工具。同时开启该聊天的“联网搜索”，然后发送“找个猫猫无语表情素材”，模型也可按聊天语境使用；唤醒回复模式的群需先 @ 或使用唤醒词。
默认来源为 auto，保留候选缓存和查询间隔。工具返回未查看的素材链接，不会自动下载、入库或原生发送。配置在 DSH 项目插件中管理；微信原生表情发送继续在 WeChatAgent 管理。旧版已授权的聊天会在准备配置时迁移，详见 DSH 技能与群聊授权。
更新提示
安装本次 0.3.6 后，助手启动时通过 GitHub Releases 检查后续更新，也可点击侧栏“检查更新”。发现新版本或同版本的新构建时显示下载入口和发布说明；下载后停止服务、完整退出助手与 DSH，再运行安装包。网络失败时不会打断聊天。此前未内置更新检查的版本，需要先手动安装本次更新。
源码与构建
运行要求：Windows 10/11 x64、Node.js 22.13+（建议 24）、Python 3.10+ 及读取依赖。桌面构建依赖在根 package.json 固定版本。
npm ci npm ci --prefix packages/dsh-social-bridge-plugin python -m pip install -r scripts/reader-requirements.txt npm run desktop:build
构建完成后双击根目录 WeChatAgent.exe 或 WeChatAgent-Console.vbs。源码副本不包含微信、DSH、第三方 Hook、已编译原生库或任何运行环境，完整收发需独立准备相应组件。外部组件说明见 发送后端。源码模式的自动连接需另行准备已授权的 wx_key.dll，放到 components/weflow-cli/resources/key/win32/x64/；安装器会内置该组件，普通用户无需手动准备。
安装器构建需要已获授权的微信客户端、Hook 编译产物及 DSH 程序。准备到本机私有 state/hook 目录，设置 DSH 程序目录后构建；每次均校验 DSH 与 SDK 版本匹配，并按根 package.json 中的版本号生成安装器。
$env:WECHATAGENT_DSH_SOURCE = '<DSH program directory>' npm run desktop:build npm run installer:runtime npm run installer:build
检查
npm run privacy:check
公开副本不附带开发回归测试、合成数据生成器或独立模型验证脚本。开发探针测试入口也已移除；应用内的环境检查、数据库读取检查和实际发送后端检查仍保留。部署、启动与日常收发不依赖测试源码。
目录
| 目录 | 用途 |
|---|---|
| apps/console-desktop、public/console | 桌面程序与界面 |
| scripts | 生命周期、读取 API、构建与原生覆盖层 |
| packages/dsh-social-bridge-plugin | DSH 0.2 插件及依赖锁 |
| components/qq-bridge | MIT 微信社交运行源码子集 |
| components/weflow-cli | MIT 数据库读取源码子集 |
| roles | 五份预设与说明 |
| config/wechatagent.example.json | 空白聊天范围的示例配置 |
数据与许可
启用云端模型后，选中的聊天消息、人格、图片，以及按请求取得的网页正文会交给配置的模型服务；本机读取不代表模型推理发生在本机。聊天不能修改人格、白名单、规则或模型工具权限，配置仅由本机所有者管理。
原作者署名和各组件许可保留，见 LICENSES.md 与 components.json。维护者已确认当前使用组件的再分发授权；这不将第三方程序、代码或角色素材重新许可为 MIT，也不表示微信或 DeepSeek 的官方背书。
源码与安装器分开发布：仓库提交本目录源码，Releases 附加安装器、SHA256SUMS.txt 和验证记录。推送与发布命令见 GitHub 发布步骤。安装、启动、升级及卸载验收使用维护者 Windows 11 的隔离目录，不替代其他电脑或账号的实际登录与收发验证。
免责声明
本项目仅供学习、技术交流与个人实验使用。请在合法授权的前提下使用，并遵守适用法律法规、平台规则及第三方组件的许可要求。请勿用于骚扰、诈骗、未经授权的数据访问，或其他侵害他人权益的行为。
本项目为第三方技术整合，不代表微信、腾讯或 DeepSeek 官方，也不构成任何官方合作或背书。项目按现状提供，不保证所有客户端版本、账号和运行环境均可正常使用。使用前请做好必要的数据备份，并自行评估账号、隐私及模型服务使用等风险。“仅供学习”的说明不替代相关许可或授权。
自定义背景
点击右上角“换肤”，选择自己的 PNG 或 JPG 图片（最大 20 MB），可实时调整背景显示强度或恢复默认。浅色、深色主题均保留阅读遮罩。图片保存在本机 state/desktop 下，重启后继续生效，不上传至模型，也不作为公开源码或安装包预设分发。
交流与反馈
使用过程中遇到问题，欢迎添加 QQ群 交流反馈。没有问题也欢迎扩列，聊聊技术或日常。
扩展页采用搜索、分类和状态筛选的卡片布局。dsh-meme 原版插件的安装教程、按聊天授权及联网补图到微信发送的流程见 dsh-meme 接入说明。
群友记忆按稳定成员 ID 记录互动倾向，按微信账号和群聊隔离，模型按需读取 JSON。使用说明见 群友记忆。
tips
默认人格的攻击力为3250，特别会怼人