DSH Super Agent · 微信历史消息

DSH Super Agent 系列 · 第 01 部分

为 DeepSeek Harness（DSH）提供微信历史读取工具。插件通过本机 WeFlow Rust CLI 查询会话、分页读取历史消息和搜索聊天内容。

模型根据返回的消息、发送者、时间和引用自行完成任务提取、归并和去重。查询按需执行，任务判断与读取源解耦。

安装

已核验环境：Windows、DSH 0.2.2-rc.1、Node 24、WeFlow Rust CLI v6.0.0（API v2）。运行时使用 DSH 提供的 SDK。

下载 v0.1.0 安装包，在 DSH 插件管理页安装 .tgz。Desktop 选择 desktop profile。也可从终端安装：

dsh plugin --profile desktop add "https://github.com/LeoAndJellyfish/dsh-super-agent-source-wechat/releases/download/v0.1.0/dsh-super-agent-source-wechat-0.1.0.tgz"

安装后在插件管理页启用「微信历史消息」。

连接 WeFlow

1. 单独安装 WeFlow Rust CLI v6.0.0，按照其 Windows 说明 配置微信账号目录和数据库密钥。Windows 首次取钥需要管理员权限及重新登录微信。

2. 在启动 WeFlow 的终端设置环境变量 WEFLOW_HTTP_TOKEN，值为自行生成的随机 ASCII 令牌，然后启动本机 API：

   weflow serve --api-only --host 127.0.0.1 --port 18108
   

   WeFlow 也支持在自身配置中保存 http_api_token；选择该方式时，DSH 使用同一令牌。

3. 在 DSH 凭据管理中保存名为 WEFLOW_HTTP_TOKEN 的凭据，值与 WeFlow API 令牌相同。插件每次查询从 DSH 凭据服务读取最新值。

4. 在 DSH 对话中要求检查微信连接，再列出会话。wechat_status 检查 HTTP 服务和 API 版本；wechat_sessions 成功时可确认账号历史查询正常。

配置项	默认值	用途
endpoint	http://127.0.0.1:18108	本机 HTTP 地址，支持字面 127.0.0.1 和 [::1]
tokenRef	WEFLOW_HTTP_TOKEN	DSH 凭据名称
timeoutMs	15000	单次 HTTP 请求超时，单位为毫秒

工具

工具	参数与结果
wechat_status	检查服务可达性，返回服务和 API 版本
wechat_sessions	可选 keyword、limit、offset；返回会话 ID、名称、时间和下一页偏移
wechat_messages	必填 sessionId；可选 limit 和 before、after、since 中的一项；返回消息及分页游标
wechat_search	必填 sessionId、keyword；可选 start、end、limit、offset；返回单会话搜索结果和下一页偏移

消息和搜索默认每页 50 条，最多 100 条，按新到旧返回。before=olderCursor 读取更早的一页；after=newerCursor 读取紧接游标之后的一页。since 按微信排序位置定位到指定 Unix 秒附近，再从该处读取一页。搜索的 start、end 为包含边界的 Unix 秒，接受 1 至 2147483647。

pageFull 表示已读满一页，满页时继续查询，直到出现短页或空页。会话关键词在最近 5000 个会话内匹配名称或 ID；sourceTruncated 标记扫描截断，matchedCount 为该范围内的匹配数。会话列表读取名称和标识，消息正文通过消息工具读取。单次 HTTP 响应上限为 4 MiB。

消息保留 serverId、localId、messageKey、_cursor 和引用正文。serverId 保持十进制字符串，其他超出 JavaScript 安全整数范围的数字也按字符串返回。相同文本的多条消息分别保留。图片、语音和文件返回上游可解析的文字内容及类型。

对话示例

• 「查一下微信连接状态。」
• 「找到名称里有课程的微信群，读取最近 50 条消息。」
• 「在刚才的群里搜索报告，按时间列出老师提出的要求，并标注消息出处。」
• 「继续读取更早的消息，结合已有结果整理任务，合并你判断重复的事项。」

查询结果通过 DSH 工具进入会话记录，并交给该会话所选模型。请根据读取范围选择合适的模型服务。API 令牌放在 HTTP Authorization 请求头，插件结果保留选定消息字段。

开发与验证

仓库包含原生 ESM JavaScript，使用 Node 24 执行 API 测试、语法检查和安装包检查：

npm test
npm run check:syntax
npm run check:package

API 测试使用合成数据和临时本机 HTTP 服务。在已安装 DSH Desktop 的 Windows 机器上，可进一步使用实际 SDK 验证工具注册、结果渲染及卸载清理：

npm run test:host

安装目录可通过 DSH_INSTALL_DIR 指定。GitHub CI 在 Linux、Windows 上执行 API、语法和安装包检查；.tgz 与 SHA256SUMS 保存为 CI 产物。发布步骤见 发布流程。

系列路线

部分	插件职责	状态
01 · 微信历史源	为 DSH 提供历史会话、消息与搜索工具	当前仓库
微信机器人通道	接收本人指令、发送消息	规划中
通知	配合 DSH Schedule 投递模型生成的摘要与结果	规划中
更多平台	QQ、Slack、Telegram 和邮箱接入	规划中

各插件独立安装，任务理解与判断由 DSH 会话中的模型完成。

许可证与上游

本插件采用 MIT 许可证。WeFlow Rust CLI 为独立安装的上游项目，本仓库发布 DSH 适配代码。WeFlow 的数据库取钥、服务运行和微信版本兼容性以其项目说明为准。