## 何时使用 * 用户提供 `agents://...` URI。 * 用户给出简写 URI，如“codex/...”或“codex？...”。 * 用户要求列出/搜索提供商线程。 * 用户要求查询角色范围的线程，例如“agents://codex/reviewer”。 * 用户要求阅读或总结对话。 * 用户要求在向下钻取之前发现子目标。 * 用户请求开始或继续与提供商的对话。 ## 安装根据当前情况选择首选方式： ### 自制通过 Homebrew Tap 安装：酿造龙头旋沃/龙头酿造安装xurl xurl --版本通过自制程序升级：酿造更新酿造升级xurl ### 货物环境通过 Cargo 安装：货物安装 xurl-cli xurl --版本升级 Cargo 安装的 `xurl`：货物安装 xurl-cli --force xurl --版本 ### Python 环境通过 `uv` 从 PyPI 安装： uv工具安装xuanwo-xurl xurl --版本升级 `uv` 安装的 `xurl`： uv工具升级xuanwo-xurl xurl --版本 ### 节点环境不安装临时使用： npx @xuanwo/xurl --help 通过 npm 全局安装： npm install -g @xuanwo/xurl xurl --版本升级 npm 安装的 `xurl`： npm update -g @xuanwo/xurl xurl --版本 ## 核心工作流程 ### 1) 查询列出最新的提供者线程： xurl 代理://codex # 等效简写： xurl 法典具有可选限制的关键字查询（默认“10”）： xurl 'agents://codex?q=spawn_agent' xurl 'agents://claude?q=agent&limit=5' 角色范围查询（会话优先，角色后备）： xurl 代理://codex/reviewer # 等效简写： xurl 法典/审稿人 ### 2) 阅读 xurl 代理://codex/ # 等效简写： xurl codex/ ### 3) 发现 xurl -I 代理://codex/ 使用返回的“子代理”或“条目”URI 进行下一步。 OpenCode 子链接通过 sqlite `session.parent_id` 进行验证。 ### 3.1) 深入子线程 xurl 代理://codex// ### 4）写创建： xurl Agents://codex -d“开始新对话” # 等效简写： xurl codex -d“开始新对话” 附加： xurl Agents://codex/ -d“继续” 使用查询参数创建： xurl "agents://codex?cd=%2FUsers%2Falice%2Frepo&add-dir=%2FUsers%2Falice%2Fshared&model=gpt-5" -d "查看此补丁" 使用角色 URI 创建： xurl Agents://codex/reviewer -d“查看此补丁” 来自文件/标准输入的有效负载： xurl 代理://codex -d @prompt.txt 猫提示.md | xurl 代理://claude -d @- ## 命令参考 * 基本形式：`xurl [OPTIONS] ` * `-I, --head`: 仅限 frontmatter/discovery * `-d, --data`: 写入有效负载，可重复 *文本：`-d“你好”` * 文件：`-d @prompt.txt` * 标准输入：`-d @-` * `-o, --output`: 将命令输出写入文件 * `--head` 和 `--data` 不能组合使用 * 多个“-d”值以换行符连接 ## URI 参考 URI 剖析 (ASCII)： [代理://]<提供商>[/<令牌>[/]][?<查询>] |------| |--------| |----------------------------| |------| 可选提供者可选路径部分查询方案成分含义： * `scheme`：可选的`agents://`前缀；省略形式被视为速记 * `provider`: 提供商名称 * `token`: 主要对话id或角色名称 * `child_id`: 子/子代理 ID * `query`: 可选的键值参数令牌解析（`agents:///`）： 1. 首先将 `` 解析为会话 id。 2. 如果session-id解析失败，则将``视为角色。常见的 URI 模式： * `agents://`：发现最近的对话 * `agents:///`：读取主要对话 * `agents:///`：角色范围的线程查询或使用 `-d` 基于角色的创建 * `agents:////`：读取子/子代理对话 * `agents://?k=v` 和 `-d`：创建 * `agents:///` 和 `-d`：追加角色由提供者创建行为： * `codex`：支持（`~/.codex/config.toml` 中的 `[agents.]` 映射到 `--config`） * `claude`：支持（`--agent <角色>`） * `opencode`：支持（`--agent <角色>`） * `amp`：返回明确错误（不支持创建非交互式角色） * `gemini`：返回明确的错误（不支持非交互式角色创建） * `pi`：返回明确的错误（角色创建不受支持）查询参数： * `q=`：按关键字过滤发现结果。按主题搜索对话时使用。 * `limit=`：上限发现结果（默认为`10`）。当您想要更少或更多结果时使用。 * `=`：在写入模式 (`-d`) 下，作为 `-- ` 转发到提供者 CLI。 * ``：在写入模式 (`-d`) 下，作为 `--` 转发到提供者 CLI。 ## 失败处理 ### `未找到命令：<代理>` 安装提供程序 CLI，然后在重试之前完成提供程序身份验证。

投

包含技能