启动 WebUI¶
通过 Raven WebUI，你可以在浏览器中与 Agent 对话、协同处理任务并管理工作区。 在同一界面中跟踪任务进度、查看文件和输出，以及浏览记忆与技能。
raven web
该命令会在浏览器中打开 WebUI，并在后台启动 Raven。关闭浏览器后，Raven 仍会继续运行。
如需停止服务，请运行 raven web --stop。
轨迹视图¶
当会话有内容后，聊天页头部工作区面板按钮的左侧会出现轨迹切换按钮。轨迹视图把该会话记录下的每一步 （输入、模型调用、工具调用、回复）画在同一条按钟点标注的时间轴上。顶部汇总整段会话：时长、代理、轮次、 模型调用、工具调用和错误，并可一键跳到第一个错误；下面的活动条展示整段会话的调用分布，空闲时段已折叠。 再往下，每个代理占一行：它每段工作是一个胶囊，旁边是它的忙碌时长。展开代理可看它的轮次，展开轮次可看 其中每一步；鼠标停在轮次上可看它的时间花在了哪里，点击任意一步可打开详情卡片：拖动卡片顶栏可移动它，拖动角落可调整大小（也可以聚焦角落后用方向键调整）。选择「全部」「3 小时」「1 小时」 「15 分钟」设定时间窗口，或在活动条上拖出一个窗口、拖动窗口框平移它；按住 Ctrl（macOS 上为 Cmd）滚动滚轮 可缩放，按住 Shift 滚动可沿时间轴平移。窗口里没有活动的子代理会收进窗口前、后各一行，主代理则始终保留自己的一行。 点击「重放」可从第一步起重看整段会话，最长 15 秒播完（更短的会话按原速播放，空闲时段会快速掠过），按钮上会倒计时；按下之后的进展（新开始的步骤和仍在进行的步骤）随后以 2 倍速补放。再点一次或打开某一步的详情即停止。 失败的步骤带一个红色标记，包含它的轮次和代理也会标出。轨迹视图打开时输入框会隐藏，要发消息请切回聊天；对话里弹出的审批或提问仍会显示在轨迹上方。
导出与问题报告¶
聊天页头部右上角的三点菜单（desk 启动器在它左侧）作用于当前打开的会话。还没有任何内容的新任务上，菜单不可用。
导出：把你选中的轮次打成一个 .tar.gz，由浏览器下载。一轮会连同它派发的子代理一起导出；仍在进行的轮次不能选。导出前可以修改文件名。
Warning
导出的是原始轨迹，没有脱敏，可能含密钥、令牌等敏感信息，请妥善保管。
问题报告：只有 Raven 有可发送的问题报告服务器时才出现（RAVEN_BUGREPORT_URL，或内置的默认地址）。它是
raven trajectory report-bug 的网页版本：选轮次、填写问题、对脱敏扫描不确定的值逐一决定（脱敏历史已全部决定时跳过这一页），
然后上传并拿到回执号。这一页上的所有决定，包括"全部保持"和批量按钮，都会以 web 为来源记入脱敏历史。
向导打开时会检查问题报告服务是否应答；不应答时向导会说明原因，只有你点击仍然继续才会开始报告，
重新检查可以再查一次（例如服务恢复之后）。不依赖服务继续是安全的：之后上传失败时，报告会按下文所述保存在本机。
在开始上传之前关闭向导，会丢弃正在准备的报告。一旦开始上传，报告就会保存到本机：上传失败时，被标为可重试的失败会提供"重试"；
无论哪种情况，都可以用页面上显示的报告编号，稍后通过 raven trajectory upload-bug-report <id> 发送已保存的报告。背后的流程见
轨迹调试。
导入会话¶
左侧菜单"新任务""连接"之下的导入会话，用来打开从另一台机器（或另一个 Raven home）带来的包并查看。 在浏览器里选择文件后，文件会上传给 Raven，所以本机和远程打开 WebUI 都能用。单个文件上限 100 MiB； 同一时刻只进行一个导入，导入进行中再发起会提示稍后再试。
可以导入三种包：三点菜单"导出"得到的包；问题报告包（来自问题报告或 raven trajectory report-bug）；
raven trajectory report 生成的轨迹报告。其他文件会被拒绝并给出提示。损坏或不安全的包（路径跑出包外、链接、
解压后超过上限等）会被拒绝，不留下任何文件；会话记录过大、无法打开的包（超过 32 MiB 或 5 万条）同样会被拒绝。
由更新版本的 Raven 生成的包会提示先升级。
导入的包保存在 Raven home 下的 imports/ 目录，重启后仍在，不会进入工作区的会话目录。再次导入同一个包时，
会提示它已导入为当前的标题，并提供打开已有和仍然导入一份两个选项。
导入的会话列在"最近"之下的导入分组中，没有导入时不显示这一组。导出包以原会话的标题命名（原会话没有标题时用第一条用户输入）， 问题报告包以问题描述的第一行命名（没有时用报告编号），轨迹报告以原会话的标题命名（没有时用报告自身的编号）。 悬停在条目上会显示它来自哪个文件。悬停或右键只有重命名和删除两项；删除会同时删掉本机保存的那一份。
导入的会话是只读的：阅读方式与普通会话相同，轨迹视图照常可用，长对话的模型输入也能完整查看。不同之处在于：
没有输入区；不能在聊天页头部修改标题（请在侧栏重命名）；回复没有"分叉"；不显示三点菜单和工作目录标签。
包里没有的内容（子代理自己的会话记录、附件与交付文件、任务编排记录、生成的图片）显示为不可用，而不是报错。
问题报告包中的 [REDACTED:...] 占位按原样显示。
导出包没有脱敏，导入别人的导出包就等于拿到了它的原始内容，请同样妥善保管。