Skip to content
Dinox AI笔记

⌨️ Dinox CLI 与 Skills

这两个工具分别是什么？

如果你希望在终端里批量管理 Dinox 笔记，或者希望让 AI 助手直接帮你操作笔记库，这两个部分现在已经放在同一个仓库里协作维护：

  • dinox-cli（dino）：命令行工具，直接管理笔记、标签、卡片盒、Prompt 等数据。
  • skills/：给 AI 编码助手（如 Claude Code）使用的技能目录，让助手理解并调用 dino 命令。
dinox-cli 仓库

GitHub 地址（便于直接复制）：

如果你在本机协作开发，当前目录通常是：

  • dinox-cli：/Users/shanks/Documents/GitHub/dinox-cli
  • skills：/Users/shanks/Documents/GitHub/dinox-cli/skills

适合谁使用？

  • 你想在终端快速搜索、创建、整理 Dinox 笔记。
  • 你想把重复操作交给 AI 助手（例如“帮我找最近 7 天的会议笔记”）。
  • 你有批量处理需求（标签整理、卡片盒归档、Prompt 模板维护）。

快速开始（普通用户）

第一步：安装并登录 dinox-cli

  1. 安装 Node.js（建议 LTS，版本 20+）。
  2. 安装 CLI：
Terminal window
npm install -g @dinoxx/dinox-cli
  1. 验证是否安装成功：
Terminal window
dino info
  1. 登录并同步：
Terminal window
dino auth login "<你的Token>"
dino sync

Token 可在 Dinox App 的同步相关设置中获取。

第二步：启用仓库内置 skills（给 Claude Code 使用）

在当前仓库里直接添加：

Terminal window
claude --add-dir /Users/shanks/Documents/GitHub/dinox-cli/skills

对于 AI / 脚本调用，推荐统一使用结构化 JSON 输出：

Terminal window
dino auth status --format json
dino note search "AI" --format json
dino schema note.search --format json

--json 仍然保留，但它返回的是兼容旧行为的 YAML。

如果 AI 助手不确定某个命令接受哪些参数、输出哪些字段，可以先查看命令 schema：

Terminal window
dino schema
dino schema note.search
dino schema todo.update --format json

仓库内置的背景 skill 参考也已经改成由命令 schema 派生，减少 CLI 与 skills 的手工同步成本。

对于支持写操作预览的命令，建议先跑 dry-run：

Terminal window
dino note create --title "Weekly note" --content @/tmp/note.md --format json --dry-run
dino note update <id> --tags "work,ai" --format json --dry-run
dino todo update <taskId> --status completed --format json --dry-run
dino tag add "work/projects" --format json --dry-run
dino box add "Inbox" --format json --dry-run
dino prompt add --name "周报助手" --prompt "请基于本周笔记输出一份简洁周报" --format json --dry-run

如果笔记正文里引用了本地图片、音频、视频或文件路径，请先用 dino storage upload ... --format json 上传，再把 Markdown 改写成远程 URL；不要把本地路径直接写进 Dinox 笔记。

常用操作示例

A. 直接用 dinox-cli（终端命令）

Terminal window
# 搜索笔记
dino note search "AI"


# 最近 7 天
dino note search --days 7


# 创建笔记
dino note create --title "今日复盘" --content "# 今日复盘\n\n- 完成了..."


# 列出标签 / 卡片盒
dino tag list
dino box list

B. 在 Claude Code 里用 skills（斜杠命令）

/search-notes 机器学习
/create-note 今日笔记
/view-note <note-id>
/manage-tags reading/tech
/manage-boxes 项目笔记
/manage-prompts --name 周报助手 --prompt "请基于本周笔记输出一份简洁周报"

也可以直接自然语言提问，例如：

  • “帮我搜索最近一周和项目 A 相关的笔记”
  • “创建一条笔记，标题是《周会纪要》”
  • “列出我所有标签并给出整理建议”

推荐使用流程

  1. 先用 dino 登录并同步，确保本地数据可用。
  2. 再启用仓库内置 skills/，让 AI 助手获得稳定、可复用的操作能力。
  3. 高频动作沉淀为 Prompt，例如周报、复盘、项目总结。

常见问题

1) 提示未登录或缺少用户信息

先执行：

Terminal window
dino auth login "<你的Token>"
dino sync

2) 提示 dino: command not found

说明 CLI 未正确安装或环境变量未生效。可重装并重新打开终端：

Terminal window
npm install -g @dinoxx/dinox-cli

3) AI 助手无法识别 /search-notes 等命令

请确认你已经执行过：

Terminal window
claude --add-dir /Users/shanks/Documents/GitHub/dinox-cli/skills

并在当前 Claude Code 项目中启用了当前仓库的 skills/ 目录。

4) Windows 安装报错：找不到 better_sqlite3.node

在 Windows 上安装后运行 dino 可能出现类似报错：

Could not locate the bindings file. Tried:
 → ...better_sqlite3.node

这是因为 dinox-cli 依赖的 better-sqlite3 是原生模块，需要在本机编译。Windows 默认没有编译工具，导致安装失败。

解决方法：安装 Windows 编译工具链

以管理员身份打开 PowerShell，执行：

Terminal window
npm install --global windows-build-tools

该命令会自动安装 Python 和 Visual Studio Build Tools，安装过程可能需要几分钟。

安装完成后，重新安装 CLI：

Terminal window
npm install -g @dinoxx/dinox-cli

如果仍然报错，可以尝试手动安装 Visual Studio Build Tools，勾选”使用 C++ 的桌面开发”工作负载后重试。