小艺 IMA 笔记与知识库助手

要解决的问题

很多 Agent 已经能调用外部 API，但在对接 IMA 时仍容易踩坑：中文内容经 PowerShell 5.1 发送后变成 GBK 乱码；上传知识库文件时文件名被改写；用户说“添加到笔记”却不知道该 append_doc 还是 add_knowledge。

技能如何工作

该技能把 notes 与 knowledge-base 两个子模块拆清楚：

• 笔记内容读写：搜索、创建、追加、读取正文，走 notes 模块。
• 知识库条目管理：上传文件、添加链接、关联笔记、获取原文，走 knowledge-base 模块。
• 跨模块任务：先读两个子模块说明，再按顺序调用，例如“把知识库内容记到笔记”。

调用前会检查凭证与运行环境。文本写入必须校验 UTF-8；二进制文件上传保持原字节；遇到视频、Bilibili/YouTube 或 file:// 链接时直接拒绝并提示使用桌面端。错误分两层：脚本层返回 -100/-200，后端业务层返回 code 与 msg。

适用边界

适合已配置 IMA Client ID 与 API Key 的工程化 Agent。不适合直接下载视频、转码二进制附件，或要求绕过文件命名规则。若用户意图不明确，应先确认是创建新笔记还是追加已有笔记。