网盘研习（Netdisk Study）

把用户百度网盘里的视频、电子书、文档、图片当作个人知识源，按一个主题/问题做语义检索、归并、并综合成研学笔记。核心价值：不下载、不转存，直接基于网盘侧已有的内容索引（语义向量、OCR、文档正文）做检索与综合。

何时使用

• 用户问"我网盘里有没有关于 X 的资料 / 视频 / 书"
• 用户想围绕某个主题，汇总网盘素材做笔记、要点、灵感、备课、写报告素材
• 用户想从网盘内容出发做研究 / 学习

前置与原则

• 百度网盘连接器（connector-baidu-netdisk）必须已连接；未连接时提示用户在连接器管理中重新连接。
• 严格遵守 connector-baidu-netdisk 的调用原则：默认只读检索；写操作（上传内容、创建分享链接、移动/重命名）前必须先与用户确认目标、文件名、冲突策略。
• 不要声称已把分享链接发送给任何人；只向用户返回链接、有效期、提取码。

工具（mcp__baidu-netdisk__*）

• file_semantics_search：核心检索。关键参数：
• query：主题关键词 / 短语（如"消防 规范""全景 拼接"）
• search_type：默认用 2（自动）。实测 search_type=1（纯语义向量检索）在多数账号返回空（向量索引常未建立）；search_type=2 会自动命中文件名 + 文档正文关键词，结果稳定可用。
• category：1-视频、2-音频、3-图片、4-文档、5-应用、6-其他
• sources：建议省略。显式指定语义向量源（7-文档向量/8-视频向量/9-音频向量）常返回空；省略后由自动模式选最稳的命中方式。
• dir：限定目录（默认 /）；含中文需 UrlEncode
• num：返回数量上限
• 返回项含 hit_terms（命中词）与 path；视频/文档列表（file_video_list/file_doc_list）的返回项额外含 abstract（网盘自动生成的内容摘要），是"按内容"检索的有效信号。
• file_keyword_search：已知文件名关键词时用。
• file_list / file_video_list / file_doc_list / file_image_list：浏览某目录。
• file_meta：用文件 ID 取详情。
• file_sharelink_set：创建分享链接（需用户确认；提取码仅数字+小写字母、4 位）。
• file_upload_by_content：把综合笔记存回网盘（单次 ≤ 2 万字；需确认目录与文件名，默认 /来自：mcp_server 或用户指定）。

标准流程

1. 澄清主题（轻量）：若主题模糊，用一句话确认范围（主题 + 想要的产出：资料清单 / 要点笔记 / 灵感卡片）。给出合理默认即可，不要反复追问。
2. 并行检索（核心步骤，建议一次发起多个调用）：
   - 用 file_semantics_search，search_type=2，query=<主题关键词/短语>，按需设 category=[1]（视频）/ [4]（文档）/ [3]（图片），num=10，省略 sources。
   - 若结果偏少：用 file_keyword_search 以文件名关键词再查一次；或浏览 file_video_list / file_doc_list 取回文件自带的 abstract 内容摘要，做本地相关性匹配（这是"按内容"检索的可靠信号，不依赖向量索引）。
3. 归并去重：按"文件类型 + 相关度 + 所在目录"整理，去掉重复与弱相关项。
4. 呈现结果：用清晰列表给出每项【文件名 | 类型 | 路径/目录 | 一句话相关性说明】。视频特别标注"网盘侧已索引内容，可直接语义搜到，无需下载"。
5. 综合产出（按需、且用户同意）：
   - 要点笔记：把相关素材浓缩为结构化要点。
   - 灵感卡片：主题 → 跨素材的关联洞察 / 可行动建议。
   - 存回网盘：file_upload_by_content 存为 .docx 或 .md，先确认目录与文件名。
6. （可选）合并 ima 知识库：若用户已建 ima 知识库，可同时用 mcp__ima-mcp__search_knowledge_base 检索文本型知识，与网盘结果合并呈现，形成"网盘 + 知识库"双层检索。

边界与提示

• 百度网盘连接器不能把文件下载到本地，因此本技能不负责"转写视频 / 解析电子书全文"——只基于网盘侧已有索引做检索与综合。
• 实测重要结论：本账号下 search_type=1（纯语义向量检索）与显式 sources=[7/8/9] 经常返回空，说明向量索引可能未建立。技能以 search_type=2（自动/关键词）为主检索，必要时用列表 abstract 做内容匹配，不依赖向量检索也能稳定工作。
• 当用户需要视频逐字稿或电子书全文入库（例如进 ima 知识库做问答）时，提示流程：先把文件下载到本地 → 用对应工具处理（ASR 转写 / 文档解析）→ 再上传到 ima 知识库。这部分不在本技能自动范围内。
• 检索结果可能较多时，用 num 限制并说明返回范围；必要时分页或缩窄目录。

示例

• "我网盘里有没有讲消防规范的文档和笔记？" → file_semantics_search 设 category=[4]、search_type=2，捞出「消防类规范强条汇总表」「AI笔记·消防控制室」等并附路径与命中词。
• "围绕'施工图审查要点'把我网盘资料整理成一份笔记" → 检索 → 综合要点 → 询问是否存回网盘。
• "从我网盘里找关于混凝土裂缝处理的图片和文档" → category 3/4，sources 5,11,14。