DinoxDinox AI笔记
命令行与 Skills

安装、登录与升级

用 npm 安装 Dinox CLI,扫码登录你的 Dinox 账号,用 dino doctor 体检,并学会升级和修改配置。

本页带你从零装好 dino:安装 → 扫码登录 → 体检 → 日常升级与配置。全程大约 5 分钟。

案例:在新电脑上装好 dino

确认 Node.js 版本

dino 需要 Node.js 22 到 26(推荐 24 或 26 LTS)。在终端运行 node -v 确认版本。

全局安装 CLI

npm install -g @dinoxx/dinox-cli@latest --allow-scripts=better-sqlite3,sharp

--allow-scripts 让 npm 编译本地数据库(better-sqlite3)和图片处理(sharp)两个依赖。npm 低于 11.16 时去掉这个参数即可。

装好后用 dino --version 和 dino info 确认版本,dino info 还会告诉你配套 Skills 的仓库地址:

node -v、dino --version 和 dino info 的输出
Node v24 + dino 2.20.2,Skills 仓库固定在同版本 tag

扫码登录

dino auth login

终端里会出现一个二维码。打开手机上的 Dinox App,进入 设置 → 设备配对 → 扫一扫,扫码并确认,电脑这边就登录好了。

扫码登录流程示意
终端出二维码 → App 扫码确认 → dino 拿到登录凭据并开始同步

命令最多等 10 分钟让你在手机上确认。确认后立即返回,第一次完整同步交给后台服务继续完成——所以刚登录时看到 stale: true 是正常的,稍等或运行一次 dino sync 即可。

查看登录状态

dino auth status
dino auth status 输出
loggedIn: yes、connected: yes 表示已登录并连上同步服务(账号信息已打码)

体检一下

dino doctor
dino doctor 输出
healthy: yes —— 登录、同步、搜索索引、后台服务、本地数据库都正常

doctor 会逐项检查:auth(登录)、sync(同步,upload_queue=0 表示没有待上传的改动)、index(搜索索引是否和笔记数一致)、daemon(后台服务)、db(本地数据库完整性)。任何一项不是 ok,它会在 issues 里告诉你怎么修。

登录凭据只保存在你的电脑上。不要把 token 贴进聊天框、命令参数或公开日志里,也不要让 AI 助手替你登录——请在你自己的终端里运行 dino auth login。在 Claude Code 里可以输入 ! dino auth login,让命令在你的终端里执行。

在 CI 或服务器上登录

没有屏幕可以扫码时,可以用 API Token。在 Dinox App → 设置 → 同步设置 → API Token 复制 token,然后通过标准输入交给 dino,不在命令行里留下明文:

read -rs DINOX_TOKEN
printf '%s' "$DINOX_TOKEN" | dino auth login --token-stdin
unset DINOX_TOKEN

CI 里也可以直接设置环境变量 DINOX_TOKEN,它的优先级高于本地保存的登录。

体检结果给机器看

doctor 也能输出 JSON,适合写进脚本或交给 AI 判断。用 --select 只挑需要的字段:

dino doctor --format json --select healthy,auth.status,sync.status,index.status,daemon.status,db.status,issues
dino doctor 的 JSON 输出
--format json + --select:只返回关心的字段,issues 为空说明没有问题

升级

先看看自己是不是最新版:

npm view @dinoxx/dinox-cli version   # 最新发布的版本
dino --version                        # 本机安装的版本

不一样时运行:

dino update
查看最新版本和 dino update 帮助
npm 上的最新版与本机版本一致;dino update 会自动识别你用的包管理器

升级 CLI 之后,记得把 Skills 也升到同一版本:运行 dino skills doctor,inSync 为 false 时照着它给的 installCommand 重新安装。详见 安装 Dinox Skills。如果 dino update 之后版本号没变,或者提示 Ignored build scripts,直接用上面的 npm install -g … 命令重装。

配置

dino config get 查看当前配置。账号相关的字段(凭据、用户 ID、邮箱)只能看不能改:

dino config get 输出
config get:auth 区块是登录信息(已打码),sync.timeoutMs 是同步等待上限

最常改的是同步超时 sync.timeoutMs(毫秒):命令在读写前最多等多久让本地数据追上云端。网络慢时可以调大,想让命令快速返回可以调小:

dino config set sync.timeoutMs 20000
dino config get sync.timeoutMs
设置并读取 sync.timeoutMs
把同步等待上限改成 20 秒

单条命令也可以临时覆盖:--sync-timeout 20000;或者设置环境变量 DINOX_SYNC_TIMEOUT_MS。

配置和数据放在哪里

系统配置文件本地数据
macOS~/Library/Application Support/dinox/config.json~/Library/Application Support/dinox/
Windows%APPDATA%\dinox\config.json%LOCALAPPDATA%\dinox\
Linux~/.config/dinox/config.json~/.local/share/dinox/

需要换位置时,设置 DINOX_CONFIG_DIR / DINOX_DATA_DIR。

下一步:笔记:记录与查找。

On this page