PDS 多模态搜索

请仔细阅读这份完整的 skill 文档

功能

• 如需获取网盘/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_id 的 PDS 实例，不同域之间的数据完全隔离
• 用户：域下的最终用户，拥有 user_id
• 群组：域下的团队组织，分为企业群组和团队群组
• 网盘：存储空间，可归属于用户（个人空间）或群组（企业空间或团队空间）
• 文件：空间下的文件或文件夹，拥有 file_id
• 挂载应用：PDS 挂载应用插件，用于将 PDS 空间挂载到本地，使用户可以方便地访问和管理 PDS 空间中的文件

空间选择规则

选择 drive_id 前，应用以下规则：

| 用户表述 | 允许的网盘来源 | 禁止的回退选项 | |------------|------|------| | "企业空间" / "company space" / "enterprise space" | 仅限 root_group_drive | items 中的任意网盘 | | "团队空间" / "某个团队空间" / "team space" | 仅限 items | root_group_drive | | "个人空间" / "我的空间" / "personal space" | 仅限 list-my-drives.items | 群组网盘 | | "网盘里" / "我的网盘" / 未指定空间 | 所有相关空间 | 无 |

继续之前，进行简短的自检：

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

如果有任何一个答案不确定，不得猜测。

---

安装要求

前提条件：要求阿里云 CLI >= 3.3.3

验证 CLI 版本：

```bash

aliyun version # requires >= 3.3.3

```

如未安装或版本过低，

运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 进行更新，

或参阅 references/cli-installation-guide.md 了解安装说明。

验证 PDS 插件版本：

```bash

aliyun pds version # requires >= 0.1.4

```

安装后，必须启用插件自动安装：

```bash

aliyun configure set --auto-plugin-install true

```

然后，[必须]运行 aliyun plugin update，以确保本地计算机上的所有现有插件始终保持最新状态。

---

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

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

[必须] 启用 AI-Mode——执行 Agent Skill 时必须启用 AI-mode。 在调用任何 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

```

确认输出中显示有效的配置文件（AK、STS 或 OAuth 身份）。

如果不存在有效配置，请先停止操作。

1. 从阿里云控制台获取凭据

2. 在此会话之外配置凭据（在终端中运行 aliyun configure 或设置环境变量）

3. 配置完成后，运行 aliyun configure list 进行验证

# Install Aliyun CLI (if not installed)
curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash
aliyun version  # confirm >= 3.3.3

# Enable auto plugin installation
aliyun configure set --auto-plugin-install true

# Install Python dependencies (for multipart upload script)
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

```

参考资料

| 参考文档 | 路径 | |------------|------| | CLI 安装指南 | [references/cli-installation-guide.md](references/cli-installation-guide.md) | | RAM 权限策略 | [references/ram-policies.md](references/ram-policies.md) |

错误处理

1. 如果文件搜索失败，请阅读 references/search-file.md，并严格按照文档中规定的流程重新执行文件搜索。