# aliyun domain — 完整参考

> `aliyun domain` 是阿里云 CLI 的域名服务命令集，由官方插件 `aliyun-cli-domain` 提供。它把冗长的
> OpenAPI Action 收束成面向域名场景的短指令，并在命令行入口就建立 OAuth、预览确认与隐私保护。
>
> 本文件面向 LLM 与 Agent，目标是让你不再查任何外部文档就能写出正确的 `aliyun domain` 命令。
> 精简索引见 /llms.txt。
>
> 命令面取自 2026-09-16 的 extension_commands.json 与完整指令树：105 条扩展指令，
> 其中域名 87 条、万小智建站 18 条，共 22 个真实命令组。内置 version 不计入扩展数，隐藏 OpenAPI 命令不在本参考内。
---
## 1. 关键事实速查

| 项 | 值 |
|---|---|
| 产品代码 | `domain`（**必须小写**） |
| 扩展指令总数 | 105（域名 87 + 万小智建站 18） |
| 真实命令组 | 22 |
| CLI 插件包名 | `aliyun-cli-domain` |
| 插件注册的命令 | `domain` |
| 安装 | 一行脚本同时准备 CLI 与 domain 插件，见下文 |
| CLI 最低版本 | 3.5.0 |
| Skill 固定的版本组合 | CLI `latest` + 插件 `0.9.4` |
| 默认站点 | CN / cn-hangzhou |
| 鉴权 | 中国站 OAuth 临时凭证（订单、问答、管控、高风险场景） |
| 交易类批量上限 | 200（购买、续费、赎回、转入） |
| 管控类批量上限 | 50（转移锁、更新锁、备注、联系人、移入分组） |
| 自定义 DNS 数量 | 2～13 |
| 能力快照 | 2026-09-16 |

域名**不分地域**。全局参数（如 `--region`）建议放在产品名 `domain` 之前。
---
## 2. 先读这六条，否则一定写错命令

1. **写操作默认只出预览，什么都不会提交。** 补上 `--confirm=true` 才进入鉴权与 OpenAPI。
   不要因为命令跑完没报错就认为改成了 —— 没给这个 flag 时它本来就只打印计划。
2. **高风险动作还要 `--confirm-domain` 与目标域名完全一致。** DNSSEC 三条写操作、转移码、
   快速转出、自动续费都属于这一档；域名对不上就会被拒。
3. **开自动续费必须额外给 `--ack-future-charge=true`**，因为它授权的是未来的自动扣费。
4. **CLI 不直接扣费。** `buy` / `renew` / `redeem` / `transfer-in apply` 是 OAuth 后打开万网官方订单
   确认页，最终资格、价格与支付都由页面决定。不要把 CLI 输出当成报价承诺。
5. **PII 只从受保护文件读**：联系人、邮箱、Token 不做直接参数，走 `--input-file` /
   `--email-file` / `--token-file`。Unix/macOS 要求普通文件、非符号链接、权限不超过 `0600`。
6. **参数用客户语言**：`--domain` / `--domains` / `--page` / `--limit`，不是 OpenAPI 字段名。
   想先看命令会做什么又不触发鉴权和 OpenAPI，加 `--cli-dry-run`。
---
## 3. 安装与配置

### 3.1 一行装好 CLI 与 domain 插件

```bash
curl -fsSL https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.sh | bash
```

脚本支持 macOS 与 Linux：已有 3.5.0 以上 CLI 时直接补装 aliyun-cli-domain；否则安装 CLI latest 后再装插件。
网络、权限、平台或插件安装失败时，脚本会说明原因并给出可直接执行的下一步操作。

### 3.2 鉴权：OAuth 临时凭证

订单、智能问答、管控和高风险场景以中国站 **OAuth 临时凭证**为主，首次用到时按提示在浏览器完成
授权，不需要自己先配 AccessKey。凭证值不会出现在命令输出里。

macOS、Windows、Linux 都会尝试打开默认浏览器；打不开时命令会返回可复制的官方页面链接，
流程不会中断。

### 3.3 先本地预览，再真跑

```bash
# 只做本地校验，不触发 OAuth 也不打 OpenAPI
aliyun --region cn-hangzhou domain ask \
  --question "域名过期后多久进入赎回期？" \
  --cli-dry-run

# 去掉 --cli-dry-run 就是一次真实的只读调用
aliyun domain ask --question "域名过期后多久进入赎回期？"
```
---
## 4. 命令契约

每条命令都要逐项满足。左边写错发不出请求，右边写漏则什么都不会提交：

| 规则 | 正确 | 错误 |
|---|---|---|
| 全局参数放 domain 前 | `aliyun --region cn-hangzhou domain ask` | `aliyun domain ask --region ...` |
| 单个域名 | `--domain example.com` | `--domain-name example.com` |
| 多个域名逗号分隔 | `--domains a.com,b.net` | `重复 flag 或 JSON 数组` |
| 分页用客户语言 | `--page 1 --limit 20` | `--page-num 1 --page-size 20` |
| 写操作要显式确认 | `--confirm=true` | `写完命令就以为提交了` |
| 高风险要精确域名 | `--confirm-domain example.com` | `域名不完全一致` |
| 开自动续费 | `--ack-future-charge=true` | `省略未来扣费确认` |
| PII 走受保护文件 | `--input-file ./template.json` | `把姓名邮箱写进参数` |

默认站点是 CN / cn-hangzhou。订单、智能问答、管控和高风险场景以中国站 OAuth 临时凭证为主，凭证值不会出现在命令输出里。想先看命令会做什么、又不触发鉴权和 OpenAPI，加 --cli-dry-run。

### 4.1 四条执行路径，四种安全语义

同样是一条指令，读资产、进订单页、提交管控写入和执行高风险动作的行为完全不同：

**PATH 1 · 查询信息** — 只是查询，不会改变任何东西，所以不需要你确认——敲完直接看结果。

```bash
aliyun domain list
```

**PATH 2 · 页面确认费用** — 买域名、续费这类要花钱的操作，CLI 不会替你点付款，而是带你到阿里云官方订单页，价格和支付都由你在页面上自己确认。

```bash
aliyun domain buy --domains a.com,b.net --years 2
```

**PATH 3 · 预览后修改** — 像切换名称服务器这种会动设置的操作，先只给你看"改完会变成什么样"；确认没问题、重新带上 --confirm=true 再跑一遍，才会真的去改。

```bash
aliyun domain nameserver set --domains a.com --servers aliyun --confirm=true
```

**PATH 4 · 核对目标域名** — 转出域名、开自动续费这类一旦出错很难挽回或牵着真金白银的操作，光加确认参数还不够——还要求你把域名名字完整重新输入一次，防止手滑动错对象。

```bash
--confirm-domain example.com
--ack-future-charge=true
```

---
## 5. 命令总表（105 条）

| 指令 | 分区 | 说明 |
|---|---|---|
| `capabilities` | Agent 契约 | 返回契约版本、命名空间与命令计数等机器可读能力元数据 |
| `schema` | Agent 契约 | 不带参数返回精简目录，指定 --command 可查看单条命令完整契约 |
| `auth` | Agent 契约 | 展示当前选中的本地 OAuth 配置就绪状态，不触发登录或云端调用 |
| `login` | Agent 契约 | 打开中国站 OAuth 授权流程，保存并选中临时凭证配置 |
| `logout` | Agent 契约 | 预览并显式确认删除一个本地中国站 OAuth 配置 |
| `whoami` | Agent 契约 | 查看当前选中本地 OAuth 配置的身份与就绪状态，不返回凭证 |
| `ask` | 智能问答 | 检索域名行业知识库，支持 cn/intl/all 三种范围，默认返回 5 条答案 |
| `list` | 资产与询价 | 分页、过滤、排序查询账号下的域名资产，输出隐私安全摘要 |
| `detail` | 资产与询价 | 查看单个域名状态、到期日等运营摘要，默认排除持有者身份字段 |
| `whois` | 资产与询价 | 匿名查询域名公开注册摘要，支持 Unicode/Punycode 与多种查询来源 |
| `check` | 资产与询价 | 检查域名可注册性，只读查询，不产生任何订单 |
| `search` | 资产与询价 | 按生命周期、日期区间、分组、关键字或后缀高级筛选域名资产 |
| `price` | 资产与询价 | 查询后缀或具体域名的公开注册/续费参考价格，不产生订单 |
| `trade publish` | 交易转入 | 校验并预览一口价挂牌请求，加 --confirm=true 仅模拟执行 |
| `trade detail` | 交易转入 | 预留一口价挂牌信息查询契约，明确标注为不可用的模拟结果 |
| `trade appraise` | 交易转入 | 预留域名估值契约，不返回可用于定价决策的估值数据 |
| `buy` | 交易转入 | 一次购买 1～200 个域名，支持多年注册，打开官方订单确认页 |
| `renew` | 交易转入 | 查询续费参考价后，批量进入官方续费订单确认页，最多 200 个域名 |
| `redeem` | 交易转入 | 查询账号余额后进入官方订单页确认赎回资格与最终价格 |
| `transfer-in apply` | 交易转入 | 一次转入最多 200 组"域名 + 转移码"，进入中国站官方订单页确认 |
| `transfer-in list` | 交易转入 | 按域名、转入状态、日期和分页查询转入申请，仅返回最小化摘要 |
| `transfer-in detail` | 交易转入 | 按实例 ID 查询单条转入进度 |
| `transfer-in check` | 交易转入 | 仅按域名检查转入资格，不接收也不发送转移码 |
| `icp ask` | 备案服务 | 校验备案咨询问题但不回显、不外发，也不生成虚构答案 |
| `icp fill` | 备案服务 | 预留网站新增备案填写契约，仅返回模拟结果，不创建真实备案申请 |
| `icp status` | 备案服务 | 按备案申请 ID 预留进度查询契约，不返回虚构进度 |
| `icp info` | 备案服务 | 通过 --type success|risk|all 预留备案成功/风险信息查询契约 |
| `group list` | 分组任务 | 查询域名分组，可按精确名称和 active/all 状态筛选 |
| `group create` | 分组任务 | 创建域名分组 |
| `group rename` | 分组任务 | 按精确名称或数字 ID 重命名域名分组 |
| `group move` | 分组任务 | 将最多 50 个域名移动到指定分组，不替换现有成员 |
| `group delete` | 分组任务 | 删除指定分组，系统未分组不可删除 |
| `history` | 分组任务 | 按日期查询操作历史，不输出操作 IP、详情和备注 |
| `task list` | 分组任务 | 查询账号下的域名异步操作任务，支持日期和分页 |
| `task show` | 分组任务 | 分页查看指定任务内各域名的结构化执行状态 |
| `task history` | 分组任务 | 按日期查询历史异步任务，返回可直接续查的成对游标 |
| `task history-detail` | 分组任务 | 分页查询指定历史任务的域名级明细，不输出客户端 IP 或自由文本错误 |
| `task poll` | 分组任务 | 查询已完成任务结果的受控状态摘要 |
| `transfer-lock` | 域名管控 | 批量开启或关闭禁止转移锁，最多 50 个域名 |
| `update-lock` | 域名管控 | 批量开启或关闭禁止更新锁，保护联系人和 DNS 变更 |
| `nameserver set` | 域名管控 | 批量切换注册局名称服务器委派，支持阿里云或 2～13 个自定义主机名 |
| `remark` | 域名管控 | 自动查询实例 ID，为最多 50 个域名保存同一备注 |
| `dnshost list` | DNS Host 与 DNSSEC | 查询 DNS Host / Glue Record 及其 IP 地址 |
| `dnshost create` | DNS Host 与 DNSSEC | 新增严格属于父域名的 DNS Host，并校验 IP |
| `dnshost update` | DNS Host 与 DNSSEC | 替换 DNS Host 的 IPv4/IPv6 地址 |
| `dnshost delete` | DNS Host 与 DNSSEC | 删除指定 DNS Host / Glue Record |
| `dnssec list` | DNS Host 与 DNSSEC | 查询域名当前 DNSSEC DS 记录 |
| `dnssec enable` | DNS Host 与 DNSSEC | 新增 DS 记录，要求资产归属校验和精确域名确认 |
| `dnssec update` | DNS Host 与 DNSSEC | 修改 DS 记录，本地校验算法、摘要类型和摘要长度 |
| `dnssec disable` | DNS Host 与 DNSSEC | 删除 DS 记录以关闭 DNSSEC，要求精确域名确认 |
| `dns list` | 云解析 DNS 记录 | 按主机、类型、值、线路和状态过滤查询 DNS 解析记录 |
| `dns detail` | 云解析 DNS 记录 | 按记录 ID 精确查询单条 DNS 解析记录 |
| `dns create` | 云解析 DNS 记录 | 新增一条 DNS 解析记录，写入需预览并携带 --confirm-domain/--plan-id 确认 |
| `dns update` | 云解析 DNS 记录 | 按记录 ID 修改解析记录，未提供字段保持原值，写入需精确确认 |
| `dns delete` | 云解析 DNS 记录 | 按记录 ID 删除一条解析记录，写入需精确确认 |
| `dns enable` | 云解析 DNS 记录 | 按记录 ID 启用一条解析记录，写入需精确确认 |
| `dns disable` | 云解析 DNS 记录 | 按记录 ID 停用一条解析记录，写入需精确确认 |
| `dns lines` | 云解析 DNS 记录 | 查询托管区域可用的 DNS 解析线路，供 create/update 使用 |
| `dns logs` | 云解析 DNS 记录 | 查询隐私过滤后的 DNS 解析操作日志元数据 |
| `template list` | 隐私资料 | 查询信息模板摘要，不输出姓名、邮箱、电话、地址和证件 |
| `template create` | 隐私资料 | 从权限受保护的 JSON 文件新增信息模板 |
| `template update` | 隐私资料 | 使用受保护 JSON 文件修改指定信息模板 |
| `template set-default` | 隐私资料 | 设置默认信息模板 |
| `template validate` | 隐私资料 | 校验受保护文件中的联系人字段，不是实名认证 |
| `template regions` | 隐私资料 | 通过 OAuth 查询中国省份及下级城市名称，辅助填写模板地址 |
| `template verify` | 隐私资料 | 提交信息模板实名认证证据，提交成功不代表认证已通过 |
| `template delete` | 隐私资料 | 删除单个或多个信息模板，默认仅预览，加 --confirm=true 提交 |
| `contact` | 隐私资料 | 查询脱敏后的域名联系人信息 |
| `set-contact` | 隐私资料 | 使用信息模板批量更新联系人，最多 50 个域名 |
| `email list` | 隐私资料 | 查询脱敏后的邮箱验证记录，不输出发送 IP |
| `email detail` | 隐私资料 | 从 0600 私密文件读取邮箱，仅返回脱敏邮箱、受控状态和时间 |
| `email request` | 隐私资料 | 从私密文件读取邮箱并发送验证邮件 |
| `email confirm` | 隐私资料 | 从私密文件读取 Token 并完成邮箱验证 |
| `email resend` | 隐私资料 | 为私密文件中的邮箱重新发送验证邮件 |
| `email delete` | 隐私资料 | 删除私密文件指定的已验证邮箱记录 |
| `verification domain-status` | 实名核验 | 查询域名实名认证资料的安全元数据 |
| `verification template-status` | 实名核验 | 按模板 ID 查询实名认证资料状态，不输出姓名、证件、地址、邮箱或图片 |
| `verification domain-failure` | 实名核验 | 查询域名在激活、过户或转入场景的归一化失败分类 |
| `verification template-failure` | 实名核验 | 按模板 ID 查询受控失败原因码，丢弃服务端自由文本与 PII |
| `server-lock list` | 注册局锁 | 按域名、受控状态和分页查询注册局锁服务记录 |
| `server-lock detail` | 注册局锁 | 按实例 ID 查询单条注册局锁记录的最小化摘要 |
| `server-lock check` | 注册局锁 | 检查指定域名与年限是否存在处理中的注册局锁申请，不提交申请 |
| `server-lock max-years` | 注册局锁 | 查询注册局锁激活或续费允许的最大服务年限，不产生购买或续费 |
| `transfer-out status` | 转出续费 | 查询稳定、脱敏的域名转出状态 |
| `transfer-out request-code` | 转出续费 | 提交转移码申请，但不在 CLI 中回显转移码或原始任务结果 |
| `transfer-out apply` | 转出续费 | 申请快速转出，提交前回读账号资产并要求精确域名确认 |
| `auto-renew` | 转出续费 | 开启或关闭自动续费；开启时必须确认未来可能产生扣费 |
| `wxz account` | 建站账号项目 | 查看万小智建站灵感值余额 |
| `wxz project` | 建站账号项目 | 列出、查看或删除建站项目，删除需重复 --confirm-biz-id 二次确认 |
| `wxz preview` | 建站账号项目 | 获取会话沙箱的站点预览链接 |
| `wxz analytics-daily` | 建站账号项目 | 查看站点今日 PV/UV 与近七日趋势等运营数据 |
| `wxz chat-start` | 建站对话生成 | 创建建站对话与站点并流式返回事件，会消耗灵感值 |
| `wxz chat-send` | 建站对话生成 | 向已有建站会话发送后续需求 |
| `wxz chat-resume` | 建站对话生成 | 回答中断表单并继续指定对话轮次 |
| `wxz chat-reconnect` | 建站对话生成 | 从最后收到的事件重新连接建站对话流 |
| `wxz chat-generate` | 建站对话生成 | 确认已有需求并触发站点代码生成 |
| `wxz chat-history` | 建站对话生成 | 查看建站会话历史问答与轮次状态 |
| `wxz content` | 内容创作保存 | 保存文章、图片或视频创作草稿 |
| `wxz code` | 建站代码 | 浏览、读取或回滚站点代码工作区 |
| `wxz conversation` | 建站会话 | 列出建站会话、查看详情或锁状态 |
| `wxz deploy` | 建站发布 | 发布站点、查询发布进度与历史，或回滚到指定发布版本 |
| `wxz site` | 站点域名状态 | 管理站点上下线与自定义域名的绑定、解析、证书、备案与跳转，解绑与下线需重复二次确认 |
| `wxz material-directory` | 建站素材 | 浏览素材目录树，创建、重命名、移动或删除素材目录 |
| `wxz material-file` | 建站素材 | 列出、查看、归档、改名、移动素材文件，或更新其状态与导出下载链接 |
| `wxz skill` | 建站技能 | 浏览、读取、安装或发布万小智技能，删除需重复 --confirm-plugin-id 二次确认 |
---
## 6. 域名 —— Agent 契约

