# Connector Baidu Netdisk > 百度网盘文件管理与智能检索。支持浏览、关键词和语义搜索、文件整理、分享链接、容量查询，以及保存文本内容或通过 URL 转存文件。触发关键词：百度网盘、网盘、baidu、netdisk、云盘、文件分享。 - Skill: `ahang1598/connector-baidu-netdisk` (Agent Skill) - Install (CLI): `npx skillmds@latest add ahang1598/connector-baidu-netdisk` - Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/connector-baidu-netdisk/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: ahang1598 (https://skillmd.com/u/ahang1598) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/ahang1598/connector-baidu-netdisk --- # 百度网盘 通过百度网盘 MCP 浏览、检索和管理用户的云端文件。当前能力包括目录与分类浏览、关键词与语义检索、文件元信息和容量查询、文件整理、创建分享链接，以及保存文本内容或通过 URL 转存文件。 ## 能力边界 当前连接器支持： - 浏览指定目录下的全部文件，或按文档、图片、视频分类查看。 - 按文件名关键词搜索。 - 使用自然语言进行语义检索，并可按目录、文件类型、扩展名和结果数量筛选。 - 在文件名、图片 OCR 文字、文档正文中搜索关键词。 - 对图片以及文档、视频、音频内容进行语义检索。 - 查询文件元信息、用户基本信息和网盘空间使用情况。 - 新建文件夹，复制、移动和重命名文件。 - 为一个或多个文件创建带有效期和提取码的分享链接。 - 将文本内容保存为网盘文件，单次文本不超过 2 万字。 - 通过可直接下载的 URL 将文件转存到网盘。 当前工具集中未提供： - 将网盘文件或文件夹下载到本地。 - 直接上传用户设备上的任意本地文件。 - 删除网盘文件或文件夹。 - 将分享链接直接发送给某个联系人；连接器只能创建分享链接，由用户自行发送。 不要把“文本内容保存”或“URL 转存”描述为完整的本地文件上传能力，也不要承诺下载或删除操作。 ## 调用原则 - 涉及百度网盘时，优先使用本连接器提供的 MCP 工具，不要用本地文件系统命令代替网盘操作。 - 目标文件、目录或路径不明确时，先浏览或搜索，再执行后续操作。 - 执行新建、复制、移动、重命名、上传、转存或创建分享链接等写操作前，确认目标对象、目标目录、文件名及冲突处理方式。 - 移动、重命名和覆盖可能改变用户现有文件结构；未获得明确授权时，不使用覆盖策略。 - 用户只要求查找或查看时，保持只读，不顺带执行整理、分享或上传操作。 - 工具要求绝对路径时使用以 `/` 开头的网盘路径；路径含中文时，按工具参数说明进行 URL 编码。 - 搜索结果可能较多时使用分页或限制返回数量，并向用户说明结果范围。 ## 工具选择 ### 浏览与查询 - 查看目录内容：使用通用文件列表。 - 只查看文档、图片或视频：使用对应的分类列表。 - 查询文件详情：先从列表或搜索结果取得文件 ID，再查询元信息；单次最多查询 10 个文件 ID。 - 查询网盘容量：使用空间配额查询。 - 查询账号基础信息：使用用户信息查询。 ### 搜索 - 用户给出明确文件名关键词时，优先使用文件名关键词搜索。 - 用户使用自然语言描述内容、主题、场景、时间或地点时，优先使用语义检索。 - 用户要求搜索图片中的文字时，选择图片 OCR 搜索来源。 - 用户要求搜索文档正文时，选择文档内容搜索来源。 - 用户要求按画面、音视频内容或文档含义搜索时，选择对应的语义向量搜索来源。 - 用户指定文件类型或后缀时，同时设置分类或扩展名过滤条件，减少无关结果。 ### 文件管理 - 新建文件夹前确认完整目标路径；同名冲突时，除非用户另有要求，优先采用自动重命名而非覆盖。 - 复制、移动和重命名时，先确认源文件绝对路径、目标目录和目标名称。 - 遇到同名文件时，向用户说明可选策略：失败、生成副本名、覆盖或跳过。默认优先选择生成副本名，避免覆盖已有文件。 ### 分享 - 创建分享链接前确认待分享文件、有效期、4 位提取码和备注。 - 提取码只能由数字和小写字母组成，长度为 4 位。 - 创建成功后向用户返回分享链接、有效期和提取码，但不要声称已发送给任何联系人。 ### 保存内容与 URL 转存 - 用户要求把一段文字、会议纪要或生成内容保存到网盘时，使用文本内容上传；单次内容不超过 2 万字。 - 用户未指定目录时，工具默认保存到 `/来自：mcp_server`；执行前应告知用户默认位置，或询问其期望目录。 - 用户未指定文件名时，工具可能默认保存为 DOCX；为减少歧义，优先确认文件名和扩展名。 - 用户提供可直接下载的文件链接并要求保存到网盘时，使用 URL 转存。 - URL 不是直接下载地址、需要登录或访问受限时，不保证转存成功，应向用户说明限制。 - 不要尝试用文本上传接口读取或上传任意本地二进制文件。 ## 使用示例 - 查看我百度网盘根目录下的文件，并告诉我还剩多少可用空间。 - 列出「项目资料」文件夹里的所有文档。 - 从文件名、文档正文和图片文字中搜索与「项目合同」相关的文件。 - 找出网盘里与海边日落相关的图片和视频。 - 搜索最近整理的 AIGC 研究资料，只返回 PDF 和 DOCX 文件。 - 新建一个「AIGC 调研资料」文件夹，把相关文件复制进去。 - 把「旧项目/周报.docx」移动到「归档/2026」，遇到同名文件时跳过。 - 将「最终方案-v3.docx」重命名为「最终方案.docx」。 - 为「周报.docx」创建一个有效期 7 天、带 4 位提取码的分享链接。 - 把这段会议纪要以「产品会议纪要.docx」保存到百度网盘的「会议记录」文件夹。 - 把这个可下载链接中的文件转存到百度网盘的「参考资料」文件夹。 ## 错误处理 - 认证失败：当返回 HTTP 401/403、Access Token 无效或过期等错误时，提示用户在连接器管理中重新连接百度网盘；如需重新获取凭据，可参考百度网盘开放平台文档：。 - 路径错误：确认路径以 `/` 开头，并按工具要求对包含中文的路径进行 URL 编码。 - 文件不存在：先重新浏览父目录或搜索文件名，避免基于猜测继续执行。 - 同名冲突：不要擅自覆盖，向用户说明冲突并确认使用生成副本名、覆盖、跳过或失败策略。 - 分享失败：检查文件 ID、有效期和提取码格式；文件 ID 列表必须符合工具要求的严格 JSON 字符串格式。 - 转存失败：检查 URL 是否可公开访问并可直接下载；若链接需要登录、验证码或临时授权，告知用户当前接口可能无法转存。 - 语义检索无结果：尝试缩短描述、调整搜索来源、取消过窄的文件类型限制，或退回文件名关键词搜索。 ## 安全说明 - Access Token 由连接器管理，通过 MCP 连接参数传递。 - 禁止在对话、日志或输出文件中展示完整的 Access Token。 - 未经用户明确确认，不覆盖已有文件，不移动或重命名重要文件，不创建公开分享链接。 - 分享链接、提取码和文件路径可能包含敏感信息，只向当前用户展示，不主动传播给第三方。