开发指南

前端开发模式（磁盘优先加载）

collector 二进制在编译时通过 RustEmbed 将前端资源内嵌。默认情况下，每次前端改动都需要重新编译 collector（cargo build --release）才能生效。

为加速前端开发，可设置 AGENTSIGHT_FRONTEND_DIST 环境变量，让 collector 直接从磁盘目录读取前端资源。这样只需重新构建前端并重启 collector，无需重新编译 Rust 代码。

使用方法

# 1. 构建前端
make build-frontend
 
# 2. 设置环境变量启动 collector
AGENTSIGHT_FRONTEND_DIST=./frontend/dist sudo -E ./collector/target/release/agentsight record -c claude --binary-path /opt/node-v22.20.0/bin/node

之后每次修改前端：

make build-frontend
# 重启 collector 即可生效，无需 cargo build

工作原理

collector 启动时检查 AGENTSIGHT_FRONTEND_DIST 环境变量。
已设置 — 直接从指定目录读取文件，跳过内嵌资源解压流程。目录中必须包含 index.html。
未设置 — 使用默认行为：将 RustEmbed 内嵌资源解压到临时目录，退出时自动清理。

注意事项

使用 sudo -E 以在 sudo 下保留环境变量。
路径支持相对路径（如 ./frontend/dist）和绝对路径。
生产环境中不要设置此变量，将正常使用内嵌资源。

继续阅读

返回索引

AgentSight：基于 eBPF 的零侵入 LLM 智能体可观测性工具

![License: MIT](https://opensource.org/licenses/MIT) ![CI](https://github.com/eunomia-bpf/agentsight/actions/workflows/ci.yml)

Build From Source

Use this guide when developing AgentSight or building a local binary from the repository. If you only want to run a release binary, see the Quick Start in README.md.

Docker Usage

Use Docker when you want a packaged AgentSight runtime for container, CI, or isolated Linux environments.

最后更新: 2026年6月3日
首次发布: 2026年6月3日
贡献者: LinuxDev9002

编辑此页分享到 X 分享到 Facebook 参与讨论 RSS 订阅

这个页面有帮助吗？