小猪 IMA 笔记与知识库

要解决的问题

当 Agent 需要操作 IMA 的笔记和知识库时，常见风险不只是接口调用失败，还包括模块路由错误、凭证缺失，以及中文内容在编码环节静默乱码。该技能将 ima.qq.com 的 OpenAPI 封装成可判断的执行流程，明确区分 notes 与 knowledge-base 两类任务，并在请求前做凭证预检和编码保护。

技能如何工作

• 统一鉴权与调用：使用 Client ID 和 API Key，按 环境变量 → 配置文件 读取；所有请求使用 HTTP POST + JSON Body，仅发往官方 Base URL。
• 模块路由：目标是笔记内容时使用 notes，覆盖搜索、浏览、读取、创建、追加；目标是知识库条目时使用 knowledge-base，覆盖上传文件、添加网页链接、搜索知识库、浏览内容、关联笔记。
• 易混淆判断：例如“把这段内容添加到知识库里的笔记”属于 notes 的 append_doc；“把这篇笔记添加到知识库”属于 knowledge-base 的 add_knowledge。
• 编码防护：notes 写入前必须确认 content、title 为合法 UTF-8；knowledge-base 上传文件时保持原始二进制；PowerShell 5.1 下所有 API 请求都需显式转成 UTF-8 字节数组。

适用边界

适合已拥有 IMA API 凭证，并需要在 Agent 工作流中管理笔记或知识库的团队。它不替代 IMA 服务本身；如果凭证为空，技能会停止并提示完成配置。多模块任务按意图顺序执行，例如先从 knowledge-base 搜索，再写入 notes。