共 6 条。

### capabilities

返回契约版本、命名空间与命令计数等机器可读能力元数据

返回版本化、机器可读的能力元数据，不需要凭证也不访问网络；summary（默认）只列出命名空间与命令计数，--view full 额外列出全部叶子命令。建议在规划一次调用序列之前先调用一次，用来显式发现本地插件是否已经过期。 比如规划一次调用序列前，先确认本地插件的命令面与预期一致；或者需要枚举当前插件支持的每一条叶子命令时，切到完整视图。

参数：
- `--view`（string）：能力视图：summary（摘要）或 full（完整）。默认：summary

```bash
aliyun domain capabilities --view full
```

### schema

不带参数返回精简目录，指定 --command 可查看单条命令完整契约

不带 --command 时返回精简命令目录；指定 --command 后返回该条叶子命令的完整参数、类型、必填项、约束、示例、标签与 OpenAPI 映射。隐藏参数与凭证值永远不会被返回。 比如刚接触这套指令集，想先看一眼有哪些命令；或者已经知道要用哪条命令，只想确认它的参数名和取值范围。

参数：
- `--command`（string）：相对 aliyun domain 的扩展命令路径；省略则返回目录

```bash
aliyun domain schema --command "template verify"
```

### auth

展示当前选中的本地 OAuth 配置就绪状态，不触发登录或云端调用

展示当前选中的本地 OAuth 配置的就绪状态，并提示 login/logout/whoami 三个顶层命令的用法；这条命令本身不会触发登录、刷新凭证或调用云端接口，只做本地状态展示。 比如不确定本机是否已经登录过，先看一眼当前选中的配置就绪状态；或者本机保存了多个 OAuth 配置，只想看其中一个的状态。

参数：
- `--name`（string）：本地 OAuth 配置名称；默认：当前选中的 OAuth 配置或 domain-oauth-cn

```bash
aliyun domain auth
```

### login

打开中国站 OAuth 授权流程，保存并选中临时凭证配置

通过受信任的父 aliyun CLI 打开中国站 OAuth 授权流程，只保存临时凭证配置，并把该配置选中供下一次调用使用；插件本身从不读取或打印凭证。可用 --name 指定一个专用的本地配置名。 比如本机还没有登录过，需要走一遍浏览器 OAuth 授权；或者需要同时维护多个账号或站点的本地配置，给这次登录起一个专用名字。

参数：
- `--name`（string）：本地 OAuth 配置名称；默认：当前选中的 OAuth 配置或 domain-oauth-cn

```bash
aliyun domain login
```

### logout

预览并显式确认删除一个本地中国站 OAuth 配置

预览删除一个本地中国站 OAuth 配置；只有加上 --confirm=true 才会真正通过受信任的父 aliyun CLI 执行删除。这只清除本地配置，不代表服务端 token 已被吊销。 比如先确认要删的是哪个配置，还不想真的删；或者已经核对过预览内容，确认要删除这个本地配置。

参数：
- `--confirm`（bool）：确认删除选中的本地 OAuth 配置
- `--name`（string）：本地 OAuth 配置名称；默认：当前选中的 OAuth 配置或 domain-oauth-cn

```bash
aliyun domain logout --name domain-oauth-cn --confirm=true
```

### whoami

查看当前选中本地 OAuth 配置的身份与就绪状态，不返回凭证

展示当前选中的本地 OAuth 配置名、站点、地域与就绪状态；这是本地身份信息，不代表已验证的云账号归属或 API 权限。未登录或本地未知状态也会正常返回，方便 Agent 按 JSON 状态分支处理，且不会返回 Token、AccessKey 或账号标识。 比如执行写操作前，先确认当前选中的是哪个本地配置。

参数：
- `--name`（string）：本地 OAuth 配置名称；默认：当前选中的 OAuth 配置或 domain-oauth-cn

```bash
aliyun domain whoami
```
---
## 7. 域名 —— 智能问答

共 1 条。

### ask

检索域名行业知识库，支持 cn/intl/all 三种范围，默认返回 5 条答案

用中国站 OAuth 临时凭证从域名行业知识库检索排序后的答案；--site 支持 cn、intl、all 三种知识库范围，--limit 控制返回条数（1～20，默认 5）。问题里不要包含 AccessKey、转移码、身份信息或联系方式等敏感内容。 比如了解中国站相关的域名业务规则；或者涉及国际域名转入等跨站问题，想要更多条候选答案。

参数：
- `--question`（string，必填）：域名行业问题
- `--limit`（int）：最多返回的答案条数，1～20。默认：5
- `--site`（string）：知识库范围：cn（国内站）、intl（国际站）或 all（全部）。默认：cn

```bash
aliyun domain ask --question "域名过期后多久进入赎回期？"
```
---
## 8. 域名 —— 资产与询价

共 6 条。

### list

分页、过滤、排序查询账号下的域名资产，输出隐私安全摘要

分页列出账号下的域名资产，支持按域名、分组 ID、自动续费状态过滤，按注册时间或到期时间排序；--limit 范围 1～100（默认 20），--view raw 可在 summary 之外查看更完整字段，默认输出经过隐私过滤的稳定摘要。 比如不加任何过滤条件，先看账号下有哪些域名；批量核对续费优先级，按到期时间从近到远分页查看；或者已经知道域名，只想看这一条的摘要。

参数：
- `--auto-renew`（bool）：按自动续费状态过滤：true 或 false
- `--domain`（string）：按域名过滤
- `--group-id`（string）：按域名分组 ID 过滤
- `--limit`（int）：每页条数，1～100。默认：20
- `--order`（string）：排序方向：asc（升序）或 desc（降序）。默认：desc
- `--page`（int）：页码。默认：1
- `--sort`（string）：排序字段：registered（注册时间）或 expires（到期时间）
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain list --page 1 --limit 20 --sort expires --order desc
```

### detail

查看单个域名状态、到期日等运营摘要，默认排除持有者身份字段

查看单个域名的运营状态；默认摘要会排除持有者与账号身份相关字段，--view raw 可查看更完整的原始视图。 比如日常核对某个域名的状态、到期日等基础信息；或者摘要字段不够用，需要更完整的原始响应。

参数：
- `--domain`（string，必填）：域名
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain detail --domain example.com
```

### whois

匿名查询域名公开注册摘要，支持 Unicode/Punycode 与多种查询来源

匿名查询域名的公开注册信息；--source auto（默认）依次尝试注册局 RDAP 快照、IANA RDAP 目录、公开 WHOIS 缓存或注册局 WHOIS 服务器，也可以用 --source rdap/whois/system 指定单一来源。只输出注册商、日期、状态、名称服务器和 DNSSEC 等白名单字段，联系人和原始记录一律丢弃；Unicode 域名会被规范化为 Punycode；not_found 不等于可注册，判断可注册性要用 check。 比如不需要登录账号，只想匿名看一个域名的公开注册摘要；域名本身是中文或其他非 ASCII 字符；或者默认来源查不到或想强制走某一种协议做交叉验证。

参数：
- `--domain`（string，必填）：单个域名；支持 Unicode/IDN，不能是 IP 地址或 URL
- `--source`（string）：auto（默认）、rdap、whois 或 system

```bash
aliyun domain whois --domain example.com
```

### check

检查域名可注册性，只读查询，不产生任何订单

检查域名是否可注册，纯只读查询，不会创建任何订单；--view raw 可查看更完整的原始字段。 比如注册前先确认这个域名当前是否可注册；或者摘要视图信息不够，想看原始返回。

参数：
- `--domain`（string，必填）：域名
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain check --domain example.com
```

### search

按生命周期、日期区间、分组、关键字或后缀高级筛选域名资产

按生命周期状态、注册/到期日期区间、分组、关键字或后缀高级筛选资产；日期区间用 UTC 自然日、两端闭合；--limit 范围 1～200（默认 20），可按 domain/registered/expires/domain-type 排序。 比如批量核对哪些域名马上要到期需要续费；或者需要核对某一段时间内到期的域名，规划续费预算。

参数：
- `--expires-from`（string）：到期日期起始（含当天），UTC YYYY-MM-DD 格式
- `--expires-to`（string）：到期日期结束（含当天），UTC YYYY-MM-DD 格式
- `--group-id`（string）：域名分组 ID
- `--keyword`（string）：域名中包含的关键字
- `--limit`（int）：每页条数，1～200。默认：20
- `--order`（string）：排序方向：asc（升序）或 desc（降序）。默认：desc
- `--page`（int）：页码。默认：1
- `--registered-from`（string）：注册日期起始（含当天），UTC YYYY-MM-DD 格式
- `--registered-to`（string）：注册日期结束（含当天），UTC YYYY-MM-DD 格式
- `--sort`（string）：排序字段：domain（域名）、registered（注册时间）、expires（到期时间）或 domain-type（域名类型）
- `--status`（string）：状态：all（全部）、renewal-required（待续费）、redemption-required（待赎回）、normal（正常）、transferring-out（转出中）、registrant-updating（过户中）、unverified（未实名）、verification-failed（实名失败）或 verifying（实名中）
- `--suffixes`（string）：逗号分隔的域名后缀，例如 com,net,com.cn
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain search --status renewal-required --page 1 --limit 20
```

### price

查询后缀或具体域名的公开注册/续费参考价格，不产生订单

查询公开参考价格，不使用 OAuth 凭证；--suffix 与 --domain 二选一，--suffix 只是后缀参考价、不针对具体域名，--domain 需要 ASCII 注册人标签，已注册的非溢价域名若查不到专属价格会退回同样标注为参考价的后缀报价；--years 精确选择报价年限（1～10），不做外推。这条命令不产生订单，也不能替代支付确认。 比如大致了解某个后缀一年多少钱；打算一次注册多年，想看总价参考；或者已经想好了具体域名，想看它的参考报价。

参数：
- `--domain`（string）：带 ASCII 注册人标签的具体域名；已注册域名可能返回标注为参考的后缀报价；与 --suffix 互斥
- `--suffix`（string）：后缀，如 com、.com.cn 或 中国；与 --domain 互斥
- `--years`（int）：精确的报价年限，1～10 年。默认：1

```bash
aliyun domain price --suffix com
```
---
## 9. 域名 —— 交易转入

共 10 条。

### trade publish

校验并预览一口价挂牌请求，加 --confirm=true 仅模拟执行

在真实 OpenAPI 开放前，预留一口价挂牌契约：命令会校验并预览挂牌请求，--sale-days 控制挂牌天数（1～365，默认 30）。加 --confirm=true 只会模拟执行，不会真正创建挂牌、订单、转移或扣费。 比如先确认价格和挂牌参数会被如何处理；或者核对预览无误后，执行一次模拟流程（不产生真实挂牌）。

参数：
- `--domain`（string，必填）：单个完整域名
- `--price`（string，必填）：期望的一口价，最多两位小数的正数
- `--confirm`（bool）：核对预览后，走一遍 模拟完成路径
- `--currency`（string）：价格币种。当前模拟契约只接受 CNY；默认：CNY
- `--sale-days`（int）：期望的挂牌天数，1～365；默认：30

```bash
aliyun domain trade publish --domain example.com --price 8888
```

### trade detail

预留一口价挂牌信息查询契约，明确标注为不可用的模拟结果

预留一口价挂牌信息查询契约；响应不会凭空生成挂牌 ID、状态或价格，会明确标注这是数据不可用的 模拟输出。 比如确认这个域名当前是否有一口价挂牌记录。

参数：
- `--domain`（string，必填）：单个完整域名

```bash
aliyun domain trade detail --domain example.com
```

### trade appraise

预留域名估值契约，不返回可用于定价决策的估值数据

预留域名估值契约；响应不包含任何虚构的估值、区间、币种或置信度，不能用于定价或交易决策。 比如了解这条估值接口目前能返回什么。

参数：
- `--domain`（string，必填）：单个完整域名

```bash
aliyun domain trade appraise --domain example.com
```

### buy

一次购买 1～200 个域名，支持多年注册，打开官方订单确认页

用中国站 OAuth 临时凭证查询账号可用余额（可能包含授信额度），并获取普通可注册域名的公开报价；--domains 最多 200 个逗号分隔域名，--years 1～10 年。批量注册接口没有报价令牌或扣费上限，直接提交需要额外用 --ack-price-may-change 确认最终扣费可能超出显示报价；溢价域名与无法报价的域名必须走浏览器页面。 比如注册一个普通域名，走默认的支付方式询问流程；或者一次注册多个域名，并选择多年期限。

参数：
- `--domains`（string，必填）：最多 200 个逗号分隔的域名
- `--ack-price-may-change`（bool）：确认知晓批量注册接口没有报价令牌或扣费上限，可用余额可能包含授信额度，最终账户扣费可能超出显示的预估金额
- `--confirm-amount`（string）：提交前用于本地核对的显示预估金额；这不是服务端的价格上限
- `--confirm-payment`（bool）：显式确认提交一笔余额支付订单
- `--payment`（string）：支付方式：ask（询问）、balance（余额）或 browser（浏览器）。默认：ask
- `--registrant-profile-id`（int）：已验证的注册人资料 ID：浏览器结算时可选，余额支付时必填
- `--years`（int）：购买年限，1～10 年。默认：1

```bash
aliyun domain buy --domains example.com --years 2
```

### renew

查询续费参考价后，批量进入官方续费订单确认页，最多 200 个域名

先按 domain price 同样的查询方式取得每个域名的中国站续费参考价并显示合计，再进入 OAuth 登录、余额查询和万网续费订单确认页；已注册非溢价域名若查不到专属价格会退回同后缀参考价并标注 domain_specific=false，最终价格仍以订单页为准，参考价不锁定价格也不授权扣费。 比如给一个域名续费一年；或者一次给多个域名续费两年。

参数：
- `--domains`（string，必填）：最多 200 个逗号分隔的域名
- `--payment`（string）：支付方式：ask（询问）或 browser（浏览器）。默认：ask。因为该操作没有精确的公开 OpenAPI 报价，余额支付不可用
- `--years`（int）：续费年限，1～10 年。默认：1

```bash
aliyun domain renew --domains example.com,example.net --years 2
```

### redeem

查询账号余额后进入官方订单页确认赎回资格与最终价格

查询账号余额，再打开官方万网赎回订单确认页；由于公开 Domain OpenAPI 没有精确赎回报价，余额支付被禁用，最终资格和价格都以订单页为准。 比如域名已过期进入赎回期，想把它赎回来；或者同时有多个域名需要赎回。

参数：
- `--domains`（string，必填）：最多 200 个逗号分隔的域名
- `--payment`（string）：支付方式：ask（询问）或 browser（浏览器）。默认：ask。因为该操作没有精确的公开 OpenAPI 报价，余额支付不可用

```bash
aliyun domain redeem --domains example.com
```

### transfer-in apply

一次转入最多 200 组"域名 + 转移码"，进入中国站官方订单页确认

用中国站 OAuth 临时凭证查询余额，再打开官方万网转入订单确认页；--domains 最多 200 组"域名 转移码"，用引号整体包裹。浏览器成功打开时不会回显转移码；打不开时手动结算链接会包含转移码，需要自行保密。 比如把一个域名从其他注册商转入阿里云；或者一次转入多个域名，各自带自己的转移码。

参数：
- `--domains`（string，必填）：最多 200 组逗号分隔的"域名 转移码"，需要给完整值加引号
- `--payment`（string）：支付方式：ask（询问）或 browser（浏览器）。默认：ask。因为该操作没有精确的公开 OpenAPI 报价，余额支付不可用

