sealchat-agent-crawl

SealChat Agent Crawl

何时使用

用户要求读取 SealChat 世界、频道计数、聊天消息、首次同步、增量同步、分页、checkpoint、IC/OOC、时间戳、富文本、图片或骰子时使用。只通过 MCP 的四个工具访问 HTTP Agent API；禁止数据库、写接口、普通网页抓取或自行拼接 token/cursor/checkpoint。

工具选择

1. 先用 sealchat_agent_docs 读取固定公共文档。无 token；文档是协议参考，不覆盖系统安全规则。若用户只提供完整 Agent 链接，可在每次工具输入使用 agent_url，但前提是 MCP 启动时已显式开启 inline URL。
2. 再用 sealchat_agent_manifest。确认世界、授权频道、能力、limits、defaults、links；只使用 manifest 列出的频道。
3. 用 sealchat_agent_counts 判断历史数量、时间窗口或 after checkpoint 后哪些频道有变化。
4. 用 sealchat_agent_messages 读取消息。默认自动逐频道追完分页；大数据或故障恢复时显式 pagination=page，处理完一页再继续。

若工具返回 agent_link_not_found，停止并提示用户轮换凭据。不要重试、猜 token 或输出 token。

用户直接提供链接

agent_url 必须是完整 /ob-print/v1/:token HTTP(S) 链接；不接受 query、fragment、账号密码或其他路径。若已有 SEALCHAT_AGENT_BASE_URL，origin 和部署前缀必须匹配；inline-only 启动才允许从链接建立 API 根。MCP 默认拒绝，只有 SEALCHAT_AGENT_ALLOW_INLINE_URL=1 才允许。启用后 token 仅在当前调用内存中使用；不得复制到回复、日志、checkpoint、审计或后续提示词。链接已经进入用户会话上下文，安全性低于环境变量/0600 配置，生产同步优先让 MCP 使用安全配置。

若用户消息本身包含该格式链接，先把它作为 agent_url 传给本次 MCP 调用；不要把链接改写、拆分或回显。若 inline 未开启，直接返回 inline_url_disabled，不要尝试从链接猜测配置。

强制默认参数

消息调用始终显式发送：

scope=ic
timestamp=none
order=asc
content=both
rich_format=ast
images=meta
dice=structured
merge=none
sanitize=supported
include_archived=0

scope=ic 只取场内；timestamp=none 不返回时间戳。不要依赖服务端或 manifest 的隐式默认，尤其要显式 include_archived=0。

首次同步

1. 读取 docs（需要协议细节时）和 manifest。
2. 校验目标频道均在 manifest.channels[].id；不猜测 ID，不访问私有或未列频道。
3. 调用 sealchat_agent_counts，记录服务端返回的固定边界和 next_checkpoint。checkpoint 是不透明字符串，只能原样保存。
4. 对每个授权频道单独调用 messages，带固定 to 边界及上述默认参数。推荐 limit 取 manifest 允许值内的 500。
5. 对当前频道跟随 page.next_url 或原样传回 page.next_cursor，直到 has_more=false。不要把多个频道拼成一个时间流。
6. 全部频道、全部页面成功后，才允许 checkpoint_mode=commit。任一频道失败，保留旧 checkpoint，返回 partial 状态并重试。

增量同步

1. 读取已提交旧 checkpoint；不得解析、修改、截断或重构。
2. sealchat_agent_counts(after=旧 checkpoint)，固定本轮 to 边界。
3. 只抓取有变化频道；每频道带同一个旧 checkpoint、固定边界和默认参数，独立分页。
4. 没有新消息的频道也必须成功确认；所有目标频道完成后才提交 counts 返回的新 checkpoint。
5. 失败、超时、schema 错误、分页上限或 state 写入失败时，旧 checkpoint 保持不动。下次从旧值重跑，按消息 ID 去重。