Skip to content

2.5.2

Choose a tag to compare

@Wxw-Gu Wxw-Gu released this 27 Oct 07:45
· 57 commits to main since this release
9608077

TraceMemo 2.5.2

2.5.2 是一次围绕 个人微信发送 API、图片消息定位与聊天展示体验 的更新。

这一版主要继续补齐 TraceMemo 作为本地微信数据与 Agent 工作台时的几个实际使用场景:

  • 新增本地个人微信发送 API,外部 Agent 可以通过 TraceMemo 向好友、群聊或文件传输助手发送消息
  • 支持通过 API 发送文字、图片和语音,并统一经过现有发送能力检查与审计链路
  • 图片支持软件内点击根据xml下载原图 ( 此功能本期暂不开放,后续可能随发送能力runtime一起发 )
  • 修复长引用消息撑破聊天气泡、发送者名称被挤压等显示问题

主要更新

🔌 Local HTTP API / 个人微信发送

新增本地个人微信发送接口:

POST /api/v1/wechat/send

外部 Agent、脚本或本机工具现在可以通过 TraceMemo 已有的个人微信发送能力执行发送操作,而不需要依赖 Agent Hub 中的机器人账号。

当前支持:

  • 文字
  • 图片
  • 语音
  • 好友 wxid
  • 微信群 @chatroom
  • 文件传输助手

发送请求会先检查当前平台和发送 Runtime 是否真正就绪,再进入统一的 Wechat Action Gateway,不会绕过现有的发送策略和执行记录。

同时补充:

  • Bearer Token 鉴权
  • 发送能力检查
  • 内容类型校验
  • 本地媒体文件校验
  • 文本长度限制
  • idempotencyKey 幂等标识
  • 成功 / 失败 / 策略阻止等明确错误状态
  • HTTP API 来源的独立发送审计记录

API 发起的发送会与用户手动发送、自动化发送区分记录,方便后续排查消息到底由谁、通过什么入口触发。

实际能否发送仍取决于当前设备是否具备并启用了对应的个人微信发送 Runtime。API 本身不会绕过发送能力限制。

相关 Reader Skill 与 API 文档也同步补充了新的发送方式,方便外部 Agent 在明确获得用户授权后调用。

🖼️ TraceMemo点击图片下载原图 ( 此功能本期暂不开放,后续可能随发送能力runtime一起发 )

用于:

  • 导出原图
  • 软件内下载原图
  • 排查缩略图 / 中图 / 原图资源差异
  • 为图片资源定位和后续处理提供原始消息依据

微信原图还区分企微上传 用户转发 自上传原图

💬 引用消息显示优化

修复聊天档案中长引用消息的排版问题。

之前当被引用的正文很长时,可能出现:

  • 引用内容撑出聊天气泡
  • 发送者名称被正文挤压
  • 名称只剩下一个冒号
  • 多行长文本影响整个消息布局

2.5.2 调整了引用区域的布局规则:

  • 引用正文保持单行显示,超出部分使用省略号
  • 发送者名称优先保留,不再被长正文挤压
  • 名称为空时不再显示多余冒号
  • 鼠标悬停引用区域时仍可查看完整引用内容
  • 图片引用继续保持原有图片展示方式

同时补充组件与布局回归测试,避免后续样式调整再次导致引用内容撑破消息气泡。

⚙️ 发送 Runtime 与打包边界

继续整理个人微信发送能力的打包方式。

TraceMemo 的普通数据读取、搜索、Knowledge、问问微信、导出等能力仍然不依赖发送 Runtime。

个人微信发送属于独立能力:

  • API 会先查询当前发送能力是否可用
  • Runtime 未配置或未就绪时明确返回不可用状态
  • 不会因为新增 /wechat/send 就假装当前设备已经具有发送能力
  • 发送 Runtime 与普通公开应用的打包配置继续保持独立

这样外部 Agent 可以稳定使用统一 API,而具体底层发送能力仍然可以按照系统、微信版本和当前 Runtime 独立适配。

修复与优化

  • 新增 POST /api/v1/wechat/send 个人微信发送接口
  • 支持通过 API 发送文字、图片和语音
  • 支持好友、群聊与文件传输助手等稳定收件人标识
  • 新增 API 发送能力预检查与错误状态
  • API 发送统一接入 Wechat Action Gateway 和审计记录
  • 支持发送请求携带幂等标识,降低重复执行风险
  • 新增图片消息原始 XML 读取与复制能力
  • 完善跨数据库分片的图片消息正文定位
  • 保持长整型微信消息 ID 的精确表示
  • 修复长引用文本溢出聊天气泡的问题
  • 修复长引用内容挤压发送者名称的问题
  • 修复空发送者情况下引用区域可能只显示冒号的问题
  • 为引用消息、图片定位和微信发送 API 补充回归测试
  • 继续整理发送 Runtime 的独立打包配置
  • 更新 Reader Skill 与 Local HTTP API 文档

💻 平台支持

TraceMemo 2.5.2 支持:

  • Windows x64
  • macOS Apple Silicon(M 系列 / arm64)
  • macOS Intel(x64)

把微信里的信息,记住、理解、监控,并在需要时行动。

也感谢所有通过 Issue、交流群、实机测试和使用反馈帮助完善 TraceMemo 的朋友 ❤️

Full Changelog: v2.5.1...v2.5.2