IMA 统一助手

问题

IMA 开放接口把笔记和知识库拆成不同模块，实际指令常有歧义。比如“把知识库里的内容记到笔记”需要跨模块执行；“添加到知识库 XX 里的笔记 YY”可能只是向已有笔记追加，而不是上传知识库条目。若误判接口，会造成内容写错位置；另外在 Windows PowerShell 5.1 环境中，HTTP 请求体可能被静默转为 GBK，导致中文内容变成不可修复的乱码。

工作方式

该技能以 ima.qq.com 官方 OpenAPI 为唯一目标，统一使用 HTTP POST + JSON Body。核心能力包括：

• 笔记模块：搜索笔记、浏览笔记本、读取内容、创建新笔记、追加内容。
• 知识库模块：上传文件、添加网页链接、搜索知识库、浏览知识库信息、获取可添加列表。
• 路由规则：目标是笔记内容就进入 notes；目标是知识库条目就进入 knowledge-base；涉及多模块时按意图顺序执行。

关键步骤是先确认 Client ID 与 API Key，再根据用户意图选择模块文档。对 notes 写入操作会强制检查 content、title 等字段是否为合法 UTF-8；对知识库文件上传则保持原始二进制内容，不擅自转码。

适用边界

该技能依赖官方 IMA 凭证，只适合已有 IMA 账号并愿意配置 API 凭证的场景。它不生成新的业务逻辑，而是约束调用路径、编码校验和模块选择。若用户意图不明确，例如“帮我记一下”但未说明新建还是追加，技能应先确认，而不是直接猜测接口。