为什么要在 Qoder 里使用企业网盘
传统方式下,需要先网盘下载文件、导入 Qoder 处理,处理完再导出、上传、分发,来回搬运繁琐,成果也散落各处、难以复用。
接入企业网盘 Skill 后,Qoder 可直接在网盘内读取并处理文件,结果存回网盘即可分享协作,产出沉淀为可复用的团队资产。
1. 网盘数据不搬迁,直接用 Qoder 处理
痛点:想让 Qoder 处理网盘里的文件,得先登录网盘、翻文件夹、一个个下载到本地、再拖进对话。文件多、目录深的时候,光是"把文件弄过来"就得花半天,还容易漏。更别提这些敏感文件下载到个人电脑上,本身就是一层安全风险。
解法:网盘里的文件不用下载、也不用上传到别的平台,Qoder 直接读取企业网盘里的文档、表格、图片、音视频进行处理。数据始终留在网盘内,要处理哪份文件,一句话就够。
2. 结果文件存回网盘,分享协作更快
痛点:Qoder 干完活,结果文件还留在本地。想发给客户或同事,得先导出、再上传到网盘或发附件、还要单独设权限——一份文件在几个工具之间倒腾好几遍才能到对方手里。
解法:Qoder 处理完的结果——生成的报告、整理好的素材、转写的纪要——可以直接存回企业网盘对应目录。存进网盘就能立刻用上网盘的分享能力:一键生成分享链接发给客户或同事、按权限控制谁能看谁能改、设置有效期和提取码。
3. 产出沉淀为可复用的团队资产
痛点:辛苦让 Qoder 生成的方案、整理好的知识,用完就散落在某个人的电脑或临时文件里。下次别人要用,根本搜不到、找不着,只能从头再做一遍。
解法:存回网盘的产出文件不是用完就丢的临时结果,而是沉淀在企业空间里的数字资产——可检索、可复用、可追溯。个人的一次处理,变成整个团队可持续调用的能力积累。
一句话总结:数据不搬家、结果好分享、产出能沉淀。
Skill 说明
企业网盘在 Qoder 生态中提供一个官方 Skill。
项 | 内容 |
Skill 名称 |
|
中文名 | 企业网盘智能工作空间 |
市场地址 | |
简介 | 云相册与网盘智能工作空间,AI 驱动的文件管理 |
2.1 支持能力(11 类)
能力 | 说明 | 是否需域级开通 |
空间查询 | 查询企业空间、团队空间、个人空间及容量 | — |
文件上传 | 本地文件上传至网盘,支持秒传、分片、覆盖写 | — |
文件下载 | 从网盘下载文件到本地,自动校验大小 | — |
文件检索 | 按名称、类型、扩展名、大小、时间等条件检索 | — |
文件管理 | 重命名、移动、复制、创建文件夹、标签与备注 | — |
文件分享 | 创建/查询/修改/取消分享链接,含权限与有效期控制 | — |
打包下载 | 多文件或整个文件夹打包成 zip 下载 | — |
文档/音视频分析 | AI 摘要、关键词、章节摘要、提取对话、PPT 提取 | 需管理员开通 |
图片编辑 | 裁剪、缩放、水印、抠图、区域擦除等 18 种操作 | 需管理员开通 |
以图搜图 | 用网盘中已有图片检索相似图片,支持图文混合 | 需管理员开通 |
语义检索 | 用自然语言描述内容检索图片/视频/音频/文档 | 需管理员开通 |
2.2 触发词
中文和英文均可唤起:
通用:
PDS、网盘、云盘、个人空间、企业空间、团队空间、drive_id、domain_id文件操作:
上传文件到PDS、从PDS下载、PDS重命名、PDS移动文件、PDS复制文件、PDS创建文件夹、PDS打包下载、批量下载检索与分析:
PDS文件搜索、PDS文档分析、PDS视频分析、PDS以图搜图图像处理:
PDS图像编辑
或直接使用斜杠命令:/alibabacloud-pds-intelligent-workspace
环境准备
3.1 通过 Qoder 市场一键安装
打开 Qoder 客户端
进入 能力市场 → 技能市场
搜索「PDS」或「网盘」
点击 安装
客户端 | 最低版本 |
Qoder | v0.12.2+ |
一键安装会自动完成 Skill 文件下载、解压和部署,无需手动操作。
3.2 依赖环境
依赖 | 版本要求 | 处理方式 |
阿里云 CLI | >= 3.3.16 | Skill 执行时自动检查,不满足时提示升级 |
PDS 插件 | >= 0.7.7 | 开启自动安装后,首次调用 |
手动安装或升级:
# 安装/升级 CLI
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash
aliyun version # 确认 >= 3.3.16
# 开启插件自动安装
aliyun configure set --auto-plugin-install true
# 升级 PDS 插件
aliyun plugin update
aliyun pds version # 确认 >= 0.7.7凭证配置(首次使用配置一次)
4.1 两条鉴权路径
路径 | 适用角色 | 凭证类型 | 说明 |
路径 A:AK/SK | 网盘管理员 / 运维 | RAM AccessKey | 用于管理类操作与底层运维 |
路径 B:API Key | 网盘用户 | API Key( | 在 Qoder 中使用网盘能力的推荐方式 |
大多数在 Qoder 中使用网盘的用户,请直接走路径 B。
4.2 路径 A:管理员 AK/SK 配置
在终端独立运行交互式配置(不要在对话中粘贴 AK/SK 明文):
aliyun configure按提示输入:
Access Key ID / Secret:从 RAM 控制台 获取
Region ID:填写你的域所在区域,例如
cn-shanghai

4.3 路径 B:用户 API Key 授权(推荐)
核心原则:1 个 API Key = 1 个 Agent 身份。建议为每一个 Agent 用途分配独立的 Key,便于权限隔离和审计追踪。
第一步:在控制台生成 API Key
进入 API Key 管理页面,点击左上方「新建 API Key」(需要管理员先开启API Key)
填写以下信息:
字段
必填
说明
API Key 名称
是
最多 50 字符。建议「用途 + 部门」,例如「合同审查 Agent 专用 · 法务部」
访问权限
是
按最小权限原则配置。大多数 Agent 场景只读即可
过期时间
是
选择有效期
访问权限二选一:
权限模式
说明
保持与登录用户一致
动态继承登录用户的全部空间与权限,随用户权限变化
自定义
在登录用户权限范围内,手动指定可访问空间与操作权限
创建成功后立即复制保存密钥(格式
uk-xxxxxxxx,仅展示一次)
第二步:在 Qoder 中完成授权
安装完 Skill 后,直接对 Qoder 说「配置 API Key 授权」,它会引导你完成配置并自动验证。

在 Qoder 中使用
5.1 典型使用场景
场景 | 描述 | 示例指令 | 前置条件 |
空间容量巡检 | 查看各空间使用情况,识别容量瓶颈 | "查询一下我的网盘各空间的使用情况" | — |
批量文件上传 | 项目资料、设计稿、会议录音批量传到团队空间 | "把 ~/Design 目录下的文件上传到网盘" | — |
文件下载归档 | 从网盘下载文件到本地离线处理或备份 | "下载网盘里上周的会议录音到本地" | — |
打包批量下载 | 整个文件夹或多个文件打成 zip 一次拿走 | "把网盘 /投标材料 整个文件夹打包下载到本地" | 需管理员开通 |
精确查找文件 | 知道文件名,快速定位 | "帮我找一下网盘里叫 Q3财报.xlsx 的文件" | — |
模糊名称搜索 | 只记得部分文件名 | "搜一下名字里带'合同'的文件" | — |
文件整理归位 | 重命名、移动、复制、建目录、打标签 | "把网盘根目录下的散图都移到 /素材库/2026 里" | — |
文档智能分析 | 对合同、报告、PPT 做 AI 摘要和关键信息提取 | "分析一下网盘里的招标文件,给出重点摘要" | 需管理员开通 |
音视频速览 | 长视频/录音快速生成文字摘要,无需完整观看 | "总结一下网盘里那个2小时的培训视频讲了什么" | 需管理员开通 |
视频提取 PPT | 从录屏或培训视频中还原讲义 | "把网盘里的培训视频中的 PPT 提取成 pptx" | 需管理员开通 |
图片编辑处理 | 裁剪、水印、抠图、擦除区域 | "把网盘里的产品图加上公司水印" | 需管理员开通 |
语义内容搜索 | 用自然语言描述内容,AI 理解后返回结果 | "找一下关于云南旅游攻略的照片" | 需管理员开通 |
场景化图片检索 | 用文字描述画面场景搜索 | "搜一下网盘里有蓝天白云背景的风景照" | 需管理员开通 |
以图搜图 | 以网盘中已有的图为参考,找出相似图片 | "用网盘 /样图/产品A.jpg,找出类似角度的图" | 需管理员开通 |
文件外部分享 | 生成分享链接给外部伙伴,控权限和有效期 | "把方案文档创建一个7天有效的分享链接" | — |
5.2 两个必须知道的使用约束
① 以图搜图的参考图必须已在网盘里。 如果你给的是本地图片(如 ~/Downloads/cat.jpg 或对话中直接附上的图),Skill 会直接停止,不会代你上传。这是刻意的安全设计——避免未经确认就把本地文件写入企业空间。请先自行上传,再提供网盘路径或 file_id。
② 分析文件 ≠ 下载文件。 要"看懂内容"(摘要、精读、提关键点)时,Skill 走服务端分析,返回摘要、关键词、章节摘要、字幕等结构化结果,文件不落地。只有你明确说"下载""保存到本地"时才真正取文件字节。这两件事不会互相替代。
功能开通说明
有一批能力属于增值功能,需按域单独开通,与账号权限无关:
能力 | 未开通时的报错 |
语义检索(以文搜图/搜视频) |
|
以图搜图 |
|
文档/音视频分析 |
|
图片编辑 |
|
打包下载 |
|
看到 OperationNotSupport 或 MultimodalAnalysisNotEnabled 时,不要往权限方向排查——这是功能开关没打开,需联系 PDS 技术支持为该域开通。开通后按索引量和调用量计费。
常见问题排查
报错 | 真实原因 | 解决方案 |
| 配置停在纯 | 补全为 |
| 该增值功能未在域上开通 | 联系 PDS 技术支持开通,与权限无关 |
| 当前用户在控制台的空间访问权限不足 | 联系管理员在 PDS 控制台补配 Drive 权限 |
| 缺少域级"列举所有空间"权限 | 会自动降级为分别查个人空间和团队/企业空间,通常无需处理 |
| MoveFile 接口未对当前凭证授权 | 联系域管理员授权,重试无效 |
| 未配置 PDS 域 | 执行 |
| 认证类型大小写错误 | 使用小写: |
| PDS 插件缺失 | 确认 |
搜索返回 0 条 | 这是有效结果,不是失败 | 跨空间批量检索已递归扫完,无需换姿势重搜 |
检索不到明显存在的内容 | 文件名不含语义信息且未开语义索引 | 文件名为 |
核心概念速查
概念 | 说明 |
Domain | PDS 实例,拥有唯一 domain_id,域之间数据完全隔离 |
User | 域下的终端用户,拥有 user_id |
Group | 域下的团队组织,分为企业组和团队组 |
Drive | 存储空间,归属用户(个人空间)或团队(团队/企业空间) |
File | 空间下的文件或文件夹,拥有 file_id |
Revision | 文件的版本快照,拥有 revision_id;覆盖写会产生新 revision |
Share Link | 分享链接,支持提取码、有效期、预览/下载/转存/编辑权限控制 |