OptiWaves
手册产品站

CLI 使用与维护

更新 CLI、检查连接、重新配置客户端，以及恢复已有配置。

本页适用于已经安装 OptiWaves CLI 的用户。首次使用请先完成 CLI 安装引导。

更新 CLI

0.1.11 及以上版本直接更新：

optiwaves update
optiwaves update --preview

更新保留客户端配置和恢复点；下载或校验失败时不会替换现有命令。仍在使用 0.1.10 或更早版本时，先执行 CLI 安装引导中对应系统的安装命令。

检查配置与网络

optiwaves status --client codex
optiwaves doctor --client codex
optiwaves doctor --client codex --network

status 查看安装与配置状态，doctor 检查配置问题；加 --network 才会验证 API 连接并读取模型目录。网络检查使用终端中的 OPTIWAVES_API_KEY 或 CLI 保存的私有凭据，不产生模型回答。

若能通过网络检查但仍无法收到回答，按错误说明检查套餐、模型权限与额度。

预览和重新配置

已有客户端时，可以先查看文件改动，再执行配置：

optiwaves configure --client codex --model auto --effort medium --preview
optiwaves configure --client codex --model auto --effort medium

--preview 不写配置。常规 configure 会在应用改动前交互确认；--yes 会跳过这一步，只有确认参数后再使用。向导会自动备份并写入，不额外要求逐文件确认。

添加本地记忆

CLI 0.1.15 起可以为已有客户端添加本地记忆连接：

optiwaves memory --client codex --preview
optiwaves memory --client codex
optiwaves memory --client codex --memory off

配置和断开连接都保留恢复点；断开连接不会删除记忆。完整验证步骤见本地记忆。

恢复配置

先列出恢复点，再将 BACKUP_ID 替换为实际编号：

optiwaves backups
optiwaves restore --operation BACKUP_ID --preview
optiwaves restore --operation BACKUP_ID

只想移除 CLI 管理的 OptiWaves 配置时：

optiwaves unconfigure --client codex --preview
optiwaves unconfigure --client codex

凭据与恢复点保存在当前用户的私有配置中。恢复或撤销遇到后续手工改动时，应先审阅提示，避免覆盖自己新增的配置。

售后群 1055897442

本页