DibuFusion Agent 安装

本指南供 Codex、Claude Code 等编程智能体读取，当前优先支持 Linux 和 macOS。

安全要求

• 不要求用户在聊天中发送密码、Hub Token、Site 授权码或私钥。
• 凭据由用户本人在 CLI 的隐藏输入中填写。
• 资源申请前展示建议的 Site、GPU、CPU、内存和预计时长，并等待用户确认。
• 不执行 Site 管理员的节点、资源组或用户权限修改操作。

检查环境

确认系统具备 curl、tar，以及 sha256sum 或 shasum：

curl --version
tar --version
command -v sha256sum || command -v shasum

安装 CLI 与 Skill

以当前用户安装，不使用 sudo。安装器只从 DibuFusion 官网下载经过 SHA-256 校验的预编译 CLI，不访问 GitHub，也不下载项目源码：

curl -fsSL "https://fusion.dibutokens.com/install.sh" \
  -o /tmp/dibufusion-install.sh
sh /tmp/dibufusion-install.sh --agent codex
export PATH="$HOME/.local/bin:$PATH"
dibufusion agent doctor --json

Claude Code 将安装参数中的 codex 改为 claude。

登录 Hub

让用户在自己的终端中选择一种方式登录。

邮箱密码：

dibufusion auth login \
  --server "https://fusion.dibutokens.com" \
  --email "user@example.com"

Hub Personal Access Token：

dibufusion auth token --server "https://fusion.dibutokens.com"

登录后验证：

dibufusion auth status --json
dibufusion site my --json
dibufusion hub dashboard --json

不注册 Hub，直接使用 Site

如果用户没有 Hub 账号，但已经获得课题组 Site 地址和 Site Access Token，可以使用独立直连模式：

dibufusion site direct add \
  --profile my-lab \
  --site-url "http://site.example.local"
dibufusion site direct token --profile my-lab
dibufusion site direct dashboard --profile my-lab

Token 必须由用户在 CLI 隐藏提示中输入，智能体不得要求用户在聊天中发送 Token。直连模式要求当前设备能通过课题组局域网或 VPN 访问 Site，不提供 Hub 的多 Site 聚合、凭据托管和 Relay 功能。

资源建议流程

1. 询问任务类型、期望 GPU 数量、CPU、内存和预计时长。 2. 读取用户已绑定 Site 的可用资源。 3. 给出简短、可解释的候选方案。 4. 说明可能的等待时间和限制。 5. 用户确认后再执行资源申请。

如果用户没有可用 Site，引导其前往 DibuFusion Dashboard 完成绑定，不要猜测 Site 地址或索取授权码。

获取支持

遇到安装或授权问题，请联系 enterprise@dibutokens.com，但不要在邮件中附带任何凭据。