项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 1346
使用教程
⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。
环境要求
- 能访问 GitHub 与官网文档的网络环境
- Node.js 运行环境（项目使用 TypeScript 编写）
- 一个已可运行的 AI Agent 项目（用于接入追踪）
- TraceRoot 账号（可使用托管云服务 app.traceroot.ai）
安装与启动步骤
-
1确认接入方式
README 同时提供云端控制台和自建仓库，先决定用托管服务还是本地部署，再继续后续步骤。
-
2克隆代码仓库
把源码拉到本地，便于查看自建部署说明和前端界面代码。
git clone https://github.com/traceroot-ai/traceroot.git cd traceroot -
3阅读仓库说明
仓库提供多语言 README，先看中文版与 Getting Started 小节，确认是否有新增部署命令。
cat README.zh.md -
4查阅官方文档
打开官网文档的入门章节，按其中的快速开始完成账号、项目与接入配置。
-
5在 Agent 中接入追踪
按文档把追踪能力接入现有 Agent，运行后即可在控制台查看执行链路与耗时。
如何确认成功
运行一次 Agent 后，在 TraceRoot 控制台能看到对应的追踪记录与调用链路，即表示接入成功。
常见问题
Q：仓库里为什么找不到安装命令？
A：README 的 Getting Started 部分尚未给出具体命令，请以官网文档 traceroot.ai/docs 的快速开始为准，不要自行猜测包名和参数。
Q：一定要自己部署吗？
A：不一定。README 提供了托管云服务入口 app.traceroot.ai，可以直接使用；自建则需参考仓库内说明。
Q：支持哪些 Agent 框架？
A：README 节选未列出具体支持列表，请在官网文档的集成章节确认后再接入。
Q：追踪数据包含什么内容？
A：按项目定位，会记录 Agent 每一步决策、工具调用、LLM 请求、上下文、耗时与错误信息。
注意事项
- README 节选未提供完整安装步骤，本教程仅包含通用准备动作，实际命令以官方文档为准。
- 项目处于早期阶段，接口和部署方式可能发生变化，部署前先看最新文档。
- 云端与自建两条路径的配置项不同，选定后不要混用两套说明。
核心亮点
- 提供 Agent 执行链路追踪，能定位工具调用与 LLM 请求的失败点
- 内置分析能力，把追踪数据转化为可操作的优化依据
- 定位自我改进层，不止监控，还支持基于反馈迭代 Agent 行为
不足之处
- 项目处于早期，生态集成与文档完善度有待观察
- 生产级大规模部署的稳定性与性能数据尚不充分
适用场景
- 调试生产环境中行为异常的 AI Agent
- 分析 Agent 各步骤耗时与成本，做性能优化
- 基于追踪数据评估并迭代 Agent 的提示与工具策略
替代项目
Langfuse、Phoenix、Helicone
上一篇：airbyte
下一篇：ai-observer
同类项目推荐
floe-guard
开源
给语音代理装上费用闸门，超支自动叫停
AI Initiative Ledger — local spend meter and budget gate for AI tasks. Meters every···
os-moda
开源
跟服务器说人话，AI 替你干活，改坏了秒回滚
An operating system built for AI agents — talk to your NixOS server instead of SSH-···
aisbom
开源
给 AI 模型和数据集做“成分表”，让供应链透明可审计
Static security scanner for ML model files — detects pickle bombs, Keras Lambda RCE···
mloda
开源
插件化数据访问，让 AI 应用轻松获取可追溯的数据上下文。
mloda.ai - Open Data Access for AI and ML. Plugin-based. Traceable. Framework-agnost···
markify
开源
把各种文件秒变 Markdown，让 RAG 和 LLM 更懂你
Convert files into markdown to help RAG or LLM understand, based on markitdown and M···
node-llama-cpp
开源
在 Node.js 里直接跑本地大模型，还能强制输出合法 JSON
Run AI models locally on your machine with node.js bindings for llama.cpp. Enforce a···
new-api
开源
一个网关接入所有大模型，协议随意转换，省心又省钱
Open-source AI gateway. Self-hosted LLM gateway with OpenAI-, Claude- and Gemini-com···
claw-compactor
开源
超长对话自动压缩，花小钱办大事不丢内容
14-stage Fusion Pipeline for LLM token compression — reversible compression, AST-aw···
Lexoid
开源
把脏乱数据变成 AI 能用的干净上下文
The open-source universal adapter for LLMs. Turn messy real-world data into clean, a···