alibabacloud-pds-multimodal-search：本场景适用于用户对企业网盘内容进行实时多模态文件检索，比如文搜文、文搜图、图搜图等。

PDS 多模态搜索

请仔细阅读本 skill 文档全文

功能

• 获取 drive/drive_id、查询企业空间、团队空间、个人空间 -> 阅读 references/drive.md
• 上传本地文件到企业空间、团队空间、个人空间 → 阅读 references/upload-file.md
• 从企业空间、团队空间、个人空间下载文件到本地 → 阅读 references/download-file.md
• 搜索或查找文件 → 阅读 references/search-file.md
• 对云盘进行文档 / 音频 / 视频分析、快速查看、摘要 → 阅读 references/multianalysis-file.md
• 图像搜索、相似图搜索、图文混合检索 → 阅读 references/visual-similar-search.md

Agent 执行指引

• 必须按顺序执行步骤：不要跳过任何步骤，前一步完成前不要进入下一步。
• 必须遵循文档：aliyun pds cli 命令和参数必须遵循本文档指引，不要臆造命令。
• [必须] CLI User-Agent —— 每次 aliyun CLI 命令调用都必须包含：

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search

• 文件操作前必须确定目标空间：搜索、上传、下载或分析前，先确定用户明确指的是企业空间、团队空间、个人空间还是所有空间。
• 空间范围不得被静默扩大：如果用户明确说"企业空间"，只用企业空间 drive_id。如果用户明确说"团队空间"，只用匹配的团队空间 drive_id。如果用户明确说"个人空间"，只用个人空间 drive_id。仅当用户未限制范围时才跨多个空间搜索。
• 企业空间和团队空间不可互换：尽管两者都由 list-my-group-drive 返回，root_group_drive 是企业空间，items 是团队空间。绝不用一个替代另一个。
• 如果请求的空间缺失，停止并解释：例如，如果用户要求企业空间但 root_group_drive 为空，不要回退到团队空间搜索。

核心概念：

• Domain：具有唯一 domain_id 的 PDS 实例，数据在 domain 之间完全隔离
• User：domain 下的最终用户，有 user_id
• Group：domain 下的团队组织，分为企业群组和团队群组
• Drive：存储空间，可属于用户（个人空间）或群组（企业空间或团队空间）
• File：空间下的文件或文件夹，有 file_id
• Mountapp：PDS 挂载盘插件，用于将 PDS 空间挂载到本地，方便用户访问和管理 PDS 空间中的文件

空间选择规则

选择 drive_id 前应用以下规则：

继续前，执行简要自检：

1. 用户是否明确指定了目标空间类型？
2. 所选的 drive_id 是否来自该空间类型的正确响应字段？
3. 如果存在多个团队空间而用户只说了"团队空间"，我是否需要消歧是哪个团队空间？

如果任何答案不确定，不要猜测。

安装要求

前置条件：需要 Aliyun CLI >= 3.3.3
验证 CLI 版本：
```bash
aliyun version # 要求 >= 3.3.3
```
若未安装或版本过低，
运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 更新，
或见 references/cli-installation-guide.md 获取安装说明。
验证 PDS 插件版本：
```bash
aliyun pds version # 要求 >= 0.1.4
```
安装后，必须启用插件自动安装：
```bash
aliyun configure set --auto-plugin-install true
```
然后 [必须] 运行 aliyun plugin update 确保本地已有插件始终为最新版本。

CLI 初始化（核心工作流前必须运行）

在核心工作流开始时（任何 CLI 调用之前）：

[必须] 启用 AI-Mode —— AI-mode 是 Agent Skill 执行所必需的。

在任何 CLI 调用之前运行以下命令：

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search"

[必须] 在每个退出点禁用 AI-Mode —— 因任何原因交付最终回复之前，始终先禁用 AI-mode。这适用于所有退出路径：工作流成功、工作流失败、错误 / 异常、用户取消、会话结束，或不再执行 CLI 命令的任何其他场景。

AI-mode 仅用于 Agent Skill 调用场景，Skill 停止运行后不得保持启用。

aliyun configure ai-mode disable

鉴权配置

前置条件：必须配置阿里云凭证
安全规则：
- 禁止读取、输出或打印 AK/SK 值（例如 echo $ALIBABA_CLOUD_ACCESS_KEY_ID 是禁止的）
- 禁止要求用户在对话或命令行中直接输入 AK/SK
- 禁止使用 aliyun configure set 设置明文凭证
- 只允许使用 aliyun configure list 检查凭证状态
检查凭证配置：
```bash
aliyun configure list
```
确认输出显示有效 profile（AK、STS 或 OAuth 身份）。
如果不存在有效配置，先停止。
1. 从阿里云控制台获取凭证
2. 在本会话之外配置凭证（在终端运行 aliyun configure 或设置环境变量）
3. 配置完成后运行 aliyun configure list 验证

安装 Aliyun CLI（若未安装）

curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash

aliyun version # 确认 >= 3.3.3

启用插件自动安装

aliyun configure set --auto-plugin-install true

安装 Python 依赖（用于分片上传脚本）

pip3 install requests

PDS 特定配置

执行任何 PDS 操作前，必须先配置 domain_id、user_id 和鉴权类型 -> 阅读 references/config.md

[必须] CLI User-Agent —— 每次 aliyun CLI 命令调用都必须包含 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
示例：
```bash
aliyun pds get-user --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds upload-file --drive-id <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
```

参考

错误处理

1. 如果文件搜索失败，请阅读 references/search-file.md 并严格遵循文档记录的流程重新执行文件搜索。