# 多实例与在线设置 0.5.0 的多实例用于默认网页 API 采集路线。可选 Graph 登录仍使用原有单配置;浏览器扩展的账号标签不自动变成已登录实例。 ## 添加账号 在「后台 API 采集」填写名称并新增实例,选择该实例后从工具登录。每个实例使用独立的浏览器资料目录,成功登录后保留该目录以供续期,关闭窗口后由后台 API 同时采集多个账号。管理实例选择框只切换当前操作对象,不会停止其他实例;资料库的实例筛选独立设置。 0.6.0 起自动续期默认随实例采集运行:优先直接刷新访问令牌,必要时短时使用本实例的无窗口浏览器会话恢复;停止实例会中止续期并关闭其恢复浏览器。控制台显示到期时间、最近成功时间、重试与交互要求;MCP `list_instances` 仅返回这些安全状态。升级前的会话没有刷新材料,需要每实例完成一次工具登录。详见 [自动续期](AUTO-RENEWAL.md)。 登录后按已捕获接口提示操作:已有消息接口即可直接尝试完成,无需打开指定聊天;消息接口仍为 0 时,等待 Teams 加载或打开任意聊天。日历可选,若需要同步且本次尚未捕获日历接口,再打开日历。消息和日历分别验证,不能仅凭消息验证成功断言日历凭证有效。 实例使用稳定的 ID,名称可以修改。同一个已识别账号只绑定一个实例;重新登录必须匹配原实例的已绑定身份,换账号请新增实例。接口请求、游标和记录归属会校验账号,无法识别身份时不会尝试混用其他实例的凭证。 首次会话验证通过后即保留账号归属。如果随后保存文件失败或登录被取消,请在原实例重试同一账号;工具不会自动将这个账号分配给其他实例。 默认实例沿用 `data/network-session.har` 及原有采集断点;新增实例保存到 `data/instances/<实例 ID>/`。数据库共用本机 SQLite,消息通过来源与账号关联实例。账号失效、登录窗口取消和停止采集均按实例处理。 服务重启遵循各实例上次保存的启动/停止设置。`NETWORK_AUTO_START` 仅在默认实例尚无持久设置时使用,不会覆盖用户停止、删除或导入后的停止状态。 如果会话已保存,但历史采集器初始化遇到不支持的参数或无效断点,0.5.2 起仍会运行实时聊天和日历同步,并单独显示「历史补录暂不可用」。工具保留原断点,修复适配后可停止并重新启动此实例重试;该提示本身不代表需要重新登录。 ## 会话名称补采 0.5.3 起,实例在后台同步时会沿已验证消息实际返回的同源 `conversationLink` 读取会话详情,从 `threadProperties.topic` 获取名称。账号、会话与来源均需匹配;不会猜测详情地址。每轮最多读取 3 个会话,成功后缓存 30 分钟,失败不阻断聊天正文同步。控制台「会话名称」显示本轮读取、更新及待处理数量。 补名完成后,资料库和 MCP 可显示、搜索同账号的当前会话名称,无需重新补录消息。原消息 `raw`、哈希和历史版本保持不变;在「原始字段与历史版本」中看到 `versions[].title` 仍为「聊天消息」,表示该版本最初保存时尚无名称,不代表当前会话名补采失败。尚未获得有效名称时仍显示占位标题。 0.5.4 起,即使同一会话最后一次抓包返回空增量,仍会从此前验证过的抓包响应建立补名计划;历史页保存后也会提供会话链接,下一轮同步读取名称。正文请求继续使用最后保存的模板和当前凭证。若请求提示 401/重新登录,需要在该实例完成登录更新凭证;本地旧记录不会因此被删除。 0.5.5 还可在本地补全对方显示名称:仅接受包含两个不同完整用户 ID 的已支持会话标识,当前账号必须是其中一人;同账号、同会话中的发送者须与这两人相符,再读取对方的最新已保存姓名。明确标题、群聊/会议证据、身份冲突或遮罩不会被这条兜底规则覆盖。此补名不需要有效的远端凭证,也不修改消息正文或历史版本;显示名称本身不授予“私聊提醒”的分类证据。 ## 保持在线/可用 该开关控制 Teams 状态心跳,后台数据采集另由启动/停止按钮控制。开关默认关闭;开启后仅在此实例运行时检查并续期,关闭或停止实例即停止心跳。 工具只使用已捕获且验证属于本人的状态读取与 Available 终端会话请求。不会重放手动强制状态接口;忙碌、会议、免打扰、外出和有效手动离线状态会暂停续期。缺少模板、凭证失效、请求失败或限流会显示状态,不能将“开关已启用”理解为 Teams 已确认在线。关闭心跳后,最终状态由 Teams 的会话超时及聚合规则决定。 在临时登录窗口打开头像状态面板并手动选择可用,可一并捕获所需接口。已有抓包也可以导入:将包含敏感数据的 HAR 留在本机 `data/captures/` 中,在当前实例输入文件名。工具仅保存经过验证的状态请求,拒绝不属于此实例的身份,并保持实例停止,等待用户启动。 在线维持不续签登录令牌。公司授权、手动首选状态和其他客户端状态仍可能影响最终显示,凭证过期后需要重新登录。 ## 删除本地记录 选择实例,展开「删除账号的本地记录」,选择账号并预览删除数量。勾选确认后,工具停止该实例的采集、登录和在线心跳,再删除指定来源与账号的记录、版本、变更、首次实时观察及关联 WebHook 投递记录。 其他账号数据保留。实例、账号绑定和提醒订阅也保留,可以继续使用;再次启动会重新采集,历史可能被补回。删除不修改 Microsoft 云端数据,也不清理原始 HAR、独立数据库备份或接收端已经收到的提醒。 `demo` 和 `browser:*` 通常没有绑定 API 实例。0.5.1 起,可在「本地资料库 → 删除示例 / 浏览器记录」中选择来源与账号,预览数量并勾选确认后删除,无需创建实例或登录。此入口删除该账号所有类型的本地记录及关联版本、变更和提醒投递,不受当前搜索、日期或聊天/日历标签筛选影响;其他账号和 API 实例继续保留。 浏览器扩展仍开启时,页面内容可能被再次上传;删除浏览器记录前请先在扩展中暂停采集。删除示例后也可通过「添加明确标记的示例记录」重新生成。若该账号已绑定实例,请使用对应实例的删除入口。 ## MCP 的实例和时间筛选 先调用 `list_instances` 找到实例 ID,再调用: ```json { "instanceId": "default", "from": "2026-09-08T00:00:00+08:00", "to": "2026-09-09T00:00:00+08:00", "limit": 50 } ``` 这是 `search_messages` 的参数,可另外加 `q`、`chatId`、`source` 或 `accountId`。至少提供一个有效筛选条件;时间采用包含开始、不包含结束的范围,必须注明时区。没有可靠原始日期的记录不进入时间范围结果。改变实例、时间或其他筛选条件后,需要重新开始分页,不能复用旧游标。 聊天目录、上下文和日历也支持实例范围。HTTP MCP 可读取运行状态;stdio 只知道持久设置,不把其他进程是否运行或账号是否在线猜成成功。账号记录删除由本地控制台执行,MCP 不提供通用删除工具。