搜索知识库列表。query 传空字符串时返回当前账号下所有可见知识库（含自建与订阅）。知道知识库名称但不知道 ID 时用此接口。

获取知识库详情（描述、推荐问题等）。支持一次查询 1-20 个知识库。

浏览知识库内容列表（根目录或指定文件夹），分页返回文件与子文件夹。操作根目录时省略 folder_id。folder_id 以 folder_ 前缀开头。

在指定知识库中按关键词搜索内容（含文件和文件夹），返回命中的标题、摘要片段。这是知识库内容检索的核心接口。

获取知识库条目的原文内容或下载链接。传入 media_id（来自 get_knowledge_list 或 search_knowledge 的返回）。对微信文章/网页/文件类，返回可访问 URL；对笔记类（media_id 以 note_ 开头），会自动拉取并返回笔记正文（note_content 字段，纯文本）。

读取笔记正文（纯文本）。传入 note_id（笔记的数字 ID，即 get_media_info 返回的 notebook_id，或笔记搜索接口返回的 doc_id）。这是读取 IMA 笔记原文的专用接口。

获取当前用户有权限添加内容的知识库列表。仅在未指定目标知识库时使用。

将网页或微信文章 URL 添加到知识库（1-10 个 URL）。添加到根目录时省略 folder_id。

将本地文件上传到指定知识库（支持 PDF / Word / PPT / Excel / Markdown / 图片 / TXT / XMind / 音频 / HTML 等）。内部流程：类型与大小预检 → 重名检测（命中自动追加时间戳）→ create_media 获取 COS 临时凭证 → 上传 COS → add_knowledge 正式入库。视频文件（.mp4 等）不支持，请改用 import_urls 以 URL 方式添加。verify=true 时仅上传到 COS 不入库，便于验证凭证与网络。