# 安装、登录与升级

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

- 网页：https://dinox.info/guides/cli/install
- 本页 Markdown：https://dinox.info/guides/cli/install.md
- 全部文档索引：https://dinox.info/llms.txt

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

## 案例：在新电脑上装好 dino

### 第 1 步：确认 Node.js 版本

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

### 第 2 步：全局安装 CLI

```bash
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）](https://dinox.info/assets/docs/cli/install-version.webp)

### 第 3 步：扫码登录

```bash
dino auth login
```

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

![截图：扫码登录流程示意（终端出二维码 → App 扫码确认 → dino 拿到登录凭据并开始同步）](https://dinox.info/assets/docs/cli/diagram-login.webp)

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

### 第 4 步：查看登录状态

```bash
dino auth status
```

![截图：dino auth status 输出（loggedIn: yes、connected: yes 表示已登录并连上同步服务（账号信息已打码））](https://dinox.info/assets/docs/cli/auth-status.webp)

### 第 5 步：体检一下

```bash
dino doctor
```

![截图：dino doctor 输出（healthy: yes —— 登录、同步、搜索索引、后台服务、本地数据库都正常）](https://dinox.info/assets/docs/cli/doctor.webp)

`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`，不在命令行里留下明文：

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

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

## 体检结果给机器看

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

```bash
dino doctor --format json --select healthy,auth.status,sync.status,index.status,daemon.status,db.status,issues
```

![截图：dino doctor 的 JSON 输出（--format json + --select：只返回关心的字段，issues 为空说明没有问题）](https://dinox.info/assets/docs/cli/doctor-json.webp)

## 升级

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

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

不一样时运行：

```bash
dino update
```

![截图：查看最新版本和 dino update 帮助（npm 上的最新版与本机版本一致；dino update 会自动识别你用的包管理器）](https://dinox.info/assets/docs/cli/update-help.webp)

> **提示**
> 升级 CLI 之后，记得把 Skills 也升到同一版本：运行 `dino skills doctor`，`inSync` 为 false 时照着它给的 `installCommand` 重新安装。详见 [安装 Dinox Skills](https://dinox.info/guides/cli/skills.md)。如果 `dino update` 之后版本号没变，或者提示 `Ignored build scripts`，直接用上面的 `npm install -g …` 命令重装。

## 配置

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

![截图：dino config get 输出（config get：auth 区块是登录信息（已打码），sync.timeoutMs 是同步等待上限）](https://dinox.info/assets/docs/cli/config.webp)

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

```bash
dino config set sync.timeoutMs 20000
dino config get sync.timeoutMs
```

![截图：设置并读取 sync.timeoutMs（把同步等待上限改成 20 秒）](https://dinox.info/assets/docs/cli/config-set.webp)

单条命令也可以临时覆盖：`--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`。

下一步：[笔记：记录与查找](https://dinox.info/guides/cli/notes.md)。