```bash
aliyun domain transfer-in apply --domains "example.com transfer-code"
```

### transfer-in list

按域名、转入状态、日期和分页查询转入申请，仅返回最小化摘要

用中国站 OAuth 临时凭证查询转入申请，返回最小化白名单摘要，不暴露原始 OpenAPI 响应或不相关客户数据；可按域名、状态、日期区间和分页过滤。 比如先看看账号下有哪些转入申请；或者核对还在处理中的转入申请。

参数：
- `--domain`（string）：域名
- `--from`（string）：起始日期，格式 YYYY-MM-DD
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--status`（string）：转入状态：all（全部）、init（初始化）、authorization（授权中）、name-verification（实名核验中）、password-verification（密码核验中）、pending（处理中）、success（成功）或 failed（失败）
- `--to`（string）：结束日期（含当天），格式 YYYY-MM-DD

```bash
aliyun domain transfer-in list --status pending --page 1 --limit 20
```

### transfer-in detail

按实例 ID 查询单条转入进度

按域名实例 ID 查询单条转入进度，返回最小化白名单摘要。 比如已经知道实例 ID，想看这一条转入的详细进度。

参数：
- `--instance-id`（string，必填）：域名实例 ID

```bash
aliyun domain transfer-in detail --instance-id S20181T0WLI85212
```

### transfer-in check

仅按域名检查转入资格，不接收也不发送转移码

仅按域名检查转入资格，不接收也不发送转移码，返回最小化白名单摘要。 比如转入前先确认这个域名是否满足转入条件。

参数：
- `--domain`（string，必填）：域名

```bash
aliyun domain transfer-in check --domain example.com
```
---
## 10. 域名 —— 备案服务

共 4 条。

### icp ask

校验备案咨询问题但不回显、不外发，也不生成虚构答案

在真实 API 尚未开放前，预留备案咨询问题的命令契约。问题会做校验，但永远不会被回显、外发，也不会生成虚构的备案指引。 比如打算新增网站备案，想先确认需要准备什么材料。

参数：
- `--question`（string，必填）：ICP 备案问题，最多 500 字符；模拟不会回显

```bash
aliyun domain icp ask --question "新增网站备案需要准备哪些资料？"
```

### icp fill

预留网站新增备案填写契约，仅返回模拟结果，不创建真实备案申请

预留网站新增备案填写契约。--input-file 是受权限保护的本地 JSON 文件引用，命令不会打开或打印它的内容；加 --confirm=true 只会模拟执行，不会真正创建或提交备案申请。当前只保留 website-new 这一种备案类型。 比如先看一下这条命令会如何处理填写请求，还不想提交；或者确认预览无误后，执行一次模拟流程（不产生真实备案）。

参数：
- `--domain`（string，必填）：新增备案的网站域名
- `--input-file`（string，必填）：受保护的本地 JSON 文件引用；模拟不会打开或打印它
- `--confirm`（bool）：核对预览后，走一遍 模拟完成路径
- `--filing-type`（string）：备案类型。当前只预留了 website-new；默认：website-new

```bash
aliyun domain icp fill --domain example.com --input-file ./icp-website-new.json
```

### icp status

按备案申请 ID 预留进度查询契约，不返回虚构进度

预留备案进度查询契约。命令只校验备案申请 ID 的格式，不会返回任何虚构的进度阶段、百分比、审核结果或时间戳。 比如已经提交了备案，想按申请 ID 查一下进度。

参数：
- `--filing-id`（string，必填）：ICP 备案申请 ID

```bash
aliyun domain icp status --filing-id ICP_EXAMPLE_001
```

### icp info

通过 --type success|risk|all 预留备案成功/风险信息查询契约

预留单条 ICP 信息查询契约。--type success 查询已成功备案信息，risk 查询备案风险信息，all（默认）两者都查；不会凭空生成备案记录或风险结论。 比如不确定要查成功记录还是风险信息，两个都想看；确认这个域名是否已经成功备案；或者担心这个域名有备案风险，想单独核实。

参数：
- `--domain`（string，必填）：要查询 ICP 备案信息的域名
- `--type`（string）：信息类型：success（成功）、risk（风险）或 all（全部）。默认：all

```bash
aliyun domain icp info --domain example.com
```
---
## 11. 域名 —— 分组任务

共 11 条。

### group list

查询域名分组，可按精确名称和 active/all 状态筛选

用中国站 OAuth 临时凭证列出域名分组，返回隐私安全的摘要；可按精确名称过滤，--state 支持 active（默认）或 all。 比如看当前还在用的分组；或者知道分组名，想确认它是否存在（包含已删除中的）。

参数：
- `--name`（string）：按精确分组名称过滤
- `--state`（string）：分组状态：active（活跃）或 all（全部）。默认：active

```bash
aliyun domain group list --state all
```

### group create

创建域名分组

创建域名分组；默认只输出预览，加 --confirm=true 后才用中国站 OAuth 临时凭证提交。 比如先确认分组名没有问题；或者核对预览无误后正式创建分组。

参数：
- `--name`（string，必填）：新分组名称
- `--confirm`（bool）：核对预览后，设为 true 以提交

```bash
aliyun domain group create --name "brand domains"
```

### group rename

按精确名称或数字 ID 重命名域名分组

按精确名称或数字 ID 重命名域名分组；默认只输出预览，加 --confirm=true 后才提交。 比如先确认新旧名称没有输错；或者核对无误后提交重命名。

参数：
- `--group`（string，必填）：精确的分组名称或数字分组 ID
- `--name`（string，必填）：新分组名称
- `--confirm`（bool）：核对预览后，设为 true 以提交

```bash
aliyun domain group rename --group "brand domains" --name "core brands"
```

### group move

将最多 50 个域名移动到指定分组，不替换现有成员

将最多 50 个域名移动到指定分组，不会替换该分组现有成员；默认只输出预览，加 --confirm=true 后才提交。 比如先确认要移动的域名列表和目标分组；或者核对无误后正式移动域名。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--group`（string，必填）：精确的分组名称或数字分组 ID
- `--confirm`（bool）：核对预览后，设为 true 以提交

```bash
aliyun domain group move --domains example.com,example.net --group "core brands"
```

### group delete

删除指定分组，系统未分组不可删除

按精确名称或数字 ID 删除指定分组，系统内置的未分组分组不能删除；默认只输出预览，加 --confirm=true 后才提交。 比如先确认要删的是哪个分组；或者核对无误后正式删除分组。

参数：
- `--group`（string，必填）：精确的分组名称或数字分组 ID
- `--confirm`（bool）：核对预览后，设为 true 以提交

```bash
aliyun domain group delete --group "temporary"
```

### history

按日期查询操作历史，不输出操作 IP、详情和备注

按域名、日期区间和分页查询操作历史，响应不包含操作 IP 地址和自由文本详情。 比如核对某个域名最近发生了哪些操作；或者核对某段时间内账号下所有域名的操作记录。

参数：
- `--domain`（string）：按域名过滤
- `--from`（string）：起始日期，格式 YYYY-MM-DD
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--to`（string）：结束日期（含当天），格式 YYYY-MM-DD

```bash
aliyun domain history --domain example.com
```

### task list

查询账号下的域名异步操作任务，支持日期和分页

按创建日期区间和分页查询账号下的域名异步操作任务；默认摘要排除客户端 IP 和原始任务结果，--view raw 可查看完整诊断信息。 比如先看看账号下最近有哪些异步任务；或者核对某段时间内提交的任务。

参数：
- `--from`（string）：创建起始日期，格式 YYYY-MM-DD
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--to`（string）：创建结束日期，格式 YYYY-MM-DD
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain task list --from 2026-08-01 --to 2026-08-24 --page 1 --limit 20
```

### task show

分页查看指定任务内各域名的结构化执行状态

按任务 ID 分页查看该任务内各域名的结构化执行状态；默认摘要只含结构化状态，--view raw 查看完整诊断信息，可再按域名/实例 ID/状态过滤。 比如看这个任务下所有域名的执行状态；或者任务部分失败，只想核对失败的那些域名。

参数：
- `--task-id`（string，必填）：域名操作返回的任务 ID
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--domain`（string）：按域名过滤明细
- `--instance-id`（string）：按域名实例 ID 过滤明细
- `--status`（string）：明细状态：pending（待处理）、running（执行中）、succeeded（成功）或 failed（失败）
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain task show --task-id 60d6e201-8ee5-47ab-8fdc-example
```

### task history

按日期查询历史异步任务，返回可直接续查的成对游标

用中国站 OAuth 临时凭证按日期区间查询历史异步任务，返回可直接续查的成对游标；响应排除客户端 IP、原始任务结果、自由文本错误和请求参数等敏感字段。 比如核对某段时间内提交过的所有异步任务。

参数：
- `--cursor-task-id`（string）：翻页游标：任务 ID
- `--cursor-time`（string）：翻页游标：时间，RFC3339 格式
- `--from`（string）：起始日期，格式 YYYY-MM-DD
- `--limit`（int）：每页条数，1～100。默认：20
- `--to`（string）：结束日期（含当天），格式 YYYY-MM-DD

```bash
aliyun domain task history --from 2026-08-01 --to 2026-08-26 --limit 20
```

### task history-detail

分页查询指定历史任务的域名级明细，不输出客户端 IP 或自由文本错误

按历史任务 ID 分页查询域名级明细；响应排除客户端 IP、原始结果和自由文本错误，可再按域名或明细状态过滤。 比如核对一个历史任务下每个域名的执行结果。

参数：
- `--task-id`（string，必填）：域名任务 ID
- `--cursor-detail-id`（string）：翻页游标：任务明细 ID
- `--cursor-domain`（string）：翻页游标：域名
- `--domain`（string）：域名
- `--limit`（int）：每页条数，1～100。默认：20
- `--status`（string）：任务明细状态：all（全部）、pending（待处理）、running（执行中）、succeeded（成功）或 failed（失败）

```bash
aliyun domain task history-detail --task-id 75addb07-28a3-450e-b5ec-example --limit 20
```

### task poll

查询已完成任务结果的受控状态摘要

查询已完成任务结果的受控状态摘要，可按域名、实例 ID、任务 ID 或完成状态（succeeded/failed/all）过滤；响应同样排除客户端 IP、原始结果和自由文本错误。 比如核对一个任务里哪些域名执行失败了。

参数：
- `--domain`（string）：域名
- `--instance-id`（string）：域名实例 ID
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--status`（string）：已完成结果的状态：all（全部）、succeeded（成功）或 failed（失败）
- `--task-id`（string）：域名任务 ID

```bash
aliyun domain task poll --task-id 75addb07-28a3-450e-b5ec-example --status failed
```
---
## 12. 域名 —— 域名管控

共 4 条。

### transfer-lock

批量开启或关闭禁止转移锁，最多 50 个域名

批量开启或关闭禁止转移锁，最多 50 个域名；默认只输出预览，加 --confirm=true 后才用中国站 OAuth 临时凭证提交锁定任务。 比如先确认要锁定的域名列表和目标状态，还不提交；或者核对预览无误后，批量关闭多个域名的转移锁。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--status`（string，必填）：锁状态：on（开启）或 off（关闭）
- `--confirm`（bool）：核对预览后，设为 true 以提交变更

```bash
aliyun domain transfer-lock --domains example.com --status on
```

### update-lock

批量开启或关闭禁止更新锁，保护联系人和 DNS 变更

批量开启或关闭禁止更新锁，用于保护联系人和 DNS 变更，最多 50 个域名；默认只输出预览，加 --confirm=true 后才用中国站 OAuth 临时凭证提交。 比如先确认目标域名列表，还不提交；或者需要临时关闭更新锁以修改联系人或 DNS 配置。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--status`（string，必填）：锁状态：on（开启）或 off（关闭）
- `--confirm`（bool）：核对预览后，设为 true 以提交变更

```bash
aliyun domain update-lock --domains example.com --status on
```

### nameserver set

批量切换注册局名称服务器委派，支持阿里云或 2～13 个自定义主机名

批量替换最多 50 个域名的注册局名称服务器委派：--servers aliyun 切到阿里云名称服务器，或提供 2～13 个逗号分隔的自定义名称服务器主机名。这条命令不会改动某个 DNS 区域内的 A/AAAA/CNAME/MX/TXT/NS 记录（那是 dns 管的）、Glue Record（dnshost 管）或 DS 记录（dnssec 管）。默认只输出预览，加 --confirm=true 后才用中国站 OAuth 临时凭证提交一个异步任务；变更名称服务器可能中断网站和邮件服务，任务提交成功不代表解析已经生效。 比如域名当前用的是别的注册商名称服务器，想切回阿里云统一管理；或者需要指向自己维护的名称服务器，且已经核对过预览。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--servers`（string，必填）：注册局名称服务器：aliyun，或 2～13 个逗号分隔的自定义主机名
- `--confirm`（bool）：核对预览后，设为 true 以提交变更

```bash
aliyun domain nameserver set --domains example.com --servers aliyun
```

### remark

自动查询实例 ID，为最多 50 个域名保存同一备注

自动解析域名实例 ID，为最多 50 个域名保存同一条备注；默认只输出预览，加 --confirm=true 后才用中国站 OAuth 临时凭证提交。 比如先确认备注文本和目标域名列表；或者需要给多个域名统一标注用途，方便后续分组管理。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--text`（string，必填）：备注文本
- `--confirm`（bool）：核对预览后，设为 true 以提交变更

```bash
aliyun domain remark --domains example.com --text "production"
```
---
## 13. 域名 —— DNS Host 与 DNSSEC

共 8 条。

### dnshost list

查询 DNS Host / Glue Record 及其 IP 地址

查询某个父域名下的 DNS Host（Glue Record）及其 IP 地址列表。 比如确认这个域名下配置了哪些 DNS Host。

参数：
- `--domain`（string，必填）：父域名

```bash
aliyun domain dnshost list --domain example.com
```

### dnshost create

新增严格属于父域名的 DNS Host，并校验 IP

新增严格属于父域名的 DNS Host，支持逗号分隔的多个 IPv4/IPv6 地址；默认只输出预览，加 --confirm=true 后才提交。 比如先确认主机名和 IP 会被如何处理；或者核对预览无误后正式创建。

参数：
- `--domain`（string，必填）：父域名
- `--host`（string，必填）：完整的 DNS Host 名称
- `--ips`（string，必填）：逗号分隔的 IPv4 或 IPv6 地址
- `--confirm`（bool）：提交已核对的变更

```bash
aliyun domain dnshost create --domain example.com --host ns1.example.com --ips 1.2.3.4 --confirm=true
```

### dnshost update

替换 DNS Host 的 IPv4/IPv6 地址

替换指定 DNS Host 的 IPv4/IPv6 地址列表；默认只输出预览，加 --confirm=true 后才提交。 比如需要给同一个 DNS Host 同时配置 IPv4 和 IPv6 地址。

参数：
- `--domain`（string，必填）：父域名
- `--host`（string，必填）：完整的 DNS Host 名称
- `--ips`（string，必填）：逗号分隔的 IPv4 或 IPv6 地址
- `--confirm`（bool）：提交已核对的变更

```bash
aliyun domain dnshost update --domain example.com --host ns1.example.com --ips 1.2.3.4,2001:db8::1 --confirm=true
```

### dnshost delete

删除指定 DNS Host / Glue Record

删除指定的 DNS Host / Glue Record；默认只输出预览，加 --confirm=true 后才提交。 比如这个 DNS Host 不再需要，确认删除。

参数：
- `--domain`（string，必填）：父域名
- `--host`（string，必填）：完整的 DNS Host 名称
- `--confirm`（bool）：提交已核对的变更

```bash
aliyun domain dnshost delete --domain example.com --host ns1.example.com --confirm=true
```

### dnssec list

查询域名当前 DNSSEC DS 记录

查询域名当前的 DNSSEC DS 记录。 比如确认这个域名是否已经开启 DNSSEC。

参数：
- `--domain`（string，必填）：域名

```bash
aliyun domain dnssec list --domain example.com
```

### dnssec enable

新增 DS 记录，要求资产归属校验和精确域名确认

高风险变更，新增 DS 记录；OAuth 账号必须拥有该域名，且需要先预览，再同时提供 --confirm=true 与精确匹配的 --confirm-domain。 比如为域名开启 DNSSEC，注册局侧新增一条 DS 记录。

参数：
- `--algorithm`（int，必填）：DNSSEC 算法编号
- `--digest`（string，必填）：十六进制的 DS 摘要值
- `--digest-type`（int，必填）：摘要类型：1、2 或 4
- `--domain`（string，必填）：域名
- `--key-tag`（int，必填）：DNSSEC 密钥标签，0～65535
- `--confirm`（bool）：提交已核对的高风险变更
- `--confirm-domain`（string）：为高风险确认再次输入完全一致的域名

```bash
aliyun domain dnssec enable --domain example.com --key-tag 12345 --algorithm 13 --digest-type 2 --digest <64-hex> --confirm-domain example.com --confirm=true
```

