Skip to content
Dinox AI笔记

⌨️ Dinox CLI 与 Skills

这两个工具分别是什么？

如果你希望在终端里批量管理 Dinox 笔记，或者希望让 AI 助手直接帮你操作笔记库，这两个工具可以配合使用：

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

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

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

  • dinox-cli：/Users/shanks/Documents/GitHub/dinox-cli
  • 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 "Bearer <你的Token>"
dino sync

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

第二步：安装 dinox-cli-skills（给 Claude Code 使用）

如果你本机已经有 skills 仓库目录，可直接添加：

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

如果你还没有仓库目录：

Terminal window
git clone https://github.com/ryzencool/dinox-cli-skills.git
claude --add-dir ./dinox-cli-skills

常用操作示例

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 周报助手 --cmd "请基于本周笔记输出一份简洁周报"

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

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

推荐使用流程

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

常见问题

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

先执行：

Terminal window
dino auth login "Bearer <你的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 项目中启用了该技能目录。

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++ 的桌面开发”工作负载后重试。