技能：Bohrium 项目管理

概述

在 Bohrium 平台上管理项目。优先使用 bohr CLI 工具；仅当 CLI 不支持的操作（如成员管理、成本限额设置、项目重命名）时，才回退至 API。

项目是 Nodes、Jobs、Images 和 Datasets 的组织容器，也是团队协作与成本管理的基本单位。

认证

"bohrium-project": {
  "enabled": true,
  "apiKey": "YOUR_ACCESS_KEY",
  "env": {
    "ACCESS_KEY": "YOUR_ACCESS_KEY"
  }
}

前提条件：安装 bohr CLI

# macOS
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_mac_curl.sh)"

# Linux
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_linux_curl.sh)"

source ~/.bashrc  # 或 source ~/.zshrc
export PATH="$HOME/.bohrium:$PATH"

列出项目

bohr project list               # 表格格式
bohr project list --json        # JSON 格式
bohr project list --csv         # CSV 格式

JSON 字段说明：

创建项目

bohr project create -n "my-experiment"
bohr project create -n "my-experiment" -m 5000          # 月度成本限额
bohr project create -n "my-experiment" -t 10000         # 总成本限额

参数说明：

删除项目

bohr project delete 154

警告：删除项目是不可逆操作——该项目下的所有 Jobs 和 Images 将被彻底清除，无法恢复。

角色与权限

Bohrium 项目包含以下 3 类角色：

权限矩阵

重要提示：成员产生的费用将直接从项目 Creator 的账户余额中扣除。

预算管理

项目预算

Creator 和 Admin 可为项目设置总预算（可选）。若未设置，则默认为“无限制”。

当项目累计消费超出预算后，成员将无法提交新 Job 或启动新 Node。

成员预算

可为每位成员单独设定个人支出限额：

• “平均分配”：将项目总预算均分给所有成员
• “统一限额”：为所有成员设定相同的限额
• “手动配置”：为不同成员分别指定不同限额

通过 API 设置项目成本限额：

requests.post(f"{BASE}/set_cost_limit", headers=HEADERS_JSON,
    json={"projectId": 154, "costLimit": 5000})

共享资源

共享磁盘（/share）

每个项目提供 1TB 免费共享存储空间，所有成员均可读写。

• 可通过 Web Shell 或文件管理页面访问 /share 目录
• 数据在 Node 释放后仍持久保留
• 可按需购买额外容量

共享镜像（Shared Images）

所有项目成员均可在 Bohrium 镜像中心查看其他成员创建的自定义镜像，便于开发环境快速共享与复用。

计费说明

• 账户余额每 5 分钟扣减一次
• 余额低于阈值（默认 ¥100）时发送告警邮件
• 余额归零后将无法提交新 Job

配额限制

如需提升配额，请联系 Bohrium 技术支持。

API 补充说明（CLI 不支持的功能）

以下操作暂未集成至 bohr CLI，需调用 API 实现：

import os, requests

AK = os.environ.get("ACCESS_KEY", "")
BASE = "https://open.bohrium.com/openapi/v1/project"
HEADERS = {"accessKey": AK}
HEADERS_JSON = {**HEADERS, "Content-Type": "application/json"}

# 获取详细项目列表（含成本、成员数等字段）
r = requests.get(f"{BASE}/list", headers=HEADERS)
# 返回：{items: [{id, name, totalCost, monthCost, userCount, projectRole, ...}]}

# 获取轻量项目列表（仅 id + name）
r = requests.get(f"{BASE}/lite_list", headers=HEADERS)

# 重命名项目
requests.post(f"{BASE}/set_name", headers=HEADERS_JSON,
    json={"projectId": 154, "name": "new-name"})

# 设置成本限额
requests.post(f"{BASE}/set_cost_limit", headers=HEADERS_JSON,
    json={"projectId": 154, "costLimit": 5000})

# 查看项目成员
r = requests.get(f"{BASE}/154/users", headers=HEADERS)
# 返回：{items: [{userId, userName, email, projectRole, cost, ...}]}

# 添加成员（通过邮箱）
requests.post(f"{BASE}/add_user", headers=HEADERS_JSON,
    json={"projectId": 154, "email": "user@example.com"})

# 移除成员
requests.post(f"{BASE}/del_user", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})

# 提升/降级 Admin 权限
requests.post(f"{BASE}/manager/add", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})
requests.post(f"{BASE}/manager/del", headers=HEADERS_JSON,
    json={"projectId": 154, "userId": 12345})

# 恢复已删除成员
requests.put(f"{BASE}/154/recovery_user", headers=HEADERS_JSON,
    json={"userId": 12345})

项目角色 API 值说明

不可用接口（Unavailable Endpoints）

以下接口无法通过 openapi accessKey 访问（返回 404）：

故障排查