跳转到内容

设置

在应用中打开 设置。不同的设置项作用范围不同:

设置项生效范围
外观、语言与临时存储当前设备
本地 Hub、网络访问与开机自启桌面端应用
消息通知与提示音桌面端应用
桌面端连接密钥系统密钥环
附件自动下载Hub 上所选的微信账号

本地/网络连接、证书和 CLI 配置请参考桌面应用。独立 CLI 客户端维护自身受保护的令牌文件。

语言

应用提供英文和简体中文两种界面。在 设置 中选择 语言,或使用登录页底部的语言菜单:

选项应用界面显示为
跟随系统(默认)系统语言受支持时使用该语言,否则显示英文
English, 简体中文对应语言

桌面端应用的托盘菜单和消息通知与此选项保持一致。应用尚未翻译的文本仍以英文显示。

消息通知

桌面端的 消息通知 在窗口最小化或隐藏时依然有效。已开启免打扰的会话、当前正在浏览的会话,以及历史旧消息或重复消息均不会弹出通知。

通知提示音 可独立开启或关闭。macOS 与 Linux 使用内置的柔和双音提示;Windows 使用系统原生通知音。点击 预览 可发送带声音的测试通知。系统全局通知与免打扰设置依然生效。密集连发的消息在 3 秒内最多触发一次提示音。

附件自动下载

agent-wechat Hub 能够在无需浏览器或 API 客户端保持打开的情况下自动下载收到的新附件。每个账号拥有独立的体积阈值,初始默认为 50 MB (52,428,800 字节)。

附件类型自动下载规则
图片与视频缩略图只要提供源数据,始终自动下载
语音留言始终自动下载为可播放格式
高清 (Standard) 与原图 (Original) 图片只要声明大小在阈值内,各版本均自动下载
高清 (Standard) 与原始 (Original) 视频只要声明大小在阈值内,各版本均自动下载
文件与表情包声明大小在阈值内时自动下载
超出阈值或大小未知的版本仅在手动请求时按需下载

修改下载阈值

  1. 选择账号并读取其当前配置:

    Terminal window
    wx --account personal --json accounts settings
    { "autoDownloadMaxBytes": 52428800 }
  2. 设置阈值(单位为 MB,CLI 按照 1 MB = 1,048,576 字节计算):

    Terminal window
    wx --account personal --json accounts settings --auto-download-max-mb 50
    { "autoDownloadMaxBytes": 52428800 }

    设置为 0 表示仅自动下载缩略图和语音。最高可设为 512,与支持的文件下载上限一致。修改将即时作用于后续新附件和尚未开始下载的任务;正在进行的传输与已下载的文件不会受到影响。

在浏览器中,打开 设置 → 自动下载。该选项控制保存在 Hub 节点上的媒体文件。在当前设备上 选项则代表浏览器本地的临时副本。

API 与 SDK

通过 GET /v1/accounts/{account}/settings 查询,并通过 PATCH /v1/accounts/{account}/settings 进行更新:

{ "autoDownloadMaxBytes": 52428800 }

读取需要账号的 read 权限;更新需要 media 权限。接口返回已保存的设置,账号事件流将广播 account.settings_updated 事件。

const settings = await client.accountSettings(accountId);
await client.updateAccountSettings(accountId, {
autoDownloadMaxBytes: 50 * 1024 * 1024,
});

如果发送方提供了文件体积,媒体响应中将暴露 advertisedByteLength,并提供反映当前策略的 autoDownloadAllowed 标记。byteLength 依然表示经校验落盘的实际字节大小。未声明体积并不代表文件为空。