mcpField
S
sui-install

sui-install

github.com/mystenlabs开发19347 次安装今天更新
代码仓库

关于 sui-install

用于安装和维护 Sui CLI 及相关工具链组件的技能，面向 Sui 开发者。它指导按目标网络选择版本、验证安装并处理常见版本不匹配问题。

主要功能

  1. 01使用 suiup 安装 Sui CLI
  2. 02按网络选择版本
  3. 03更新并切换活动版本
  4. 04验证 CLI 安装和状态
  5. 05安装可选 Sui Stack 工具

适用场景

  1. 01为 Testnet 或 Mainnet 配置 Sui CLI
  2. 02解决 CLI 版本过旧或未激活问题
  3. 03检查已安装工具版本
  4. 04安装可选的 Walrus 或 Move 工具

MCP 相关

建议查询 Sui 文档 MCP 服务，以获取最新答案并进行核验。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mystenlabs/skills --skill sui-install

安装后在 Claude Code 中输入/sui-install确认已加载。

附带文件evals/evals.json

详细介绍

设置与安装

**MCP 工具：**如果你的环境支持，也请查询 Sui 文档 MCP 服务（https://sui.mcp.kapa.ai），以获取最新答案。使用它进行核验，并了解这些参考文件未涵盖的详细信息。

**来源限制：**所有信息均仅来自 docs.sui.io。

系统要求

Sui 支持：

  • **Linux：**Ubuntu 22.04（Jammy Jellyfish）或更高版本
  • **macOS：**Monterey 或更高版本
  • **Windows：**Windows 10 或 11

安装 Sui

suiup（推荐）

suiup 是 Sui 工具链的官方安装程序和版本管理器。它支持安装和切换不同版本的 Sui CLI 及其他 Sui Stack 组件（Walrus、MVR）。

curl -sSfL https://raw.githubusercontent.com/MystenLabs/suiup/main/install.sh | sh

Windows 注意事项：curl | sh 命令需要 Unix shell。在 Windows 上，使用 WSL（Windows Subsystem for Linux）运行上述命令，或改用 Chocolatey 安装（见下方的其他方法）。

安装 suiup 后，安装适用于特定网络的 Sui CLI。CLI 版本必须与目标网络匹配——每个网络运行特定的协议版本，而 CLI 版本不匹配可能导致构建失败、交易错误或意外行为：

suiup install sui@testnet    # install the Testnet-compatible version
suiup install sui@mainnet    # install the Mainnet-compatible version

更新到最新版本：

suiup update sui@testnet

重要：suiup update 会下载新版本，但不会自动将其设为当前默认版本。更新后，必须切换到新版本：

suiup switch sui@testnet     # set the latest installed testnet version as default

查看已安装的版本及当前启用的版本：

suiup show                   # list all installed binaries and their default status
suiup 命令参考
命令语法作用
installsuiup install sui@testnet下载并安装适用于某个网络的二进制文件
updatesuiup update sui@testnet下载最新版本（不会切换到该版本）
switchsuiup switch sui@testnet将某个网络已安装的最新版本设为当前默认版本
showsuiup show列出所有已安装的二进制文件、版本及默认项
statussuiup status显示哪些已安装的二进制文件有可用更新，以及更新命令
self updatesuiup self update更新 suiup 本身

switch 命令接受 binary@network 参数（例如 sui@testnet、walrus@testnet、move-analyzer@testnet）。它不接受 suiup switch sui testnet v1.70.2 这类独立的位置参数。

其他方法
  • Homebrew（macOS/Linux）：brew install sui
  • Chocolatey（Windows）：choco install sui

这些替代方法不支持安装 Walrus 或 MVR 等其他 Sui Stack 组件；如果尚未安装前置条件，安装可能需要几分钟。

验证安装
sui --version

如果命令返回 "sui not found"，运行 suiup switch sui@testnet 将其设为当前默认版本。不要建议手动修改 PATH（export PATH=...）或重新安装——正确的解决方法是运行 suiup switch。

版本管理

保持 Sui 为最新版本

CLI 版本应与目标网络匹配——每个网络运行特定的协议版本，而 CLI 版本不匹配可能导致构建失败或交易错误。使用 @network 后缀更新到正确的版本：

suiup update sui@testnet     # update to latest Testnet version
suiup update sui@mainnet     # update to latest Mainnet version
版本不匹配

CLI 版本必须与目标网络匹配。版本不匹配的常见症状：

  • 构建错误中提到 "old dependencies"
  • 发布时交易失败
  • 网络升级后出现意外行为

检查你的版本是否与网络匹配：

sui --version                 # your installed version
sui client active-env         # which network you are targeting

如果版本已过期，请更新并切换：

suiup update sui@testnet      # download the latest version
suiup switch sui@testnet      # make it the active default
suiup show                     # verify which version is now active

CLI 输出中的 client/server api version mismatch 警告表示本地 CLI 版本低于网络版本。不要忽略此警告——版本不匹配可能导致构建失败和意外行为。请更新并切换版本以解决问题。

可选附加工具

仅在用户明确要求使用该工具时才安装。它们不属于默认设置。

suiup install move-analyzer   # Move Language Server
suiup install mvr             # Move Registry CLI (onchain package manager)
suiup install walrus          # Walrus CLI for decentralized storage
suiup install site-builder    # Walrus site builder

安装后，切换每个工具，将其设为当前默认工具：

suiup switch move-analyzer@testnet
suiup switch walrus@testnet

评论

支持 Markdown