命令行与 Skills
同步与后台服务
了解 dino 的本地数据库如何与 Dinox 云端同步,学会手动同步、离线查询、查看后台服务状态,以及用 dino doctor 排查问题。
dino 在你的电脑上保存一份 Dinox 数据的本地副本。读的时候查本地,所以快;写的时候先写本地,再自动上传到云端,手机和其他电脑随后就能看到。负责「一直保持同步」的,是登录后自动安装的后台服务(daemon)。
大多数时候你什么都不用管。本页讲的是:想确认「是不是最新的」时该怎么做,以及出问题时怎么查。
手动同步
dino sync
想确保「真正追平云端」再继续(例如在脚本里),加 --strict:没连上、没下载完、索引没建好都会直接失败,而不是返回旧数据。
每条命令都会先等一下同步
读写命令在执行前,会先等本地数据追上云端,最多等 sync.timeoutMs(见 配置)。几个相关的全局参数:
| 参数 | 作用 |
|---|---|
--offline | 完全不联网,直接查本地(之前至少同步过一次) |
--require-sync | 必须同步成功才执行,否则报错 |
--sync-timeout <毫秒> | 本次命令最多等多久 |
返回结果里的 stale: true 表示「在等待时间内没能追上云端,这是本地已有的数据」。对读来说通常无伤大雅;要确认最新结果时,运行一次 dino sync 再查。
后台服务
dino daemon status
- 登录(
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 里告诉你原因和下一步命令:

| 看到什么 | 说明 | 怎么办 |
|---|---|---|
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 技能排查的真实过程:

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