ndb —— NewBeeDebugBridge 工程师端 CLI

远程运维客户机（截图 / 执行命令 / 读文件），默认人类可读，-o json / -c 供脚本与 LLM Agent 解析。

安装

npm i -g @newbeebox/newbeebox-debug-bridge     # 或 npx @newbeebox/newbeebox-debug-bridge ...

服务端地址随包固定，无需配置。请保持最新版：版本过旧时 ndb 会在 stderr 提示一句升级命令（不影响命令执行）。

用法

ndb login --token ndbk_xxx           # token 由服务端管理面板签发，落 ~/.ndb/config.json(600)
ndb connect 81268383                 # 连上并设为当前设备
ndb devices                          # 看清单与状态：device / unauthorized / offline

ndb status                           # 之后的命令默认打在当前设备上
ndb exec -- ipconfig /all
ndb ls   C:\logs
ndb get  C:\logs\app.log --out app.log        # >2MB 自动走资产桶异步下载
ndb upload patch.dll "C:\Program Files\App\"  # 推文件过去（>2MB 走桶，单文件 ≤2GB）
ndb screenshot --window "*.txt" --out shot.png

ndb newbeebox diag                   # 新手盒子排障，这一族全在 `ndb newbeebox <tool>` 下
ndb doc                              # 操作手册：能做什么、按什么顺序用、哪些会动客户机

ndb -s 90011223 status               # 临时打到别的设备
ndb disconnect                       # 用完让出这台机器（--all 全断）

连接码也可以写在命令里：ndb ls 81268383 C:\logs、ndb exec 81268383 -- ipconfig /all。

一台客户机同时只允许一个工程师连接。 已被别人连着时 connect 会直接拒绝并告诉你是谁； 干完请 ndb disconnect 让出来，否则下一个人得等你 15 分钟没动作才接管得了。 ndb status 只读，会报出当前占用者，不会把机器抢过来。

全局选项

| 选项 | 说明 | |------|------| | --token <token> | 覆盖 token（或 ~/.ndb/config.json） | | -s, --serial <code> | 目标设备连接码，覆盖当前设备（同 adb -s） | | -o, --output <fmt> | text(默认) | json | | -c, --compact | 紧凑单行 JSON（隐含 -o json） |

给 LLM Agent

ndb schema -c        # 导出全部命令的 function-calling 友好 schema
ndb <cmd> ... -c     # 结构化调用，输出 { ok, data? , error? }

-o json 输出始终为 { ok: boolean, data?, error?: {code,message} }，退出码与 ok 对应。字段只增不改义。