快捷菜单

通过你与 OOMOL 关联的账户来操作 快捷菜单。这项技能通过 [oo CLI](https://github.com/oomol-lab/oo-cli) 调用 short_menu 连接器；OOMOL 在服务端注入凭据，因此你无需处理原始令牌。

执行操作

假设用户已经安装了 oo CLI、登录并连接了快捷菜单。**不要主动运行 oo auth login 或打开连接 URL —— 直接执行操作即可。** 只有当命令确实因认证或连接错误而失败时，才回退到 [首次设置](#首次设置)。

1. 检查契约，在构建载荷之前获取权威的输入/输出模式：

oo connector schema "short_menu" --action "<action_name>"

2. 运行操作，使用符合输入模式的 JSON 载荷：

oo connector run "short_menu" --action "<action_name>" --data '<json>' --json

• --data 接受 JSON 对象字符串或 @path/to/file.json；省略时发送 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 位于 meta.executionId 中。

每个操作在下方以一行描述列出；改变状态的操作带有 [write] 或 [destructive] 标签。在构造 --data 之前，请使用 oo connector schema 获取该操作的实时模式，以了解其权威输入字段。

可用操作

• create_link — 创建快捷菜单短链接。[write]
• delete_link — 删除已有的快捷菜单短链接。[destructive]
• update_link — 更新已有的快捷菜单短链接。[write]

安全

• 无标签的操作是读取操作（获取 / 列出 / 搜索）—— 可以直接安全运行。
• **标记为 [write] 的操作会改变快捷菜单的状态 —— 运行前请与用户确认具体的载荷和效果。**
• **标记为 [destructive] 的操作会删除或覆盖数据 —— 务必先确认目标并获取明确许可。**

首次设置

以下是 一次性 步骤 —— 不要每次调用都重复执行。仅当命令因匹配原因失败时，才执行相应的步骤。

• **oo: command not found** — 安装 oo CLI（其他平台：<https://cli.oomol.com/install-guide.md>）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell

• 未登录 / 认证错误 — 登录你的 OOMOL 账户一次：

  oo auth login

• **scope_missing / credential_expired / app_not_ready / app_not_found** — 快捷菜单未连接，或连接已过期、缺少作用域。在以下地址进行一次连接（认证类型：API key）：

  https://console.oomol.com/app-connections?provider=short_menu

• **HTTP 402 / OOMOL_INSUFFICIENT_CREDIT** — 计费停止。在重试前，请到 https://console.oomol.com/billing/token-recharge 进行充值。

资源

• 快捷菜单主页：https://shortmenu.com