VisionClaw 交互Trace与研究数据导出Tracer批量上报系统与导出工具链完全指南【免费下载链接】VisionClawReal-time AI assistant for Meta Ray-Ban smart glasses -- voice vision agentic actions via Gemini Live and OpenClaw项目地址: https://gitcode.com/gh_mirrors/vi/VisionClawVisionClaw 是 Meta Ray-Ban 智能眼镜上的实时 AI 助手通过语音、视觉与 Agent 动作帮你完成各种任务。它内置了一套交互TraceInteraction Trace批量上报系统用户说了什么、助手回复了什么、执行了哪些工具动作都会被 Tracer 记录下来并批量上报到 gateway配套的研究数据导出工具链一条命令就能把全部交互历史导出成 CSV 表格和 Markdown 摘要报告方便研究人员分析真实使用情况。为什么智能眼镜助手需要交互 Trace普通应用日志只关心接口有没有报错而 VisionClaw 是一项部署研究deployment study研究者需要回答更细的问题——用户实际让助手做了什么事天气查询、购物清单、日历预约、网页搜索……助手调用了哪些工具、参数是什么、耗时多少、是否失败一轮对话为什么中断stop_reason这些细节在普通的任务列表里看不到。Trace 系统为每个用户生成一份独立的 JSONL 文件完整记录每次调用的文本轨迹。值得注意的是Trace按设计只记录文本出于研究隐私协议事件里永远不会携带图片gateway 在入口处还会主动剥离一切疑似图片字段的键名双保险确保数据卷里只有文字。Tracer 批量上报agent 端的设计不拖累语音循环Trace 的生产者住在语音 worker 里——agent/main.py 中的Tracer类。它的设计目标很明确记录行为绝不能干扰实时语音对话。批量上报采用双触发策略机制规则作用数量触发本地攒满20 条事件高频对话时尽快落库时间触发后台每5 秒定时 flush低频对话也不让事件积压几个值得借鉴的工程细节失败重排队而非阻塞上报失败如瞬时超时时整批事件会被放回队列等下一次 tick 再发——研究数据晚到比丢失好。队列上限 500 条先丢最旧只有 gateway 长时间宕机才会真正丢数据且丢的是最旧的事件语音循环始终不受影响。超长字段截断单字段超过 2000 字符自动截断并标记...[truncated]防止异常负载撑爆存储。gateway 安全落盘文本过滤门禁上报入口是 gateway 的POST /trace接口gateway/src/server.ts它把事件交给 gateway/src/trace.ts 的appendTrace落盘。这里有一道隐私门禁禁用键名单image、frame、screenshot、jpeg、png等键名在入口处直接丢弃在门口拦截而不是事后信任单批次上限 200 条字段超限截断写入串行化所有追加操作走同一条 Promise 链并发批次绝不会在文件里交错出半行数据读取端readTrace支持since游标翻页为导出工具的全量拉取打下基础。实时查看Trace Dashboard想边用边看gateway 提供了一个静态仪表盘页面gateway/public/dashboard.html直接访问部署地址的/dashboard路由即可。页面本身不带鉴权——你在页面里输入自己的 gateway token它就以你的身份调用GET /trace查询数据。在应用端历史对话也可以在设置面板的 History 一栏里快速回看研究数据导出工具链一条命令生成 CSV 与摘要这是整个工具链的终点。gateway/src/trace-export-cli.ts 提供了trace:export命令脚本定义见 gateway/package.json# 导出单个用户的全部交互 Trace npm run trace:export -- userId [--since ISO] [--out dir] # 批量导出所有用户并生成总览报告 npm run trace:export -- --all [--since ISO] [--out dir] # 离线模式跳过网络直接读本地 JSON 转储 npm run trace:export -- fixture --from-file gateway/test-fixtures/trace-sample.json导出工具会分页拉取该用户的全部事件每页 1000 条沿时间游标前移直到拉空然后按会话切分并生成一份目录每个用户三个文件文件内容events.csv逐条事件时间戳、所属会话、类型、角色/工具名、正文、其余字段 JSONsessions.csv每个会话一行起止时间、时长、引擎、采集模式、用户轮次/助手轮次、按工具统计的动作数summary.md人类可读摘要总量、采集模式分布、各工具调用排行、子 Agent 工具深度与耗时、错误与延迟事件清单用--all时还会额外产出两份研究者专属文件总览summary.md全体用户的事件/会话/轮次/动作/问题数汇总表participants.csv按注册时间生成稳定假名p01、p02……的参与者名册——研究从此无需手工维护ID ↔ 真人映射天然保护隐私。几个研究场景的小技巧会话自动分组以session_start为界、session_end收尾若某次通话的起始事件被队列裁掉导出工具会智能地合成一个标记为 partial 的会话而不是报错。条件标注回填早期会话可能没有内建的采集模式标签工具会用操作员记录 gateway/study-assignments.json 按时间窗口回填但只补空、不覆盖日志证据。离线试跑仓库自带样例数据 gateway/test-fixtures/trace-sample.json含查天气、购物清单、日历预约、延迟送达结果等真实形态事件本地用--from-file即可零成本体验完整导出流程。回合级调试npm run trace 快速定位问题导出工具面向全量研究那刚出问题的单次会话怎么快速排查用 gateway/src/trace-cli.tsnpm run trace # 默认用户 demo最近 5 个回合 npm run trace -- demo 20 # 用户 demo最近 20 个回合它直接从托管 Agent 的事件日志读取数据把工具调用与工具结果配对后逐回合打印一条时间线用户说了什么USER、助手想了什么think、调用了哪个工具、参数是什么、耗时多少毫秒、结果是ok/ERROR/no result以及每轮为何结束stop_reason非end_turn会明确标出回合未完成。结尾还附上工具错误总数——排查时一眼定位。相关文件速查模块路径职责Tracer 批量上报agent/main.py事件产生、批处理、失败重排队落盘与过滤gateway/src/trace.ts隐私门禁、JSONL 存储、游标读取上报/查询接口gateway/src/server.tsPOST /trace与GET /trace仪表盘页面gateway/public/dashboard.html实时会话列表与时间线回合级调试 CLIgateway/src/trace-cli.ts单会话逐回合时间线研究导出 CLIgateway/src/trace-export-cli.tsCSV 导出、摘要与名册生成条件标注记录gateway/study-assignments.json操作员分组时间窗口样例数据gateway/test-fixtures/trace-sample.json离线导出试跑小结VisionClaw 的 Trace 体系把实时性和完整性分开治理agent 端用攒 20 条或 5 秒一 flush的批量上报 失败重排队保证研究数据尽量不丢、且绝不拖累语音体验gateway 端用文本过滤门禁守住隐私底线最后由trace:export工具链一键产出 CSV 与 Markdown 摘要让研究者拿到即用。如果你想深入了解这套系统建议先用--from-file跑一遍样例数据再顺着上表的路径阅读源码——从上报到落盘、从查询到导出整条链路都非常值得参考。【免费下载链接】VisionClawReal-time AI assistant for Meta Ray-Ban smart glasses -- voice vision agentic actions via Gemini Live and OpenClaw项目地址: https://gitcode.com/gh_mirrors/vi/VisionClaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考