Agent Skills
返回列表
IMA 小龙虾 API 对接

IMA 小龙虾 API 对接

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_32bcb989/ima-lobster-link。

技能介绍

解决什么问题

在调用 IMA OpenAPI 时，笔记和知识库两条链路容易混用：append_doc 用于向已有笔记追加内容，import_doc 用于创建新笔记，而上传文件、添加链接、获取原文属于 knowledge-base。中文内容如果经过文件读取、网页抓取或 PowerShell 5.1 发送，还可能出现 GBK 转码导致的不可逆乱码。这个技能把路由、凭证检查、UTF-8 校验和错误码处理收敛成一套调用约束，让 Agent 在执行前先判断目标对象是笔记内容、知识库条目还是知识库原文。

工作方式与边界

  • 模块路由：读、写、追加笔记走 notes；上传文件、添加网页链接、搜索知识库走 knowledge-base；“把笔记添加到知识库”这类跨模块任务会先读取两个子模块再按顺序执行。
  • 强制校验：调用 import_doc 或 append_doc 前，要求 content、title 为合法 UTF-8；文件上传保持二进制原样，且 title 必须等于原始 file_name。
  • 凭证与请求：优先读取环境变量或配置文件，所有请求仅发送到 https://ima.qq.com，使用 POST + JSON Body。
  • 错误处理：脚本层关注 -100 程序错误和 -200 更新提示；业务层关注 stdout 中 code != 0 的 msg，直接回传给用户。
  • 注意点：视频、Bilibili/YouTube 链接和 file:// 链接不支持；PowerShell 5.1 必须显式使用 UTF-8 字节数组，否则中文 Body 可能被静默转成 GBK。

使用场景

  • 把网页文章保存为知识库条目，并添加链接，方便后续搜索和检索。
  • 把草稿追加到指定已有笔记，先搜索获取 note_id，再调用追加内容流程。
  • 在 PowerShell 5.1 中调用 IMA 接口写入中文笔记，必须用 UTF-8 字节数组发送请求体。
  • 查看知识库中笔记类型条目的原文，先读取媒体信息获取 media_id，再跨模块获取笔记内容。

适合人员

  • 负责 IMA 自动化集成的后端工程师：需要按正确模块路由调用笔记和知识库接口。
  • 维护中文文档的运营工程师：要把网页、文件内容写入 IMA 笔记并保持 UTF-8 不乱码。
  • 在 PowerShell 5.1 环境调用 IMA API 的开发者：需要避免请求体被静默转成 GBK。
  • 做知识库检索的技术支持：需要查找条目、查看原文，并区分笔记追加与知识库添加。