# aliyun domain

> `aliyun domain` 由官方插件 `aliyun-cli-domain` 提供，共 105 条扩展指令：域名 87 条、万小智建站 18 条，包含 22 个真实命令组。

本文件面向 LLM 与 Agent。完整内容见 [llms-full.txt](/llms-full.txt)。命令面取自 2026-09-16 的 extension_commands.json 与完整指令树。

## 先读这六条，否则一定写错命令

1. **写操作默认只出预览，什么都不会提交。** 补上 `--confirm=true` 才进入鉴权与 OpenAPI；命令跑完没报错不等于改成了。
2. **高风险动作还要 `--confirm-domain` 与目标域名完全一致**：DNSSEC 三条写操作、转移码、快速转出、自动续费都在这一档。
3. **开自动续费必须额外给 `--ack-future-charge=true`**，它授权的是未来的自动扣费。
4. **CLI 不直接扣费。** `buy` / `renew` / `redeem` / `transfer-in apply` 是 OAuth 后打开万网官方订单确认页，最终资格、价格与支付都由页面决定。
5. **PII 只从受保护文件读**：走 `--input-file` / `--email-file` / `--token-file`，Unix/macOS 要求普通文件、非符号链接、权限不超过 `0600`。
6. **参数用客户语言**：`--domain` / `--domains` / `--page` / `--limit`。全局参数放 `domain` 之前；想先看不执行加 `--cli-dry-run`。

## 最小可用序列

```bash
# 1. 一行装好阿里云 CLI latest 与 aliyun-cli-domain 0.9.4
curl -fsSL https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.sh | bash
# 2. 看一遍客户侧命令；订单/问答/管控/高风险场景走 OAuth，首次用到时在浏览器授权
aliyun domain --help
# 3. 本地预览，不触发 OAuth 也不打 OpenAPI
aliyun --region cn-hangzhou domain ask --question "域名过期后多久进入赎回期？" --cli-dry-run
# 4. 真实只读调用
aliyun domain list --page 1 --limit 20
```

## 命令参考（105 条 / 22 个真实命令组）

- [域名 · Agent 契约](/llms-full.txt): `capabilities`、`schema`、`auth`、`login`、`logout`、`whoami`
- [域名 · 智能问答](/llms-full.txt): `ask`
- [域名 · 资产与询价](/llms-full.txt): `list`、`detail`、`whois`、`check`、`search`、`price`
- [域名 · 交易转入](/llms-full.txt): `trade publish`、`trade detail`、`trade appraise`、`buy`、`renew`、`redeem`、`transfer-in apply`、`transfer-in list`、`transfer-in detail`、`transfer-in check`
- [域名 · 备案服务](/llms-full.txt): `icp ask`、`icp fill`、`icp status`、`icp info`
- [域名 · 分组任务](/llms-full.txt): `group list`、`group create`、`group rename`、`group move`、`group delete`、`history`、`task list`、`task show`、`task history`、`task history-detail`、`task poll`
- [域名 · 域名管控](/llms-full.txt): `transfer-lock`、`update-lock`、`nameserver set`、`remark`
- [域名 · DNS Host 与 DNSSEC](/llms-full.txt): `dnshost list`、`dnshost create`、`dnshost update`、`dnshost delete`、`dnssec list`、`dnssec enable`、`dnssec update`、`dnssec disable`
- [域名 · 云解析 DNS 记录](/llms-full.txt): `dns list`、`dns detail`、`dns create`、`dns update`、`dns delete`、`dns enable`、`dns disable`、`dns lines`、`dns logs` —— 通过阿里云云解析（AliDNS）管理 A/AAAA/CNAME/MX/TXT 等公开解析记录；这是解析记录本身，和注册局侧的名称服务器委派（nameserver）、Glue Record（dnshost）、DS 记录（dnssec）是完全不同的四件事。
- [域名 · 隐私资料](/llms-full.txt): `template list`、`template create`、`template update`、`template set-default`、`template validate`、`template regions`、`template verify`、`template delete`、`contact`、`set-contact`、`email list`、`email detail`、`email request`、`email confirm`、`email resend`、`email delete`
- [域名 · 实名核验](/llms-full.txt): `verification domain-status`、`verification template-status`、`verification domain-failure`、`verification template-failure`
- [域名 · 注册局锁](/llms-full.txt): `server-lock list`、`server-lock detail`、`server-lock check`、`server-lock max-years`
- [域名 · 转出续费](/llms-full.txt): `transfer-out status`、`transfer-out request-code`、`transfer-out apply`、`auto-renew`
- [万小智 · 建站账号项目](/llms-full.txt): `wxz account`、`wxz project`、`wxz preview`、`wxz analytics-daily`
- [万小智 · 建站对话生成](/llms-full.txt): `wxz chat-start`、`wxz chat-send`、`wxz chat-resume`、`wxz chat-reconnect`、`wxz chat-generate`、`wxz chat-history`
- [万小智 · 内容创作保存](/llms-full.txt): `wxz content` —— 保存 AI 生成的文章、图片、视频草稿，供站点内容板块使用；这是内容素材本身，和 wxz-material 管理的通用建站素材库是两个不同的领域。
- [万小智 · 建站代码](/llms-full.txt): `wxz code`
- [万小智 · 建站会话](/llms-full.txt): `wxz conversation`
- [万小智 · 建站发布](/llms-full.txt): `wxz deploy`
- [万小智 · 站点域名状态](/llms-full.txt): `wxz site`
- [万小智 · 建站素材](/llms-full.txt): `wxz material-directory`、`wxz material-file`
- [万小智 · 建站技能](/llms-full.txt): `wxz skill`

