# 常见问题

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

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

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

```bash
dino doctor
```

![截图：dino doctor 体检（哪一项不是 ok，就看对应的说明和 issues 里的建议）](https://dinox.info/assets/docs/cli/doctor.webp)

## 安装与升级

### 安装后一用就报 better-sqlite3，或提示 Ignored build scripts

本地数据库依赖 `better-sqlite3`，图片处理依赖 `sharp`。新版 npm（11.16+）和 pnpm（10.15+）默认不运行它们的安装脚本。确认 Node.js 是 22 到 26，然后重新安装：

```bash
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` 看本机版本：

![截图：对比最新版本和本机版本（两个版本号一致，就是最新版）](https://dinox.info/assets/docs/cli/update-help.webp)

## 登录

### 扫码没反应 / 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` 两项，见 [同步与后台服务](https://dinox.info/guides/cli/sync-and-daemon.md)。

### 能完全离线用吗？

可以。只要之前成功同步过一次，读命令加 `--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）](https://dinox.info/assets/docs/cli/usage-error.webp)

先建好再重试：`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](https://dinox.info/guides/cli/skills.md)），装完重启助手。
2. 运行 `dino skills doctor`，确认每个技能都是 `current`：

![截图：dino skills doctor（当前技能全部与 CLI 版本一致，旧技能都已不在）](https://dinox.info/assets/docs/cli/skills-doctor.webp)

3. 说清楚是 Dinox：「在 Dinox 里找……」比「找一下……」更容易触发技能。

### AI 用了不存在的参数

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

### AI 执行写操作前总要问我，能跳过吗？

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

> **提示**
> 还没找到答案？在 [CLI 更新日志](https://dinox.info/guides/changelog/cli.md) 里看看最近的修复，或者把 `dino doctor` 的输出（打码账号信息）发给我们。