Agent Skills
返回列表
IMA 笔记与知识库接口

IMA 笔记与知识库接口

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_8d97f2ac/123-v2。

技能介绍

解决的问题

调用 IMA 时，笔记和知识库的接口容易混用，且中文内容在文件读取、网页抓取、PowerShell 请求中可能出现编码问题。这个技能把 ima.qq.com 官方 OpenAPI 封装成统一入口，用于处理 notes 和 knowledge-base 两类操作。

工作方式

  • 笔记模块：支持搜索笔记、浏览笔记本、读取内容、import_doc 创建新笔记、append_doc 追加内容。
  • 知识库模块：支持上传文件、添加网页链接、搜索知识库、浏览内容、获取知识库信息和可添加列表。
  • 统一调用：请求均为 HTTP POST + JSON，仅发往官方 Base URL https://ima.qq.com；凭证按环境变量、配置文件优先级读取。
  • 路由判断：目标对象是笔记内容时走 notes；目标对象是知识库条目时走 knowledge-base；跨模块任务按意图顺序执行。

适用边界

  • notes 写入前必须校验 content、title 等为合法 UTF-8，避免乱码后不可修复。
  • 上传知识库文件时必须保持原始二进制内容，不做编码转换。
  • 在 PowerShell 5.1 中，所有 API Body 都需显式转为 UTF-8 字节数组，防止 Invoke-RestMethod 静默转 GBK。

使用场景

  • 把网页文章抓取后整理成 IMA 笔记，需要先确认来源编码再写入正文。
  • 将 PDF、Excel、图片等文件原样上传到 IMA 知识库并建立可检索条目。
  • 在 PowerShell 5.1 中调用 IMA OpenAPI，避免中文请求体被静默转成 GBK。
  • 根据把知识库内容记到笔记的意图，先读取知识库再创建或追加笔记。

适合人员

  • 需要把外部文章、会议纪要写入 IMA 笔记的内容工程师。
  • 负责维护 IMA 知识库文件与链接入口的知识管理员。
  • 在 Windows PowerShell 环境中集成 IMA API 的后端开发者。
  • 需要自动搜索并汇总知识库内容到指定笔记的自动化工程师。