技能介绍

要解决什么问题

inBox 是本地优先、通过 S3/WebDAV 同步的笔记应用。Agent 若只能「让用户自己打开 App」，就无法在对话里查笔记、搜关键词、按盒子整理或写入一条速记。本技能把 gudong-inbox CLI 封装成可编排流程：读操作直接查 stdout 的 JSON，写操作则受明确的安全约束，避免误改云端真实数据。

技能如何工作

使用前先做前置检查（CLI 是否安装、~/.gudong-inbox/config.json 或环境变量是否就绪）。日常读路径通常是：

gudong-inbox list：按 updated_at/created_at 与时间窗口（如上海时区「今天」用 --since 带 +08:00）拉摘要，含约 200 字预览
gudong-inbox search --query：在标题、正文、标签里检索，比盲扫 list 更灵活
gudong-inbox read --id：用 20 位 hex 的 id 拉全文；绝不猜测 id，一律来自 list/search

盒子与标签：tags、boxes 用于盘点；box create/update/delete 会同步到云端。创建笔记时只有显式传 --box 才会进盒子，不传则笔记保持无盒子（不会悄悄写入历史默认盒名）。

写入类命令（create/update/delete 及盒子增删改）必须两阶段确认：先向用户展示将要改动的字段与预览，用户明确同意后再执行 CLI。删除为软删除（is_removed），可在 App 回收站恢复；update 为部分字段更新。

适用边界与注意点

所有成功输出为 JSON（exit 0），失败在 stderr（exit 1）；笔记量大时首次读取可能较慢，之后有缓存。
遇 ConflictError 表示他端已改笔记，需重新 read 再更新。
旧版仅 content.box、无 boxes.json 时，boxes 可能返回 is_legacy: true 的虚拟盒子，不能对其 update/delete。
一次只操作一条笔记，删除前应先 read 让用户看清内容。