https://blog.kalend.top/tags/cloud/Recent content in Cloud on Kalend's BlogHugo -- gohugo.iozhhttps://blog.kalend.top/wiki/entities/ima-openapi/Mon, 01 Jan 0001 00:00:00 +0000https://blog.kalend.top/wiki/entities/ima-openapi/<h1 id="ima-openapi">IMA OpenAPI </h1><h2 id="概述">概述 </h2><p>腾讯 IMA（ima.qq.com）的 OpenAPI 接口，提供云端笔记管理和知识库操作能力。与 [[mempalace]] 的本地记忆互补，负责云端文档管理。</p> <h2 id="功能模块">功能模块 </h2><h3 id="notes-笔记管理">Notes 笔记管理 </h3><ul> <li>搜索笔记、浏览笔记本、获取笔记内容</li> <li>创建笔记（import_doc）、追加内容（append_doc）</li> <li>写入前强制 UTF-8 编码校验（否则乱码不可修复）</li> </ul> <h3 id="knowledge-base-知识库">Knowledge-base 知识库 </h3><ul> <li>上传文件到知识库、添加网页链接</li> <li>搜索知识库内容、浏览知识库条目</li> <li>获取可添加的知识库列表</li> </ul> <h2 id="认证">认证 </h2><p>Client ID + API Key，HTTP POST + JSON Body 发送到 ima.qq.com。</p> <h2 id="注意事项">注意事项 </h2><ul> <li>文件上传到知识库时保持原样不转码</li> <li>PowerShell 5.1 环境需特殊处理（GBK 编码问题）</li> </ul> <h2 id="在记忆系统中的位置">在记忆系统中的位置 </h2><p>作为 [[memory-layered-architecture]] 中的外部知识源，处理需要跨设备/持久化的大文件和文档管理。与 Hermes 的集成优先级低于 [[mempalace]] 的深度集成。</p> <h2 id="相关">相关 </h2><ul> <li>[[mempalace]] — 本地记忆系统（互补）</li> <li>[[hermes-agent]] — 通过 skill 系统集成</li> <li>[[memory-layered-architecture]] — 整体记忆架构</li> </ul>