常见问题
Dinox CLI 和 Dinox Skills 的常见问题:安装报错、登录、同步不及时、标签不存在、AI 助手找不到技能、Windows 写法等。
遇到问题,先跑一次体检,大部分情况它会直接告诉你原因:
dino doctor
安装与升级
安装后一用就报 better-sqlite3,或提示 Ignored build scripts
本地数据库依赖 better-sqlite3,图片处理依赖 sharp。新版 npm(11.16+)和 pnpm(10.15+)默认不运行它们的安装脚本。确认 Node.js 是 22 到 26,然后重新安装:
node -v
npm install -g @dinoxx/dinox-cli@latest --allow-scripts=better-sqlite3,sharp
dino infodino update 之后版本号没变
直接用上面的 npm install -g … 命令重装。用 npm view @dinoxx/dinox-cli version 看最新版本,dino --version 看本机版本:

登录
扫码没反应 / App 提示二维码无效
先把 Dinox App 升级到最新版,再在 设置 → 设备配对 → 扫一扫 里扫码。dino auth login 最多等 10 分钟,超时了重新运行即可。
报错 Missing resolved userId for the current authorization
还没完成登录,或者环境变量 DINOX_TOKEN 覆盖了本地登录。在自己的终端运行 dino auth login 扫码;用 token 的话确认它有效后运行一次 dino sync。
能让 AI 助手帮我登录吗?
不行,也不应该。登录凭据不要贴进任何聊天框。在 Claude Code 里可以输入 ! dino auth login,命令会在你自己的终端里运行。
同步
手机上刚记的笔记,电脑上查不到
运行 dino sync 再查。查询结果里 stale: true 表示这次没等到云端的最新数据。长期如此,跑 dino doctor 看 sync 和 daemon 两项,见 同步与后台服务。
能完全离线用吗?
可以。只要之前成功同步过一次,读命令加 --offline 就直接查本地,例如 dino note search 日报 --offline。
dino doctor 里 upload_queue 一直不是 0
有本地改动传不上去。先确认网络,再运行 dino sync。如果一直降不下来,把 dino doctor --format json 的结果(不含账号信息)反馈给我们。
命令用法
报 Unknown tags 或 Unknown zettel box names
你引用的标签或文件夹还不存在。dino 会在提示里告诉你该运行哪条命令:

先建好再重试:dino tag add "你的标签"、dino box add --name "你的文件夹" --color "#bbf7d0"。
note update 把我原来的标签弄没了
note update --tags 是整体替换。追加或去掉单个标签请用 dino note tag <ID> --add … / --remove …;文件夹用 dino note move。
todo append 不写 --note-id 会加到哪?
加到今天的每日待办笔记里(没有会自动创建)。想加到某个清单,显式写 --note-id。
怎么知道一个命令支持哪些参数?
dino <命令> --help 看说明,dino schema <命令路径> 看结构化定义,例如 dino schema note.search。
Windows 下 @文件 不生效、多行命令报错
PowerShell 里把 @路径 放进引号:--content "@.\note.md";多行命令用反引号续行,而不是反斜杠。
Skills 与 AI 助手
AI 助手好像没用上 Dinox 技能
- 确认装到了这个助手的目录(见 安装 Dinox Skills),装完重启助手。
- 运行
dino skills doctor,确认每个技能都是current:

- 说清楚是 Dinox:「在 Dinox 里找……」比「找一下……」更容易触发技能。
AI 用了不存在的参数
多半是技能版本比 CLI 旧(或反过来)。运行 dino skills doctor,按提示重新安装匹配版本;旧版技能用 dino skills migrate --dry-run 预览后清理。
AI 执行写操作前总要问我,能跳过吗?
这是技能内置的安全规则:写入前说明计划,能预演的先预演。你可以在一句话里说明已授权,例如「直接把这三条待办都勾掉,不用再问」,AI 就会按你授权的范围执行。
还没找到答案?在 CLI 更新日志 里看看最近的修复,或者把 dino doctor 的输出(打码账号信息)发给我们。