{
  "schema_version": 1,
  "product": "wx-bot-sdk",
  "releases": [
    {
      "schema_version": 1,
      "version": "0.1.0-beta.1",
      "status": "published",
      "channel": "beta",
      "published_at": "2026-08-04T10:27:57+08:00",
      "build_id": "20260730-133518-a8f3b33d",
      "source_revision": "00c6430cce0550957b11643d4d1d5c443f633c44",
      "source_dirty": true,
      "source_dirty_paths": [
        "build_info.py",
        "deploy/linux-wechat-xfce/packages/wx-bot-client_20260717.122350.58dd4ad7_amd64.deb",
        "deploy/linux-wechat-xfce/packages/wx-bot-client_20260730.133518.a8f3b33d_amd64.deb"
      ],
      "build_receipts": [
        {
          "platform": "linux",
          "created_at": "2026-07-30T14:02:45+08:00",
          "validation_commands": [
            "validate_release.py --strict",
            "validate_build_freshness.py --phase all"
          ]
        }
      ],
      "summary": "Linux 微信桌面版文件收发与稳健自动化首个公开测试版本。",
      "changes": {
        "features": [
          "支持通过 SDK 队列与 API 向 Linux 微信会话发送文件，并在发送前后验证编辑区文件预览状态。",
          "支持接收微信文件消息：先推送 pending 事件，文件完整下载并校验后再推送 message.media.ready 与可下载 file_url。",
          "支持定位当前视口及被后续消息顶出视口的历史文件卡，按会话、消息 ID、完整文件名和字节数定向接收。",
          "接收完成后校验文件大小稳定性、微信提供的 MD5（如有），计算 SHA-256，并原子写入 SDK 托管目录。"
        ],
        "fixes": [
          "文件卡仅在微信数据库确认待手动接收或操作区明确可接收时点击；上传中、下载中、已完成和未知状态只等待且不消耗点击重试次数。",
          "文件名 OCR 改为完整行和独立大小字段匹配，避免相似文件名或后缀造成误触。",
          "点击前要求连续两帧位置与身份稳定，点击后同时验收卡片主体和右侧操作区变化，并恢复会话到底部。",
          "刷新被微信替换的消息数据库来源，降低历史文件回填读取旧快照的概率。"
        ],
        "breaking": [],
        "security": [
          "Linux 包继续使用编译保护的消息采集和发送模块，并通过构建哈希清单校验运行时文件。",
          "部署包不包含激活码、账号配置、微信数据或服务端凭据。"
        ]
      },
      "compatibility": [
        "适用于 x86_64 Linux 微信桌面版，可运行在原生 Linux 桌面或项目提供的 Xfce Docker 桌面容器。",
        "本次 beta 仅发布 Linux DEB、TAR、一键部署包和安装脚本；Windows 下载保持现状。",
        "文件发送目录需位于 SDK 配置的 file_send_allowed_dirs 白名单中。"
      ],
      "upgrade_notes": [
        "升级 Linux SDK 包后只需重启 SDK 进程；持久化的微信登录、配置、队列和微信数据目录不应删除或重建。",
        "一键部署用户可使用版本页提供的 install-linux.sh 或版本化部署 ZIP 完成安装。"
      ],
      "known_issues": [
        "自动文件接收目前仅支持 Linux；Windows 仍只支持文件发送。",
        "历史文件自动定位默认回溯最近 7 天，并优先处理每个会话最新的待接收文件。",
        "单个接收文件默认上限为 2 GiB。",
        "VNC 中主动点击、滚动或切换微信会与 SDK 界面自动化争用；仅观察不会主动抢占输入。"
      ],
      "assets": [
        {
          "kind": "linux-amd64-deb",
          "name": "wx-bot-client_20260730.133518.a8f3b33d_amd64.deb",
          "url": "/downloads/v0.1.0-beta.1/wx-bot-client_20260730.133518.a8f3b33d_amd64.deb",
          "sha256_url": "/downloads/v0.1.0-beta.1/wx-bot-client_20260730.133518.a8f3b33d_amd64.deb.sha256",
          "size": 32046276,
          "sha256": "f51f64371511135b4e39211596884049d56e56a0e720040206615b0ea0e03fe6",
          "signature": null
        },
        {
          "kind": "linux-amd64-tar",
          "name": "wx-bot-client-20260730.133518.a8f3b33d-linux-x86_64.tar.gz",
          "url": "/downloads/v0.1.0-beta.1/wx-bot-client-20260730.133518.a8f3b33d-linux-x86_64.tar.gz",
          "sha256_url": "/downloads/v0.1.0-beta.1/wx-bot-client-20260730.133518.a8f3b33d-linux-x86_64.tar.gz.sha256",
          "size": 41297032,
          "sha256": "e5b277a1f7c5ff11eacb90dd5608ad8d1f4524af4d5b4ed1163946d63c643c45",
          "signature": null
        },
        {
          "kind": "linux-deploy",
          "name": "wx-bot-linux-deploy.zip",
          "url": "/downloads/v0.1.0-beta.1/wx-bot-linux-deploy.zip",
          "sha256_url": "/downloads/v0.1.0-beta.1/wx-bot-linux-deploy.zip.sha256",
          "size": 32073951,
          "sha256": "913503fd58a6f04901701f7cd3005e608523fc0fe906527a84febd03404fbddd",
          "signature": null
        },
        {
          "kind": "linux-installer",
          "name": "install-linux.sh",
          "url": "/downloads/v0.1.0-beta.1/install-linux.sh",
          "sha256_url": "/downloads/v0.1.0-beta.1/install-linux.sh.sha256",
          "size": 1959,
          "sha256": "ffcbf2b601fee5600ce14573d0d808a52716c54f07a1cebabd0a3cc6bc77b9c9",
          "signature": null
        }
      ]
    }
  ]
}