IMA 知识库与笔记
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_aa25c9ca/crab-skills。
技能介绍
要解决什么问题
个人知识往往分散在「随手记一条」和「长期资料库」两条线:前者是笔记、备忘录,后者是 PDF、网页收藏和可检索文档。若模型只能泛泛回答「你可以去 IMA 里找」,却无法通过 OpenAPI 真正读写,对话里的「帮我记一下」「知识库里有没有 XX」就落不了地。
本技能把 IMA OpenAPI 收敛成同一套调用约定,在对话中处理笔记管理与知识库操作,而不是各说各的接口名。
技能如何工作
触发意图包括但不限于:知识库/资料库、笔记与备忘、上传文件、添加网页到知识库、搜索库内内容,以及笔记的浏览、创建与编辑。即使用户没直说「知识库」,只要意图是收藏网页、上传文档或检索个人资料,也应走这条技能路径。
当前能力面集中在两类资源:
- 笔记(notes):创建、编辑、追加与检索个人记事。
- 知识库(knowledge-base):文档导入、内容搜索与资料组织。
写入笔记时,技能侧会强调若干硬规则,避免不可逆的数据损坏:
- 调用
import_doc/append_doc前,content、title等字符串字段必须是合法 UTF-8;非 UTF-8 会导致乱码且难以恢复。 - 文件上传时
title必须与file_name(含扩展名)一致,不得擅自改名、截断或翻译原文件名。 - 二进制文件(PDF、图片、Excel 等)上传时保持原字节,不做编码转换。
在 PowerShell 5.1 环境下,还需在首次 API 调用前识别版本,并用 UTF-8 字节数组方式发 Body,否则请求体会被静默转成 GBK。
适用边界与注意点
以下场景应直接拒绝并给出明确说明,而不是让用户「要不要试试」:
- 视频文件、Bilibili/YouTube 链接、
file://本地路径等 不支持的类型;可提示改用 IMA 桌面客户端处理。
技能描述中的内部标识为 ima-skill,与 SkillHub 上的包名 crab-skills 并存——安装与引用以清单中的规范名 @user_aa25c9ca/crab-skills 为准,能力语义以 OpenAPI 的笔记与知识库操作为准。
使用场景
- 研究资料分散在多份 PDF,需要在对话里直接上传到 IMA 知识库并保留原文件名
- 写会议结论时让模型追加到已有 IMA 笔记,而不是只在聊天窗口里复述一遍
- 整理竞品网页链接时,要求把指定 URL 收藏进知识库并在库内检索是否已有同类条目
- 临时想到要点时说「帮我记一下」,由技能创建或编辑 IMA 笔记且保证 UTF-8 正文不乱码
适合人员
- 用 IMA 做个人资料库、常把 PDF 与网页收进库内再全文检索的研究与写作者
- 在对话里维护项目备忘,需要浏览、创建、编辑 IMA 笔记的产品经理或项目负责人
- 把 OpenAPI 接到 Agent 工作流里,要统一走笔记与知识库读写而非手写多套接口的集成开发者
- 在 Windows PowerShell 5.1 环境调用 IMA 接口、需规避 GBK 静默转码导致写入失败的运维或脚本作者