用途：统一封装 IMA OpenAPI，帮助智能体通过官方接口管理笔记与知识库。用户提到知识库、资料库、笔记、备忘录、记事，或想上传文件、添加网页到知识库、搜索知识库内容、搜索/浏览/创建/编辑笔记时适用。
主要能力：notes 模块支持搜索笔记、浏览笔记本、获取笔记内容、创建笔记、追加内容；knowledge-base 模块支持上传文件、添加网页链接、搜索知识库、浏览知识库内容、获取知识库信息、获取可添加的知识库列表。
使用方式：先到 https://ima.qq.com/agent-interface 获取 Client ID 和 API Key，再以配置文件或环境变量存储。配置文件：mkdir -p ~/.config/ima，echo "your_client_id" > ~/.config/ima/client_id，echo "your_api_key" > ~/.config/ima/api_key。环境变量：export IMA_OPENAPI_CLIENTID="your_client_id"、export IMA_OPENAPI_APIKEY="your_api_key"。读取优先级为环境变量优先于配置文件，凭证为空时应停止操作。所有请求为 HTTP POST + JSON Body，仅发往 https://ima.qq.com，凭据仅作为 HTTP 头发送给该域名。
路由规则：操作笔记内容（读、写、追加）用 notes；操作知识库条目（上传文件、加链接、关联笔记）用 knowledge-base；若“知识库”仅用于描述笔记位置，仍走 notes。多模块任务按意图顺序依次执行。易混淆场景：向已有笔记追加用 notes 的 append_doc；将笔记关联到知识库用 knowledge-base 的 add_knowledge（media_type=11）；上传文件走 create_media → COS → add_knowledge；新建笔记用 import_doc；未指定已有笔记时先询问用户。
限制与注意：notes 模块写入前必须做 UTF-8 编码校验，否则乱码且无法修复；knowledge-base 上传文件须保持原文件二进制内容，不得转码。PowerShell 5.1 下 invokes 请求会静默转 GBK，需在首次调用前检测版本并将 Body 显式转为 UTF-8 字节数组。其他功能、收费、平台与效果资料暂未提供。