IMA OpenAPI

概述

腾讯 IMA（ima.qq.com）的 OpenAPI 接口，提供云端笔记管理和知识库操作能力。与 [[mempalace]] 的本地记忆互补，负责云端文档管理。

功能模块

Notes 笔记管理

• 搜索笔记、浏览笔记本、获取笔记内容
• 创建笔记（import_doc）、追加内容（append_doc）
• 写入前强制 UTF-8 编码校验（否则乱码不可修复）

Knowledge-base 知识库

• 上传文件到知识库、添加网页链接
• 搜索知识库内容、浏览知识库条目
• 获取可添加的知识库列表

认证

Client ID + API Key，HTTP POST + JSON Body 发送到 ima.qq.com。

注意事项

• 文件上传到知识库时保持原样不转码
• PowerShell 5.1 环境需特殊处理（GBK 编码问题）

在记忆系统中的位置

作为 [[memory-layered-architecture]] 中的外部知识源，处理需要跨设备/持久化的大文件和文档管理。与 Hermes 的集成优先级低于 [[mempalace]] 的深度集成。

相关

• [[mempalace]] — 本地记忆系统（互补）
• [[hermes-agent]] — 通过 skill 系统集成
• [[memory-layered-architecture]] — 整体记忆架构