rrweb-stack 是 Cubenest 维护的一个开源仓库，包含两个建立在同一 rrweb 基础上的开源产品：tracelane 与 peek。两者目前均以 npm 包形式发布，强调本地优先、不使用 SaaS、不包含遥测。
用途与产品定位
- tracelane：用于测试阶段，为 WDIO（WebdriverIO）、Playwright、Cypress 生成自包含的 HTML 测试失败回放，团队与 AI 代理可离线读取。
- peek：用于本地优先的浏览器会话取证与复现，面向 AI 编程代理，通过 MCP 提供会话查询能力，并可在用户明确逐源同意后驱动实时页面。
共享底层 两个产品共用 @cubenest/rrweb-core，这是 PostHog rrweb 分支的 vendored 版本，包含 PII 脱敏原语、大 DOM 节流、截图回退、网络与控制台捕获抽象、压缩辅助等能力。该分支通过 SHA 固定，底层 NOTICE 同时注明 PostHog 插件谱系与上游 rrweb 来源。
使用方式
- tracelane：在项目中使用 npx @tracelane/cli init 初始化，会检测运行器、执行安装、编辑 wdio.conf.ts，并忽略 reports 目录。tracelane-wdio 的 README 是合适的起点，文档位于 tracelane.cubenest.in。
- peek：需要 Node.js ≥ 22，其原生依赖 better-sqlite3 仅为 Node 22+ 提供预编译二进制文件；在更旧版本 Node 上（尤其是默认没有 C/C++ 工具链的 Windows）安装会回退到从源码编译并失败。文档位于 peek.cubenest.in。peek 的会话数据保留在 ~/.peek，可通过 MCP 被 AI 编码代理查询。
主要能力
- 录制已认证的浏览器会话，包括 rrweb DOM、控制台与网络数据，写入本地 SQLite，并进行 PII 脱敏。
- peek 提供会话列表与查看命令，例如 peek sessions list、peek sessions show ... --format markdown，可将录制的浏览器会话输出为可查询的结构化内容，便于 AI 使用。
- peek 的实时读取与操作工具受五级按源权限模型控制：0 关闭、1 只读、2 仅建议、3 确认后执行、4 YOLO；默认级别为 1。另设破坏性操作黑名单，此类操作始终会提示。
- 无遥测、无云端，全部保留在 ~/.peek。
适用场景
- 测试失败时生成可离线分享与阅读的 HTML 回放。
- 让 AI 编程代理查询真实浏览器会话以复现问题、辅助调试。
- 在用户明确授权的前提下，让代理通过实时页面执行操作。
限制与当前状态
- 项目处于 1.0 之前，两个包均为 alpha 阶段。
- peek 仅支持 Node.js ≥ 22，旧版本 Node 安装可能失败。
- peek 的实时读写受权限门控，默认只读；驱动实时页面需要逐源明确同意。
- 关于具体收费、价格或更多平台支持信息，资料中暂未提供。
许可与协作 项目采用 Apache-2.0 许可，所有贡献需 DCO 签署。安全漏洞可通过 SECURITY.md 上报，共享威胁模型见 docs/SECURITY-NOTES.md。仓库 main 分支启用了分支保护（PR + CI + DCO + 线性历史），工作流使用 Trusted Publishing OIDC 与 SLSA 溯源，Renovate 以 7 天冷却期（@posthog/rrweb 谱系为 21 天）和 config:best-practices 运行。项目接受 GitHub Sponsors 支持，维护节奏见 docs/SUSTAINABILITY.md。
