后台 API 采集到新消息中的 Teams 图片后,会自动保存到 DATA_DIR/media/。图片文件和下载队列持久化到本机,不需要 Teams 网页或扩展常驻。每张图片关联本地消息、账号和实例;下载使用所属实例当前会话中的 IC3 凭证,跟随现有独立续期流程更新,不会借用其他账号的令牌。
在「后台 API 采集」选择实例,点击「历史图片自动补下载 → 开启补下载」,即可把该实例已有的未下载图片加入队列。之后历史补录新发现的图片也会自动加入。每个实例独立保存开关、队列与重试进度,关闭控制台页面不影响运行,重启后自动继续。未开启的实例仍可在单条记录详情按需下载。
同一位置显示已保存、待处理、失败数量,可暂停补下载,或批量重试网络、权限等暂时失败的图片。暂停会在正在下载的这一张完成后生效,不影响新消息图片和其他实例。停止实例则暂停其全部自动下载。已保存且文件仍存在的图片不会重复下载;重新开启时会检查并补回缺失的本地图片文件。
HISTORY_REQUEST_MIN_DELAY_MS / HISTORY_REQUEST_MAX_DELAY_MS 配置。限流时遵守 Retry-After,不会阻塞其他实例。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:。原有历史版本保留当时采集文本;重新解析后的当前消息采用新格式。