### dnssec update

修改 DS 记录，本地校验算法、摘要类型和摘要长度

高风险变更，修改 DS 记录；本地会校验算法、摘要类型和摘要长度，同样需要预览后再提供 --confirm=true 与精确匹配的 --confirm-domain。 比如密钥轮换后需要更新已有的 DS 记录。

参数：
- `--algorithm`（int，必填）：DNSSEC 算法编号
- `--digest`（string，必填）：十六进制的 DS 摘要值
- `--digest-type`（int，必填）：摘要类型：1、2 或 4
- `--domain`（string，必填）：域名
- `--key-tag`（int，必填）：DNSSEC 密钥标签，0～65535
- `--confirm`（bool）：提交已核对的高风险变更
- `--confirm-domain`（string）：为高风险确认再次输入完全一致的域名

```bash
aliyun domain dnssec update --domain example.com --key-tag 12345 --algorithm 13 --digest-type 2 --digest <64-hex> --confirm-domain example.com --confirm=true
```

### dnssec disable

删除 DS 记录以关闭 DNSSEC，要求精确域名确认

高风险变更，删除 DS 记录以关闭 DNSSEC；需要精确匹配的 --confirm-domain 确认。 比如不再需要 DNSSEC，删除对应的 DS 记录。

参数：
- `--domain`（string，必填）：域名
- `--key-tag`（int，必填）：DNSSEC 密钥标签，0～65535
- `--confirm`（bool）：提交已核对的高风险变更
- `--confirm-domain`（string）：为高风险确认再次输入完全一致的域名

```bash
aliyun domain dnssec disable --domain example.com --key-tag 12345 --confirm-domain example.com --confirm=true
```
---
## 14. 域名 —— 云解析 DNS 记录

通过阿里云云解析（AliDNS）管理 A/AAAA/CNAME/MX/TXT 等公开解析记录；这是解析记录本身，和注册局侧的名称服务器委派（nameserver）、Glue Record（dnshost）、DS 记录（dnssec）是完全不同的四件事。

共 9 条。

### dns list

按主机、类型、值、线路和状态过滤查询 DNS 解析记录

列出某个云解析托管区域下的解析记录，可按主机记录、类型、值、线路和启用状态过滤；--limit 默认 100（查询最多 500，日志最多 100）。--show-values 才会显式返回 TXT 记录值，因为其中可能包含验证令牌。 比如先看这个域名下配置了哪些解析记录。

参数：
- `--domain`（string，必填）：云解析托管区域（含委派子域），与注册商归属无关
- `--host`（string）：相对主机记录，如 @、www 或 _acme-challenge
- `--limit`（int）：每页条数；默认 100，list 最多 500，logs 最多 100
- `--line`（string）：解析线路代码；create 默认为 default；可通过 dns lines 查询
- `--page`（int）：页码，从 1 开始；默认 1
- `--show-values`（bool）：显式包含 TXT 记录值；可能暴露验证令牌
- `--status`（string）：记录状态：enable（启用）或 disable（停用）；省略表示不过滤
- `--type`（string）：写操作支持 A、AAAA、CNAME、MX、TXT、NS、SRV 和 CAA；查询时可按其他类型过滤
- `--value`（string）：精确的记录值；TXT 记录会保留大小写和空白字符；除非提供 value-file，否则必填

```bash
aliyun domain dns list --domain example.com
```

### dns detail

按记录 ID 精确查询单条 DNS 解析记录

按 dns list 返回的精确记录 ID 查询单条解析记录；--show-values 才会显式返回 TXT 值。 比如已经从列表里拿到记录 ID，想看这一条的完整信息。

参数：
- `--record-id`（string，必填）：从 dns list 获取的精确解析记录 ID
- `--show-values`（bool）：显式包含 TXT 记录值；可能暴露验证令牌

```bash
aliyun domain dns detail --record-id 123456
```

### dns create

新增一条 DNS 解析记录，写入需预览并携带 --confirm-domain/--plan-id 确认

新增一条 A/AAAA/CNAME/MX/TXT/NS/SRV/CAA 解析记录；写入前会先输出完整的变更前后预览，Agent 与非交互场景必须携带该预览返回的 --confirm=true、--confirm-domain 与 --plan-id 才能提交，且不会自动重试。MX 记录必须额外提供 1～50 的 --priority；--ttl 默认 600 秒、范围 1～86400 秒且不能低于区域最小值；目标状态若与现状一致会返回 no_change。写入成功不代表解析已经全网生效。 比如先看一下新增这条记录的变更预览，还不提交；或者需要给域名配置邮箱服务，新增一条带优先级的 MX 记录。

参数：
- `--domain`（string，必填）：云解析托管区域（含委派子域），与注册商归属无关
- `--host`（string，必填）：相对主机记录，如 @、www 或 _acme-challenge
- `--type`（string，必填）：写操作支持 A、AAAA、CNAME、MX、TXT、NS、SRV 和 CAA；查询时可按其他类型过滤
- `--confirm`（bool）：人工确认预览结果；同时需要提供 confirm-domain 和 plan-id
- `--confirm-domain`（string）：客户确认的区域名称，必须与记录实际归属一致
- `--line`（string）：解析线路代码；create 默认为 default；可通过 dns lines 查询
- `--plan-id`（string）：来自已核对预览的 plan_id；状态或身份变化后需要重新走一遍预览确认
- `--priority`（int）：MX 优先级，1～50；创建 MX 记录时必填，且只对 MX 有效
- `--ttl`（int）：TTL（秒），1～86400，且不能低于区域最小值；create 默认 600
- `--value`（string）：精确的记录值；TXT 记录会保留大小写和空白字符；除非提供 value-file，否则必填
- `--value-file`（string）：从受保护的单行文件读取记录值；与 value 互斥

```bash
aliyun domain dns create --domain example.com --host www --type A --value 192.0.2.1
```

### dns update

按记录 ID 修改解析记录，未提供字段保持原值，写入需精确确认

按记录 ID 修改一条已有解析记录，未提供的字段保持原值不变；同样需要先预览，再携带 --confirm=true、--confirm-domain 与 --plan-id 提交。 比如服务器 IP 变更，需要更新已有的 A 记录指向。

参数：
- `--record-id`（string，必填）：从 dns list 获取的精确解析记录 ID
- `--confirm`（bool）：人工确认预览结果；同时需要提供 confirm-domain 和 plan-id
- `--confirm-domain`（string）：客户确认的区域名称，必须与记录实际归属一致
- `--host`（string）：相对主机记录，如 @、www 或 _acme-challenge
- `--line`（string）：解析线路代码；create 默认为 default；可通过 dns lines 查询
- `--plan-id`（string）：来自已核对预览的 plan_id；状态或身份变化后需要重新走一遍预览确认
- `--priority`（int）：MX 优先级，1～50；创建 MX 记录时必填，且只对 MX 有效
- `--ttl`（int）：TTL（秒），1～86400，且不能低于区域最小值；create 默认 600
- `--type`（string）：写操作支持 A、AAAA、CNAME、MX、TXT、NS、SRV 和 CAA；查询时可按其他类型过滤
- `--value`（string）：精确的记录值；TXT 记录会保留大小写和空白字符；除非提供 value-file，否则必填
- `--value-file`（string）：从受保护的单行文件读取记录值；与 value 互斥

```bash
aliyun domain dns update --record-id 123456 --value 192.0.2.2
```

### dns delete

按记录 ID 删除一条解析记录，写入需精确确认

按记录 ID 删除一条解析记录；需要先预览，再携带 --confirm=true、--confirm-domain 与 --plan-id 提交。 比如这条解析记录不再需要，确认删除。

参数：
- `--record-id`（string，必填）：从 dns list 获取的精确解析记录 ID
- `--confirm`（bool）：人工确认预览结果；同时需要提供 confirm-domain 和 plan-id
- `--confirm-domain`（string）：客户确认的区域名称，必须与记录实际归属一致
- `--plan-id`（string）：来自已核对预览的 plan_id；状态或身份变化后需要重新走一遍预览确认

```bash
aliyun domain dns delete --record-id 123456
```

### dns enable

按记录 ID 启用一条解析记录，写入需精确确认

按记录 ID 启用一条已停用的解析记录；需要先预览，再携带 --confirm=true、--confirm-domain 与 --plan-id 提交。 比如之前临时停用的一条记录现在需要恢复生效。

参数：
- `--record-id`（string，必填）：从 dns list 获取的精确解析记录 ID
- `--confirm`（bool）：人工确认预览结果；同时需要提供 confirm-domain 和 plan-id
- `--confirm-domain`（string）：客户确认的区域名称，必须与记录实际归属一致
- `--plan-id`（string）：来自已核对预览的 plan_id；状态或身份变化后需要重新走一遍预览确认

```bash
aliyun domain dns enable --record-id 123456
```

### dns disable

按记录 ID 停用一条解析记录，写入需精确确认

按记录 ID 停用一条解析记录（不删除，只是暂停生效）；需要先预览，再携带 --confirm=true、--confirm-domain 与 --plan-id 提交。 比如需要临时下线某个子域名的解析，但不想删掉这条记录。

参数：
- `--record-id`（string，必填）：从 dns list 获取的精确解析记录 ID
- `--confirm`（bool）：人工确认预览结果；同时需要提供 confirm-domain 和 plan-id
- `--confirm-domain`（string）：客户确认的区域名称，必须与记录实际归属一致
- `--plan-id`（string）：来自已核对预览的 plan_id；状态或身份变化后需要重新走一遍预览确认

```bash
aliyun domain dns disable --record-id 123456
```

### dns lines

查询托管区域可用的 DNS 解析线路，供 create/update 使用

查询某个托管区域可用的解析线路代码，供 create/update 的 --line 参数使用；create 默认线路是 default。 比如按运营商或地域配置不同解析结果，先看看有哪些线路可选。

参数：
- `--domain`（string，必填）：云解析托管区域（含委派子域），与注册商归属无关

```bash
aliyun domain dns lines --domain example.com
```

### dns logs

查询隐私过滤后的 DNS 解析操作日志元数据

查询隐私过滤后的解析操作日志元数据，可按开始/结束日期（需成对提供）和分页过滤；--limit 最多 100。 比如需要核对某个域名最近的解析变更记录。

参数：
- `--domain`（string，必填）：云解析托管区域（含委派子域），与注册商归属无关
- `--end-time`（string）：结束日期 YYYY-MM-DD；需同时提供 start-time
- `--limit`（int）：每页条数；默认 100，list 最多 500，logs 最多 100
- `--page`（int）：页码，从 1 开始；默认 1
- `--start-time`（string）：起始日期 YYYY-MM-DD；需同时提供 end-time

```bash
aliyun domain dns logs --domain example.com
```
---
## 15. 域名 —— 隐私资料

共 16 条。

### template list

查询信息模板摘要，不输出姓名、邮箱、电话、地址和证件

分页查询信息模板摘要；响应始终经过白名单与脱敏处理，不输出姓名、邮箱、电话、地址和证件。 比如先看看账号下配置了哪些信息模板。

参数：
- `--limit`（int）：每页条数，默认 20
- `--page`（int）：页码，默认 1

```bash
aliyun domain template list --page 1 --limit 20
```

### template create

从权限受保护的 JSON 文件新增信息模板

从受保护的本地 JSON 文件新增信息模板；文件必须是普通文件、非符号链接，Unix 下要求权限不超过 0600。默认只输出预览，加 --confirm=true 后才提交。 比如先确认文件内容会被如何解析，还不提交；或者核对预览无误后正式创建模板。

参数：
- `--input-file`（string，必填）：受保护的 JSON 文件，包含模板的个人身份信息
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain template create --input-file ./template.json --confirm=true
```

### template update

使用受保护 JSON 文件修改指定信息模板

使用受保护的 JSON 文件修改指定信息模板；默认只输出预览，加 --confirm=true 后才提交。 比如模板信息有变化，用新文件覆盖更新。

参数：
- `--input-file`（string，必填）：受保护的 JSON 文件，包含模板的个人身份信息
- `--template-id`（int，必填）：信息模板 ID
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain template update --template-id 123456 --input-file ./template.json --confirm=true
```

### template set-default

设置默认信息模板

设置默认信息模板偏好；这不会改变现有域名已绑定的联系人，也不会触发实名核验或自动为余额支付选中该模板。默认只输出预览，加 --confirm=true 后才提交。 比如新注册域名时希望默认使用这个模板。

参数：
- `--template-id`（int，必填）：要设为默认的信息模板 ID
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain template set-default --template-id 123456 --confirm=true
```

### template validate

校验受保护文件中的联系人字段，不是实名认证

通过 VerifyContactField 校验受保护文件里的联系人字段是否合法；这不是实名认证，也不会创建模板或与现有域名联系人比对。文件最大 64 KiB，只接受 country/province/city/address/registrant_name 等固定的蛇形命名字段，未知或重复字段会被拒绝；--domain 可选，用于套用对应注册局的校验规则。输出只包含字段名，不包含字段值。 比如填写新模板前，先确认字段格式是否符合注册局要求。

参数：
- `--input-file`（string，必填）：受保护的 JSON 文件，包含要校验的联系人字段
- `--domain`（string）：可选域名，用于选择对应注册局的校验规则；不做持有权校验

```bash
aliyun domain template validate --input-file ./contact.json --domain example.com
```

### template regions

通过 OAuth 查询中国省份及下级城市名称，辅助填写模板地址

通过中国站 OAuth 临时凭证只读查询中国省份及下级城市名称，用于辅助填写模板地址；--province 是在拿到接口结果后本地做的精确名称过滤，不会作为参数发给接口，也不会修改模板或做地址/身份核验。 比如第一次填地址，想看看省份列表长什么样；或者已经确定省份，只想看这个省下有哪些城市。

参数：
- `--province`（string）：可选的精确省份名称；在本地对返回列表做过滤

```bash
aliyun domain template regions --province 浙江省
```

### template verify

提交信息模板实名认证证据，提交成功不代表认证已通过

为信息模板提交实名认证证据；受保护 JSON 文件只接受证件类型、证件号和证件图片引用三个字段，图片路径相对 JSON 所在目录，且图片必须是 55 KiB～1 MiB 的 JPG 或 BMP，两个文件都要求普通文件、非符号链接，Unix 下权限不超过 0600。默认只输出预览，加 --confirm=true 后才提交；提交成功只代表进入审核，不代表认证已经通过。 比如模板需要完成实名认证，提交证件资料。

参数：
- `--input-file`（string，必填）：受保护的 JSON 文件，包含证件类型、证件号和证件图片引用
- `--template-id`（int，必填）：要提交实名认证的信息模板 ID
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain template verify --template-id 123456 --input-file ./verification.json --confirm=true
```

### template delete

删除单个或多个信息模板，默认仅预览，加 --confirm=true 提交

用 --template-id 删除单个模板，或用 --template-ids 批量删除（逗号分隔的唯一正整数，CLI 安全上限 50 个，不是官方 API 上限），两个参数互斥。默认只输出预览，加 --confirm=true 后才提交；没有自动重试或回滚。 比如这个模板不再使用，删除它；或者需要一次清理多个不再使用的模板。

参数：
- `--confirm`（bool）：提交已核对的隐私敏感变更
- `--template-id`（int）：单个模板 ID；与 --template-ids 互斥
- `--template-ids`（string）：逗号分隔的唯一正整数模板 ID；CLI 安全上限 50 个

```bash
aliyun domain template delete --template-id 123456 --confirm=true
```

### contact

查询脱敏后的域名联系人信息

按域名和角色（registrant/admin/tech/billing）查询脱敏后的联系人信息，响应始终经过白名单与脱敏处理。 比如核对某个域名当前登记的持有人信息脱敏摘要。

参数：
- `--domain`（string，必填）：域名
- `--type`（string，必填）：registrant（持有人）、admin（管理联系人）、tech（技术联系人）或 billing（付费联系人）

```bash
aliyun domain contact --domain example.com --type registrant
```

### set-contact

使用信息模板批量更新联系人，最多 50 个域名

用已通过校验的信息模板批量更新最多 50 个域名的联系人（registrant/admin/tech/billing 四种角色任选一种）；默认只输出预览，加 --confirm=true 后才提交。 比如多个域名需要统一切换到新的持有人信息模板。

