Dinox Skills 1.1.0 更新
Dinox CLI 1.0.22 更新指南
下载地址：
这次从 2026-06-04 到 2026-06-05，Dinox CLI 主要围绕“更可靠的同步、更完整的
笔记整理、更安全的内容编辑、AI Skills 更好安装使用”做了一轮系统升级。新版已
发布到 npm：@dinoxx/dinox-cli@1.0.22。
1. 安装和配置更简单
现在可以直接安装 CLI：
npm install -g @dinoxx/dinox-cli
如果希望让 AI 助手直接使用 Dinox 知识库能力，可以安装 Dinox Skills：
npx skills add ryzencool/dinox-cli-skills -g
登录方式支持两种：
dino auth login "<你的 token>"
或者使用环境变量：
export DINOX_TOKEN="<你的 token>"
DINOX_TOKEN 会优先于本地保存的登录信息，适合临时环境、CI、AI Agent 或不想把
token 持久保存到本机的场景。
2. 同步安全性增强
新增严格同步能力，适合在做“最近 30 天笔记分析”“知识库总结”“批量整理”之前使
用，避免本地数据还没同步完整就开始分析。
dino sync --strict
也可以在查询和分析类命令里要求先确认同步状态：
dino note search --require-sync
这解决了一个关键问题：CLI 是基于本地 PowerSync 数据库读取的，如果本地还没同
步完成，分析结果可能会漏笔记。现在可以显式要求“先同步、再分析”。
3. 卡片盒功能完善
卡片盒现在以 zettel_box 为核心，路径层级是主要语义。新增和完善了这些能力：
dino box tree
dino box stats
dino box rename <old> <new>
dino box move <path> --to <parent>
dino box merge <from> <to>
dino box cleanup --dry-run
普通用户可以用它来：
- 查看完整卡片盒树
- 找出空盒子、重复路径、异常层级
- 重命名盒子并自动更新子层级
- 移动整个盒子分支
- 合并重复盒子
这些写入操作已经按事务方式处理，减少中途失败导致半更新的风险。
4. 标签系统对齐 c_tag_node
标签系统现在只以 c_tag_node 为准，不再依赖旧的 c_tag 表。新增和完善了：
dino tag tree
dino tag stats
dino tag rename <old> <new>
dino tag move <path> --to <parent>
dino tag merge <from> <to>
dino tag suggest
dino tag cleanup --dry-run
其中 tag merge 很重要，适合清理重复语义标签，例如把 AI、ai、人工智能、AIGC
合并到一个统一标签下。
文内 hashtag 和笔记标签也做了对齐处理，尽量保持标签节点 ID 与 c_tag_node.id
一致，减少编辑器、CLI、同步层之间的数据歧义。
5. 笔记整理能力增强
以前 note update 更偏完整替换，现在拆出了更符合用户心智的整理命令。
增量整理标签：
dino note tag <id> --add "AI"
dino note tag <id> --remove "临时"
dino note tag <id> --replace "知识管理,AI"
增量整理卡片盒：
dino note move <id> --add "知识管理/AI"
dino note move <id> --remove "Inbox"
dino note move <id> --replace "长期笔记"
批量整理笔记：
dino note bulk "AI" --tag-add "人工智能" --dry-run
dino note bulk --boxes "Inbox" --box-add "待整理" --dry-run
这里没有开放任意 --sql 批量写入，避免能力过大造成误操作。批量命令走安全过滤
器，并推荐先 --dry-run 预览。
6. 支持笔记导出
新增 Markdown / JSON 导出，方便备份、迁移、二次分析。
dino note export <id> --type markdown --output ./exports
dino note export --ids ids.txt --type json --output ./backup
适合普通用户定期备份，也适合把知识库交给其他工具做分析。
7. 支持结构化编辑正文
新增 note content-read 和 note patch。核心原则是：编辑前必须先读。
dino note content-read <id> --include-content
读取后会返回一个短期 token，之后才能 patch：
dino note patch <id> \
--append-section "新的想法" \
--content "这里是新增内容" \
--read-token "<read-token>"
支持：
- 追加章节
- 追加到某个标题下
- 替换某个章节
- 替换指定 markdown block
对图片、表格、复杂块、未知块做了保护，默认不会轻易覆盖复杂内容，降低误伤笔
记结构的风险。
8. AI Skills 和文档更完整
Dinox Skills 已经整理成更适合 AI Agent 使用的形式。AI 可以通过 Skills 了
解：
- 如何安装 Dinox CLI
- 如何配置 DINOX_TOKEN
- 如何先同步再分析
- 如何搜索、读取、创建、更新、整理笔记
- 如何管理标签、卡片盒、Todo、存储
网站的 CLI 和 Skills 文档也已经更新部署。
9. 技术稳定性提升
这次还做了一些普通用户不一定感知、但很重要的底层优化：
- PowerSync 运行时逻辑统一，减少 note / tag / box / todo 各模块重复处理同步
状态
- 层级创建、移动、合并尽量放入事务，减少半更新
- daemon 命令明确公开：start/status/restart/stop
- 移除旧 MCP 入口，统一走 CLI 原生命令
- 保留复杂 Markdown / diagram 节点，减少内容转换丢失
推荐升级
npm install -g @dinoxx/dinox-cli@latest
dino sync --strict