# 同步与后台服务

> 了解 dino 的本地数据库如何与 Dinox 云端同步，学会手动同步、离线查询、查看后台服务状态，以及用 dino doctor 排查问题。

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

`dino` 在你的电脑上保存一份 Dinox 数据的本地副本。读的时候查本地，所以快；写的时候先写本地，再自动上传到云端，手机和其他电脑随后就能看到。负责「一直保持同步」的，是登录后自动安装的**后台服务**（daemon）。

大多数时候你什么都不用管。本页讲的是：想确认「是不是最新的」时该怎么做，以及出问题时怎么查。

## 手动同步

```bash
dino sync
```

![截图：dino sync 输出（同步完成：本地数据库位置、最后同步时间、搜索索引状态）](https://dinox.info/assets/docs/cli/sync.webp)

想确保「真正追平云端」再继续（例如在脚本里），加 `--strict`：没连上、没下载完、索引没建好都会直接失败，而不是返回旧数据。

### 每条命令都会先等一下同步

读写命令在执行前，会先等本地数据追上云端，最多等 `sync.timeoutMs`（见 [配置](https://dinox.info/guides/cli/install.md)）。几个相关的全局参数：

| 参数                    | 作用                     |
| --------------------- | ---------------------- |
| `--offline`           | 完全不联网，直接查本地（之前至少同步过一次） |
| `--require-sync`      | 必须同步成功才执行，否则报错         |
| `--sync-timeout <毫秒>` | 本次命令最多等多久              |

返回结果里的 `stale: true` 表示「在等待时间内没能追上云端，这是本地已有的数据」。对读来说通常无伤大雅；要确认最新结果时，运行一次 `dino sync` 再查。

## 后台服务

```bash
dino daemon status
```

![截图：dino daemon status 输出（Running：通过本机私有 socket 通信，由 launchd 托管，版本与 CLI 一致）](https://dinox.info/assets/docs/cli/daemon-status.webp)

* 登录（`dino auth login`）或添加 Gateway 后，`dino` 会自动把它安装为登录服务：macOS 用 launchd，Linux 用 systemd，Windows 用计划任务。电脑重启后它会自动起来。
* 它只通过你电脑上的私有 socket（Windows 是命名管道）通信，不监听网络端口。
* 常用命令：`dino daemon restart`（重启）、`dino daemon stop`（停止）、`dino daemon install` / `uninstall`（安装 / 移除登录服务）。

> **提示**
> 不想让 `dino` 自动安装后台服务？设置环境变量 `DINOX_DAEMON_AUTO_INSTALL=0`。没有后台服务时 `dino` 照样能用，只是每条命令都要自己连接和同步，会慢一些。

## 出问题时：dino doctor

`dino doctor` 一次检查所有环节，有问题时在 `issues` 里告诉你原因和下一步命令：

![截图：dino doctor 体检（auth / sync / index / daemon / db 全部 ok；upload_queue=0 表示本地改动都已上传）](https://dinox.info/assets/docs/cli/doctor.webp)

| 看到什么                   | 说明           | 怎么办                                        |
| ---------------------- | ------------ | ------------------------------------------ |
| `upload_queue` 一直大于 0  | 有本地改动传不上去    | 检查网络后 `dino sync`；长时间不降，把 `doctor` 结果反馈给我们 |
| `index` 的 `drift` 不为 0 | 搜索索引和笔记数对不上  | 运行 `dino sync`，会自动补建索引                     |
| `daemon` 不是 ok         | 后台服务没在跑或版本不对 | `dino daemon restart`                      |
| `auth` 不是 ok           | 登录失效         | 在自己的终端运行 `dino auth login`                 |

## 交给 AI 助手

「电脑上看不到手机刚记的笔记」——这种问题直接问 AI 助手就行。下面是 Claude Code 用 `dino-sync` 技能排查的真实过程：

![截图：Claude Code 排查同步问题（先跑 doctor 看上传队列和索引，再做一次严格同步，确认本地数据已是最新）](https://dinox.info/assets/docs/cli/chat-health.webp)

> **提示**
> AI 助手遇到 `stale: true` 或超时时，会把结果当作「不确定」，先核实再决定要不要重试，而不是贸然再写一次——这是 Dinox Skills 内置的安全规则。