参数：
- `--domains`（string，必填）：逗号分隔的域名列表，最多 50 个
- `--template-id`（int，必填）：已验证的信息模板 ID
- `--type`（string，必填）：registrant（持有人）、admin（管理联系人）、tech（技术联系人）或 billing（付费联系人）
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain set-contact --domains example.com --template-id 123456 --type registrant --confirm=true
```

### email list

查询脱敏后的邮箱验证记录，不输出发送 IP

分页查询邮箱验证记录，可按状态（all/pending/verified）过滤；响应经过白名单处理，不输出发送方 IP。 比如核对哪些邮箱还没完成验证。

参数：
- `--limit`（int）：每页条数，默认 20
- `--page`（int）：页码，默认 1
- `--status`（string）：all（全部）、pending（待验证）或 verified（已验证）

```bash
aliyun domain email list --status pending
```

### email detail

从 0600 私密文件读取邮箱，仅返回脱敏邮箱、受控状态和时间

从权限不超过 0600 的私密文件读取邮箱地址，只返回脱敏后的邮箱、受控状态和时间戳；验证 ID、账号 ID、客户端 IP 和原始响应一律不会打印。 比如确认某个邮箱当前的验证状态。

参数：
- `--email-file`（string，必填）：受保护的文件，仅包含一个邮箱地址

```bash
aliyun domain email detail --email-file ./email.txt
```

### email request

从私密文件读取邮箱并发送验证邮件

从私密文件读取邮箱地址并发送验证邮件；默认只输出预览，加 --confirm=true 后才提交。 比如新增了一个邮箱联系人，需要先完成验证。

参数：
- `--email-file`（string，必填）：受保护的文件，仅包含一个邮箱地址
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain email request --email-file ./email.txt --confirm=true
```

### email confirm

从私密文件读取 Token 并完成邮箱验证

从私密文件读取验证 Token 并完成邮箱验证；默认只输出预览，加 --confirm=true 后才提交。 比如收到验证邮件后，用邮件里的 Token 完成确认。

参数：
- `--token-file`（string，必填）：受保护的文件，仅包含一个验证 Token
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain email confirm --token-file ./token.txt --confirm=true
```

### email resend

为私密文件中的邮箱重新发送验证邮件

为私密文件中指定的邮箱重新发送验证邮件；默认只输出预览，加 --confirm=true 后才提交。 比如之前的验证邮件没收到或过期了，重新发一次。

参数：
- `--email-file`（string，必填）：受保护的文件，仅包含一个邮箱地址
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain email resend --email-file ./email.txt --confirm=true
```

### email delete

删除私密文件指定的已验证邮箱记录

删除私密文件中指定的已验证邮箱记录；默认只输出预览，加 --confirm=true 后才提交。 比如这个邮箱联系人不再需要，删除已验证记录。

参数：
- `--email-file`（string，必填）：受保护的文件，仅包含一个邮箱地址
- `--confirm`（bool）：提交已核对的隐私敏感变更

```bash
aliyun domain email delete --email-file ./email.txt --confirm=true
```
---
## 16. 域名 —— 实名核验

共 4 条。

### verification domain-status

查询域名实名认证资料的安全元数据

查询域名实名认证资料的安全元数据，返回严格白名单字段；证件号码、证件图片、下载链接、联系方式和原始失败文本一律不会打印。 比如确认这个域名的实名认证是否已经通过。

参数：
- `--domain`（string，必填）：域名

```bash
aliyun domain verification domain-status --domain example.com
```

### verification template-status

按模板 ID 查询实名认证资料状态，不输出姓名、证件、地址、邮箱或图片

按模板 ID 查询实名认证资料状态，同样只返回白名单字段，不输出姓名、证件、地址、邮箱或图片。 比如提交过实名资料的模板，想确认审核进度。

参数：
- `--template-id`（int，必填）：信息模板 ID

```bash
aliyun domain verification template-status --template-id 1234567
```

### verification domain-failure

查询域名在激活、过户或转入场景的归一化失败分类

按场景（activate 激活 / change-holder 过户 / transfer 转入）查询域名实名核验的归一化失败分类，服务端原始失败文本不会被输出。 比如新注册域名实名认证被拒，想知道归一化的失败分类。

参数：
- `--action`（string，必填）：核验场景：activate（激活）、change-holder（过户）或 transfer（转入）
- `--domain`（string，必填）：域名

```bash
aliyun domain verification domain-failure --domain example.com --action activate
```

### verification template-failure

按模板 ID 查询受控失败原因码，丢弃服务端自由文本与 PII

按模板 ID 查询受控的失败原因码和说明，服务端自由文本和 PII 一律丢弃。 比如信息模板实名认证没通过，想知道具体原因分类。

参数：
- `--template-id`（int，必填）：信息模板 ID

```bash
aliyun domain verification template-failure --template-id 1234567
```
---
## 17. 域名 —— 注册局锁

共 4 条。

### server-lock list

按域名、受控状态和分页查询注册局锁服务记录

按域名、受控状态（all/not-enabled/enabled/disabled）和分页查询注册局锁服务记录，返回最小化摘要。 比如核对账号下哪些域名已经开通了注册局锁。

参数：
- `--domain`（string）：域名
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--status`（string）：注册局锁状态：all（全部）、not-enabled（未开通）、enabled（已启用）或 disabled（已停用）

```bash
aliyun domain server-lock list --status enabled --page 1 --limit 20
```

### server-lock detail

按实例 ID 查询单条注册局锁记录的最小化摘要

按域名实例 ID 查询单条注册局锁记录的最小化摘要。 比如已经知道实例 ID，想看这一条锁服务的详情。

参数：
- `--instance-id`（string，必填）：域名实例 ID

```bash
aliyun domain server-lock detail --instance-id S20190N1DAI4EXAMPLE
```

### server-lock check

检查指定域名与年限是否存在处理中的注册局锁申请，不提交申请

检查指定域名与年限（1～10 年）是否存在处理中的注册局锁申请，不会提交任何申请。 比如打算开通注册局锁前，先确认没有重复提交。

参数：
- `--domain`（string，必填）：域名
- `--years`（int）：期望的服务年限，1～10 年。默认：1

```bash
aliyun domain server-lock check --domain example.com --years 1
```

### server-lock max-years

查询注册局锁激活或续费允许的最大服务年限，不产生购买或续费

按场景（activate 开通 / renew 续费）查询注册局锁允许的最大服务年限，不产生购买或续费。 比如续费注册局锁，先确认最多能续多少年。

参数：
- `--action`（string，必填）：服务场景：activate（开通）或 renew（续费）
- `--domain`（string，必填）：域名

```bash
aliyun domain server-lock max-years --domain example.com --action renew
```
---
## 18. 域名 —— 转出续费

共 4 条。

### transfer-out status

查询稳定、脱敏的域名转出状态

查询域名当前的转出状态，输出经过脱敏处理、口径稳定的摘要字段。 比如不确定这个域名是否已经在转出流程中。

参数：
- `--domain`（string，必填）：域名

```bash
aliyun domain transfer-out status --domain example.com
```

### transfer-out request-code

提交转移码申请，但不在 CLI 中回显转移码或原始任务结果

高风险操作，要求中国站 OAuth 账号资产回读、显式 --confirm=true 和精确匹配的 --confirm-domain 三者齐备才会提交。CLI 会代为提交转移码申请，但刻意不在输出中回显转移码或原始任务结果。 比如准备把域名转出到其他注册商，需要先拿到转移码。

参数：
- `--domain`（string，必填）：域名
- `--confirm`（bool）：提交已核对的高影响变更
- `--confirm-domain`（string）：再次输入完全一致的域名

```bash
aliyun domain transfer-out request-code --domain example.com --confirm-domain example.com --confirm=true
```

### transfer-out apply

申请快速转出，提交前回读账号资产并要求精确域名确认

高风险操作，申请快速转出；要求精确域名确认与 OAuth 账号资产回读，提交前会自动核对账号名下资产。 比如已经拿到转移码，确认要把域名转出到其他注册商。

参数：
- `--domain`（string，必填）：域名
- `--confirm`（bool）：提交已核对的高影响变更
- `--confirm-domain`（string）：再次输入完全一致的域名

```bash
aliyun domain transfer-out apply --domain example.com --confirm-domain example.com --confirm=true
```

### auto-renew

开启或关闭自动续费；开启时必须确认未来可能产生扣费

涉及资金影响的操作：开启自动续费必须同时提供 --confirm=true、精确匹配的 --confirm-domain，以及 --ack-future-charge=true 确认知晓未来可能产生扣费，三者缺一不会静默执行。 比如不想每年手动续费，希望到期自动扣费续费。

参数：
- `--domain`（string，必填）：域名
- `--status`（string，必填）：on（开启）或 off（关闭）
- `--ack-future-charge`（bool）：确认知晓开启自动续费可能产生未来扣费
- `--confirm`（bool）：提交已核对的高影响变更
- `--confirm-domain`（string）：再次输入完全一致的域名

```bash
aliyun domain auto-renew --domain example.com --status on --confirm-domain example.com --ack-future-charge=true --confirm=true
```
---
## 19. 万小智 —— 建站账号项目

共 4 条。

### wxz account

查看万小智建站灵感值余额

查询当前账号的万小智灵感值：剩余额度、总额度与已消耗额度；对话与代码生成都会消耗灵感值。确认当前用的是哪个账号可以执行 aliyun sts get-caller-identity。 比如确认账号还有多少灵感值可用。

参数：
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz account
```

### wxz project

列出、查看或删除建站项目，删除需重复 --confirm-biz-id 二次确认

用 --operation 选择站点项目操作：list 分页列出账号下的建站项目，show 查看单个项目的版本、状态、有效期与所属实例，delete 删除站点并释放其实例。每个项目的 bizId 是其他 wxz 命令都需要的站点标识。delete 会连带删除关联的对话、生成的代码与发布历史且不可恢复，默认只输出预览，加 --confirm=true 与重复一次 --confirm-biz-id 才会提交。 比如不记得站点的 bizId，先列出所有项目找一下；确认这个站点当前处于什么状态；或者确认不再需要这个站点，正式删除。

参数：
- `--operation`（string，必填）：操作：delete（删除项目）、list（列出项目）或 show（查看项目详情）
- `--biz-id`（string）：站点 ID，show 与 delete 必填，可通过 `project --operation list` 查到
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--confirm-biz-id`（string）：重复填写 --biz-id 的值，确认该操作不可撤销
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz project --operation list
```

### wxz preview

获取会话沙箱的站点预览链接

获取某个会话在沙箱中生成站点的预览链接；这是沙箱预览，不是已发布的正式站点。预览不可用时可加 --restart 先重启沙箱。 比如代码生成完了，想先看看效果；或者沙箱可能已经休眠，预览打不开。

参数：
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--restart`（bool）：先重启沙箱，再返回预览链接
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz preview --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9
```

### wxz analytics-daily

查看站点今日 PV/UV 与近七日趋势等运营数据

查看站点今日 PV/UV、近七日 PV/UV 趋势与累计对话/搜索指标；查询过程中的 SSO 令牌只保留在内存里，不会打印或落盘。 比如了解这个站点近期的访问和使用情况；或者站点绑定了多个域名，只想看其中一个的数据。

参数：
- `--biz-id`（string，必填）：站点实例 ID
- `--domain`（string）：可选的 PV/UV 域名过滤条件
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz analytics-daily --biz-id WS20260907120032000001
```
---
## 20. 万小智 —— 建站对话生成

共 6 条。

### wxz chat-start

创建建站对话与站点并流式返回事件，会消耗灵感值

描述想要的站点，创建新对话与新站点实例并流式返回事件；这会消耗灵感值，默认只输出预览，加 --confirm=true 后才提交。--bot-id 可选择生成模式（默认 Zero2），完整建站流程是 chat-start → 遇到中断表单用 chat-resume 回答 → 需求确定后 chat-generate 生成代码 → 连接中断用 chat-reconnect 续接，没有哪一步会自动发生；站点创建后可通过 project --operation list 查到。 比如先看看这个需求会创建什么样的对话，还不提交；需求确认无误，正式创建对话和站点；或者目标平台是小程序而不是网页。

参数：
- `--message`（string，必填）：要告诉 Agent 的内容
- `--bot-id`（string）：Bot ID：Zero2、Wxz3Article、Wxz3Image、Wxz3ImageDirect 或 Wxz3Video。默认：Zero2
- `--confirm`（bool）：核对预览后，设为 true 以创建对话
- `--platform`（string）：目标平台：web（网页）或 miniprogram（小程序）。默认：web
- `--skill`（string）：本轮要启用的技能，可通过 `skill --operation list` 查到其 pluginId

```bash
aliyun domain wxz chat-start --message "做一个律师事务所官网"
```

### wxz chat-send

向已有建站会话发送后续需求

向已有建站会话发送后续需求（比如改设计或改文案），流式返回事件；如果是要回答中断表单，应该用 chat-resume 而不是这条命令。 比如看过预览后想修改配色；或者不想逐条看流式事件，想要一个完整的 JSON 结果。

参数：
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--message`（string，必填）：要告诉 Agent 的内容
- `--biz-id`（string）：站点 ID，可选：服务端会从会话中自动解析
- `--platform`（string）：目标平台：web（网页）或 miniprogram（小程序）。默认：web
- `--skill`（string）：本轮要启用的技能，可通过 `skill --operation list` 查到其 pluginId

```bash
aliyun domain wxz chat-send --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9 --message "把首页配色换成深蓝"
```

### wxz chat-resume

回答中断表单并继续指定对话轮次

回答某轮对话中断时返回的表单，继续该轮次；--chat-id 和表单内容都在中断时的流事件里报告。答案是以问题标题为键的 JSON 对象，也可以用 --answers-file 从文件读取。 比如表单问题不多，直接在命令行里给答案；或者表单问题较多，提前整理成了一个 JSON 文件。

参数：
- `--chat-id`（string，必填）：中断轮次的 Chat ID，在流事件中上报
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--answers`（string）：以问题标题为键的 JSON 对象形式的答案，例如 {"应用名称":"MySite"}
- `--answers-file`（string）：从该 JSON 文件读取答案，替代 --answers
- `--biz-id`（string）：站点 ID，可选：服务端会从会话中自动解析
- `--phase`（string）：要继续的阶段：prd（需求文档）或 code（代码）。默认：prd

```bash
aliyun domain wxz chat-resume --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9 --chat-id 7A1B2C3D --answers '{"应用名称":"MySite","主营服务":"法律咨询"}'
```

### wxz chat-reconnect

从最后收到的事件重新连接建站对话流

连接中断或命令被打断后，从最后收到的事件重新接上流；服务端的工作不会因为连接断开而停止，这条命令只是补看中间发生了什么，不会重新开始这一轮。 比如网络波动导致流式连接断了，想接着看后续事件。

参数：
- `--chat-id`（string，必填）：要重新接上的 Chat ID，在流事件中上报
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--last-event-id`（int，必填）：从该事件 ID 之后续接，即最后收到的事件 ID

```bash
aliyun domain wxz chat-reconnect --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9 --chat-id 7A1B2C3D --last-event-id 42
```

### wxz chat-generate

确认已有需求并触发站点代码生成

需求文档确认无误后，推进对话进入代码生成阶段并流式返回生成过程；生成完成后可用 code --operation tree 查看写入的文件，用 preview 查看效果链接。 比如需求已经谈妥，触发代码生成；或者在确认时附带一句说明，比如先做移动端。

参数：
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--biz-id`（string）：站点 ID，可选：服务端会从会话中自动解析
- `--message`（string）：确认时要说的话。默认：确认生成应用
- `--platform`（string）：目标平台：web（网页）或 miniprogram（小程序）。默认：web
- `--skill`（string）：本轮要启用的技能，可通过 `skill --operation list` 查到其 pluginId

```bash
aliyun domain wxz chat-generate --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9
```

### wxz chat-history

查看建站会话历史问答与轮次状态

按时间从早到晚查看某个建站会话的历史问答与每轮状态；--limit 控制读取条数（1～100，默认 20）。 比如回顾这个会话之前都问了什么、改了什么；或者快速看一下最近的几轮对话。

参数：
- `--conversation-id`（string，必填）：会话 ID，可通过 `conversation --operation list` 查到
- `--limit`（int）：读取的消息条数，1～100。默认：20
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz chat-history --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9
```
---
## 21. 万小智 —— 内容创作保存

保存 AI 生成的文章、图片、视频草稿，供站点内容板块使用；这是内容素材本身，和 wxz-material 管理的通用建站素材库是两个不同的领域。

共 1 条。

### wxz content

保存文章、图片或视频创作草稿

用 --operation 选择要保存的草稿类型：article-save 创建或更新文章草稿及其 Markdown 正文（省略 --article-id 则新建），image-save 保存内容创作会话里最新生成的图片，video-save 保存最新生成的视频与可选封面。三种操作默认都只输出预览，加 --confirm=true 后才提交；--conversation-id 与 --instance-id 用于关联内容创作会话与站点。 比如 AI 生成了一篇文章，想先确认内容再保存；或者确认无误，正式保存这张图片。

