dce

dce CLI

当用户要求你操作 dce、查看其 API 命令或为某项 API 任务查找合适的生成命令时，请使用此技能。

工作流

1. 使用 dce search "<intent>" --json 搜索候选项；必要时使用 --limit。搜索仅用于发现候选项。
2. 执行不熟悉的命令前，使用 dce commands show <path...> --json 查看具体命令。
3. 如果命令详情中 auth.required=true，请在执行前运行 dce auth status -o json 并读取 hostname 和 source。主机解析顺序：--hostname > $DCE_HOST > 已选主机（dce auth use <host>）> http.default_hostname > hosts.yml 中唯一的主机。如果以上都不适用，请停止并要求用户进行身份验证或选择主机。
4. 只有在通过 commands show 确认标志、正文、身份验证、HTTP 路径、mutation、dry_run 和输出提示后，才能执行命令。当 mutation 不为 read 时，如果 dry_run.mode 为 http_preview，请使用 --<dry_run.flag> 预览；如果无法预览，则在执行前获得用户的明确确认。

常用命令

• dce commands --json：完整的生成命令目录。
• dce commands --include-hidden --json：包含隐藏的生成命令。
• dce commands show <path...> --json：单个命令的权威信息来源。
• dce commands schema --json：目录架构版本、界面和试运行结果结构。
• dce search "<intent>" --json：按排名排列的候选命令。
• dce auth status -o json：已解析的 hostname、其 source、selected 主机以及所有已登录的主机。

维护命令

• dce --version 或 dce -v：打印 CLI 构建版本。

参考资料

• 阅读 references/catalog.md，了解命令发现协议和目录字段含义。
• 阅读 references/modules/ai-lab.md，了解 ai-lab 模块命令索引。
• 阅读 references/modules/billing-center.md，了解 billing-center 模块命令索引。
• 阅读 references/modules/business-cockpit.md，了解 business-cockpit 模块命令索引。
• 阅读 references/modules/container-management.md，了解 container-management 模块命令索引。
• 阅读 references/modules/elasticsearch.md，了解 elasticsearch 模块命令索引。
• 阅读 references/modules/global-management.md，了解 global-management 模块命令索引。
• 阅读 references/modules/insight.md，了解 insight 模块命令索引。
• 阅读 references/modules/kafka.md，了解 kafka 模块命令索引。
• 阅读 references/modules/llm-studio.md，了解 llm-studio 模块命令索引。
• 阅读 references/modules/microservice-engine.md，了解 microservice-engine 模块命令索引。
• 阅读 references/modules/minio.md，了解 minio 模块命令索引。
• 阅读 references/modules/mongodb.md，了解 mongodb 模块命令索引。
• 阅读 references/modules/mysql.md，了解 mysql 模块命令索引。
• 阅读 references/modules/operations-management.md，了解 operations-management 模块命令索引。
• 阅读 references/modules/postgresql.md，了解 postgresql 模块命令索引。
• 阅读 references/modules/rabbitmq.md，了解 rabbitmq 模块命令索引。
• 阅读 references/modules/redis.md，了解 redis 模块命令索引。
• 阅读 references/modules/rocketmq.md，了解 rocketmq 模块命令索引。
• 阅读 references/modules/seaweedfs.md，了解 seaweedfs 模块命令索引。
• 阅读 references/modules/virtual-machines.md，了解 virtual-machines 模块命令索引。
• 阅读 references/modules/workbench.md，了解 workbench 模块命令索引。

规则

• 不要根据命令名称猜测标志或请求体结构。
• 不要直接执行搜索结果；先用 commands show 确认。
• 当 mutation 不是 read 时，如果 dry_run.mode 为 http_preview，执行前先预览。如果无法预览，执行前须获得用户的明确确认。不要将 unknown 安全地视为 read。
• 除非用户要求人类可读的输出，否则优先使用 -o json 获取机器可读的命令输出。
• 使用 -o json 或 -o yaml 时，根据 error.code 和进程退出状态进行分支处理；error.message 和 error.hint 可作为安全的人工指引，error.http.status 是唯一可选的 HTTP 上下文。
• 配置的流暂停属于成功（exit 0）；检查映射自暂停事件的已收集输出字段，不要将其视为错误。
• 对于已收集的流，选择一种模式：使用 -o json 获取一份稳定文档；当目录中存在 output.streaming.policy.live 时，在默认输出模式下使用 --stream；或使用 -o raw 获取线路事件。
• 根据 commands show 中的请求体要求，使用 --file、--set 或 --set-str 设置 JSON 请求体。
• 存在 body.runtime_schema 时，常规执行会在发送目标请求前获取该架构并进行校验；http_preview dry-run 不会访问网络，也会跳过此预检。
• 对于敏感标志，优先使用 flags[].input_modes 中的安全模式：--<flag>-env、--<flag>-file 或 --<flag>-stdin。

模块可用性

目录（dce commands / dce search）会列出 dce 构建时包含的所有模块，无论这些模块是否实际安装在目标主机上。命令出现在目录中，并不保证其所属模块已部署。

在模块路径级别出现 404 / 路由未找到（即 API 路由本身不存在，而非特定对象不存在）时，情况并不明确：模块可能未安装，也可能是路径或版本有误。出现此类 404 时，请主动确认后再下结论，方法是运行 dce global-management about list-g-product-versions -o json（global-management 是始终存在的基础模块，因此始终可用）。然后：

• 列表中没有该模块 → 此主机上未安装该模块。不要重试，不要尝试同一模块中的其他命令，也不要告诉用户该功能可用——应明确说明该模块未安装。
• 列表中有该模块 → 该模块已安装，因此此 404 并不表示模块缺失。使用 dce commands show <path...> --json 重新检查确切路径和参数（很可能是路径或版本错误，也可能是资源级别的未找到）；不要报告模块缺失。
• 资源级别的 404（在正常工作的模块中找不到特定 ID/名称）表示该对象不存在，并不表示模块缺失——按常规情况处理。