云码道 CodeArts + HuaweiCloud Devkit 实战：用自然语言管理华为云资源

一、为什么要在云码道里用 Devkit

云码道（CodeArts）在线体验环境里可以安装 HuaweiCloud Devkit 插件，装上之后 agent 就能直接调用 KooCLI 去查询、创建、修改华为云资源。相比在本地装一堆 SDK，这种方式更适合临时排障、批量查询和教学演示——环境是现成的，凭证也可以只在会话内存中使用。

二、环境准备

进入云码道在线体验后，第一步是让 agent 安装插件，直接用自然语言说：

安装 HuaweiCloud Devkit插件

插件安装完成后会同时准备好 KooCLI（hcloud）。此时还没有身份认证，执行任何资源类命令都会提示凭证缺失，需要先在“我的凭证”里创建访问密钥（AK/SK）。创建访问密钥是两步向导，最后一步需要短信验证码，属于必须人工确认的环节。

三、认证与首次验证

把 AK/SK 交给 agent 后，它会把凭证配置进 hcloud 的 profile，然后用一条最简单的只读命令验证连通性：

hcloud ECS ListServersDetails --cli-region=cn-north-4

如果返回 JSON 列表，说明认证和网络都正常。建议先用只读接口验证，再执行创建类操作，避免因为凭证错误产生垃圾资源。

四、实战：用自然语言查询与变更资源

认证通过后，日常操作基本可以“说人话”完成，例如：

• “列出北京四所有运行中的 ECS，按创建时间倒序”
• “帮我把这台 Flexus L 实例的公网带宽从 2M 调整到 5M，先给我看预估费用”
• “查一下我这个账号还有多少张未过期的代金券”

agent 会把这些意图翻译成 KooCLI 命令，再把结果整理成表格。对于变更类操作，建议始终要求它先输出将要执行的命令原文，确认无误后再执行。

五、几个真实的踩坑记录

1. Node 版本与 node:sqlite

Devkit 依赖的某些脚本在 Node 22 下会因为没有启用内置 sqlite 模块而报错，启动时需要加上：

NODE_OPTIONS=--experimental-sqlite

2. 在线聊天框发送消息

用脚本操作页面时，直接对发送按钮做合成点击往往无效。可靠的做法是让输入框获得焦点，然后派发一次 keydown 的 Enter 事件，组件会自己完成提交。

3. 凭证只在会话内有效

把 AK/SK 贴进对话后，凭证只存在于当前会话内存里，新建会话需要重新配置。因此长任务建议在同一个会话里做完，或者提前把 profile 写入环境变量。

六、安全建议

自动化管理云资源时，权限最小化比什么都重要。建议单独创建一个 IAM 子用户，只授予需要的操作权限，AK/SK 定期轮换；不要把访问密钥提交到任何代码仓库，也不要贴在公开渠道。临时凭证（STS）能用就用 STS，有效期短、泄露风险更低。

七、小结

云码道 + Devkit 的组合把“查文档、拼命令、复制粘贴”的过程压缩成了一句话，特别适合运维排障和教学场景。但自然语言只是入口，真正决定安全边界的是 IAM 权限设计和操作前的二次确认。把这两件事做好，自动化才敢放心用。