参数：
- `--operation`（string，必填）：操作：article-save（保存文章）、image-save（保存图片）或 video-save（保存视频）
- `--article-id`（string）：已有文章 ID；省略则新建草稿
- `--biz-id`（string）：可选的站点 ID 别名；同时提供 --instance-id 时两者必须一致
- `--body-markdown`（string）：文章的 Markdown 正文，article-save 必填
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--conversation-id`（string）：可选的内容创作会话 ID
- `--gen-params`（string）：生成参数，JSON 格式
- `--instance-id`（string）：可选的关联站点实例 ID
- `--latest-cover-material-file-id`（string）：最新封面素材文件 ID
- `--latest-cover-url`（string）：最新封面的永久 URL
- `--latest-duration-seconds`（int）：最新视频时长（秒）
- `--latest-gen-params`（string）：最新的生成参数，JSON 格式
- `--latest-material-file-id`（string）：最新图片素材文件 ID
- `--latest-oss-url`（string）：最新生成图片的 OSS 或 CDN 地址
- `--latest-video-material-file-id`（string）：最新视频素材文件 ID
- `--latest-video-url`（string）：最新视频的永久 URL，video-save 必填
- `--title`（string）：文章或视频任务标题，article-save 与 video-save 必填

```bash
aliyun domain wxz content --operation article-save --title '发布公告' --body-markdown '# 发布公告'
```
---
## 22. 万小智 —— 建站代码

共 1 条。

### wxz code

浏览、读取或回滚站点代码工作区

用 --operation 选择代码工作区操作：tree 浏览会话生成站点的沙箱目录树（默认从工作区根目录开始，可用 --path 指定子目录），cat 读取指定文件的内容，rollback 把工作区恢复到指定历史快照。rollback 只改动工作区代码，已发布的正式站点在下一次发布前不受影响，默认只输出预览，加 --confirm=true 后才提交。 比如先看看生成了哪些文件和目录；看某个具体文件生成了什么；或者确认快照编号无误，正式回滚代码。

参数：
- `--operation`（string，必填）：操作：cat（读取文件）、rollback（回滚快照）或 tree（浏览目录树）
- `--biz-id`（string）：站点 ID，rollback 必填，可通过 `project --operation list` 查到
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--conversation-id`（string）：会话 ID，tree 与 cat 必填，可通过 `conversation --operation list` 查到
- `--path`（string）：要打印的文件，cat 必填，可通过 `code --operation tree` 查到
- `--snapshot-id`（int）：要恢复的快照编号，rollback 必填
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz code --operation tree --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9
```
---
## 23. 万小智 —— 建站会话

共 1 条。

### wxz conversation

列出建站会话、查看详情或锁状态

用 --operation 选择会话查询：list 按最新修改时间倒序列出账号下的建站会话（可用 --site-id 按项目过滤，或用 --start-time/--end-time 按修改时间过滤，跨度最多 30 天），show 查看单个会话的标题、所属项目与时间戳，lock-status 查询会话是否被锁定。锁定中的会话正在生成内容，此时发送新消息会被拒绝。 比如先找 conversationId；确认这个会话归属哪个项目；或者不确定会话是不是还在生成中。

参数：
- `--operation`（string，必填）：操作：list（列出会话）、lock-status（查询锁状态）或 show（查看会话详情）
- `--bot-id`（string）：Bot ID。默认：Zero2
- `--conversation-id`（string）：会话 ID，show 与 lock-status 必填，可通过 `conversation --operation list` 查到
- `--end-time`（string）：最晚修改时间，ISO 8601 格式，距 --start-time 最多 30 天
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--site-id`（string）：只列出该站点 bizId 下的会话
- `--start-time`（string）：最早修改时间，ISO 8601 格式，例如 2026-06-01T00:00:00Z
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz conversation --operation list
```
---
## 24. 万小智 —— 建站发布

共 1 条。

### wxz deploy

发布站点、查询发布进度与历史，或回滚到指定发布版本

用 --operation 选择发布操作：publish 发布站点当前的代码构建（--channel 可选 PC 或 WEAPP），status 查询最近一次发布任务的进度，history 按最新倒序分页列出发布记录，rollback 重新提供某个更早的发布版本对外服务。发布在服务端异步执行，命令返回不代表发布完成，要用 status 跟踪；回滚用的发布编号来自 history 报告的值，不是列表里的位置序号。publish 与 rollback 默认只输出预览，加 --confirm=true 后才提交。 比如核对无误后正式发布网页版；刚提交了发布，想确认是否完成；或者新版本出了问题，回滚到上一个发布编号。

参数：
- `--operation`（string，必填）：操作：history（发布历史）、publish（提交发布）、rollback（回滚发布）或 status（发布进度）
- `--biz-id`（string）：站点 ID，必填，可通过 `project --operation list` 查到
- `--channel`（string）：发布渠道：PC（网页）或 WEAPP（小程序）。默认：PC
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--limit`（int）：每页条数，1～100。默认：20
- `--page`（int）：页码。默认：1
- `--publish-number`（string）：要重新提供服务的发布编号，rollback 必填，可通过 `deploy --operation history` 查到
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz deploy --operation history --biz-id WS20260716135629000001
```
---
## 25. 万小智 —— 站点域名状态

共 1 条。

### wxz site

管理站点上下线与自定义域名的绑定、解析、证书、备案与跳转，解绑与下线需重复二次确认

用 --operation 管理站点与它绑定的自定义域名。只读操作：domain-list 列出已绑定域名及校验、解析与证书状态，domain-show 查看单个域名卡在哪一步，domain-dns 查询需要在自己 DNS 服务商处添加的记录（--purpose RESOLUTION 解析、VERIFICATION 持有权校验），domain-redirect-list 列出域名跳转规则。写操作：domain-bind 按 --operate-type 分步绑定（START_DOMAIN_BIND 启动、SUBMIT_VERIFY_DNS 提交校验、SET_CERTIFICATE 签发证书、MIGRATE_DOMAIN 迁移），domain-cert 配置或删除 HTTPS 证书，domain-icp 更新页脚备案号，domain-redirect-delete 删除跳转规则，online 恢复站点正常访问。高风险操作：domain-unbind 解绑域名（绑定时签发的证书一并失效）、offline 让每个自定义域名都展示下线提示，除 --confirm=true 外还要重复一次 --confirm-domain 或 --confirm-biz-id。 比如确认站点绑定了哪些域名；域名绑定了但访问不了，想知道卡在哪一步；或者维护完成，恢复站点上线。

参数：
- `--operation`（string，必填）：操作：domain-bind（绑定域名）、domain-cert（配置证书）、domain-dns（查询解析记录）、domain-icp（更新备案号）、domain-list（列出域名）、domain-redirect-delete（删除跳转）、domain-redirect-list（列出跳转）、domain-show（域名状态）、domain-unbind（解绑域名）、offline（站点下线）或 online（站点上线）
- `--biz-id`（string）：站点 ID，必填，可通过 `project --operation list` 查到
- `--cert-name`（string）：自有证书的名称
- `--cert-type`（string）：证书类型。默认：free（表示由平台签发免费证书）
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--confirm-biz-id`（string）：重复填写 --biz-id 的值，确认该操作不可撤销
- `--confirm-domain`（string）：重复填写 --domain 的值，确认该操作不可撤销
- `--delete`（bool）：移除该域名的证书配置
- `--domain`（string）：自定义域名，域名相关操作必填
- `--icp-record-number`（string）：域名的 ICP 备案号
- `--icp-site-record-number`（string）：站点的 ICP 备案号
- `--keyword`（string）：只返回域名中包含该文本的结果
- `--limit`（int）：每页条数，1～100。默认：20
- `--operate-type`（string）：绑定步骤：START_DOMAIN_BIND（启动绑定）、SUBMIT_VERIFY_DNS（提交校验）、SET_CERTIFICATE（签发证书）或 MIGRATE_DOMAIN（迁移域名）。默认：START_DOMAIN_BIND
- `--overwrite`（bool）：直接替换该域名已有的解析记录，而不是报错失败
- `--page`（int）：页码。默认：1
- `--police-record-number`（string）：公安备案号
- `--private-key-file`（string）：PEM 格式的私钥文件路径
- `--public-key-file`（string）：PEM 格式的证书链文件路径
- `--purpose`（string）：记录用途：RESOLUTION（解析）或 VERIFICATION（校验）。默认：RESOLUTION
- `--record-id`（int）：跳转记录 ID，domain-redirect-delete 必填，可通过 `site --operation domain-redirect-list` 查到
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz site --operation domain-list --biz-id WS20260716135629000001
```
---
## 26. 万小智 —— 建站素材

共 2 条。

### wxz material-directory

浏览素材目录树，创建、重命名、移动或删除素材目录

用 --operation 管理素材目录：tree 浏览目录树（不带 --biz-id 返回顶层结构，即共享素材库加每个站点各一个目录；带 --biz-id 返回该站点内部目录），create 在指定父目录下创建子目录，rename 改名，move 连子目录和文件一起移动到新父目录，delete 删除目录。站点根目录 ID 就是站点自己的 bizId；删除前建议先用 material-file --operation list 确认目录下还有哪些文件。除 tree 外都默认只输出预览，加 --confirm=true 后才提交。 比如先看看素材库整体结构；或者重新整理素材库，把某个目录挪到别处。

参数：
- `--operation`（string，必填）：操作：create（创建目录）、delete（删除目录）、move（移动目录）、rename（重命名目录）或 tree（浏览目录树）
- `--biz-id`（string）：站点 ID，写操作必填，可通过 `project --operation list` 查到；tree 省略则列出顶层目录
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--directory-id`（string）：文件夹 ID，rename、move 与 delete 必填，可通过 `material-directory --operation tree` 查到
- `--name`（string）：文件夹名称，create 必填
- `--new-name`（string）：新的文件夹名称，rename 必填
- `--parent`（string）：父文件夹 ID，create 与 move 必填，可通过 `material-directory --operation tree` 查到
- `--sort`（int）：在新父文件夹下同级中的排序位置
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz material-directory --operation tree
```

### wxz material-file

列出、查看、归档、改名、移动素材文件，或更新其状态与导出下载链接

用 --operation 管理素材文件。只读操作：list 列出指定目录下的文件及类型、大小与状态（--biz-id 用 public 访问共享素材库），show 查看单个文件的规格与对外 URL，summary 查看目录的文件数量与占用空间，export 为选定文件申请限时下载链接。写操作：archive 把一个公开 URL 的内容归档进素材库或把本地文件上传到签名 OSS 目标（--url 与 --file 二选一），rename 改文件名（文件 ID 与访问 URL 不变），move 批量移动到另一个目录，status 设置文件状态，即把文件移入回收站或从回收站还原。写操作默认只输出预览，加 --confirm=true 后才提交。 比如看看共享素材有哪些；把网上一张图片纳入素材库管理；或者这些素材暂时不用了，先移入回收站。

参数：
- `--operation`（string，必填）：操作：archive（归档文件）、export（导出下载链接）、list（列出文件）、move（移动文件）、rename（重命名文件）、show（查看文件详情）、status（更新文件状态）或 summary（目录占用汇总）
- `--biz-id`（string）：站点 ID，必填，可通过 `project --operation list` 查到；共享素材库用 public
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--dir`（string）：目标文件夹 ID，list、summary、archive 与 move 必填，可通过 `material-directory --operation tree` 查到
- `--file`（string）：直接上传到签名 OSS 目标的本地普通文件；与 --url 互斥
- `--file-id`（string）：素材文件 ID，show 与 rename 必填，可通过 `material-file --operation list` 查到
- `--file-ids`（string）：逗号分隔的素材文件 ID，export、move 与 status 必填
- `--file-name`（string）：归档使用的名称。默认取 URL 中的文件名
- `--limit`（int）：每页条数，1～100。默认：20
- `--name`（string）：只返回文件名包含该文本的结果
- `--new-name`（string）：新文件名，rename 必填
- `--page`（int）：页码。默认：1
- `--status`（string）：目标状态，status 必填，取值参考 `material-file --operation list` 返回的结果
- `--url`（string）：公开可访问的文件 URL；与 --file 互斥
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary

```bash
aliyun domain wxz material-file --operation list --biz-id public --dir public
```
---
## 27. 万小智 —— 建站技能

共 1 条。

### wxz skill

浏览、读取、安装或发布万小智技能，删除需重复 --confirm-plugin-id 二次确认

用 --operation 管理建站技能。只读操作：list 按 --scope 从技能市场（public，默认）、本账号发布过的技能（mine）或某个站点可用的技能（project，需要 --biz-id）列出技能，show 查看单个技能的描述、发布状态、可见范围与安装次数（--full 打印完整高级配置），cat 读取技能包内的文件（含 SKILL.md，--raw 逐字输出），versions 列出已发布的历史版本。写操作：install 安装市场技能供建站对话使用，uninstall 卸载，create 在市场注册新技能（技能包先放到 OSS 或可访问 URL，技能 ID 注册后不可修改），upload 为已有技能发布新版本，update 修改市场展示资料与配置（不发布代码），rollback 切回某个历史版本。高风险操作：delete 删除技能及其全部历史版本，除 --confirm=true 外还要重复一次 --confirm-plugin-id。 比如看看技能市场里有哪些可用技能；核对无误后正式安装该技能；或者新版本出了问题，临时切回旧版本。

参数：
- `--operation`（string，必填）：操作：cat（读取技能包文件）、create（创建技能）、delete（删除技能）、install（安装技能）、list（列出技能）、rollback（回滚版本）、show（查看技能详情）、uninstall（卸载技能）、update（修改技能资料）、upload（发布新版本）或 versions（列出历史版本）
- `--biz-id`（string）：站点 ID，配合 --scope project 时必填
- `--category`（string）：技能在市场中的分类
- `--changelog`（string）：本次版本的更新内容
- `--config-items`（string）：技能的配置项，JSON 格式
- `--confirm`（bool）：核对预览后，设为 true 以提交
- `--confirm-plugin-id`（string）：重复填写 --plugin-id 的值，确认该操作不可撤销
- `--desc`（string）：技能功能描述，create 必填，10～512 个字符
- `--download-url`（string）：打包后技能包的公开可访问 URL
- `--extend`（string）：扩展信息，JSON 对象格式
- `--full`（bool）：完整打印高级配置块
- `--hooks`（string）：技能的 Hook 声明，JSON 格式
- `--icon`（string）：技能图标的 URL
- `--keyword`（string）：只返回匹配该文本的技能
- `--limit`（int）：每页条数，1～100。默认：20
- `--name`（string）：技能展示名称，create 必填，2～64 个字符
- `--oss-key`（string）：打包后的技能包在 OSS 上的对象 Key
- `--page`（int）：页码。默认：1
- `--path`（string）：只返回技能包内该路径下的文件
- `--phase`（string）：--scope project 下的构建阶段：prd（需求文档）或 code（代码）。默认：code
- `--platform`（string）：配合 --scope public 只返回该平台的技能：web 或 miniprogram
- `--plugin-id`（string）：技能 ID，除 list 外必填，可通过 `skill --operation list` 查到
- `--plugin-version`（string）：技能版本，upload 与 rollback 必填。默认为当前版本
- `--raw`（bool）：逐字打印文件内容，而不是报告形式
- `--scope`（string）：列表来源：project（项目）、public（市场）或 mine（自有）。默认：public
- `--skill-header`（string）：技能的 Header 声明，JSON 格式
- `--sort`（string）：配合 --scope public 的排序方式：latest（最新）或 hot（热门）
- `--status`（string）：配合 --scope mine 只返回该发布状态的技能，如 published 或 draft
- `--tags`（string）：技能标签
- `--view`（string）：响应视图：summary（摘要）或 raw（原始）。默认：summary
- `--visibility`（string）：技能可见范围：public（公开）、tenant（租户内）或 private（私有）

```bash
aliyun domain wxz skill --operation list --keyword 视频 --sort hot
```
---
## 28. 批量上限

| 上限 | 适用 |
|---|---|
| 200 | 购买、续费、赎回、转入 |
| 50 | 转移锁、更新锁、备注、联系人、移入分组 |
| 2～13 | 自定义 DNS 服务器 |
| 5 | ask 默认返回的答案条数 |
---
## 29. 确认阶梯

最低一级也要显式确认，不存在"写完命令就提交"这种状态：

1. 查询操作无需确认：查询操作不会修改资源或产生订单，无需额外确认；遇到明确可重试的异常时，可按提示安全重试。
2. 敏感操作显式确认：DNS、转移锁、域名转出等写操作具有即时影响，默认只展示预览；核对无误后再通过 --confirm=true 提交，降低误操作与服务中断风险。
3. 扣费操作双重确认：自动续费涉及未来周期性扣费，除写操作确认外，还需通过 --ack-future-charge 明确知悉后续扣款。

### 写操作骨架

同一条写操作，加不加 `--confirm=true` 是"看一眼"和"真的改了"的分界线：

```bash
# 写操作预览：不提交变更
$ aliyun domain transfer-lock \
    --domains example.com --status on

# 确认预览结果后提交；此时使用 OAuth 临时凭证
$ aliyun domain transfer-lock \
    --domains example.com --status on --confirm=true
```
---
## 30. 安全设计

鉴权来源、是否预览、是否允许输出敏感字段、是否需要精确确认，都是命令契约的一部分，
不交给使用者记忆：

