@dptech-corp/bohr-cli 2.6.48 → 2.6.49

package/CHANGELOG.md

@@ -16,6 +16,35 @@
 
 ## [Unreleased]
 
+## [2.6.49] - 2026-08-25
+
+### Breaking
+
+- **`sandbox image list` 改列制品目录**：九个筛选/分页 flag 移除，只剩 `--type`；单个构建仍可 `image get`/`buildlog` 查，按条件筛构建任务暂无替代。**随 2.6.47 已发出**，当时漏记。
+
+### Added
+
+- **新增内嵌 `bohr-mentor` Skill**：提供与当前 CLI 一致的科学问答、计费确认和失败重试边界指引。
+- **新增内嵌 `bohr-pdf-parse` Skill**：提供 PDF 提交、按页计费、异步结果与结构化输出指引。
+- **补齐独立 Bohrium Skill 的 CLI 内嵌覆盖**：新增其余 12 个命令域的版本锁定指引。
+- **新增内嵌 `bohr-scimaster` Skill**：覆盖论文深搜、稿件评审、异步等待与报告下载，当前共 20 个 Skill。
+
+### Changed
+
+- **`lkm parse result` 新增结果格式选择**：支持 `--format local|graph`，首次成功按 1 元/缓存 0.1 元确认计费。
+- **公开模板不再与额外临时存储互斥**：`--visibility 1` 也能带 `--extra-ephemeral-storage-gb`，只按配额判。**随 2.6.47 已发出**，当时漏记。
+
+### Fixed
+
+- **上游报错时不再丢掉限流/计费/废弃提示**：`{"code":非零}` 形态的失败此前把响应头带的 notice 整体丢弃，429 也看不到限流提示。另修 notice 无期限时渲染成 `(deadline: )`。
+- **修复 KB 与 Scholar 分页参数**：`--page/--size` 现使用上游真实字段，不再静默回退默认分页。
+- **补齐 SciMaster wait 与 Image list 输出上限**：新增本地 `--limit` 并保证机读结果不超限。
+- **澄清 `--jq` 能力**：帮助明确其为字段/数组路径过滤器，不再暗示支持完整 jq 语言。
+
+### Deprecated
+
+- **`bohr sandbox image` 整组标记废弃**：人读模式 stderr 告警，`-o json` 在 `notice.deprecation` 里给出替代命令；功能不变，后续版本移除。
+
 ## [2.6.48] - 2026-08-25
 
 ### Added

package/README.md

@@ -2,44 +2,103 @@
 
 Bohrium 科学计算平台的命令行工具，可执行文件名为 `bohr`。
 
-## ⚠️ 2.6.1 及以下版本用户请手动升级一次
+它把科研计算、开发环境、数据资产、论文工具和 AI 科学服务收进一套统一命令。人可以直接在终端中使用，AI Agent 也可以通过稳定、可读、可控的命令接口完成科研任务。
 
-从 2.6.0 起，本包改为按平台拆分分发（全局安装体积从约 193MB 降至约 33MB）。受此影响，**2.6.1 及以下版本内置的 `bohr update` 无法完成自动升级**（会报错退出，不影响已装版本的正常使用）。请执行一次手动升级：
+## 安装
 
 ```bash
-npm install -g @dptech-corp/bohr-cli@latest
+npm install -g @dptech-corp/bohr-cli
 ```
 
-升级后 `bohr version` 显示 2.6.2 或更高即成功。2.6.2 起自更新已适配新包结构，后续版本可继续用 `bohr update` 升级。
+支持 macOS、Linux 和 Windows 的 x64 / arm64 环境。安装时只会下载当前平台对应的二进制包。
 
-如安装缓慢或拿不到最新版（镜像源同步延迟），可指定官方源：
+## 快速开始
 
 ```bash
-npm install -g @dptech-corp/bohr-cli@latest --registry https://registry.npmjs.org
+bohr auth login    # 登录 Bohrium 账号
+bohr doctor        # 检查本地配置与服务连接
+bohr --help        # 查看全部命令
+bohr version       # 查看当前版本
+bohr update        # 自更新到最新版（2.6.2 及以上）
 ```
 
-## 安装
+所有命令都可以通过分层帮助继续查看子命令和参数：
 
 ```bash
-npm install -g @dptech-corp/bohr-cli
+bohr job --help
+bohr sandbox --help
+bohr paper --help
+bohr agents --help
 ```
 
-支持 macOS / Linux / Windows 的 x64 与 arm64。安装时通过 `optionalDependencies` 只下载当前平台对应的二进制子包。
+## 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 database` 和 `bohr tools` 检索论文、专利、学者、科学知识与专业数据。
+- **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 auth login    # 登录 Bohrium 账号
-bohr --help        # 查看全部命令
-bohr version       # 查看当前版本
-bohr update        # 自更新到最新版（2.6.2 及以上）
+bohr billing pricing    # 查看计费项与价格
+bohr billing balance    # 查询账户余额与 Photon
 ```
 
-## 文档与变更记录
+具体计费方式和价格以 [Bohrium CLI 计费说明](https://docs.bohrium.com/docs/bohrctl/pricing) 为准。
 
-- 使用文档：https://docs.bohrium.com
+## 文档
+
+- [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
+```
+
 ## License
 
 MIT © DP Technology

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dptech-corp/bohr-cli",
-  "version": "2.6.48",
+  "version": "2.6.49",
   "description": "CLI tool for Bohrium scientific computing platform",
   "bin": {
     "bohr": "run.js"
@@ -32,11 +32,11 @@
     "CHANGELOG.md"
   ],
   "optionalDependencies": {
-    "@dptech-corp/bohr-cli-darwin-arm64": "2.6.48",
-    "@dptech-corp/bohr-cli-darwin-amd64": "2.6.48",
-    "@dptech-corp/bohr-cli-linux-amd64": "2.6.48",
-    "@dptech-corp/bohr-cli-linux-arm64": "2.6.48",
-    "@dptech-corp/bohr-cli-windows-amd64": "2.6.48",
-    "@dptech-corp/bohr-cli-windows-arm64": "2.6.48"
+    "@dptech-corp/bohr-cli-darwin-arm64": "2.6.49",
+    "@dptech-corp/bohr-cli-darwin-amd64": "2.6.49",
+    "@dptech-corp/bohr-cli-linux-amd64": "2.6.49",
+    "@dptech-corp/bohr-cli-linux-arm64": "2.6.49",
+    "@dptech-corp/bohr-cli-windows-amd64": "2.6.49",
+    "@dptech-corp/bohr-cli-windows-arm64": "2.6.49"
   }
 }