DinoxDinox AI笔记
命令行与 Skills

同步与后台服务

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

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

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

手动同步

dino sync
dino sync 输出
同步完成:本地数据库位置、最后同步时间、搜索索引状态

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

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

读写命令在执行前,会先等本地数据追上云端,最多等 sync.timeoutMs(见 配置)。几个相关的全局参数:

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

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

后台服务

dino daemon status
dino daemon status 输出
Running:通过本机私有 socket 通信,由 launchd 托管,版本与 CLI 一致
  • 登录(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 表示本地改动都已上传
看到什么说明怎么办
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 看上传队列和索引,再做一次严格同步,确认本地数据已是最新

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

On this page