OpenRig rig transcript 完整教程：持久化终端转录捕获与全文检索

OpenRig rig transcript 完整教程持久化终端转录捕获与全文检索【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 的rig transcript命令把每个智能体Claude Code、Codex 等终端会话的输出持久化捕获为转录文件并提供--tail快速回放与--grep正则全文检索两大能力——即使会话已经结束你也能随时追溯当时发生了什么。本教程带你快速上手这套终端转录捕获与检索工作流。为什么需要 rig transcript 转录命令多智能体团队在终端里并行干活但 tmux 滚屏scrollback容量有限、重启即失很难事后审计某个 agent 到底做了什么。OpenRig 的转录系统解决的就是这个问题持久化原始终端输出通过 tmuxpipe-pane持续追加写入磁盘日志文件与终端存活无关可读性读取时自动剥离 ANSI 转义码、过滤启动横幅与 UI 装饰行留下干净文本可检索内置正则搜索跨整个会话历史做全文检索底层设计在 transport-and-transcripts.md 中有完整说明transcripts are raw capture via pipe-pane, ANSI strip on read。转录捕获原理pipe-pane 持续写入日志文件捕获链路非常简洁核心步骤如下NodeLauncher在 tmux 会话创建后立即启动pipe-pane先于 agent 框架启动原始终端输出实时流入~/.openrig/transcripts/{rig-name}/{session-name}.logTranscriptStore负责路径约定、读取时 ANSI 剥离、readTail与grep实现rig transcript session命令面向你暴露 tail / grep 读取入口相关文件位置存储与清洗逻辑transcript-store.ts捕获健康检查live / degraded / unavailable 三态transcript-store.tsHTTP 路由tail / grep / full 三个端点transcripts.ts还有一个贴心的细节如果读取时发现捕获缺失例如旧会话路由层会自动补启动捕获并在下次重试时返回内容而不是干巴巴地报错见 transcripts.ts。快速上手4 个最常用的命令rig transcript的完整用法为rig transcript session [--tail lines] [--grep pattern] [--host id] [--json]定义见 transcript.ts。1.--tail N查看会话最后 N 行默认 50rig transcript dev-implmy-rig --tail 100适合看一眼它最近在干嘛的场景输出是清洗后的纯文本。2.--grep pattern正则全文检索rig transcript dev-implmy-rig --grep decision|architecture模式按正则处理无匹配时输出No matches found.。当--grep与--tail同时给出时--grep优先。3.--json结构化输出方便程序消费rig transcript dev-implmy-rig --json返回会话名、行数、内容与捕获健康状态便于脚本或 agent 自动化处理。4.--host id跨主机读取远程 rig 的转录rig transcript dev-implmy-rigvps-b --grep handoff三段式agentrighost是--host的语法糖要求后缀是已注册主机 ID。远程读取直连远端 daemon 的转录路由输出与本地完全一致仅多一行[via host…]横幅。命令细节与示例更多可参考 cli-reference.md。全文检索最佳实践用管道符组合关键词--grep handoff|error|TODO一次覆盖多个关注点配合--json落盘把匹配结果导入其他工具做二次分析先 tail 后 grep先用--tail 20判断会话活跃度再决定是否全文检索注意捕获健康提示如果输出少于 6 行CLI 会在 stderr 给出thin transcript提示通常意味着该 seat 使用了全屏渲染器alternate screen 不产生 scrollback重新启动会话即可恢复捕获见 transcript.ts转录功能未开启怎么办转录默认随rig up自动启动如果显示被禁用执行rig config set transcripts.enabled true配置项还包括transcripts.path自定义存储路径详见 cli-reference.md。小结能力命令典型场景尾部回放--tail N快速查看最近输出全文检索--grep regex追溯决策、错误、交接点程序消费--json自动化审计跨主机--host/agentrighost分布式 rig 团队rig transcript让终端输出即历史变得可靠捕获是原始 pipe-pane 落盘读取是按需清洗检索是正则全文——三件事各司其职构成一套对新手友好、又经得起生产检验的观测体系。【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考