xget

name: xget
description: 在任务涉及Xget URL重写、注册表/包/容器/API加速、将Xget集成到Git、下载工具、包管理器、容器构建、AI SDK、CI/CD、部署、自托管，或从实时README的`Use Cases`部分调整命令和配置到文件、环境、shell或基础URL时使用。

默认执行而非指令。当用户表达执行意图时，直接实施更改：运行所需的 shell 命令，编辑实际文件，并验证结果，而不仅仅是回复示例命令。将诸如“configure”、“set up”、“wire”、“change”、“add”、“fix”、“migrate”、“deploy”、“run”或“make this use Xget”等请求视为执行意图，除非用户明确要求仅作解释。

首先解析基础 URL：

1. 使用用户明确给出的域名；
2. 否则使用环境变量 XGET_BASE_URL；
3. 如果两者都不存在，询问用户的 Xget 基础 URL，以及是临时为当前 shell/会话设置，还是持久地为将来所有 shell 设置；
4. 仅当文档或模板尚未实际部署时，才将 https://xget.example.com 作为明确标记的占位符使用。

优先使用 scripts/xget.mjs 而非手动猜测，用于获取实时平台数据、URL 转换和 README Use Cases 查询。

仅在缺少必要信息而阻碍安全执行时才停止询问，例如对于必须针对实际部署运行的命令，未知的真实基础 URL。如果用户仅需要文档或模板，使用下面的占位符路径规则。

工作流程

1. 在查看示例之前先对任务进行分类：

• 执行意图：用户希望立即运行命令、更改文件或应用配置；
• 指导意图：用户明确希望获得示例、说明或模板，而不立即应用；
• 然后划分技术领域：一次性 URL 转换或前缀查找；Git 或下载工具加速；包管理器或语言生态系统配置；容器镜像、Dockerfile、Kubernetes 或 CI/CD 加速；AI SDK / 推理 API 基础 URL 配置；部署或自行托管 Xget 本身。

1. 完成上述基础 URL 预检。如果用户需要帮助设置 XGET_BASE_URL，打开 参考指南 并：

• 当用户要求你设置或配置时，在环境允许的情况下直接运行适合该 shell 的临时或持久命令；
• 当你无法安全执行时，提出最小阻碍性问题，或者给出确切的命令并明确指出缺失的值。

1. 分两步获取实时 README 指导，而不是默认加载整个部分：

• 使用 node scripts/xget.mjs topics --format json 列出候选标题；
• 使用 --match 缩小范围，或使用 node scripts/xget.mjs snippet --base-url https://xget.example.com --heading "Docker Compose Configuration" --format text 获取特定部分。

1. 优先选择最小的相关实时子部分。如果重复的子标题（如“Use in Project”）存在歧义，则获取其父节。
2. 将实时指导适应用户的实际任务：

• 对于执行意图，端到端应用更改，而不是止步于示例命令；
• 当请求是安装、配置、重写、切换、迁移、测试或以其他方式执行更改时，亲自运行命令；
• 当用户需要的是实现而非仅仅解释时，编辑实际的配置文件或源文件；
• 保持 shell 命令与用户的操作系统和 shell 一致；
• 除非用户要求进行更大的重写，否则保留现有的项目约定；
• 更改文件或运行命令后，在可行时执行轻量级验证步骤。

1. 当答案依赖于当前前缀时，使用 node scripts/xget.mjs platforms --format json 刷新实时平台映射，并使用 convert 进行精确的 URL 重写。
2. 当工作流程跨越多个层时，组合多个实时部分。例如，当用户的项目需要多个集成点时，将包管理器部分与容器、部署或 .env 指导配对。
3. 完成之前，检查每个命令、文件编辑或示例是否使用了正确的 Xget 路径形状：

• 仓库/内容：/{prefix}/...
• crates.io HTTP URL：/crates/... 而非 /crates/api/v1/crates/...
• 推理 API：/ip/{provider}/...
• OCI 注册表：/cr/{registry}/...

1. 如果实时平台获取失败或上游 URL 不匹配任何已知平台，明确说明并回退到 references/REFERENCE.md 中的稳定指导，而不是自行发明前缀。