sourcepro5 / WeChatAgent

# WeChatAgent 0.3.9
Windows 微信助手与独立桌面控制台。支持白名单好友／群聊、人格预设、独立 DSH 会话、天气查询、网页正文阅读、图片理解、原生文字及表情包发送。内置功能可通过扩展页面管理。
## DSH 单独安装
DSH 需单独安装，首次配置提供 官方兼容版本下载链接。安装后选择程序位置、登录模型账号并启用本机插件；已有 DSH 可直接使用。安装包不再携带 DSH 桌面程序，旧程序和会话数据不会自动删除。详见 单独安装 DSH。
## 安装使用
普通用户使用 GitHub Releases 附件中的 `WeChatAgent-Setup-0.3.9-x64.exe`。安装后通过“首次配置”登录自己的微信和 DSH、自动查找账号并连接验证数据库、选择聊天范围，日常操作无需命令行。首次白名单为空。安装器需由维护者上传至 Releases；本源码目录不包含它。
0.3.9 安装器只需选择一次根目录：程序自动放入 app，WeChatAgent 数据自动放入同级 data；同位置升级保留原有数据路径。旧版 AppData 数据可在首次启动确认后复制、逐文件校验并迁移，保留原副本；微信原始数据库仍在原位置。升级与卸载保留用户数据。详见 数据目录与迁移。维护者的账号、密钥、联系人、聊天和运行日志未包含在源码中。
安装完成后，按“首次配置”依次连接微信账号、验证数据库、登录 DSH 并启用本项目插件、选择聊天范围，再启动助手服务。首次聊天范围为空，添加好友或群后保存并重启服务。
升级到 0.3.9 前，停止助手服务并从托盘完整退出匹配微信、助手和 DSH；安装后重新打开，确保加载新版界面与模型插件。账号、读取凭据、聊天范围、人格编辑及背景设置会保留。
点击窗口“×”仍收起到托盘；点击“退出应用”会先停止本实例后台服务再退出，微信和外部 DSH 保持运行。停止失败时保留窗口供重试。详见 退出与后台服务。
## 版本与预设
- WeChatAgent：0.3.9；DSH 桌面端和插件 SDK 实际验收版本：`0.2.0-rc.2`。
- 匹配微信：Windows x64 `4.1.10.27`；版本可登录性需按实际账号和环境验证。
- 内置预设：傲娇助手、德克萨斯、洛奇希、示例助手、小鲸鱼。首次选中示例助手，可在桌面应用切换。
- 支持人格稳定复用、归档后创建新会话、图片完成后卸载输入、按聊天控制表情发送和标签缓存。
- 首次配置自动识别账号目录、获取并验证读取密钥，验证通过才安全保存；失败显示恢复步骤，保留原配置。
- 支持切换绑定账号：微信辅助进程不再误报为多客户端；读取凭据、聊天范围、消息状态与 DSH 会话按账号保存，切换后需完整重开 DSH。
- 支持人格 Markdown 导入、接收引用消息、按需联网搜索、逐聊天主动聊天与自动上下文压缩；联网及主动聊天默认关闭。
- 天气问题直接通过 DSH 网页搜索查询，缺少城市时先询问；气温、降雨和日期以实际返回的来源资料为准。
- 当前未提供主动拍回、文件发送、语音／视频理解或通用新版微信适配。
## 0.3.9 更新
- 会话可按 DSH 工作区分组、选择目录，并移动已有会话；跨目录时继承历史并保留原会话。详见 会话分组。
- 安装时只选择一次根目录，自动采用 app/data 分离布局；升级沿用已有数据位置，换位置时支持校验后迁移旧数据并保留原副本。
- 增加匹配微信恢复入口，修复 Hook 加载较慢后永久不可用、启动交接误判等问题。
- “退出应用”先停止本实例后台服务；窗口“×”继续收起到托盘。
- 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。每轮最多