Skip to main content

​
CLI 费用与确认

本页按已发布 CLI 0.8.1 说明。CLI 直接请求平台 API，命令与保存的报价由本地管理；登录复用 Passport。运行命令之前可先读完整流程。
  1. 使用最终模型与输入执行 evolink estimate，展示预计费用。
  2. 用户批准本次模型、参数和预计费用后，使用保存的 quote_id 与 --confirm 生成。
  3. 参数、身份、报价有效期或价格变化时重新核价并取得批准，不复用另一份报价。
  4. 查询原任务与账户用量了解结果；不能把估价写成已扣费或退款记录。
报价状态、公开默认价限制、费用批准和预算边界统一见模型、费用与额度。已发布版 max_cost_usd 仍只比较提交前估价，不能保证最终扣费不超额。 报价通常保留 15 分钟，与原身份、模型和输入绑定。报价不是付款凭证。--confirm 表示本次用户批准，不代替登录和宿主执行权限。模型查询、余额、任务查询无需提交生成；生成会计费，文件服务另有大小及保留期限制。美元换算参考为 68 积分约 $1，实际以返回值和账户记录为准。 账户共用权限和额度规则见共用说明，本页保留当前入口的登录与退出操作。

​
登录、权限与额度

CLI 的浏览器登录由 Passport 完成，凭据由系统安全存储保存。平台业务使用现有 OAuth 关联 Key。CLI 与远程 MCP 可以共用账户、Key 额度和权限；暂停或调整共享 Key 会影响使用它的入口。各 OAuth 会话的退出分别处理。
需要退出本机 CLI 时，单独执行：
本地 MCP 使用个人 API Key 时按该 Key 的权限执行；CLI 登录不会给另一个本地 MCP 进程授权。余额、日额度、总额度、模型权限和工具权限都可能阻止提交。失败任务、连接中断或退出登录不能自动证明已经退款。

​
保存与有效期

报价、素材、一次性上传授权和原件链接的默认有效期集中在任务、素材与结果。具体以实际返回值为准；上传回执兼容取决于文件服务部署。

​
CLI 排错：先找到失败步骤

在运行 CLI 的同一机器、系统用户和终端检查版本与连接。以下查询不会提交生成：
先检查当前步骤，修复后再继续下一步。连接验证不需要付费生成，不要通过重复生成来验证安装。

​
环境与安装：命令找不到、权限不足、安装超时

**第一步：检查安装在哪个环境。**在 Agent 自己使用的终端执行：
CLI 需要 Node.js 22+。command not found 或 Windows“无法识别命令”时，先安装 Node.js，重开终端。不要只在本机安装，却让 SSH、WSL 或容器里的 Agent 使用。 第二步：确认 npm 的安装位置。
定位命令路径时，选择当前系统对应的一组：
**第三步：重新验证命令。**修复对应问题后再安装或更新，运行 evolink --version。能显示版本后才继续登录。完整步骤见通用安装指南。

​
登录与回调：浏览器没有打开、登录未完成

  1. 保持 evolink auth login 或 setup 运行。浏览器未自动打开时，手动打开这一次命令给出的链接，核对账户并同意。
  2. 回到原终端等待登录完成。浏览器回调页只表示收到回调，不表示余额连接已验证；不要提前关闭命令。
  3. 用下面两条命令分别确认保存了登录、可以访问账户：
authenticated: true 与真实余额结果是各自的成功标志。超时后重新发起登录，用新链接，不复用旧授权码。需要更长等待可使用：
--no-browser 仍然需要浏览器回调，不是设备码或无浏览器身份验证。不要将 API Key 当作 OAuth 令牌填入远程连接。

​
技能与权限：文件已安装，但 Agent 不会使用

  1. 确认安装目录属于实际运行 Agent 的用户，使用对应的 --agent 查看状态。例如 Codex：
  1. 根据状态处理：current: true 说明文件与当前 CLI 一致；缺失或旧版本时运行 evolink skills install --agent codex。modified 表示个人修改，先决定保留内容；conflict 需处理同名技能或无效安装元数据，不直接删除整个技能目录。
  2. 回到 Agent 对话，让它确认能发现并读取 evolink-cli。没有刷新时新开对话；宿主要求命令执行许可时，由您审核并允许需要的命令。仍受组织策略限制时按宿主设置处理。
