IMA 笔记与知识库 API
将以下提示词粘贴到你的 AI 对话框中：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_aca80b9b/sk-3a9384a808454868983f9f9adea41c96。
技能介绍
要解决的问题
IMA 的笔记与知识库能力分散在多个 OpenAPI 中：创建笔记、追加内容、搜索知识库、上传文件、添加网页链接、获取原文都需要不同参数与流程。直接调用时，常见问题是路由错、编码乱、文件名被改、凭证缺失和错误层级不一致。尤其 notes 写入如果 content、title 不是合法 UTF-8，服务端会保存为不可恢复的乱码；PowerShell 5.1 还可能把请求体静默转成 GBK。
技能如何工作
该技能把 IMA OpenAPI 收敛为两个模块：notes 与 knowledge-base。notes 处理笔记的创建、追加、搜索和内容读取；knowledge-base 处理文件上传、网页链接添加、知识库检索和原文管理。关键流程会按意图路由：目标是笔记正文就走 import_doc 或 append_doc；目标是知识库条目就走 create_media、add_knowledge 或相关查询接口；跨模块任务会先读取两个子模块再串联执行。
调用前需要先检查 IMA Client ID 与 API Key。请求统一为 HTTP POST + JSON，由 ima_api.cjs 发送。错误分两层：脚本执行错误在 stderr 返回 -100 或 -200；后端业务错误在 stdout 返回 code 与 msg。notes 写入前必须校验字符串字段为 UTF-8；文件上传则必须保持二进制原样，且 title 与原始文件名一致。
适用边界
它适合需要把 IMA 笔记与知识库操作接入自动化流程的场景，但不覆盖所有 IMA 能力，且不支持视频、Bilibili/YouTube 链接和 file:// 地址等类型。使用时不应改原始文件名，不应绕过编码检查，也不应在缺少凭证时反复盲试 API。
使用场景
- 把抓取到的网页要点整理成新笔记，并追加到同一主题笔记。
- 上传 PDF 或 Excel 到知识库，添加网页链接，并按主题搜索相关条目。
- 从知识库获取某条 media 的原文，再读取笔记内容用于分析。
- 在自动化脚本里检查 IMA 凭证，调用 API 创建或追加笔记并处理业务错误。
适合人员
- 维护 IMA 笔记流程的研发：希望把网页要点自动写成笔记并追加到指定笔记。
- 管理知识库条目的运营：需要上传文档、添加链接并检索知识库内容。
- 处理原文分析的工程师：要从知识库 media 获取原文并读取笔记正文。
- 搭建 API 工作流的自动化负责人：需要检查凭证、调用 IMA 并处理两类错误。
相关技能
读取对话痕迹文件，生成动物或神话人格的灵魂映照卡面，并结合乔哈里窗输出认知四象限解读。
面向德灵知识库的深度调研流程，先澄清意图，再按广度搜索、垂直挖掘、网络补充、多样性验证与答案溯源收集资料，确保关键论点可追溯。
面向思源笔记/SiYuan 的知识库管理技能，围绕父页双链索引、MOC、编号、标签、仓库批量同步与微信文章导入，提供 CLI 工作流与常见陷阱检查。
面向学术文献综述的结构化流程，覆盖多数据库检索、筛选、主题综合、引用验证和 PDF 输出。