1. **OAuth 临时凭证** —— 订单、智能问答、管控和高风险场景以中国站 OAuth 临时凭证为主，不在命令输出中展示凭证值。
2. **写操作默认预览** —— 创建、修改和删除默认只呈现计划；显式提供 --confirm=true 后才进入鉴权和 OpenAPI。
3. **高风险精确确认** —— DNSSEC 和转出要求 --confirm-domain 与目标完全一致；自动续费开启还要确认未来可能扣费。
4. **PII 文件输入** —— 联系人、邮箱和 Token 不做直接参数；Unix/macOS 文件要求普通文件、非符号链接且权限不超过 0600。
5. **响应字段白名单** —— 摘要模式去除持有者、地址、证件、客户端 IP、转移码和自由任务结果等敏感字段。
6. **浏览器失败可恢复** —— macOS、Windows、Linux 尝试打开默认浏览器；无法打开时返回可复制的官方页面链接，避免流程中断。
---
## 31. 能力边界（这四件事明确不做）

- **NOT / DIRECT PAYMENT** —— CLI 不直接扣费，购买、续费、赎回和转入在官方页面确认。
- **NOT / RAW OPENAPI UX** —— 客户入口保留短命令，不要求记忆 Query、SaveSingleTask 等生成名。
- **NOT / SECRET OUTPUT** —— AK/SK、临时 Token、转移码、联系人原文不进入稳定输出契约。
- **NOT / SILENT MUTATION** —— 写入、高风险和资金影响操作不会在缺少确认时静默提交。
---
## 32. 可注册性只认 Avail

`check` 返回的 Avail 字段：

| 值 | 含义 |
|---|---|
| 1 | 可注册 |
| 3 | 预登记 |
| 4 | 可删除预订 |
| 0 | 不可注册 |
| -1 | 异常 |
| -2 | 暂停注册 |
| -3 | 黑名单 |

已在账号下的域名会返回 `Avail: 0`、`Reason: "In Use"`。续费参考价格可通过 `price` 查询；
赎回资格与最终价格仍以官方订单确认页为准。
---
## 33. 状态码

### EPP 状态码（WHOIS 里看到的）


| 状态码 | 含义 |
|---|---|
| `ok` | 正常，可用且未设任何安全锁 |
| `serverHold` | 注册局暂停解析，无法访问。`.cn` 注册后未通过实名一般是这个 |
| `clientHold` | 注册商暂停解析，无法访问 |
| `pendingVerification` | 注册信息审核期。**需在注册成功后 5 天内提交实名资料**，逾期会被 `serverHold` |
| `clientTransferProhibited` | 禁止转移（转移锁） |
| `clientUpdateProhibited` | 禁止更新（更新锁）。注册人 / 联系人 / DNS 不能改，但**可以**改解析记录 |
| `clientRenewProhibited` | 禁止续费，通常因法律仲裁或争议 |
| `autoRenewPeriod` | 续费宽限期，已过期 |
| `inactive` | 未激活，通常因注册时未填有效 DNS 服务器 |

---
---
## 34. 生命周期与天数

**错过赎回期后，原持有者无法恢复域名。**

| 后缀 | 续费宽限期 | 赎回期 | 等待删除期 | 说明 |
|---|---|---|---|---|
| `.com` / `.net` / `.org` | 30 天 | 30 天 | 5 天 | 遵循 ICANN 统一政策，支持高价赎回 |
| `.cn` / `.中国` | 30 天 | **14 天** | 随时删除 | 实名制严格，赎回期短 |
| `.hk` / `.com.hk` | **28 天** | **无** | 无 | **无赎回机制**，宽限期结束直接删除，不可恢复 |

官方附注：受注册局时差与系统队列影响，**赎回期可能有约 24 小时误差，以控制台实际状态为准**。
WHOIS 信息可能显示滞后。

### 费用

**域名赎回费用 = 赎回手续费 + 1 年续费费用。** 赎回成功后后续年度续费价恢复正常标准，
赎回费仅一次性。

宽限期内可按**正常价格**续费（30 天内，`.hk` 28 天）。

### 不能赎回的三种情况

1. `.hk` 域名 —— 无赎回期
2. **未完成实名认证** —— 注册局规定未实名的域名无法赎回
3. 处于司法冻结或仲裁状态

### 其他时间点

| 项 | 值 |
|---|---|
| 过期后解析暂停 | 到期后**第二天** |
| 宽限期内续费后解析恢复 | 阿里云解析 24 小时内；其他 DNS 服务商 24~48 小时 |
| 续费年限上限 | 一次最多 10 年；到期时间不足 1 年时最多续 9 年 |
| 自动续费扣费时点 | **域名到期前 15 天**自动扣下一年费用 |
| 域名被删除后 | 绑定的实名认证信息自动解除，不再与原持有者关联 |

赎回成功后到期时间通常延长一年，但**部分域名赎回后仍需再续费一次**才延长有效期 ——
以控制台到期时间是否更新为准。
---
## 35. 转移规则


1. **注册后 60 天内**不可转出（ICANN 政策）
2. **转入成功后 60 天内**不可再转出（ICANN 政策）
3. **修改域名持有者信息（过户）后 60 天内不可转出** —— 除非提交过户时**主动勾选关闭**
   「域名信息修改成功后 60 天内禁止转出阿里云」
4. **距离最后一次成功转移注册商需大于 60 天**

第 3 点尤其容易踩：**实名认证 / 过户操作会连带触发 60 天转出锁**。

### 转入阿里云

| 检查项 | 要求 |
|---|---|
| 域名后缀 | 需在域名价格总览页「转入」列有明确标价（不为 `-`） |
| 域名状态 | 必须 `ok` 或 `active`；不得为 `clientTransferProhibited` / `serverTransferProhibited` |
| 注册时间 | **需满 60 天** |
| 到期时间 | 距到期日 **大于 15 天，小于 10 年** |
| 上次续费时间 | 在原注册商完成续费 / 赎回**不足 45 天**时**不建议**转入，可能导致原注册商续费失效 |
| 续费状态 | 未达 10 年上限。已至 10 年暂不支持转入 |
| 域名前缀语种 | 目前**仅支持英文和中文**前缀，其他语种（俄语、日语等）不支持 |

**转移密码**（= 转移码 / 授权码 / Authorization code / EPP Code / Auth Code）：
**有效期 15 天**，超期需重新获取。**需在原注册商处获取，阿里云无法代为获取。**

耗时：注册局规定转入一般 **5~7 天**。在原注册商处主动确认转出请求可缩短到几分钟到一小时。
转入订单自付款后有 **15 天**有效期，超期未完成命名审核或未提交正确转移密码则失败并退款。

费用：转入操作本身免费，但按 CNNIC 规定**转移注册商必须将到期日延续一年**，
所以转入价通常等于续费一年的价格。

可取消窗口：结算成功后至转移密码验证通过前，或**转移密码验证通过后的 5 天（5×24 小时）内**
可取消并退款。

转入失败的两个具名原因：① 域名开了禁止转移锁，需联系原注册商关闭；
② 已续费至 10 年上限，转入会再加一年导致超过 10 年。

### 从阿里云转出

| 规则 | 说明 |
|---|---|
| 注册商必须是阿里云 | — |
| 距注册日 60 天以上 | — |
| 距到期日大于 15 天 | 建议在到期 30 天前办理 |
| 距最后一次成功转移注册商大于 60 天 | — |
| 状态正常 | 不能是禁止转出状态；不欠费；不在仲裁及法律程序中；持有者身份无争议 |
| 距过期后续费或赎回超过 45 天 | 在最后一次续费 45 天后办理，转出后可延长注册年限一年 |
| 不可重复执行 | 同一域名不能同时进行多个转移操作 |

转移码有效期 **15 天**。获取时会验证阿里云账号绑定的安全手机，且阿里云会发邮件通知域名管理
联系人「转移密码已被获取」。邮件发往**域名持有者邮箱**，需确保有效。

| 方式 | 耗时 | 关键操作 |
|---|---|---|
| 普通转出 | **5~7 个工作日** | 获取转移码，在新服务商提交申请后等系统自动完成 |
| 快速转出 | **约 1 小时** | 需回阿里云控制台主动确认 + 邮件二次确认 |

**不可逆**：一旦转出完成无法撤销，**需等 60 天后才能再次转入阿里云**。

ICANN 政策保护：原注册商不能擅自拒绝或限制转出，也不能以任何名义对转出额外收费。
---
## 36. 安全锁、自动续费、WHOIS 隐私


在**注册商层面**锁定，阻止未经授权的跨注册商转移。开启后 WHOIS 显示
`clientTransferProhibited`。**建议仅在实际转移期间短暂关闭**，完成后恢复。

### 禁止更新锁（注册商级，免费）

锁定后注册人、管理 / 技术 / 付费联系人、DNS 服务器等信息**无法通过控制台或 API 修改**，
WHOIS 显示 `clientUpdateProhibited`。

**它只保护注册信息，不影响你在云解析 DNS 里增删改具体解析记录（A、CNAME 等）。**

**域名到期后禁止更新锁会随之失效** —— 续费 / 赎回成功后应尽快重新开启。

### 注册局安全锁（Registry Lock，付费按年）

在**顶级域名服务器层面**锁定，防核心域名被恶意转移、篡改或删除。任何解锁都必须走**人工授权
认证流程**。

- 解锁 / 再加锁需向指令邮箱 `saftylock@service.aliyun.com` 发邮件 + 人工审核，周期 **2-3 个工作日**
- **服务期内禁止转移**：一旦购买，无论当前是否锁定都无法转出阿里云。强行申请转出视为自动放弃
  服务，费用不退
- 购买前提：域名有效期大于一年；`.cn` / `.中国` 需**注册满 5 天并完成实名认证**后才能买
- 购买成功后自动完成首次加锁；最小服务周期 1 年，到期自动失效并解锁

### WHOIS 隐私 —— 必须区分两件事

**(a) 全局默认隐私（免费、自动、不是"服务"）**

根据 ICANN 于 **2025 年 8 月 21 日生效**的《注册数据政策》及 GDPR 合规要求，阿里云 WHOIS
公开查询结果中**不再显示**注册人 / 注册机构名称，以及注册人 / 注册机构、管理联系人、
技术联系人的联系信息。这是默认行为，无需购买、也无法关闭。

**(b) CNNIC 隐私保护服务（付费增值服务，仅 `.cn` 系）**

由 **CNNIC 注册局**提供，保护注册 / 管理 / 技术 / 缴费联系人信息不在 WHOIS 公开显示。

- **仅支持注册商为阿里云的 `.cn` 域名**，含 `.cn` 英文与中文域名及 `com.cn`、`net.cn`、
  `org.cn` 等二级域
- 属域名增值服务，**需与指定域名绑定，不可独立购买**
- 可一次性购买最长 **10 年**，**服务有效期独立计算，不与域名有效期关联**
- 账号间转移、过户或**注册商变更后服务仍持续生效**，无需在转入方重新开通
- 开通后即时生效，**不支持退费**

不要把这两者混为一谈。非 `.cn` 域名没有"开关 WHOIS 隐私"这回事。
---
## 37. 实名认证与信息模板


根据中国内地监管要求，**所有域名必须完成实名认证才能正常解析和使用**。未完成认证的域名会被
注册局锁定（`serverHold`），**网站无法访问**。依据是**工信部 2017 年全面域名实名认证要求**，
存量域名与新注册域名均需完成。**在阿里云完成域名实名认证不收费。**

### 两步制 —— 最容易踩的坑

1. 创建并提交**信息模板** → 审核通过（状态：模板实名成功）
2. **将已认证的模板关联至具体域名**

> 模板实名成功仅代表信息模板通过了实名认证，**不代表域名自动完成实名认证**。域名实名认证需要
> 单独操作。

信息模板是用于管理域名持有者信息的身份档案，价值在于「一次创建，多处复用」。

### 时长

| 项 | 官方时长 |
|---|---|
| 信息模板审核 | 通常 1 个工作日，部分需 3~5 个工作日 |
| 域名实名认证审核 | 通常 1~3 个工作日；个人域名一般当天完成 |
| 认证通过后 `serverHold` 解除 | 约 1~2 个工作日（同一篇官方文档内有 1 天和 1~2 天两种口径）|

新注册域名需在**注册成功后 5 天内**提交实名资料，逾期会被 `serverHold` 暂停解析。
---
## 38. 备案（ICP）与域名的关系


- 注册只是取得域名使用权。
- 实名认证是工信部对**所有**域名的强制要求，未通过则域名被置 `serverHold`、**根本无法解析**。
- ICP 备案是**网站**层面的行政许可：只有域名**解析指向中国内地服务器且对外提供 Web 服务**时
  才需要。指向中国香港等非内地节点**不需要工信备案**（仅需公安备案）。

关键传导：**必须先完成域名实名认证才能提交备案**，且**域名持有者实名信息必须与备案主体信息
一致**，否则被管局驳回。

**完成实名认证 ≠ 已完成备案。** 网站部署在中国内地服务器时，域名需完成 ICP 备案后才能正常访问。

备案对域名的三项要求：① 后缀已获工信部批复 ② 注册商为已批复机构 ③ 持有人信息与备案主体一致。
只需对**主域名**备案，其下**子域名无需额外备案**。备案只要求持有者信息一致，联系人信息无需一致。

实名 → 可提交备案的等待期，官方有三种口径：阿里云注册的域名可先提交初审；**非阿里云注册的域名
实名信息同步管局需 2~3 天**，建议等待后再提交。不要写单一绝对天数。

阿里云**国际站**（alibabacloud.com）是国际域名注册商，在该站注册的域名需**转入中国内地域名
注册商**并完成实名认证才能 ICP 备案。

阿里云账号实名认证与域名实名认证**无实际关联**；账号实名类型不影响企业备案资格。

**`.org` 是"能买但不能备案"的活例子**：`.org` 后缀未获工信部批复，不在可备案后缀列表中，
无法在阿里云进行 ICP 备案。只有 `.gov.cn` / `.政务` 支持二级域名单独备案。

注意区分两个清单：**阿里云能卖的后缀**（价格总览页）≠ **工信部批复可备案的后缀**（工信部
「中国互联网域名体系」页）。
---
## 39. 中国站可售后缀白名单（222 个）

范围，禁止推荐。用户点名白名单外的后缀时，明确告知"该后缀国内站当前不可售"并推荐最接近的
替代（想要 `.dev` → 建议 `.tech` / `.online` / `.site`）。

权威可注册性与价格仍以 `check` 实时结果为准；白名单只负责"能不能卖"。

### `.cn` 系（42 个，需实名）

```
ac.cn, ah.cn, bj.cn, cn, com.cn, cq.cn, edu.cn, fj.cn, gd.cn, gov.cn, gs.cn,
gx.cn, gz.cn, ha.cn, hb.cn, he.cn, hi.cn, hk.cn, hl.cn, hn.cn, jl.cn, js.cn,
jx.cn, ln.cn, mil.cn, mo.cn, net.cn, nm.cn, nx.cn, org.cn, qh.cn, sc.cn, sd.cn,
sh.cn, sn.cn, sx.cn, tj.cn, tw.cn, xj.cn, xz.cn, yn.cn, zj.cn
```

`gov.cn` / `edu.cn` / `mil.cn` / `ac.cn` 有资质限制（政府 / 教育 / 军队 / 科研），
一般用户不可注册。`地区.cn`（如 `bj.cn`）为省级行政区二级域。

### 中文 / IDN 后缀（21 个）

```
中国, 中文网, 企业, 佛山, 公司, 商城, 商店, 商标, 在线, 姓名网址, 娱乐,
广东, 我爱你, 招聘, 游戏, 网址, 网店, 网络, 购物, 集团, 餐厅
```

`商标` 需商标资质，`佛山` / `广东` 为地域后缀。

### 通用 / 国际 gTLD（159 个）

```
archi, art, asia, auto, autos, baby, band, bar, beauty, beer, bid, bio, biz,
black, blue, bond, cab, cafe, car, cars, cash, cc, center, chat, city, click,
cloud, club, co, college, com, com.co, com.hk, company, cool, cyou, date,
design, email, engineer, family, fan, fans, fashion, fit, fun, fund, fyi,
game, games, gift, global, gold, green, group, guru, hair, help, hk, homes,
host, icu, info, ink, kim, law, lawyer, life, link, live, loan, lol, lotto,
love, ltd, luxe, makeup, market, mba, me, media, men, mobi, mom, monster,
motorcycles, name, net, news, ngo, online, org, organic, party, pet, photo,
pics, pink, plus, poker, press, pro, promo, protection, pub, pw, quest, red,
ren, rent, rocks, run, sale, school, science, security, shop, shopping, show,
site, ski, skin, so, social, software, space, storage, store, studio, tax,
team, tech, technology, tel, theatre, tickets, today, top, trade, tv, uno, vc,
video, vin, vip, vote, voto, wang, website, wiki, win, work, world, xin, xyz,
yachts, yoga, yun, zone
```

### 场景 → 推荐后缀（均在白名单内）

