메뉴
小米云笔记（i.mi.com）的全功能命令行工具，可读取、创建、更新、删除、移动、置顶笔记，管理文件夹，上传图片，导出与双向同步。当用户提到"小米笔记"、"小米云笔记"、"读写小米笔记"、"创建/更新/删除小米笔记"、"导出/同步小米笔记"、"mi-note-cli"时触发此 skill。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | mi-note-cli |
| description | 小米云笔记（i.mi.com）的全功能命令行工具，可读取、创建、更新、删除、移动、置顶笔记，管理文件夹，上传图片，导出与双向同步。当用户提到"小米笔记"、"小米云笔记"、"读写小米笔记"、"创建/更新/删除小米笔记"、"导出/同步小米笔记"、"mi-note-cli"时触发此 skill。 |
操作小米云服务（i.mi.com）笔记的全功能 CLI。覆盖读、写、文件夹管理、图片上传、导出与双向同步。
--json：所有命令支持 --json，输出 { "ok": true, "data": ... } 或 { "ok": false, "error": "..." }，便于解析。mi-note-cli login。delete 默认会要求确认；脚本调用时加 -y。永久删除需显式 --purge（否则只是移到回收站）。通过 npx 直接执行，无需提前全局安装：
npx mi-note-cli list --json [--folder <id>] [--limit <n>] # 列出笔记
npx mi-note-cli get <id> --json # 查看笔记（转 Markdown）
npx mi-note-cli get <id> --raw # 查看原始 XML
npx mi-note-cli search <关键词> --json [--limit <n>] # 搜索
npx mi-note-cli folders --json # 列出文件夹
# 创建：内容可来自 --content、--file 或 stdin
npx mi-note-cli create --title "标题" --content "# 正文" --json
echo "正文" | npx mi-note-cli create --title "标题" --json
npx mi-note-cli create --file ./note.md --folder <folderId> --json
# 更新：仅传需要改的字段；不传 content 则只改元数据
npx mi-note-cli update <id> --content "新正文" --json
npx mi-note-cli update <id> --title "新标题" --json
# 删除 / 移动 / 置顶
npx mi-note-cli delete <id> -y --json # 移到回收站
npx mi-note-cli delete <id> --purge -y --json # 永久删除
npx mi-note-cli move <id> <folderId> --json
npx mi-note-cli pin <id> --json
npx mi-note-cli unpin <id> --json
npx mi-note-cli folder create "名称" --json [--parent <id>]
npx mi-note-cli folder rename <id> "新名称" --json
npx mi-note-cli folder delete <id> -y --json [--purge]
# 1. 上传图片，得到 fileId 与可嵌入的 Markdown
npx mi-note-cli upload-image ./photo.png --json
# 返回 data.markdown: 
# 2. 把该 Markdown 放进 create/update 的 --content 中即可
npx mi-note-cli export -o <dir> --json # 导出为 Markdown（含附件），永不修改云端
npx mi-note-cli export -f -o <dir> # 强制重新导出
export 只读云端、写本地，适合"只想备份"。本地内容相同则跳过；不回写云端。
与 sync --mode cloud-first 的关键区别：export 无状态文件（不创建 .mi-note-cli.state.json）、不删本地文件（云端删了本地保留）、支持 --force 全量重下。需要持续同步用 sync，需要一次性快照用 export。
npx mi-note-cli sync -o <dir> --mode <mode> --json # 双向同步
npx mi-note-cli sync -o <dir> --dry-run # 只预览计划不执行
npx mi-note-cli sync init # 交互设默认模式
npx mi-note-cli sync status --json # 查看配置与各目录状态
模式 --mode：
cloud-first 云端优先（仅下行，冲突以云端为准）local-first 本地优先（仅上行，冲突以本地为准）two-way 双向自动（真冲突才停）manual（默认）任何不一致都逐条询问基于「上次同步基线 / 云端现状 / 本地现状」三方对比。冲突时：有优先方的模式自动解决；two-way/manual 在非交互环境跳过并报告，绝不擅自删数据（需交互或 -y）。
遇到其他场景，优先 npx mi-note-cli <command> --help 查阅选项（--help 含输出约定、模式说明、示例）。
笔记内容以 Markdown 形式读写，工具自动在 Markdown 与小米自有 XML 间双向转换。支持：标题（#/##/###）、有序/无序列表、复选框（- [ ] / - [x]）、引用（>）、分割线（---）、加粗/斜体/删除线、图片（minote://image/{fileId}）。
执行 delete / folder delete / 会删除数据的 sync 前，必须遵循以下流程：
get <id> --json 获取云端笔记内容，与本地文件做比对，确认是目标待删除笔记。尤其当本地文件名与状态文件记录不一致时，禁止跳过此步骤。-y 执行。永久删除（--purge）需二次确认。绝对禁止：仅凭 subject 相似或时间接近就推断是同一篇笔记并直接删除。
项目根 .mi-note-cli/config.json，可入版控、团队共享。所有字段均可选，缺省使用内置默认值。
syncMode：默认同步模式，默认同步模式，模式含义见上方「同步（双向）」output：默认输出目录，CLI -o 优先；都缺省时落到 .mi-note-cli/output/fileNameTemplate：同步落盘文件名模板（不含 .md 后缀）。缺省等价 ${subject}
${YYYY} ${YY} ${MM} ${DD} ${HH} ${mm} ${ss}（createDate 本地时区分量）、${title}（真实标题，未填即空）、${subject}（带兜底，永远非空）、${id}[...]：方括号内所有 ${var} 都非空才渲染，否则整块丢弃。例：${YYYY}-${MM}-${DD}[_${title}] → 有标题 2026-06-06_工作，无标题 2026-06-06[ ] 用 \[ \] 转义~/Library/Caches/mi-note-cli/（cookie + browser-data/）<output>/.mi-note-cli.state.json，存同步基线（笔记内容哈希、filePath、上次同步云端 modify）；自动生成、跟 output 1:1 绑定、不入版控login⚠️ 如果 CLI 实际行为与本文档有明显差异，说明 skill 版本已落后于 CLI 更新。执行
npx skills update mi-note-cli更新到最新版本，或先通过npx mi-note-cli <command> --help确认当前行为。