常见问题

找不到 zioon 命令#

确认 Node.js 与 npm 可用，查看安装使用的 prefix，并把其命令目录加入 PATH。Unix 通常为 prefix/bin，Windows 为 prefix 本身。重开终端后运行 zioon --version。

如果仍指向开发源码，可以先用完整命令路径检查，再按当前发行方式安装。zion 与 zioon 是别名，可能被已有其他命令占用。

401 或登录确认无效#

运行 zioon auth status zioon-cloud，必要时重新登录。使用登录命令打印的完整确认链接，包含本次确认代码；过期流程需重新开始。

正式与开发 Runtime 使用独立端点配置。检查 zioon profile show，不要混用不同环境的账号和确认链接。

为什么读不到本机文件#

CLI 所在目录不会自动授予云端文件权限。确认任务运行在正确沙箱或授权设备，并核对项目、目录和设备在线状态。见 执行资源。

已安装插件，却无法调用#

• 查看是否启用以及工具是否实际注册。
• 账户代码 / MCP 扩展需要配置授权 Node 并成功 probe。
• 完整 Runtime 插件使用 --host runtime。
• 交互配置和账号必须允许该工具。
• ADC 等外部服务还需要完成插件自己的连接授权。

extensions list 为空表示当前账户没有这类安装；还可检查 --host runtime。API 404 时核对 Runtime 版本、端点与所用安装类型。

超时后要不要重试#

收到 execution_outcome_unknown 时先读取实际结果。只读查询通常可以重新进行；写入、进程或外部动作可能已经发生，需要先核对对应文件、进程或回执。