小猪:用 IMA OpenAPI 统一接入笔记与知识库

前言

在 Agent 里做个人知识管理时,常见做法是各写一套脚本:上传文件走 COS、搜资料再调另一个 HTTP 接口、记笔记又是第三套。对话里用户只说「帮我记一下」或「知识库里有没有 XX」,模型往往分不清该走哪条链路。下面介绍 SkillHub 上的社区 Skill「小猪」:它把腾讯 IMA 的 OpenAPI 收成一条技能,用同一套触发规则覆盖笔记与知识库相关意图。

这是什么

「小猪」(坐标 @user_5f8d5bba/968db633cb6a4ca2398b69371eb4e326,版本 1.0.0)是发布者 user_5f8d5bba 在 SkillHub 提交的社区 Skill,分类为 knowledge-management。官方说明将其定位为统一的 IMA OpenAPI 技能,用于笔记管理和知识库操作。Skill 带有 requires_api_key=true 标签,使用前需要配置 IMA 相关 API 密钥(具体字段以 Skill 包内 SKILL.md 为准)。

核心功能

以下能力均来自 SkillHub 页面与抓取元数据中的简介,不展开未在资料中出现的接口名或参数。

  1. 知识库:上传文件到知识库、将网页添加到知识库、搜索知识库内容。
  2. 笔记:搜索、浏览、创建、编辑笔记(含备忘录、记事等表述)。
  3. 意图路由:当用户提到知识库、资料库、笔记、备忘录、记事,或表达上传文件、网页收藏、知识搜索、个人文档存取时,应由 Agent 选用本 Skill;即使用户未直说「知识库」或「笔记」,例如「帮我记一下」「搜一下知识库里有没有 XX」,也属于触发范围。

安装与启用

SkillHub 提供的安装方式是让 AI 按官方安装说明拉取指定坐标,而不是在本机 git clone。

  1. 打开安装说明文档(若页面暂时不可用,可在 SkillHub 技能页复制同款提示词):
https://skillhub.cn/install/skillhub.md
  1. 将下面提示词发给支持 SkillHub 的 AI(如 Cursor、Codex CLI、Claude Code 等,具体以你所用客户端是否支持 SkillHub 安装为准),让其按 skillhub.md 完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_5f8d5bba/968db633cb6a4ca2398b69371eb4e326`。
  1. 安装完成后,按 Skill 包内说明配置 API Key(requires_api_key=true)。各客户端的技能目录与配置文件路径以对应产品的 Skill 文档为准;本资料未给出统一 CLI 命令时,不另行编造。

典型用法

本 Skill 的「用法」主要体现在自然语言意图与 IMA 能力的对应关系。在 Agent 已安装并配置密钥的前提下,用户侧可以这样发起任务(示例均摘自官方简介,用于验证触发是否合理):

  • 「把这份 PDF 上传到知识库。」
  • 「把这个网页收藏进资料库。」
  • 「搜一下知识库里有没有关于 XX 的笔记。」
  • 「帮我记一下:明天十点开会。」
  • 「打开我上周写的备忘录,改一下结尾那段。」

Agent 侧应根据 Skill 内的 SKILL.md 调用 IMA OpenAPI,完成上传、收录、检索或笔记 CRUD;具体请求格式以技能包内文档为准。

适用场景与注意

适合谁:已经在用或计划用腾讯 IMA 做个人/团队知识库与笔记,并希望 Coding Agent 通过 SkillHub 标准技能包接入,而不是为每个动作手写脚本的用户。

限制与注意:

  • 依赖 IMA OpenAPI 与有效 API Key;未配置密钥时技能无法正常工作。
  • 来源为 community,行为与维护节奏以发布者与 Skill 包更新为准,使用前建议在 SkillHub 查看当前版本(页面显示 v1.0.0)。
  • SkillHub 统计(抓取时):评分 100000,下载 668 次,安装 1 次;仅作平台侧参考,不代表你的环境可用性。
  • 安装说明 URL 若遇网关超时,可稍后重试,或直接在 SkillHub 技能页使用「将提示词发送给你的 AI 安装该 skills」区块中的同款文案。

结尾

「小猪」把 IMA 的笔记与知识库能力收进一个 Skill,并用较宽的意图描述减少「用户没说关键词就接不上」的问题。若你需要在 Agent 里统一处理收藏、上传、检索和记事,可以从 SkillHub 安装页与官方坐标入手。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_5f8d5bba/968db633cb6a4ca2398b69371eb4e326
  • API 元数据地址:https://api.skillhub.cn/user_5f8d5bba/968db633cb6a4ca2398b69371eb4e326
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