技能介绍

要解决什么问题

在对话里整理资料时，你往往希望按标题找到某篇笔记、浏览某个笔记本里的列表，或把 Markdown 写回 IMA，而不是只在本地临时记一段。IMA 客户端能完成这些操作，但 Agent 需要一套稳定的 HTTP 约定：note_id、folder_id、统一 POST JSON，以及导出时先拿签名 URL 再二次下载。

本技能把 IMA OpenAPI 的读写与笔记本管理串成可执行流程，并明确哪些场景应交给 Search/Fetch，哪些才走笔记 API。

技能如何工作

读取：search_note 按标题定位笔记（拿 note_id 与笔记本归属）；list_note 按 folder_id 浏览列表（不传则查全部）；export_note 导出原文到 workspace（content_url → 再 curl 下载，格式由 target_content_format 决定）。
写入：import_doc 新建；append_doc 向已有笔记追加短内容；push_note 在「不确定是否已有笔记」时新建或追加，长内容可走 ima_cos_util + content_cos_key。
笔记本：list_notebook（用户自建取 folder_type=0）、add_notebook、rename_notebook、move_notes 批量移动。
展示约定：对用户只谈笔记标题，不暴露内部 ID；写入时 content_format 固定为 1（Markdown）。

典型串联：先 list_notebook 拿 folder_id，长文写 .md → COS 上传 → push_note，必要时 move_notes 归入目标笔记本。

边界与注意点

按正文搜、直接读全文：优先用 Search / Fetch；本技能读取侧重标题定位、列表浏览与导出 fallback。
无删除 API：删笔记或笔记本只能在 IMA 客户端操作，不要构造删除请求。
写入不可逆：创建、追加、推送前若非用户明确要求，应先确认；常见错误如 210005（非作者）、210009（内容过大需拆分）需给出原因与建议。
翻页不统一：list_notebook 首页 cursor 为 "0"，list_note 首页为空字符串，search_note 用 start/end；不要把 folder_id 传成 "0"。