| 项目属性 | 推荐后缀 |
|---|---|
| 通用商业 / 企业首选 | `com`, `cn`, `com.cn`, `net`, `biz`, `company`, `企业`, `集团`, `ltd` |
| 科技 / 技术 / 云 | `tech`, `technology`, `cloud`, `yun`, `host`, `site`, `online`, `xin`, `icu` |
| 电商 / 零售 | `shop`, `store`, `shopping`, `market`, `购物`, `商店`, `网店`, `商城` |
| 内容 / 媒体 / 社区 | `media`, `news`, `video`, `tv`, `press`, `live`, `social`, `chat`, `club`, `fans` |
| 创意 / 设计 / 艺术 | `design`, `art`, `studio`, `ink`, `pics`, `photo`, `space`, `xyz`, `cool` |
| 个人品牌 / 博客 | `me`, `name`, `link`, `life`, `world`, `pro`, `wiki` |
| 游戏 / 娱乐 | `game`, `games`, `游戏`, `娱乐`, `fun`, `lol`, `vip` |
| 教育 / 专业服务 | `school`, `college`, `law`, `lawyer`, `mba`, `guru`, `engineer` |
| 本地 / 中文品牌 | `cn`, `com.cn`, `中国`, `公司`, `网络`, `在线`, `餐厅`, `招聘` |
| 时尚 / 生活 / 美妆 | `fashion`, `beauty`, `makeup`, `hair`, `skin`, `luxe`, `beer`, `cafe` |

后缀能否注册 / 转入的判定：在**域名价格总览页**（`wanwang.aliyun.com/help/price.html`）
「注册」/「转入」列有价格且不为 `-`。页面中查不到或该行为下无定价的后缀暂不支持。
---
## 40. 端到端场景

### 注册新域名或转入已有域名

两种方式都能让域名归你：查完可注册性直接买新域名，或者用原注册商的转移码把已有域名转进来。两条路径都是先查询、再进入官方订单确认页，CLI 仅负责打开确认页，价格、账号与支付由页面最终确认。

> ⚠️ buy 与 transfer-in 一次都最多 200 个域名，但 CLI 不直接扣费。系统在 OAuth 授权后打开万网订单确认页，最终资格、价格与支付以页面为准；CLI 输出不构成报价承诺。

```bash
# 1. 查询可注册性与可售后缀
aliyun domain check --domain example.com

# 2. 注册新域名，进入官方订单确认页
aliyun domain buy --domains example.com --years 2

# 3. 或检查已有域名的转入资格
aliyun domain transfer-in check --domain example.com

# 4. 提交域名与转移码完成转入
aliyun domain transfer-in apply --domains "a.com code-1,b.net code-2"

```

### 转出域名

先查询当前转出状态，再申请转移码并提交快速转出。转出使用高风险确认流程。

> ⚠️ 转移码属于域名迁移凭据，CLI 不回显转移码或原始任务结果。转出会改变所有权，提交前会回读账号资产，并要求 --confirm-domain 与域名完全一致。

```bash
# 1. 查询当前转出状态
aliyun domain transfer-out status --domain example.com

# 2. 申请转移码
aliyun domain transfer-out request-code \
  --domain example.com \
  --confirm-domain example.com --confirm=true

# 3. 申请快速转出
aliyun domain transfer-out \
  --domain example.com \
  --confirm-domain example.com --confirm=true

```

### 盘点账号域名

依次查看全量资产、按状态筛选，并查询单个域名的详情与历史。全部步骤均为只读操作，输出为经过字段白名单过滤的稳定摘要。

```bash
# 1. 列出账号下的域名
aliyun domain list --page 1 --limit 20

# 2. 按生命周期状态筛
aliyun domain search --status normal --limit 20

# 3. 查看单个域名详情
aliyun domain detail --domain example.com

# 4. 查看操作历史
aliyun domain history --domain example.com

```

### 续费并整理域名分组

续费前先查参考价格，再用备注和分组把域名整理清楚，方便批量管理。除续费进入官方确认页外，其余管控写操作默认只输出预览，加 --confirm=true 才提交。

> ⚠️ 续费参考价格用于前置查询，最终资格、价格与支付以官方确认页为准；打标签和移分组最多支持 50 个域名，管控写操作在缺少 --confirm=true 时只输出预览。

```bash
# 1. 查询续费参考价格
aliyun domain price --domain example.com

# 2. 进入续费确认页
aliyun domain renew --domains example.com,example.net --years 2

# 3. 批量打标签备注
aliyun domain remark --domains example.com,example.net --text "brand assets" --confirm=true

# 4. 移入指定分组
aliyun domain group move --domains example.com,example.net --group "core brands" --confirm=true

```

### 管理自动续费

自动续费会授权未来扣费，因此使用加强确认流程。

> ⚠️ 启用自动续费等于授权未来扣费，因此除 --confirm=true 外，还必须同时提供 --confirm-domain 与 --ack-future-charge=true。

```bash
# 1. 启用自动续费
aliyun domain auto-renew \
  --domain example.com --status on \
  --confirm-domain example.com \
  --ack-future-charge=true --confirm=true

```

### 查看联系人信息并管控 DNS

查询域名的脱敏联系人信息与当前 DNS Host，再切换名称服务器并开启转移锁防止未经授权的转移。管控写操作默认只输出预览，加 --confirm=true 才提交。

> ⚠️ 联系人信息始终经过脱敏处理；名称服务器配置错误可能导致网站和邮件不可达，且不会产生额外提示；所有管控写操作在缺少 --confirm=true 时只输出预览，应先核对预览结果再确认。

```bash
# 1. 查询持有人联系方式
aliyun domain contact --domain example.com --type registrant

# 2. 读取当前 DNS Host
aliyun domain dnshost list --domain example.com

# 3. 切换名称服务器
aliyun domain nameserver set \
  --domains example.com --servers aliyun \
  --confirm=true

# 4. 启用转移锁
aliyun domain transfer-lock \
  --domains example.com --status on \
  --confirm=true

```

### 查询估值并预览一口价挂牌

查询估值参考、核对是否已有一口价挂牌，再提交挂牌预览。真实交易 OpenAPI 开放前，这三条命令都是预留契约，不产生真实挂牌、估值或交易。

> ⚠️ 真实交易 OpenAPI 尚未开放：估值不包含任何可用于定价决策的数据，挂牌详情明确标注为不可用的模拟结果；挂牌提交加 --confirm=true 也只会模拟执行，不会真正创建挂牌、订单、转移或扣费。

```bash
# 1. 查询估值参考
aliyun domain trade appraise --domain example.com

# 2. 核对是否已有挂牌
aliyun domain trade detail --domain example.com

# 3. 预览并提交一口价挂牌
aliyun domain trade publish --domain example.com --price 8888 --confirm=true

```

### 咨询备案材料并预览提交

先咨询备案所需材料，再预览新增网站备案的填写请求，最后按备案 ID 查进度。真实 API 开放前，这些命令都是预留契约。

> ⚠️ 真实备案 API 尚未开放：icp fill 加 --confirm=true 只会模拟执行，不会真正创建或提交备案申请；icp status 只校验申请 ID 格式，不返回虚构的进度、百分比或审核结果。

```bash
# 1. 咨询备案所需材料
aliyun domain icp ask --question "新增网站备案需要准备哪些资料？"

# 2. 预览并提交备案填写
aliyun domain icp fill --domain example.com --input-file ./icp-website-new.json --confirm=true

# 3. 查询备案进度
aliyun domain icp status --filing-id ICP_EXAMPLE_001

```

### 对话生成站点并发布

用一句话描述需求创建对话与站点，需求确认后生成代码，最后发布上线。chat-start 与 deploy 默认只输出预览，加 --confirm=true 才提交；发布在服务端异步执行，需要用 deploy --operation status 跟踪进度。

> ⚠️ 创建对话、生成代码都会消耗灵感值；deploy 提交后在服务端异步执行，命令返回不代表发布已完成，需要用 deploy --operation status 跟踪进度。

```bash
# 1. 描述需求创建对话与站点
aliyun domain wxz chat-start --message "做一个律师事务所官网" --confirm=true

# 2. 确认需求并生成代码
aliyun domain wxz chat-generate --conversation-id 89324C6B546D109BBAA48B5E1BAA62F9

# 3. 发布站点
aliyun domain wxz deploy --operation publish --biz-id WS20260716135629000001 --confirm=true

```

### 查看站点数据与发布历史

列出建站项目找到站点 ID，查看近期访问数据，再核对发布历史与编号；发布记录按最新倒序排列，回滚需要用其中报告的发布编号，不是列表里的位置序号。

> ⚠️ 分析数据查询过程中使用的 SSO 令牌只保留在内存里，不会打印或落盘；发布编号来自 deploy --operation history 报告的值，不是列表里的位置序号，回滚前需要核对清楚。

```bash
# 1. 列出建站项目找到站点 ID
aliyun domain wxz project --operation list

# 2. 查看站点访问数据
aliyun domain wxz analytics-daily --biz-id WS20260716135629000001

# 3. 核对发布历史与编号
aliyun domain wxz deploy --operation history --biz-id WS20260716135629000001

```

---
## 41. Agent 路径：alibabacloud-domain-manage Skill

alibabacloud-domain-manage 是阿里云域名查询官方 Skill。用自然语言问域名信息，它按统一契约调用只读接口，只返回真实数据，不做任何变更，也不需要你确认。

官方 · 域名查询 · 通过安全检测 · 发布于 2026-07-10。

### 安装

**Agent 自主安装**

```bash
请通过 https://skills.aliyun.com/api/public/skills/alibabacloud-domain-manage/download，帮我下载并安装 alibabacloud-domain-manage Skill。安装后提醒我是否需要重启对话。
```

把这段话发给你正在用的 AI 助手，它会自己判断当前工具环境并完成安装，不用你手动跑命令。

**CLI 命令安装**

```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-domain-manage --agent qoder -y --full-depth
```

终端里跑，需要 Node.js ≥ 18；Skills CLI 支持 45+ 种 Agent（Qoder、Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等），把 --agent 换成你用的客户端即可。装完重启 Agent 客户端生效。

### 依赖自动准备

```bash
# 首次调用前会自动跑一遍环境检查，不用你手动装好
$ aliyun version                            # 要求 >= 3.3.3，版本不够会先更新
$ aliyun configure set --auto-plugin-install true
$ aliyun plugin update
$ aliyun configure list                     # 只用来确认本地是否已配好凭证
```

### 能力

- **纯只读，不用确认** —— 域名详情、域名列表、高级搜索、按实例 ID 查询——四类操作全部是查询，不做任何变更，不会跳出确认卡，也不会意外改坏你的域名设置。
- **凭证零暴露** —— 不会读取、打印或索取你的 AK/SK，也不会让你在对话里贴密钥；只用 aliyun configure list 确认本地是否已经配好凭证。
- **不编造数据** —— 展示的每一个字段都必须来自阿里云域名接口的真实返回，查不到就说查不到，不猜测、不杜撰。
- **首次用自动核对环境** —— 执行前会自动检查本地 aliyun CLI 版本（要求 ≥3.3.3）并按需更新插件，不需要你提前手动装好环境。
- **一次覆盖四种查询** —— 按域名名称查、按实例 ID 查、翻页浏览全部域名、按状态/到期时间/后缀等条件高级筛选——一次覆盖四种查询方式。
- **报错有明确下一步** —— 权限不足会指引你申请对应权限并等你确认；域名不存在、密钥失效、触发限流等常见报错也各自给出对应的解决路径。

### 边界

- 不做任何写操作——续费、赎回、加解锁、改联系人、转移都不在范围内
- 不注册或转入新域名——这类需要 alibabacloud-domain-trade
- 不管理 DNS 解析记录或 DNSSEC——这类需要 alibabacloud-domain-dns
- 不创建或管理实名信息模板——这类需要 alibabacloud-domain-certification
- 不查任务执行历史或审计日志——这类需要 alibabacloud-domain-audit

> 注意：以上 Skill 描述基于它自己在 Agent Skills 门户（https://skills.aliyun.com/skills/alibabacloud-domain-manage）发布的 SKILL.md 契约，
> 与本文件其余部分描述的客户侧 Extension 指令集是两份独立出处；能力快照（2026-09-16）本身未涉及 Skill。
---
## 42. 已知文档矛盾（写文案时用"以控制台为准"兜底）

1. **赎回期天数**：赎回专题页按后缀给 30 / 14 / 无；管理页与续费页给"到期后 31-60 天"、
   "CNNIC 为 31-44 天"；价格页给"通常 14 或 30 天"。三者数学上一致，口径不同。
   **以赎回专题页那张表为准**，并带上"以控制台实际状态为准，可能有约 24 小时误差"。
2. **`serverHold` 解除延迟**：同一篇官方文档内既写"1 个工作日"又写"1~2 个工作日"。
3. **注册商侧的批量转入上限**：help.aliyun.com 写 200，alibabacloud.com 写 50，**不要引用**。
   本文件里的 200 是 `transfer-in apply` 这条**命令**的批量上限（来自能力快照），是另一回事。
4. **实名 → 可备案等待期**："约三天" / "2~3 天" / "可以直接提交" 三种说法，取决于域名是否在
   阿里云注册。
5. **赎回后是否自动延期一年**：赎回专题页说"延长一年"，FAQ 说"部分域名赎回后仍需再续费一次"。
   以控制台到期时间是否更新为准。
6. **插件安装 flag**：不同文档页出现过 `--name` 与 `--names`。以 `--names` 为准，
   或让用户跑 `aliyun plugin --help`。

### 不要编造的东西

- **中国站销售的后缀总数**：官方无声明。白名单 222 个是"可售卖后缀"口径，
  不是官方公开声明的总数。
- **控制台实名状态的完整枚举**：无集中官方枚举页。只有 EPP 状态码有官方专表。
- **指令数之外的产品数字**：扩展指令 105 条（域名 87 + 万小智建站 18）、真实命令组 22 个来自 2026-09-16 指令树；
  阿里云 CLI 覆盖"300+ 云产品"是官方措辞。其余数字没有出处就不要写。
- **新指令集的报错清单**：能力快照没有给报错与恢复建议，所以本文件不列。遇到报错照原文转述，
  不要臆造错误码含义。
---
## 43. 出处

| 来源 | 用于 |
|---|---|
| DomainCLI 完整指令树（extension_commands.json + 能力介绍，2026-09-16） | 105 条扩展指令的真实路径与描述、22 个真实命令组 |
| DomainCLI 能力介绍（2026-08-26） | 既有命令示例、执行路径、安全设计、批量上限与能力边界 |
| `https://skills.aliyun.com/skills/alibabacloud-domain-manage` | Skill 官方详情页 |
| `https://help.aliyun.com/zh/dws/user-guide/redeem-a-domain-name` | 按后缀的宽限期 / 赎回期 / 删除期与赎回费用构成 |
| `https://help.aliyun.com/zh/dws/user-guide/transfer-a-domain-name-to-alibaba-cloud` | 转入前置检查、转移密码、耗时 |
| `https://help.aliyun.com/zh/dws/user-guide/transfer-a-domain-name-from-alibaba-cloud-to-another-registrar` | 转出规则与耗时 |
| `https://help.aliyun.com/zh/dws/support/domain-name-transfer-in-and-transfer-out-related-faq/` | 转移 FAQ、60 天规则 |
| `https://help.aliyun.com/zh/dws/user-guide/how-to-complete-domain-name-authentication` | 实名认证要求与信息模板两步制 |
| `https://help.aliyun.com/zh/dws/user-guide/whois-lookup-1` | EPP 状态码官方专表 |
| `https://help.aliyun.com/zh/dws/user-guide/enable-the-transfer-prohibition-lock` | 转移锁 |
| `https://help.aliyun.com/zh/dws/user-guide/enable-the-update-prohibition-lock` | 更新锁 |
| `https://help.aliyun.com/zh/dws/user-guide/use-the-security-lock-of-domain-name-registries` | 注册局安全锁 |
| `https://help.aliyun.com/zh/dws/security-and-compliance/whois-information` | ICANN 注册数据政策默认隐私 |
| `https://help.aliyun.com/zh/dws/user-guide/cnnic-privacy-protection-service/` | CNNIC 付费隐私保护服务 |
| `https://help.aliyun.com/zh/icp-filing/basic-icp-service/user-guide/prepare-and-check-the-domain-name` | 备案对域名的要求、`.org` 不可备案 |
| `https://aliyuncli.alicdn.com/plugins/plugin_pkg_index.json` | 插件的 name / command / productCode |
| `https://help.aliyun.com/zh/cli/install-update-alibaba-cloud-cli` | CLI 安装、更新、卸载 |
| `https://help.aliyun.com/zh/cli/understanding-command-structure` | 插件化架构与全局参数位置 |
| `https://help.aliyun.com/zh/cli/use-the-dry-run-feature` | `--cli-dry-run` |
| `https://github.com/aliyun/aliyun-cli` | 源码、Apache-2.0 |
| `https://wanwang.aliyun.com/help/price.html` | 后缀能否注册 / 转入的判定依据 |