↑

IMA 笔记管理v1.0.0

ima-skills-skillhub-notes13 KB

通过 IMA OpenAPI 操作用户个人笔记,支持搜索查找、列表浏览、读取正文,以及新建笔记、追加内容、插入图片等写入操作。用户提到「记笔记」「查看笔记」「把这段内容加到笔记里」等意图时触发。

0 0 0 0 更新于 2026-10-28 19:06

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 面向 IMA 平台用户的笔记管理场景,代理可通过 OpenAPI 完成笔记的全生命周期操作:按标题或正文关键词搜索定位笔记、分页拉取笔记本与笔记列表、读取笔记纯文本内容;同时支持新建 Markdown 笔记到指定笔记本、向已有笔记追加文本或批量插入图片。写入前强制校验 UTF-8 合法性,避免不可逆乱码;追加操作设敏感确认机制,防止误改用户已有内容。图片写入独立走笔记通道,执行原始文件预检(大小、MIME、签名),超限或格式不符立即拒绝。

技能包含

  • SKILL.md(本文件):技能主说明,含接口决策表、新建/追加行为规则、图片写入流程与错误处理
  • references/api.md:完整数据结构、接口参数与枚举值定义
  • scripts/note-images.cjs:图片预检与写入脚本,支持 --dry-run 预览批次、--content 短内容写入、--url 本地图片临时链接获取

核心能力

  • 笔记检索:按标题或正文搜索,支持高亮结果与偏移量分页
  • 列表浏览:分页获取笔记本目录、笔记本内笔记或全部笔记,自动解析嵌套字段
  • 内容读取:通过 note_id 拉取笔记纯文本正文,群聊场景仅展示标题与摘要保护隐私
  • 新建笔记:调用 import_doc 创建 Markdown 格式笔记,可指定目标笔记本
  • 追加内容:向已有笔记追加文本,用户未明确目标时先询问确认,避免误操作
  • 图片写入:按原文顺序分批插入图片,执行原始文件大小、MIME 类型、签名三重预检,失败即停不回滚
  • 编码安全:任何写入前校验字符串字段为合法 UTF-8,阻断非 UTF-8 内容入库

应用场景

用户怎么说本技能做什么
"帮我找一下上周的会议纪要"按标题或正文关键词搜索笔记,返回匹配列表与高亮摘要
"我最近有哪些笔记?"分页拉取全部笔记列表,按更新时间排序,展示标题与修改时间
"把这段内容记到笔记里"先询问用户是新建笔记还是追加到已有笔记,确认后执行对应写入
"在《项目排期》笔记末尾加上这段"定位目标笔记,校验 UTF-8 后追加 Markdown 内容
"这篇笔记里有张图,帮我存进去"预检图片原始文件(<3 MiB、PNG/JPEG/WebP、签名一致),通过后分批插入笔记
"列出我所有的笔记本"游标分页获取笔记本目录,含笔记数量与文件夹类型