xget

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

先确定基础 URL：

1. 使用用户明确提供的域名
2. 否则，使用环境变量中的 XGET_BASE_URL
3. 如果两者都没有，请询问用户的 Xget 基础 URL，以及应该仅为当前 shell/会话临时设置，还是为后续 shell 永久设置
4. 仅在尚无实际部署的文档或模板中，将 https://xget.example.com 用作明确标注的占位符

对于实时平台数据、URL 转换和 README 中 Use Cases 的查询，优先使用 scripts/xget.mjs，不要手动猜测。

只有在缺少的信息会妨碍安全执行时才暂停询问，例如必须针对实时部署运行命令，却不知道实际基础 URL。用户只需要文档或模板时，按照下方的占位符规则处理。

工作流

1. 在查找示例前，先对任务进行分类：
   • 执行意图：用户希望立即运行命令、修改文件或应用配置
   • 指导意图：用户明确希望获取示例、说明或模板，暂时不应用
   • 然后对技术领域进行归类：单次 URL 转换或前缀查询；Git 或下载工具加速；包管理器或语言生态配置；容器镜像、Dockerfile、Kubernetes 或 CI/CD 加速；AI SDK / 推理 API 基础 URL 配置；部署或自托管 Xget
2. 完成上述基础 URL 预检。如果用户希望获取设置 XGET_BASE_URL 的帮助，请打开参考指南，并且：
   • 用户要求你设置或接入该变量时，只要环境允许，就直接运行适用于当前 shell 的临时或持久化命令
   • 如果无法安全地执行，请提出最少的阻塞性问题，或给出明确指出缺少值的准确命令
3. 分两步获取实时 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 获取特定章节
4. 优先选择最小且相关的实时子章节。如果重复出现的子标题（如 Use in Project）存在歧义，请获取其父章节。
5. 根据用户的实际任务调整实时指南：
   • 对于执行意图，应端到端应用更改，而不是只提供示例命令
   • 用户要求安装、配置、重写、切换、迁移、测试或以其他方式执行更改时，亲自运行命令
   • 用户需要实现时，应编辑实际的配置文件或源文件，而不只是解释
   • shell 命令应与用户的操作系统和 shell 相符
   • 除非用户要求进行更广泛的重写，否则应保留现有项目惯例
   • 更改文件或运行命令后，在可行时执行轻量级验证
6. 如果答案取决于当前前缀，使用 node scripts/xget.mjs platforms --format json 刷新实时平台映射，并使用 convert 进行精确的 URL 重写。
7. 如果工作流涉及多个层面，应结合多个实时章节。例如，当用户的项目需要多个集成点时，应同时参考包管理器章节和容器、部署或 .env 指南。
8. 完成前，检查每条命令、每项文件编辑和每个示例是否使用正确的 Xget 路径格式：
   • 仓库/内容：/{prefix}/...
   • crates.io HTTP URL：使用 /crates/...，而不是 /crates/api/v1/crates/...
   • 推理 API：/ip/{provider}/...
   • OCI 注册表：/cr/{registry}/...
9. 如果实时平台获取失败，或上游 URL 与任何已知平台都不匹配，应明确说明，并改用 references/REFERENCE.md 中稳定的指南，而不是臆造前缀。