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

IMA 笔记与知识库

知识管理 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f5c3b86b/yk。

技能介绍

要解决什么问题

很多人用腾讯 IMA 做笔记和知识库,但 Agent 侧若自己拼 OpenAPI,很容易踩三类坑:笔记写入乱码(非 UTF-8 或 PowerShell 5.1 把 Body 悄悄转成 GBK)、笔记与知识库操作串线(「写到笔记」和「上传到知识库」走错了模块),以及跨模块链路缺一步(例如知识库里的笔记型媒体要先拿 media_id 再调笔记读正文)。本技能把 IMA 能力收成统一入口,用决策表和强制规则约束 Agent 行为。

技能如何工作

顶层 ima-skill 按用户意图路由到两个子模块:

  • notes:搜索/浏览笔记本、import_doc 创建笔记、append_doc 追加内容、读取笔记正文
  • knowledge-base:文件上传(create_media → COS → add_knowledge)、网页链接、add_knowledge 把已有笔记关联进知识库、搜索与浏览知识库、用 media_id 查原文

调用统一经 ima_api.cjs 向 https://ima.qq.com 发 HTTP POST + JSON;凭证来自 ~/.config/ima/ 或环境变量,缺凭证时必须先引导用户在 ima.qq.com/agent-interface 配置 Client ID 与 API Key。错误分两层:进程退出码(如 -100 程序错误、-200 需更新技能)与响应体里 code≠0 的业务 msg。

涉及「从知识库摘内容写笔记」或「把笔记加入知识库」时,SKILL 明确要求先读两个子模块 SKILL.md 再按序执行,避免只加载单侧 API。

适用边界与注意点

  • 不支持:视频、Bilibili/YouTube 链接、file://,应提示用户用 IMA 桌面客户端;勿询问「是否仍要尝试」。
  • 文件上传:title 必须等于原 file_name(含扩展名);二进制文件不得做编码转换。
  • 笔记写入前必须校验 content、title 为合法 UTF-8;知识库文件上传不适用该转码规则。
  • 意图含糊(如「记一下」未指明新建还是追加)应先向用户确认,再选 import_doc 或 append_doc。

使用场景

  • 调研时把对话结论用 import_doc 写成新笔记,并在用户指定标题下保证 UTF-8 合法再提交
  • 用户说「追加到 XX 笔记」时,先搜索笔记拿 note_id,再调用 append_doc 写入片段
  • 需要将 PDF 挂到某知识库:create_media 上传且 title 与原名一致,再走 add_knowledge 入库
  • 知识库条目要「查看原文」且类型为笔记:先 knowledge-base 取 media_id,再 notes 拉正文

适合人员

  • 已在 IMA 配置 Client ID/API Key、希望 Agent 稳定读写笔记而非手写 curl 的个体研究者
  • 维护团队知识库、需把会议记录 PDF 与网页链接批量入库的运营或售前
  • 在 Windows PowerShell 5.1 环境跑 Agent、需要避免中文笔记 silently 乱码的自动化维护者
  • 做 RAG 或二次分析、要从知识库 media_id 拉回笔记原文再本地处理的工程师