用途：Seq 用于从 Codex 的 rollout JSONL 及会话/状态元数据、受支持的 OpenCode 执行/会话来源，以及调用方显式提供的不可变输入关系中，重建带溯源的观测结果。它只读取上述来源，不会隐式扫描内存根、Ledger 存储或制品目录。
主要能力：提供 seq version、seq capabilities、seq definition check/describe、seq observe、seq explain、seq sessions、seq turns、seq session-detail、seq tool-lifecycle、seq session-graph、seq tail、seq find-session、seq datasets、seq dataset-schema、seq query、seq index 等原生命令，用于物理会话结构查询与观测。内置标准定义包括 message-search、session-summary、token-usage、tool-search、turn-metrics、turn-report。token-usage 按源顺序重建累计 token 变化，处理现代行的 (total - last) 到 total 转换，并给出缓存输入占比口径。
使用方式：先运行 seq version 与 seq capabilities --format json，确认主版本为 1 且支持 seq-observation-abi/v1。选择 OpenCode 提示历史需显式指定 --path ~/.local/state/opencode/prompt-history.jsonl。组成持久事实需先完成 ledger ensure，再用 ledger project 生成 facts.json，然后通过 seq observe --definition ... --input facts=facts.json 执行。示例：seq observe --definition "$seq_definition_root/token-usage.json" --root "${CODEX_HOME:-$HOME/.codex}/sessions/2026/07" --since 2026-07-01T00:00:00-07:00 --until 2026-08-01T00:00:00-07:00 --projection summary --format json。
适用场景：需要基于会话与工具生命周期证据进行有界、可溯源的观测与查询时。限制：Seq 不验证持久制品，也不授予行动、修复、审查、发布或关闭权限；不隐式读取 Ledger 或内存根；不得以 shell、jq、Python、插件或子进程替代缺失算子；原始 turns 或会话 token 求和不得当作谱系语料用量；固定时间窗口不等于不可变语料快照。报告中应保留定义标识、ABI 与版本、适配器结构版本、会话 ID、时间范围、时区、包含与排除项、扫描行数、污染及不确定性。worker 仅在请求或相关证据出现时纳入，且不与根分母合并。