【开源自荐】OrcaReplay：把一次 AI agent 运行录成可反复重放的本地产物
还没有人认领这个 Issue。
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 48/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- ai-infra-agents, nodejs
- 领域
- content
调研方向
首先查看此 issue 中的 OrcaReplay 项目详情和仓库链接。确认提交内容符合月度仓库的选择标准，并确定项目推荐应出现的位置；完成意味着该条目已被接受并添加到相应的月度内容中，或已说明原因后被拒绝。
由索引模型根据 Issue 内容生成。
描述
项目名称
OrcaReplay
项目地址
https://github.com/Continuum-AI-Corp/OrcaReplay
快速开始
npm i -g orcareplay # 安装后命令行叫 orca，Node 20+
orca mcp # 把本地 trace 库暴露给 MCP 客户端
项目简介
OrcaReplay 把一次 AI agent 的运行变成可反复重放的本地构建产物。它以 HTTP 代理的形态夹在 agent 程序与模型服务之间，把这次运行的全部 provider 流量（prompt、工具调用、响应、原始字节）原样落盘成 trace；之后可以在不联系任何模型服务的情况下重放这次运行、diff 两次运行的差异，或把同一份录像 fork 到另一个模型上重跑。Apache-2.0，独立 CLI + npm 包，非托管服务，无 API key，无日志外发。
推荐原因
- 把"不可复现"变成可复现：AI 应用里最难工程化的部分是一次运行无法重现——模型是非确定性的、远端状态会变、上下文会被截断。OrcaReplay 的做法是把 wire 上的东西先录下来，让"复现"这件事不再依赖再次请求 provider。
- 离线可用，适合放在 CI 里跑回归：重放不需要网络、不需要额度，因此可以把真实录制下来的流量当作测试用例集，验证升级 prompt / 更换模型 / 改动中间件之后行为是否漂移，而不是只凭stdout 日志判断。
- 字节级而非摘要级：保留的是原始字节而不是结构化摘要，所以做 tool-call 解析、token 统计、中间件兼容这类工作时，可以拿真实流量做离线回归，不必每次调真模型。
- 框架无关：工作在 HTTP 层，不侵入框架。OpenAI Agents SDK、OpenHands、LangGraph、Aider、Vercel AI SDK / Mastra、goose、CrewAI、LlamaIndex、Agno、smolagents、AutoGen、Strands、CAMEL、DSPy、Haystack 等在 CI 里有回归覆盖。
- 可被另一个 agent 消费：
orca mcp提供 list / show / checkpoints / graph / replay / compare 六个工具读取本地 trace 库，也可以作为 coding-agent skill 使用。
适合分类
AI 工程化 / 开发者工具 / 调试与可观测性
Disclosure: I maintain OrcaReplay.
- 主要语言
- 没有语言数据
- 星标
- 854
- 派生
- 19
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
OpenGithubs/monthly 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 42/100
OpenGithubs/monthly#31 ·
-
难度 2/5 1-3 小时 新手友好度 35/100
OpenGithubs/monthly#30 ·
-
难度 5/5 一周以上 新手友好度 20/100
OpenGithubs/monthly#28 ·
-
难度 1/5 1 小时以内 新手友好度 42/100
OpenGithubs/monthly#27 · 1 条评论 ·
-
难度 1/5 1 小时以内 新手友好度 35/100
OpenGithubs/monthly#26 ·
查看 OpenGithubs/monthly 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 85/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
obophenotype/human-phenotype-ontology#11798 ·
-
Add HuskHoard未关闭addition
难度 2/5 1-3 小时 新手友好度 62/100
awesome-selfhosted/awesome-selfhosted-data#3179 ·
维护者通常 1 天内回复
-
good first issue
难度 2/5 1-3 小时 新手友好度 72/100
Progressive-Victory/the-website#653 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 68/100
cline/mcp-marketplace#2881 ·