## 确认阶梯

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

## 能力边界

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

## 安全设计

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

## 业务规则

- [生命周期与天数](/llms-full.txt): 续费宽限期 30 天（`.hk` 28 天）→ 赎回期（`.com`/`.net`/`.org` 30 天、`.cn`/`.中国` 14 天、`.hk` 无）→ 等待删除期；赎回费用 = 赎回手续费 + 1 年续费
- [转移的 60 天规则](/llms-full.txt): 注册后 60 天、转入成功后 60 天、过户后 60 天、距上次转移 60 天 —— 四个独立触发点
- [实名认证](/llms-full.txt): 工信部强制，未实名会被注册局置 `serverHold` 导致无法解析；新注册域名需 5 天内提交资料；模板实名成功 ≠ 域名已实名
- [备案（ICP）](/llms-full.txt): 必须先完成实名认证才能提交备案，且持有者信息需与备案主体一致；`.org` 能买但不可备案
- [可售后缀](/llms-full.txt): 中国站可售白名单 222 个，`.dev`/`.ai`/`.app` 不在其中；可注册性与价格以 `check` 实时结果为准
- [Avail 取值](/llms-full.txt): 1 可注册 / 3 预登记 / 4 可删除预订 / 0 不可注册 / -1 异常 / -2 暂停注册 / -3 黑名单；已持有域名返回 0 且无报价

## Agent 路径

- [alibabacloud-domain-manage Skill](https://skills.aliyun.com/skills/alibabacloud-domain-manage): 官方域名查询 Skill，纯只读、不需要确认；首次调用会自动核对本地 CLI 版本并按需更新插件，只用 `configure list` 检查凭证状态，不读取或索要 AK/SK；不做任何写操作，续费转入、DNS、模板、审计各有独立的配套 Skill

## 权威出处

- [DomainCLI 完整指令树](/llms-full.txt): extension_commands.json + 能力介绍快照（2026-09-16），105 条扩展指令与 22 个真实命令组的来源
- [阿里云 CLI 安装与更新](https://help.aliyun.com/zh/cli/install-update-alibaba-cloud-cli)
- [阿里云 CLI 命令结构与插件](https://help.aliyun.com/zh/cli/understanding-command-structure): 3.3.0 起插件化，全局参数放产品名之前
- [阿里云 CLI --cli-dry-run](https://help.aliyun.com/zh/cli/use-the-dry-run-feature)
- [阿里云 CLI 官方插件索引](https://aliyuncli.alicdn.com/plugins/plugin_pkg_index.json): `aliyun-cli-domain` 的 `command` 是 `domain`
- [域名赎回](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/user-guide/how-to-complete-domain-name-authentication)
- [WHOIS 状态码](https://help.aliyun.com/zh/dws/user-guide/whois-lookup-1): EPP 状态码官方专表

## Optional

- [域名价格总览](https://wanwang.aliyun.com/help/price.html): 后缀能否注册/转入以此页有无定价为准
- [CNNIC 隐私保护服务](https://help.aliyun.com/zh/dws/user-guide/cnnic-privacy-protection-service/): 仅 `.cn` 系、付费；非 `.cn` 的 WHOIS 隐私是 ICANN 默认行为
- [注册局安全锁](https://help.aliyun.com/zh/dws/user-guide/use-the-security-lock-of-domain-name-registries): 付费按年，服务期内禁止转出
- [ICP 备案与域名](https://help.aliyun.com/zh/icp-filing/basic-icp-service/user-guide/prepare-and-check-the-domain-name)
- [aliyun/aliyun-cli](https://github.com/aliyun/aliyun-cli): Apache-2.0