assistant_discovery: not_checked 是“宿主加载尚未验证”，不是已加载的证明。只看到 SKILL.md、只让 Agent 阅读了网页，也不表示它能执行 CLI。 更新 CLI 后需要再次同步技能。明确决定替换个人修改时才加 --replace-modified，备份位于 ~/.evolink-media/skill-backups/。安装位置和技能内容集中在Agent 可读资料。

​
模型与价格：搜索为空、参数报错、报价不完整

  1. 使用实时模型搜索，采用返回的规范 ID；别名、展示名称和模型系列不一定是可提交 ID。搜索为空时放宽关键词，但保留素材类型等必要条件。
  2. 用 models show / models schema 查本型号参数。检查必填字段、拼写、枚举、数值范围和参考互斥，不复制其他型号的 duration、size 或 quality。
  3. 重新估价，查看 input_valid、problems、estimate.status、basis、warnings。修改输入、价格或账户后重新报价并确认。
needs_input 需要补齐参数，no_price 不是有效报价，partial 不是总价；未知输出时长或参考倍率不能靠目录起价补齐。保留原预算，不自动删除上限、更换 Key 或降低规格来绕过。 已发布客户端的公开默认估价不是账户专属权威 Quote，max_cost_usd 也不是最终结算硬上限。具体边界见费用说明。完整命令参数见CLI 参考。

​
生成超时、任务仍运行或提交结果未知

1

已有 task_id 时查询原任务

等待超时不取消任务。多任务使用 batch 或 list 查状态，完成后下载原件。
2

没有 task_id 时恢复原报价

使用原身份、原报价和请求编号恢复。不能换账户、新报价或新编号重复生成；结果未知不表示未提交或未扣费。
3

失败时保留证据再处理

记录原任务编号、错误码与时间。确认失败后核对账户记录；不能只从失败状态推断已退款。取消排队目前没有公开可用命令，关闭终端或停止等待不会取消服务端任务。
报价过期或变价，在尚未提交的情况下重新估算并确认；已有任务或未知提交先恢复。详细命令见任务参考。

​
上传失败、文件太大或结果未知

  1. 在 Agent 实际执行机器上确认绝对路径、可读权限和真实文件类型。远端或容器不能直接读取用户桌面的路径。
  2. CLI 本地上传上限为 95 MiB，模型可能有更严格的格式、数量或大小限制。先核对模型说明，再上传；聊天附件需要落成 CLI 可读文件或可访问 URL。
  3. 上传不确定时保留原 upload_id 并查询：
  1. 查询能力取决于文件服务部署。outcome_unknown 不证明未上传；确认失败或授权过期后才申请新的上传。参考文件通常保留 72 小时，过期后重新上传并更新输入，生成前重新估价与确认。
上传命令和 URL 方式见素材流程，回执字段见命令参考。不要把一次性上传 URL、私人签名链接或 Key 发到聊天中。

​
下载与预览

先查原任务、确认完成并使用原件链接。CLI 优先使用 download；命令见CLI 参考。CLI 下载已带产品 UA。 HTTP／格式检查、Python 产品 User-Agent 示例、过期链接与灰色缩略图处理统一见下载排错。结果未知先恢复原任务，不为预览重新生成或剪辑。

​
仍未解决时提供什么

按问题信息清单提供版本、失败步骤、编号和脱敏错误。保留本入口的诊断记录；不要分享 Key、token、私人链接或完整环境变量。

​
需要排查原生 MCP 连接吗

CLI 和 MCP 是独立入口。原生 MCP 的 OAuth、工具发现和本地 stdio 排错请看MCP 排错；CLI 安装成功不能作为 MCP 连接验证。这里保留旧链接入口，CLI 的命令、登录和技能排错都在本页。