# 聊天图片与自定义表情(0.7.1) 后台 API 采集到新消息中的 Teams 图片后,会自动保存到 `DATA_DIR/media/`。图片文件和下载队列持久化到本机,不需要 Teams 网页或扩展常驻。每张图片关联本地消息、账号和实例;下载使用所属实例当前会话中的 IC3 凭证,跟随现有独立续期流程更新,不会借用其他账号的令牌。 在「后台 API 采集」选择实例,点击「历史图片自动补下载 → 开启补下载」,即可把该实例已有的未下载图片加入队列。之后历史补录新发现的图片也会自动加入。每个实例独立保存开关、队列与重试进度,关闭控制台页面不影响运行,重启后自动继续。未开启的实例仍可在单条记录详情按需下载。 同一位置显示已保存、待处理、失败数量,可暂停补下载,或批量重试网络、权限等暂时失败的图片。暂停会在正在下载的这一张完成后生效,不影响新消息图片和其他实例。停止实例则暂停其全部自动下载。已保存且文件仍存在的图片不会重复下载;重新开启时会检查并补回缺失的本地图片文件。 - 支持已验证的 Teams AMS 聊天图片接口,格式为 PNG、JPEG、GIF、WebP,单张上限 25 MiB。 - 暂不下载外站图片/Giphy、文件附件、头像或自定义表情图片;正文仍保留已有图片标签。 - 下载独立于聊天同步。每轮最多处理 3 张,各实例轮流处理,新消息图片优先。同一实例的自动图片请求默认间隔随机 2–5 秒,沿用 `HISTORY_REQUEST_MIN_DELAY_MS` / `HISTORY_REQUEST_MAX_DELAY_MS` 配置。限流时遵守 `Retry-After`,不会阻塞其他实例。 - 普通暂时失败最多自动尝试 8 次;会话缺失或过期时按账号等待自动续期,不消耗图片的重试次数。无法读取、超过上限或不支持格式的图片保留失败状态,不会无限重复下载。历史覆盖取决于已经发现的聊天和仍可访问的原图。 - 文件只通过本机接口访问,不在 MCP、正文或日志中暴露微软下载凭证。接口拒绝重定向及未知文件类型,不接受任意 URL 或保存路径。 - 删除账号本地记录会同时删除图片元数据和对应文件。下载与删除并发时,已删除账号的数据不会被晚到的下载重新写回。原始 HAR 和独立备份不受影响。 - 消息编辑移除的图片保留为历史版本证据,并标记 `fromEarlierVersion`;删除账号记录时一并清理。 MCP 的 `search_messages`、`get_message` 和 `get_chat_context` 返回当前消息的 `images` 数组。调用 `list_message_images({messageId})` 查看状态;调用 `download_message_image({id})` 下载、重试或获取已有文件。成功时返回绝对 `localPath`、MIME、字节数和 SHA-256;这个路径位于采集器主机,不是客户端机器。 调用 `configure_image_backfill({instanceId, enabled: true})` 开启指定实例的历史图片补下载,`enabled: false` 暂停,`retryFailed: true` 可同时重排暂时失败的任务。`get_collector_status.media.instances` 返回每实例的开关、数量与等待原因。stdio 也能配置,但自动队列始终由主后台服务执行。 自定义表情使用 Teams `CustomEmoji` 的 shortcode,例如 `quby-dance;对象标识` 显示为 `:quby-dance:`。只有明确标记为自定义表情的图片才转换,普通 Emoji(例如 🔥)和正文中的单词不变。仅发送自定义表情的消息也会保存。无法识别 shortcode 时使用 `:custom_emoji:`。原有历史版本保留当时采集文本;重新解析后的当前消息采用新格式。