用途:将本地 Claude Code 或 Codex 的会话轨迹提交到 BenchFlow。用户把相关线索粘贴进对话后,由代理完成查找、预览、确认和上传,用户无需自己运行 BenchFlow 命令。
主要流程:1)安装或升级 BenchFlow;2)发现近期本地会话;3)由用户选定一个;4)用查看器打开并展示上传时会遮蔽的内容;5)等待用户在页面点击批准或在聊天中确认;6)由代理上传并报告结果;7)若仓库没有本地技能副本则写入一份。
必要命令:uv tool install --python 3.12 --upgrade benchflow;bench traj setup --list;bench traj upload /path/to/session.jsonl --dry-run;bench eval view /path/to/session.jsonl --confirm --port 8889 --redaction-summary "2 API keys, 1 bearer token";bench traj upload /path/to/session.jsonl。若已存在可执行文件需加 --force;版本需至少 0.7.1,--confirm 与 --redaction-summary 需 0.7.2 及以上,旧版需改用聊天确认。
能力与限制:可发现 Claude、Codex、Cursor、OpenCode 及 BenchFlow trial 的会话文件;查看器显示原始会话,不执行遮蔽;上传前 CLI 在本地遮蔽检测到的密钥值,服务端会再次扫描并拒绝遗漏的密钥,但遮蔽只是安全网,不应上传凭据。上传会依据会话记录的工作目录解析 git origin,打上 repo/<owner>/<name> 标签,可用 --no-repo 省略;无 git 仓库的会话不上标签。重试因内容摘要寻址而安全。仅用于提交轨迹;若需操作、测试或调试上传管线本身,应改用 benchflow-traj-upload-ops。