安装、登录与升级
用 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 的仓库地址:

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

命令最多等 10 分钟让你在手机上确认。确认后立即返回,第一次完整同步交给后台服务继续完成——所以刚登录时看到 stale: true 是正常的,稍等或运行一次 dino sync 即可。
体检一下
dino doctor
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_TOKENCI 里也可以直接设置环境变量 DINOX_TOKEN,它的优先级高于本地保存的登录。
体检结果给机器看
doctor 也能输出 JSON,适合写进脚本或交给 AI 判断。用 --select 只挑需要的字段:
dino doctor --format json --select healthy,auth.status,sync.status,index.status,daemon.status,db.status,issues
升级
先看看自己是不是最新版:
npm view @dinoxx/dinox-cli version # 最新发布的版本
dino --version # 本机安装的版本不一样时运行:
dino update
升级 CLI 之后,记得把 Skills 也升到同一版本:运行 dino skills doctor,inSync 为 false 时照着它给的 installCommand 重新安装。详见 安装 Dinox Skills。如果 dino update 之后版本号没变,或者提示 Ignored build scripts,直接用上面的 npm install -g … 命令重装。
配置
dino config get 查看当前配置。账号相关的字段(凭据、用户 ID、邮箱)只能看不能改:

最常改的是同步超时 sync.timeoutMs(毫秒):命令在读写前最多等多久让本地数据追上云端。网络慢时可以调大,想让命令快速返回可以调小:
dino config set sync.timeoutMs 20000
dino config get sync.timeoutMs
单条命令也可以临时覆盖:--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。
下一步:笔记:记录与查找。
