IMAGES.md 3.6 KB

聊天图片与自定义表情(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:。原有历史版本保留当时采集文本;重新解析后的当前消息采用新格式。