使用 REPL 交互模式

REPL（Read-Eval-Print Loop）交互模式适合在终端中通过多轮对话完成云资源规划、选型、IaC 生成、部署和后续变更。本文介绍如何启动会话、完成一次云资源管理任务并管理上下文。

前提条件

• 已完成安装和配置 IaC Code。

• 已进入用于保存 IaC 文件和会话上下文的项目目录。

• 查询或管理云资源时，已配置具有相应权限的阿里云身份。

快速开始

在项目目录启动 REPL：

cd /path/to/project
iac-code

首次使用或需要修改认证信息时，输入：

/auth

然后提交以下需求：

在杭州规划一套包含 VPC、两个交换机和两台 ECS 的环境。查询可用规格，生成并校验 ROS 模板，估算费用；展示将创建的资源和费用后等待我确认，不要直接部署。

IaC Code 将依次分析需求、查询云产品和库存、生成并校验 IaC、估算费用，然后等待确认。核对地域、资源数量、安全组、计费方式和费用后，再决定是否部署。

部署完成后，可以在同一个会话中继续输入：

查询刚才创建的资源栈及其中资源的状态，汇总异常和下一步建议，不要执行变更。

预期结果：IaC Code 保留前文的资源栈上下文，查询部署状态并给出建议。后续还可以提出更新、继续创建或删除需求；写操作执行前应再次核对影响范围并确认。

使用对话和工具

• 直接描述云资源目标、地域、规格、安全和费用要求，不需要先编写完整模板。

• IaC Code 需要读取或写入文件、查询云 API 或管理资源栈时，会显示相应工具调用。

• 根据权限模式，写文件、部署、更新和删除等操作可能要求确认。批准前检查工具名称、参数、地域和目标资源。

• 输入 !git status --short 等命令，可以通过受权限控制的 Bash 工具执行本地命令。

• 终端支持时，使用 Shift+Enter 输入多行内容；不能识别该组合键时使用 Esc 后按 Enter。

使用斜杠命令和 Skill

输入 / 查看当前可用的斜杠命令。常用入口包括：

命令或前缀	用途
/auth	配置模型服务和阿里云身份。
/status	查看当前会话状态。
/skills	查看、搜索和启停 Skill。
/memory	查看和管理项目或用户记忆。
/rename	重命名当前会话。
/resume	选择历史会话继续处理。
$	仅搜索和调用 Skill。

完整命令会随版本演进，请以 REPL 中的 / 补全结果和 GitHub 命令参考为准。

恢复会话

退出 REPL 不会删除会话。可以通过以下方式恢复：

iac-code --resume <会话 ID 或名称>

继续最近一次会话：

iac-code --continue

也可以启动 REPL 后输入 /resume。REPL 与 Web 共用会话存储，因此 Web 创建的会话也可以从终端恢复。

常见问题

REPL 启动后提示未配置模型

输入 /auth，完成模型服务商、模型和 API Key 配置。配置问题的通用排查方法请参见 安装和配置 IaC Code。

云资源查询没有返回结果

确认已配置阿里云身份和正确地域，并检查身份是否具有目标产品的只读权限。要求中应明确目标地域；未指定时，IaC Code 会使用配置的默认地域并说明该选择。

工具操作没有执行

检查当前权限模式和此前的审批结果。对于部署、更新或删除操作，重新明确目标资源和影响， 并在出现权限请求时确认；不要使用宽泛授权绕过安全检查。

会话上下文过长

将长期稳定的项目约定放入项目记忆或 Skill；开启新任务时创建新会话。需要继续同一资源栈任务时，优先恢复原会话以保留资源栈和决策上下文。

相关文档

• 安装和使用 IaC Code

• REPL 交互模式完整参考

• 斜杠命令

• 会话管理

• Skill 完整参考