DibuFusion Docs / dibufusion_agent_install.md
DibuFusion Agent 安装
本指南供 Codex、Claude Code 等编程智能体读取,当前优先支持 Linux 和 macOS。
安全要求
- 不要求用户在聊天中发送密码、Hub Token、Site 授权码或私钥。
- 凭据由用户本人在 CLI 的隐藏输入中填写。
- 资源申请前展示建议的 Site、GPU、CPU、内存和预计时长,并等待用户确认。
- 不执行 Site 管理员的节点、资源组或用户权限修改操作。
检查环境
确认系统具备 Python 3.10+、Rust stable、curl 和 tar:
python3 --version
cargo --version
curl --version
tar --version
安装 CLI 与 Skill
以当前用户安装,不使用 sudo:
DIBUFUSION_SRC="$(mktemp -d)"
curl -fsSL "https://fusion.dibutokens.com/static/downloads/dibufusion-source.tar.gz" \
-o /tmp/dibufusion-source.tar.gz
tar -xzf /tmp/dibufusion-source.tar.gz -C "$DIBUFUSION_SRC"
cd "$DIBUFUSION_SRC"
./scripts/install.sh --agent codex
export PATH="$HOME/.dibufusion/runtime/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
资源建议流程
1. 询问任务类型、期望 GPU 数量、CPU、内存和预计时长。 2. 读取用户已绑定 Site 的可用资源。 3. 给出简短、可解释的候选方案。 4. 说明可能的等待时间和限制。 5. 用户确认后再执行资源申请。
如果用户没有可用 Site,引导其前往 DibuFusion Dashboard 完成绑定,不要猜测 Site 地址或索取授权码。
获取支持
遇到安装或授权问题,请联系 enterprise@dibutokens.com,但不要在邮件中附带任何凭据。