DinoxDinox AI笔记
命令行与 Skills

常见问题

Dinox CLI 和 Dinox Skills 的常见问题:安装报错、登录、同步不及时、标签不存在、AI 助手找不到技能、Windows 写法等。

遇到问题,先跑一次体检,大部分情况它会直接告诉你原因:

dino doctor
dino doctor 体检
哪一项不是 ok,就看对应的说明和 issues 里的建议

安装与升级

安装后一用就报 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 info

dino 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 会在提示里告诉你该运行哪条命令:

标签不存在时的提示
最后一段:Unknown tags,并建议先运行 dino tag add

先建好再重试: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 技能

  1. 确认装到了这个助手的目录(见 安装 Dinox Skills),装完重启助手。
  2. 运行 dino skills doctor,确认每个技能都是 current:
dino skills doctor
当前技能全部与 CLI 版本一致,旧技能都已不在
  1. 说清楚是 Dinox:「在 Dinox 里找……」比「找一下……」更容易触发技能。

AI 用了不存在的参数

多半是技能版本比 CLI 旧(或反过来)。运行 dino skills doctor,按提示重新安装匹配版本;旧版技能用 dino skills migrate --dry-run 预览后清理。

AI 执行写操作前总要问我,能跳过吗?

这是技能内置的安全规则:写入前说明计划,能预演的先预演。你可以在一句话里说明已授权,例如「直接把这三条待办都勾掉,不用再问」,AI 就会按你授权的范围执行。

还没找到答案?在 CLI 更新日志 里看看最近的修复,或者把 dino doctor 的输出(打码账号信息)发给我们。

On this page