ui 操作
ui 操作
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
每个 ui.* 操作接受和返回的确切字段。
每个 op 都是 HTTP 上的 POST /v1/<op>,也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,会根据令牌和 MCP 会话自动填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们沿用各自平面的 org)之外,所有 op 都使用该安装的 org,而部分 op 还会使用其命名空间和 agent;参见身份与命名空间。操作索引说明了角色、类型以及 MCP all 列表。未知的输入字段照常处理,并列在 ignored_args 中。
ui.vitals
记录一个控制台页面的 web vitals;传输层写入的每个 op 的账本行会携带这些字段。
POST /v1/ui.vitals · MCP loom_ui_vitals · 角色 viewer · 幂等 · 不在 MCP all 工具集中列出
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
必填 | 租户(身份元组的第一个元素)。 |
namespace |
str |
必填 | 该 op 读取或写入的命名空间。 |
agent |
str |
'loom-ui' |
写入或读取的 agent;'-' 或 '*' 表示在 op 允许时的任意 agent。 |
route |
str |
必填 | 控制台路由 id(memories、knowledge、admin/usage…)。 |
lcp_ms |
int | None |
None |
会话首个视图的最大内容绘制时间,单位 ms;在客户端导航时为 None(浏览器每个文档只报告一次 LCP)。 |
long_task_ms |
int |
0 |
该视图内主线程长任务(>50 ms)的总和,单位 ms。 |
inp_ms |
int | None |
None |
该视图中最长的一次交互(事件计时条目的持续时间,即输入延迟 + 处理 + 呈现),单位 ms;若没有交互达到客户端的阈值则为 None。 |
dom_nodes |
int |
0 |
视图被刷新时文档中的元素数量(* 的计数)。 |
api_calls |
int |
0 |
该视图发出的 /v1 调用数,以及从第一个请求开始到最后一个响应结束的时间跨度,单位 ms。 |
api_ms |
int |
0 |
保持打开一小时并持续轮询的视图,其跨度会超过 600 s。 |
build |
str |
'' |
提供该 bundle 的服务器构建(health 的 build_commit)。 |
cold |
bool |
True |
会话的首个视图(文档加载)为 True,SPA 内部导航为 False。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
recorded |
bool |
始终为 true:vitals 随传输层为该调用写入的账本行一同记录。 |
route |
str |
该调用报告的路由 id(回显请求中的值)。 |