# @dptech-corp/bohr-cli 中文文档

规范地址：https://npmcn.com/package/%40dptech-corp/bohr-cli/

版本：2\.9\.41
npm 元数据更新时间：2026-11-13T03:14:00.674Z
中文译文更新时间：2026-11-12T18:54:23.079Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dptech-corp/bohr-cli
原文对照：https://npmcn.com/package/%40dptech-corp/bohr-cli/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：280 kB，5 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-10T04:25:13.157Z
- 最新版本发布：2026-11-13T03:14:00.492Z
- 近 30 天下载量：14748（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：263（近 12 个月 263 个）

## 中文简介

Bohrium 科学计算平台的 CLI 工具

## 安装

```sh
npm install @dptech-corp/bohr-cli
```

也可以使用：`pnpm add @dptech-corp/bohr-cli`、`yarn add @dptech-corp/bohr-cli`、`bun add @dptech-corp/bohr-cli`

## README

# @dptech-corp/bohr-cli

Bohrium 科学计算平台的命令行工具，可执行文件名为 `bohr`。

它把科研计算、开发环境、数据资产、论文工具和 AI 科学服务收进一套统一命令。人可以直接在终端中使用，AI Agent 也可以通过稳定、可读、可控的命令接口完成科研任务。

## 安装

```bash
npm install -g @dptech-corp/bohr-cli
```

支持 macOS、Linux 和 Windows 的 x64 / arm64 环境。安装时只会下载当前平台对应的二进制包。

## 快速开始

```bash
bohr auth login    # 登录 Bohrium 账号
bohr doctor        # 检查本地配置与服务连接
bohr --help        # 查看全部命令
bohr version       # 查看当前版本
bohr update        # 自更新到最新版（2.6.2 及以上）
```

所有命令都可以通过分层帮助继续查看子命令和参数：

```bash
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 科学服务按调用计费；部分能力免费或包含免费额度。付费命令执行前会请求确认，不会静默发起扣费操作。

```bash
bohr billing pricing    # 查看计费项与价格
bohr billing balance    # 查询账户余额与 Photon
```

具体计费方式和价格以 [Bohrium CLI 计费说明](https://docs.bohrium.com/docs/bohrctl/pricing) 为准。

## 文档

-   [Bohrium CLI 产品介绍](https://www.bohrium.com/bohr-cli/intro)
-   [Bohrium CLI 使用与帮助文档](https://docs.bohrium.com/docs/bohrctl/about)
-   变更记录：随包附带的 `CHANGELOG.md`（npm 包页面 Code 标签页内可直接查看）

## 旧版本升级

从 2.6.0 起，本包改为按平台拆分分发，全局安装体积从约 193 MB 降至约 33 MB。受此影响，2.6.1 及以下版本内置的 `bohr update` 无法完成自动升级，请手动执行：

```bash
npm install -g @dptech-corp/bohr-cli@latest
```

升级后 `bohr version` 显示 2.6.2 或更高即成功。若安装缓慢或因镜像源同步延迟拿不到最新版，可指定 npm 官方源：

```bash
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"` |

手动确认与处理如下。

1.  看清实际命中的是哪一个、它是什么版本：
    
    ```bash
    command -v bohr
    type -a bohr        # 按优先级列出 PATH 上全部同名可执行文件
    bohr version
    ```
    
2.  找出把那个目录前置进 PATH 的那几行：
    
    ```bash
    grep -nE '\.bohrium|\.bohr/bin' ~/.zshrc ~/.bash_profile ~/.bashrc ~/.profile 2>/dev/null
    ```
    
3.  把第 1 步里 `command -v bohr` 报出来的**那个文件**改名——不是照抄下面的路径，是改你自己那一个：
    
    ```bash
    mv "$(command -v bohr)" "$(command -v bohr).legacy"
    ```
    
    如果它在 `~/.bohrium` 里，**不要删掉 `~/.bohrium` 整个目录**——登录凭据还存在那里，新版是从它迁移过来的。`~/.bohr/bin` 里没有凭据，只有那个可执行文件。
    
4.  刷新 shell 的命令缓存，或者直接新开一个终端：
    
    ```bash
    hash -r     # bash
    rehash      # zsh
    ```
    
    **这一步不能省。** bash 会记住上一次解析到的路径；改完名不刷新，下一条 `bohr` 命令会报 `bash: /Users/you/.bohrium/bohr: No such file or directory`（或 `~/.bohr/bin` 里的那一个）——指着你刚刚改名的那个文件， 看上去像是把环境弄坏了。
    
5.  复核：
    
    ```bash
    command -v bohr && bohr version
    ```
    

## License

MIT © DP Technology

## 常见问题

### @dptech-corp/bohr-cli 是什么？

Bohrium 科学计算平台的 CLI 工具

### 如何安装 @dptech-corp/bohr-cli？

在项目目录运行 npm install @dptech-corp/bohr-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bohr，可以用 npx bohr 直接运行。

### @dptech-corp/bohr-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dptech-corp\_\_bohr-cli 是否存在。

### @dptech-corp/bohr-cli 可以商用吗？

@dptech-corp/bohr-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dptech-corp/bohr-cli 的下载量有多少？

根据 npm 官方下载统计，@dptech-corp/bohr-cli 在 2026/10/13 – 2026/11/11 这 30 天内被下载 14,748 次，日均约 492 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dptech-corp/bohr-cli 还在维护吗？

最新版本 2\.9\.41 发布于 2026/11/13（今天）；至今共发布 263 个版本，其中过去 12 个月发布了 263 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。