@dptech-corp/bohr-cli
Bohrium 科学计算平台的命令行工具，可执行文件名为 bohr。
它把科研计算、开发环境、数据资产、论文工具和 AI 科学服务收进一套统一命令。人可以直接在终端中使用，AI Agent 也可以通过稳定、可读、可控的命令接口完成科研任务。
安装
npm install -g @dptech-corp/bohr-cli
支持 macOS、Linux 和 Windows 的 x64 / arm64 环境。安装时只会下载当前平台对应的二进制包。
快速开始
bohr auth login # 登录 Bohrium 账号
bohr doctor # 检查本地配置与服务连接
bohr --help # 查看全部命令
bohr version # 查看当前版本
bohr update # 自更新到最新版（2.6.2 及以上）
所有命令都可以通过分层帮助继续查看子命令和参数：
bohr job --help
bohr sandbox --help
bohr paper --help
bohr agents --help
Agent Ready
让你喜爱的 Agent 快速变身 Bohrium 科研助手。Claude Code、Codex、Kimi Code、ZCode、DSH 等能够执行本地命令的 Agent，都可以直接调用 bohr，从理解科研目标一路走到资源查询、任务执行和结果获取。
- 自主发现能力：Agent 可以从
bohr --help开始，逐级读取命令、子命令和参数，无需预先记住完整用法。 - 稳定的机读结果：
--output json、--output yaml等结构化格式，以及统一的成功与错误结果，便于 Agent 可靠地读取和组合多步操作。 - 错误清晰可恢复：失败会返回非零退出码、标准错误信息和 Request ID，Agent 可以停止错误流程，并根据提示继续排查。
- 自动化仍然可控：身份凭证由本地配置管理；涉及付费资源或破坏性操作时，CLI 会要求明确确认，避免 Agent 在未知情况下产生费用或删除资源。
可以做什么
- 科研计算与开发环境：通过
bohr job、bohr batchjob提交和追踪计算任务，使用bohr node和bohr sandbox创建开发环境、运行程序并查看结果。 - 数据与项目资产：通过
bohr project、bohr dataset、bohr file、bohr image和bohr kb管理项目、数据集、文件、容器镜像与知识库，让计算输入、运行环境和产出保持在同一套工作流中。 - 科学信息检索：通过
bohr paper、bohr scholar、bohr wiki（含科研工具库bohr wiki tools）和bohr database检索论文、专利、学者、科学知识、科研工具与专业数据。 - AI 科学服务：通过
bohr pdf、bohr lkm和bohr agents解析科研文献，使用大知识模型、AI 科学小导师和论文智能体完成检索、分析与研究辅助任务。 - 终端与自动化：统一的身份认证、命令层级、结构化结果和操作确认，方便人工使用，也便于接入脚本、CI 和 AI Agent。
具体能力和参数以 bohr --help 及各级命令的 --help 输出为准。
交给 Agent 的任务示例
把目标直接告诉 Agent，让它自行检查环境、拆解步骤并组合 bohr 命令：
帮我调研机器学习力场的最新进展，筛选代表性论文，解析关键文献，并整理出带来源的研究脉络。
先在云沙箱中验证当前目录里的训练脚本；确认能够运行后，查询合适的 GPU 规格和计费方式，等我确认费用再提交计算任务，并持续跟踪日志直到结果可以下载。
检查这个项目的计算输入，把数据和镜像组织好，创建一批参数扫描任务；提交前汇总资源选择和费用，运行后整理每个任务的状态、失败原因与产出位置。
这些任务可以在 Claude Code、Codex、Kimi Code、ZCode、DSH 或其他命令行 Agent 中使用。同一套 bohr 命令同时服务人工操作和 Agent 自动化，不需要在多个平台入口之间来回切换。
从探索到规模计算
Bohrium CLI 覆盖一条完整的科研工作流。你可以先在本地、开发节点或临时沙箱中调试代码，再把数据集、文件和镜像组织成可复用的计算输入，随后提交单个任务或批处理任务，并在命令行中持续查看状态、日志和结果。
文献研究也可以在同一套命令中完成：从论文、专利和学者检索开始，继续解析 PDF、整理知识库、查询科学百科或专业数据库，再调用 AI 科学服务辅助归纳、分析与推理，减少在多个网站和工具之间反复切换。
计费说明
Bohrium CLI 本身免费开源。计算任务、开发节点和云沙箱等计算资源按实际使用时长计费，部分论文工具与 AI 科学服务按调用计费；部分能力免费或包含免费额度。付费命令执行前会请求确认，不会静默发起扣费操作。
bohr billing pricing # 查看计费项与价格
bohr billing balance # 查询账户余额与 Photon
具体计费方式和价格以 Bohrium CLI 计费说明 为准。
文档
- Bohrium CLI 产品介绍
- Bohrium CLI 使用与帮助文档
- 变更记录：随包附带的
CHANGELOG.md（npm 包页面 Code 标签页内可直接查看）
旧版本升级
从 2.6.0 起，本包改为按平台拆分分发，全局安装体积从约 193 MB 降至约 33 MB。受此影响，2.6.1 及以下版本内置的 bohr update 无法完成自动升级，请手动执行：
npm install -g @dptech-corp/bohr-cli@latest
升级后 bohr version 显示 2.6.2 或更高即成功。若安装缓慢或因镜像源同步延迟拿不到最新版，可指定 npm 官方源：
npm install -g @dptech-corp/bohr-cli@latest --registry https://registry.npmjs.org
升级后 bohr version 显示的还是旧版本号
多半是早先的安装留下了一个可执行文件，并把它所在的目录前置进了 PATH。这种情况下 npm 装的新版拿不到控制权，敲 bohr 跑起来的仍然是旧的那个。npm install -g 现在会在装完时直接提示这件事，并且会把实际挡路的那个路径打出来。
已知有两个来源，处置只差在第 3 步动哪个文件：
| 来源 | 留下的可执行文件 | 写进 PATH 的位置 |
|---|---|---|
| 早期版本 | ~/.bohrium/bohr | rc 文件里的 ~/.bohrium |
| 独立安装脚本（已移除） | ~/.bohr/bin/bohr | rc 文件里的 export PATH="$HOME/.bohr/bin:$PATH" |
手动确认与处理如下。
-
看清实际命中的是哪一个、它是什么版本：
command -v bohr type -a bohr # 按优先级列出 PATH 上全部同名可执行文件 bohr version -
找出把那个目录前置进 PATH 的那几行：
grep -nE '\.bohrium|\.bohr/bin' ~/.zshrc ~/.bash_profile ~/.bashrc ~/.profile 2>/dev/null -
把第 1 步里
command -v bohr报出来的那个文件改名——不是照抄下面的路径，是改你自己那一个：mv "$(command -v bohr)" "$(command -v bohr).legacy"如果它在
~/.bohrium里，不要删掉~/.bohrium整个目录——登录凭据还存在那里，新版是从它迁移过来的。~/.bohr/bin里没有凭据，只有那个可执行文件。 -
刷新 shell 的命令缓存，或者直接新开一个终端：
hash -r # bash rehash # zsh这一步不能省。 bash 会记住上一次解析到的路径；改完名不刷新，下一条
bohr命令会报bash: /Users/you/.bohrium/bohr: No such file or directory（或~/.bohr/bin里的那一个）——指着你刚刚改名的那个文件， 看上去像是把环境弄坏了。 -
复核：
command -v bohr && bohr version
License
MIT © DP Technology