腾讯云 COS 云存储的 DeepSeek Harness 插件。0.3.2 修复了桌面客户端云存储页上传时代理不提供 Content-Length 导致的错误；0.3.1 修复了 0.3.0 在 DSH 0.2.0-rc.2 中从 npm 安装后无法激活的问题。DSH 0.1.2 用户请继续使用插件 0.2.1。

界面预览

COS 云存储面板

当前能力

作为 bundle 安装到 DSH web profile。
在 DSH 0.2 的“插件 > dsh-cos”配置 SecretId、SecretKey、存储桶、地域、目录前缀和自定义域名。
密钥只保存到 DSH Host 凭据服务，浏览器不读取或回显原文。
支持保存普通配置并测试 COS 存储桶连接。
在工作区上方显示“COS 云存储”菜单，按目录前缀浏览存储桶内容。
支持宫格/列表视图、多选操作，每页最多 100 项，支持 Marker 上一页/下一页。
支持面包屑导航、刷新、双击进入目录以及查看文件和文件夹属性。
支持在当前目录新建文件夹；上传弹窗可选择或拖拽多个文件、文件夹并保留目录层级。
上传任务由 Host 管理，任务抽屉展示总体/单项进度、速度和耗时，支持暂停、继续、取消、失败重试、删除记录和清理已完成。
上传采用浏览器 → DSH Host → COS 流式 Multipart Upload，不在内存中缓存完整文件，不设置插件级单文件大小限制；最多同时上传 3 个文件，其余任务自动排队。切换页面不终止本次上传，但刷新浏览器后未完成的浏览器文件无法自动恢复；可在任务抽屉取消旧任务并重新选择文件。
文件支持下载和获取 15 分钟临时链接；文件夹和文件支持单项或批量不可恢复删除。
会话输入框提供“COS 云存储”附件入口：选中的 COS 文件或目录会下载到当前会话工作区，再以附件卡片加入消息；模型可读取本地副本，并同时获知对应 COS URI 和地域。作为会话附件导入的文件夹上限为 1000 个文件或 1 GiB；云盘自身的上传不受此目录导入限制。
提供内置 tencentcloud-cos Skill，以及两个账号级 Agent Tool：tencentcloud_cos_storage_manage 管理 COS Bucket、对象和 Bucket 配置；tencentcloud_cos_ci_manage 管理数据万象（CI）和 MetaInsight。
账号级 Tool 通过 Action + Parameters 调用内置白名单，自动使用 DSH Host 中已配置的 COS 凭证；密钥不会进入 Agent 上下文或 Tool 参数。
Tool 操作范围由当前凭证的 CAM 权限决定；COS 云存储默认 Bucket/Region 仅是可选缺省值，管理 Tool 可显式访问其他获授权 Bucket。
Agent 侧只注册上述两个 Tool，不注册场景专用 Tool 或 Action。内置 Skill 会先从现有 help 输出的 DefaultCloudStorage 读取非敏感配置，再复用通用 COS list、head、upload、download、delete-multiple 等 Action。
写入、配置变更和删除由内置 Skill 在调用前说明目标与影响，并等待用户在后续消息明确同意；Tool 不创建 DSH 审批卡。不提供任意 HTTP 请求、任意 Shell、删除 Bucket 或清空 Bucket 的入口。
替换默认附件提供者后，图片仍可存入 COS；DSH 0.2 的普通文件附件保留本地流式存储和历史路径读取能力。
插件卸载或热更新时清理路由、上传任务、样式和监听器。

快速开始

系统要求

已安装 DeepSeek Harness，dsh web 可以正常启动。
COS 存储桶及具有相应 CAM 权限的腾讯云访问密钥。
运行 DSH 的 Node.js 版本必须为 >=22.19.0；从源码安装或开发插件时还需要 pnpm。

从 npm 安装（推荐）

0.3.2 发布后，可将该版本安装到 DSH 0.2.0-rc.2 的 web profile：

dsh plugin --profile web add dsh-cos@0.3.2
dsh web

如果通过 DSH 源码仓库运行命令，将上面的 dsh 换成 pnpm dsh：

pnpm dsh plugin --profile web add dsh-cos@0.3.2
pnpm dsh web

安装完成后必须重启 dsh web，侧边栏才会出现“COS 云存储”入口。DSH 桌面客户端使用独立的 desktop profile：请在桌面客户端的“插件”页面安装 dsh-cos@0.3.2 并重启客户端；全局 dsh plugin --profile web 不会更新桌面客户端的插件。

配置并使用

打开“插件 > dsh-cos”，进入插件详情的 COS 配置卡。升级时插件会尝试恢复旧 settings.yaml 的 COS 配置；升级前请备份该文件。
填写 SecretId、SecretKey、Bucket、Region；按需填写目录前缀和自定义域名。
点击“测试连接”，通过后保存配置。
从侧边栏进入“COS 云存储”，即可浏览、上传、下载、预览和生成临时链接。
在 AI 会话中可以直接说“把这些产物同步到 COS 云存储”或“给刚上传的文件生成临时分享链接”；内置 Skill 会先确认目标和影响，再调用 Agent Tool。

插件配置

COS 云存储配置

在会话中添加 COS 附件

打开任意有工作区的会话，点击输入框左侧的“COS 云存储”。
在弹窗中浏览 COS，选择一个或多个文件或目录后点击“添加附件”。
插件将每个选中的对象下载到当前会话工作区的 .dsh-cos/<sessionId>/，并在输入框显示附件卡片。
发送消息时，每个 COS 附件都会独立提供本地工作区路径、cos://<bucket>/<key> 和地域。AI 因而既能读取文件内容，也能定位其云端对象。
从输入框移除附件只删除会话工作区副本，不会删除 COS 中的源文件或目录。

验证、更新与卸载

# 查看 web profile 是否已挂载插件
dsh --profile web --dump-config

# 更新到 npm 最新版本
dsh plugin --profile web update dsh-cos

# 卸载插件
dsh plugin --profile web remove dsh-cos

使用 DSH 源码仓库时，同样将每条命令开头的 dsh 换成 pnpm dsh。更新或卸载后也要重启 dsh web。

如果新版本刚发布但实际安装成旧版本，请检查 DSH profile 的 pnpm-workspace.yaml 是否配置了 minimumReleaseAge。可临时设为 0，或将 dsh-cos 加入 minimumReleaseAgeExclude，再执行更新命令。

从源码安装（开发调试）

npm 安装是正常使用方式；只有开发或调试插件时才需要链接本地仓库：

git clone https://github.com/annexwu/dsh-cos.git
cd dsh-cos
pnpm install --frozen-lockfile
pnpm verify

# 使用 DSH 源码仓库时，在 DSH 根目录执行：
pnpm dsh plugin --profile web add 'link:<dsh-cos 绝对路径>'
pnpm dsh web