代理轨迹浏览器 omni-/agent-explorer

Agent Explorer Core

一个用于编码代理转录的本地 C# 库。它发现会话、读取原生记录、生成规范化事件、关联工具调用与结果、搜索内容，并计算会话的机械性事实。可选的 SQLite 索引支持增量重新扫描、跨会话查询和分页。转录来源保持只读。Core 中没有 TUI、Web UI、模型评判、遥测、代理执行或网络访问。

该解决方案面向 .NET 10。运行时包为 ZstdSharp.Port（用于 DSH 的压缩日志）和 Microsoft.Data.Sqlite（包括其捆绑的 SQLite 原生库，用于可选索引）。包通过 NuGet 还原；运行该库不需要网络、Python、Node、代理安装或账户。

构建与验证

dotnet restore AgentExplorer.slnx
dotnet build AgentExplorer.slnx --no-restore
dotnet test AgentExplorer.slnx --no-restore
dotnet format AgentExplorer.slnx --verify-no-changes --no-restore

测试使用小型、自编、已脱敏的测试夹具。data/ 下的私有真实转录和 .local/ 下的临时验证输出被 Git 忽略。

使用该库

从 .NET 使用方引用 src/AgentExplorer.Core/AgentExplorer.Core.csproj：

using AgentExplorer.Core;
using AgentExplorer.Core.Discovery;
using AgentExplorer.Core.Models;
using AgentExplorer.Core.Querying;

// No transcript paths are needed for normal Codex/Claude installations.
var available = await new SessionDiscovery().DiscoverAsync();
var descriptor = available.Sessions.First();
var session = await new TranscriptReader().LoadAsync(descriptor.PreferredInput);

foreach (var item in session.Query(new EventQuery { Text = "build" }))
{
Console.WriteLine($"{item.Timestamp}: {item.Kind}: {item.Text}");
// Native.Text and its source location are available on every event.
}

var facts = session.Statistics;
var unresolved = session.Tools.Where(tool => tool.IsMissingResult);

对于大型会话，请使用 ReadEventsAsync 和 SessionStatisticsBuilder.CalculateAsync，而不是加载所有事件。参见使用方 API 与契约。

支持的输入

| 来源 | 成功验证的输入 | 发现方式 |
| Codex | 本地 rollout JSONL，较旧和当前观察到的 schema | $CODEX_HOME 或 ~/.codex，包括已归档会话 |
| Claude Code | 本地项目/会话 JSONL | $CLAUDE_CONFIG_DIR 或 ~/.claude，跨项目 |
| OpenCode V1 | 规范的 { info, messages: [{ info, parts }] } JSON 封装 | 配置的导出目录 |
| OpenCode V2 | 结构化 JSON 导出和 Markdown /export 转录 | 配置的导出目录；为匹配 ID 优先使用 JSON |
| DSH | Storage v3 JSONL、拼接的 Zstandard 帧、包含根会话和子代理会话的 ZIP 包 | $DSH_HOME 或 ~/.dsh，以及配置的导出目录 |
V1 实时验证在规范导出信封中使用了真实数据库记录，以只读方式重建，未启动 agent 或迁移其数据库。除 v3 之外的 DSH 代际作为未知记录保留并附带警告；它们不被声称为受支持的解码器。

诊断 CLI

dotnet run --project src/AgentExplorer.Cli -- discover
dotnet run --project src/AgentExplorer.Cli -- discover C:\transcript-exports
dotnet run --project src/AgentExplorer.Cli -- stats C:\transcripts\rollout.jsonl
dotnet run --project src/AgentExplorer.Cli -- events C:\transcripts\session.json build
dotnet run --project src/AgentExplorer.Cli -- verify C:\transcripts\session.zip
dotnet run --project src/AgentExplorer.Cli -- stats C:\transcripts\session.zip DshJsonl subagents/child/session.v3.jsonl

events 输出包含原生内容的 JSONL。stats 和 verify 输出事实和原生记录哈希。verify 在解析器警告时以 2 退出，在输入/参数失败时以 1 退出，在成功读取输入时以 0 退出；它不评判 agent 的工作。关于 Markdown 保真度的信息性通知不会导致验证失败。

在将来自不同运行时的计数视为可直接比较之前，请阅读遇到的格式及其限制和验证说明。

本地索引

Explicit export directories define the catalog; omit them to use default agent locations.
dotnet run --project src/AgentExplorer.Cli -- index-scan .local/transcripts.db C:\transcript-exports
dotnet run --project src/AgentExplorer.Cli -- index-inputs .local/transcripts.db --page-size 20
dotnet run --project src/AgentExplorer.Cli -- index-events .local/transcripts.db --text build --source Codex --page-size 50
dotnet run --project src/AgentExplorer.Cli -- index-events .local/transcripts.db --session SESSION_ID --kind ToolCall,ToolResult

重复执行 index-scan 以复用未更改的输入并替换已更改的修订。每次扫描都会对源字节进行哈希；只有已更改的输入才会再次被规范化。追加、重写、截断、格式更改、解码限制更改和规范化版本更改都会重建受影响的输入。同一会话的导出和 ZIP 成员保持分离。

页面返回 Items、IndexRevision 和 ContinuationToken。提供该 token 以及 --cursor 和相同的过滤器以获取下一页。已更改的索引会拒绝旧 token；重新启动查询以查看新修订。输入页面按稳定的输入 ID 排序；事件页面按输入 ID 和原生序列排序。即使源文件离线，查询也使用持久化数据。
当发现、输入读取或新索引的解析器诊断报告问题时，index-scan 以 2 退出。失败的输入保留其先前修订版本。发现类问题会阻止移除缺失的输入，直到成功扫描为止。查询失败（包括过期游标）以 1 退出。有关库用法和限制，请参阅索引 API 与存储契约。