可观测:历史、花销、监控
用 history / dashboard / monitor / status / export / feedback 看清 Vyane 跑了什么、花了多少、成功率如何。
Vyane 每一次派活(dispatch / broadcast / collaborate / workflow)都会落一条记账。这一页讲怎么把这些记录读出来——回答三个问题:跑了什么、花了多少、成功率如何。
一句话对照表:
| 我想…… | 用这个 |
|---|---|
| 看历史记录和聚合统计(成功率、平均耗时、花销) | vyane history |
| 打开一个网页面板,图表化地看全局 | vyane dashboard |
| 在终端里开一个实时刷新的监控面板 | vyane monitor |
| 只看此刻正在跑的任务 | vyane status |
| 把历史导出成 CSV / JSON / Markdown 报告 | vyane export |
| 给某次结果打分,喂给智能路由 | vyane feedback |
记账的粒度
每条历史记录带上了 provider(哪个供应商 / 模型)、source(是 dispatch 还是 broadcast 等)、status(成功 / 失败)、duration_seconds(耗时)、以及 token 用量(有的话)。花销是按 token 用量估算出来的,不是账单原值。
vyane history —— 历史与统计
两种用法:不带 --stats 是流水(最近 N 条一条条列),带 --stats 是聚合(按供应商汇总成功率、平均耗时,可选花销)。
看最近 10 条流水(默认):
vyane history看聚合统计:
vyane history --stats加上花销估算:
vyane history --stats --costs常用参数:
| 参数 | 作用 |
|---|---|
--stats | 从流水切换到聚合统计视图 |
-n / --limit | 列多少条(流水模式,默认 10) |
--provider | 只看某个供应商 |
--source | 按来源过滤(dispatch / broadcast / cli-dispatch / cli-broadcast) |
--hours | 只看最近 N 小时(0 = 全部) |
--costs | 统计里带上 token 花销明细 |
--json | 输出 JSON,喂给脚本或 CI |
聚合视图长这样:总派活数、按来源拆分、然后每个供应商一行,给出调用次数、成功率、平均耗时;开了 --costs 再多一段——带 token 数据的条数、总 token(输入 / 输出)、按每千 token 估算的美元花销,并按供应商拆开。
流水里的来源标记
流水模式里每行前面会有个小标记:[B] 是 broadcast、[C] 是命令行 dispatch、[CB] 是命令行 broadcast、[A] 是 collaborate(A2A 协作)。绿色 + 表示成功,红色 ! 表示失败。
vyane dashboard —— 网页面板
在浏览器里图表化地看全局:趋势曲线、供应商可用性、花销拆分、协作历史、反馈分数等等。适合"想一眼看清整体态势"的时候。
vyane dashboard默认监听 127.0.0.1:41521(只绑本机)。可以改:
| 参数 | 默认值 | 作用 |
|---|---|---|
--host | 127.0.0.1 | 绑定地址;只绑本机最安全,想让局域网 / 内网访问才改 |
--port | 41521 | 端口 |
默认只绑本机
默认 --host 127.0.0.1 意味着只有这台机器能访问。如果你要从别的设备打开(比如手机查看一台常驻 macOS 主机上的面板),得改 --host 0.0.0.0 或走隧道 / 反代——但那样就暴露到网络上了,自己权衡安全。别为了图方便直接裸绑公网。
面板背后是一组 /api/* 只读接口(status / history / stats / providers / trends / collaborations / feedback / costs / usage 等),这些接口也可以单独被 Argus 等前端消费。
vyane monitor —— 终端 TUI 面板
不想开浏览器、就在终端里要一个实时刷新的监控面板,用这个。它是一个 TUI(终端里的图形界面),自动刷新,还能直接操作任务——暂停、恢复、取消。
vyane monitor参数:
| 参数 | 默认值 | 作用 |
|---|---|---|
--owner-user-id | legacy | 只显示和控制归这个 owner 的任务 |
键盘快捷键:c 取消、p 暂停、u 恢复、r 刷新、s 切到会话视图、l 切换语言。
需要额外装 TUI 依赖
monitor 依赖 textual 这个终端 UI 库,不在最小安装里。没装会提示你:
pip install vyane[tui]
# 或者临时跑一次:
uvx --with textual vyane monitorstatus、monitor、dashboard 三个是层层加码的关系:status 是最轻的一次性快照,monitor 是终端里能动手的实时面板,dashboard 是浏览器里图表最全的全局视图。按当下需要挑一个。
vyane status —— 此刻在跑什么
最轻的一个:只列当前正在跑的派活,一次性打印完就退出。想守着看,加 -w。
一次性快照:
vyane status实时守着看(每秒刷新,Ctrl-C 退出):
vyane status --watch参数:
| 参数 | 作用 |
|---|---|
-w / --watch | 实时刷新模式,每秒更新一次 |
--owner-user-id | 只看归某个 owner 的派活 |
每行给出 run id、供应商、状态、已跑了多少秒、任务摘要。经历过 failover(主模型被挡、切了备用)的任务会标一个紫色的重试符号。
vyane export —— 导出报告
把历史导出成文件,拿去做报表、归档或喂给别的工具。支持三种格式:CSV、JSON、Markdown。
导出成 CSV 打到屏幕上:
vyane export导出成 Markdown 写进文件:
vyane export --format md --output report.md只导最近 24 小时、某个供应商的记录:
vyane export --hours 24 --provider your-provider --format json参数:
| 参数 | 默认值 | 作用 |
|---|---|---|
--format / -f | csv | 输出格式:csv / json / md |
--hours | 0(全部) | 只导最近 N 小时 |
--provider | 空 | 只导某个供应商 |
-n / --limit | 1000 | 最多导多少条 |
--output / -o | 空(打到屏幕) | 写进文件 |
--source | 空 | 按来源过滤 |
history 和 export 有什么区别
history 是给你在终端里看的(带颜色、带图标、人读友好);export 是给别的东西吃的(干净的 CSV / JSON / Markdown,拿去做表格或存档)。同一份底层数据,两种出口。
vyane feedback —— 路由反馈
给某一次结果打个分(1 到 5 星)。这不只是留个记录——分数会喂回智能路由(provider=auto 时用来决定派给谁的那套打分),让下次同类任务更倾向于历史上被你打高分的供应商。
给一次结果打分:
vyane feedback --run-id abc12345 --provider your-provider --rating 5 --comment "推理很到位"看最近的反馈:
vyane feedback --list参数:
| 参数 | 作用 |
|---|---|
--run-id | 要打分的那次 run 的 ID(提交时必填) |
--provider | 出这个结果的供应商(提交时必填) |
--rating | 评分 1–5(1 = 很差,5 = 极好;提交时必填) |
--category | 任务类别(analysis / generation / reasoning / language),让打分按类别生效 |
--comment | 附一句评语 |
--list | 切到查看模式,列最近的反馈 |
--hours | 配合 --list 按时间窗过滤 |
打分是怎么影响路由的
智能路由的打分由四块加权而成:关键词匹配、历史成功率、benchmark 结果、以及用户反馈。反馈这块是按类别聚合的——你给 reasoning 类任务上某个供应商打了高分,下次遇到推理类任务,路由就会更偏向它。所以 --category 填对了,反馈才落在正确的桶里。默认路由在没有反馈数据时按中性分处理,不会因为没打过分就歧视谁。