IMA 知识库与笔记 API
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3ef04463/qianqiong-ima。
技能介绍
解决的问题
IMA 笔记和知识库的操作分散在多个接口里,开发者需要在笔记写入、知识库上传、网页链接、搜索读取之间判断路由,并处理凭证、编码和平台差异。
技能如何工作
该技能以 ima-skill 为入口,先读取 SETUP_TOKEN.md,再通过 get-token.sh 或 get-token.ps1 在每条命令中内联获取凭证。所有请求统一发往 https://ima.qq.com,使用 HTTP POST + JSON 调用。技能会把用户意图路由到两个模块:notes 用于搜索、浏览、获取、创建和追加笔记;knowledge-base 用于上传文件、添加网页链接、搜索和浏览知识库。对于“记到某篇笔记”与“把文件加入知识库”这类易混淆请求,它会先判断目标对象是笔记内容还是知识库条目,再选择 append_doc、import_doc、create_media、add_knowledge 等接口。
适用边界
该技能不保存跨会话凭证,也不允许在对话中回显真实 Client ID 或 API Key。notes 写入前需要确保文本为合法 UTF-8;文件上传则应保持原始二进制内容。PowerShell 5.1 环境需显式将请求 Body 转为 UTF-8 字节数组,否则中文可能静默乱码。
使用场景
- 在整理会议记录时,把新内容追加到已有笔记并避免重复创建条目。
- 将 PDF、Word、Excel、PPT 或图片上传到 IMA 知识库并生成可检索条目。
- 把外部网页链接加入知识库,并在后续按主题搜索相关条目和知识库内容。
- 当需求模糊时,先确认是创建新笔记还是追加到指定笔记,再调用对应接口。
适合人员
- 整理知识库的助理:把多份文档、链接和网页资料归入同一 IMA 知识库。
- 维护团队笔记的负责人:把讨论结论追加到已有笔记并检索旧内容。
- 做资料沉淀的分析师:上传 PDF、Excel、PPT 并搜索可引用的知识库条目。
- 接入 IMA 的工程师:用统一脚本调用笔记和知识库 API,处理编码与凭证问题。