v0.1.0-beta.1

新增

• 支持通过 SDK 队列与 API 向 Linux 微信会话发送文件，并在发送前后验证编辑区文件预览状态。
• 支持接收微信文件消息：先推送 pending 事件，文件完整下载并校验后再推送 message.media.ready 与可下载 file_url。
• 支持定位当前视口及被后续消息顶出视口的历史文件卡，按会话、消息 ID、完整文件名和字节数定向接收。
• 接收完成后校验文件大小稳定性、微信提供的 MD5（如有），计算 SHA-256，并原子写入 SDK 托管目录。

修复

• 文件卡仅在微信数据库确认待手动接收或操作区明确可接收时点击；上传中、下载中、已完成和未知状态只等待且不消耗点击重试次数。
• 文件名 OCR 改为完整行和独立大小字段匹配，避免相似文件名或后缀造成误触。
• 点击前要求连续两帧位置与身份稳定，点击后同时验收卡片主体和右侧操作区变化，并恢复会话到底部。
• 刷新被微信替换的消息数据库来源，降低历史文件回填读取旧快照的概率。

安全更新

• Linux 包继续使用编译保护的消息采集和发送模块，并通过构建哈希清单校验运行时文件。
• 部署包不包含激活码、账号配置、微信数据或服务端凭据。

破坏性变更

本版本没有登记相关内容。

兼容性

• 适用于 x86_64 Linux 微信桌面版，可运行在原生 Linux 桌面或项目提供的 Xfce Docker 桌面容器。
• 本次 beta 仅发布 Linux DEB、TAR、一键部署包和安装脚本；Windows 下载保持现状。
• 文件发送目录需位于 SDK 配置的 file_send_allowed_dirs 白名单中。

升级说明

• 升级 Linux SDK 包后只需重启 SDK 进程；持久化的微信登录、配置、队列和微信数据目录不应删除或重建。
• 一键部署用户可使用版本页提供的 install-linux.sh 或版本化部署 ZIP 完成安装。

已知问题

• 自动文件接收目前仅支持 Linux；Windows 仍只支持文件发送。
• 历史文件自动定位默认回溯最近 7 天，并优先处理每个会话最新的待接收文件。
• 单个接收文件默认上限为 2 GiB。
• VNC 中主动点击、滚动或切换微信会与 SDK 界面自动化争用；仅观察不会主动抢占输入。

下载与校验