Agent Skills
返回列表
IMA OpenAPI 统一接入

IMA OpenAPI 统一接入

知识管理 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c54b5ab8/ima-skill-pro。

技能介绍

解决的问题

IMA OpenAPI 的调用容易在两类地方出问题：一是 notes 文本写入时，用户输入、网页抓取、文件读取都可能带入非法 UTF-8，最终造成不可修复的乱码；二是 notes 与 knowledge-base 的职责边界容易混淆，例如“把内容记到笔记”“把笔记加入知识库”“查看知识库里的原文”分别需要不同路由。该技能把这两类操作收敛到同一入口，并在执行前明确强制校验和模块选择。

工作方式

  • 模块路由：搜索、浏览、创建、追加笔记走 notes；上传文件、添加链接、搜索知识库、关联笔记走 knowledge-base；跨模块任务要求先读取两个子模块的 SKILL.md，再按顺序执行。
  • 凭证与调用：优先检查环境变量或 ~/.config/ima 下的凭证；所有请求以 HTTP POST + JSON Body 发往 https://ima.qq.com。
  • 编码防护：调用 notes 的 import_doc、append_doc 前必须校验 content、title 为合法 UTF-8；文件上传保持二进制原样，不改名、不转码。
  • 错误分层：脚本退出码区分程序错误 -100 与更新提示 -200；后端返回 code 与 msg，失败时直接呈现可操作信息。

适用边界与注意点

该技能适合需要把 IMA 笔记与知识库操作接入 Agent 流程的场景。注意视频文件、Bilibili/YouTube URL 与 file:// URL 不受支持；在 PowerShell 5.1 环境中必须使用 UTF-8 字节数组模式发送请求；若用户未说明目标笔记，应先确认是创建新笔记还是追加到已有笔记。

使用场景

  • 在 Agent 中把网页抓取内容保存为 IMA 笔记，写入前需要校验 UTF-8 避免乱码。
  • 把 PDF、图片、Excel 文件上传到指定知识库，并保持原文件名和二进制内容。
  • 先搜索知识库中的条目，再将其内容追加到已有 IMA 笔记中。
  • 将已有 IMA 笔记关联到知识库，而不是重新写入正文。

适合人员

  • 需要在 Agent 里读写 IMA 笔记、并处理编码校验的工程团队。
  • 要把网页、文件等内容沉淀到 IMA 知识库的知识管理负责人。
  • 在 PowerShell 或 Node 脚本中调用 IMA OpenAPI 的集成工程师。
  • 需要把笔记与知识库跨模块串联自动化流程的开发者。