小米云笔记 CLI
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_35ebe43a/mi-note-cli。
技能介绍
问题在哪
小米云笔记平时在 i.mi.com 或客户端里用,但一旦要在终端里批量读笔记、把 Markdown 仓库和云端对齐,或者给 Agent 写可解析的自动化脚本,网页操作就不够用。你需要的是稳定、可脚本化的接口,而不是反复点界面。
这个 CLI 怎么干活
mi-note-cli 覆盖小米云笔记的读、写、文件夹管理、图片上传、单向导出与双向同步。习惯上可以把它当成「带格式转换的远程文件系统」:笔记以 Markdown 读写,工具在 Markdown 与小米自有 XML 之间自动转换,支持标题、列表、复选框、引用、图片(minote://image/{fileId})等。
面向自动化有两条硬约定:始终加 --json,输出 { "ok": true, "data": ... } 或错误对象;未登录时在非交互环境会直接失败,不会卡浏览器,需先执行 mi-note-cli login。delete 默认要确认,脚本里用 -y;永久删除必须显式 --purge。
同步靠 .mi-note-cli.state.json 记录基线,在「上次同步 / 云端现状 / 本地现状」三方对比。--mode 可选 cloud-first、local-first、two-way、manual(默认逐条询问)。export 只做云→本地快照:无状态文件、云端删了本地仍保留,适合备份;持续对齐用 sync。项目根可放 .mi-note-cli/config.json 配置默认同步模式、输出目录和 fileNameTemplate。
边界与注意
回收站列表与恢复没有公开 API,删了只能去网页 30 天内恢复;私密笔记、待办独立类型、思维导图无稳定写接口;用户标签体系也不存在。Agent 执行删除前应按文档做身份比对与确认,禁止仅凭标题相似就删笔记。Cookie 短效 token 通常会静默续期,长效登录失效才需重新 login。
使用场景
- 把 i.mi.com 上的工作笔记定期拉到本地 Git 仓库,用 export 做无状态全量或增量备份
- 本地写完 Markdown 后要用 local-first 同步只上行,避免云端旧稿覆盖刚改的版本
- 在 CI 或非交互环境里用 --json 列出文件夹、按 ID get 笔记内容给下游脚本解析
- 冲突多、不能自动删数据时,用 manual 或 two-way 模式跑 sync,在非交互下只报告跳过项
适合人员
- 维护个人知识库、想把小米云笔记和本地 Markdown 目录长期对齐的工程师
- 写自动化脚本、需要从云端批量读取笔记标题与正文并处理图片引用的后端开发
- 团队协作中通过共享 .mi-note-cli/config.json 统一落盘路径和 fileNameTemplate 的同学
- 让 AI Agent 代管云笔记、又要求删除前必须比对 ID 与内容摘要的运维或个人用户