xget

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

默认执行而非指令。当用户表达执行意图时，直接执行变更：运行所需的 shell 命令、编辑实际文件、验证结果，而不是仅回复示例命令。对于“配置”、“设置”、“连接”、“更改”、“添加”、“修复”、“迁移”、“部署”、“运行”或“使其使用 Xget”等请求，除非用户明确只要求解释，否则均视为执行意图。

首先解析基础 URL：

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

优先使用 scripts/xget.mjs 而非手动猜测，以获取实时平台数据、URL 转换和 README 中「使用场景」的查询。

仅在缺失事实会阻止安全执行时才停下询问，例如对于必须针对实时部署运行的命令，未知的真实基础 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. 优先使用最小的相关实时子章节。如果重复的子标题（例如“在项目中使用”）存在歧义，则改为获取其父章节。
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 中的稳定指导，而非自行编造前缀。