Back to home@annexwu

dsh-cos

No description

Stars
0
Language
TypeScript
Created
Aug 19, 2026
Updated
Aug 19, 2026
GitHub repo

Introduction

DSH COS 云存储插件

腾讯云 COS 云存储的 DeepSeek Harness Web 插件。

当前能力

  • 作为 bundle 安装到 DSH web profile。
  • 在设置页配置 SecretIdSecretKey、存储桶、地域、目录前缀和自定义域名。
  • 密钥只保存到 DSH Host 凭据服务,浏览器不读取或回显原文。
  • 支持保存普通配置并测试 COS 存储桶连接。
  • 在工作区上方显示“COS 云存储”菜单,按目录前缀浏览存储桶内容。
  • 支持宫格/列表视图、多选操作,每页最多 100 项,支持 Marker 上一页/下一页。
  • 支持面包屑导航、刷新、双击进入目录以及查看文件和文件夹属性。
  • 支持在当前目录新建文件夹;上传弹窗可选择或拖拽多个文件、文件夹并保留目录层级。
  • 上传任务由 Host 管理,任务抽屉展示总体/单项进度、速度和耗时,支持暂停、继续、取消、失败重试、删除记录和清理已完成。
  • 上传采用浏览器 → DSH Host → COS 流式 Multipart Upload,不在内存中缓存完整文件,不设置插件级单文件大小限制,并限制最多 3 个并发上传。
  • 文件支持下载和获取 15 分钟临时链接;文件夹和文件支持单项或批量不可恢复删除。
  • 提供内置 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 listheaduploaddownloaddelete-multiple 等 Action。
  • 写入、配置变更和删除由内置 Skill 在调用前说明目标与影响,并等待用户在后续消息明确同意;Tool 不创建 DSH 审批卡。不提供任意 HTTP 请求、任意 Shell、删除 Bucket 或清空 Bucket 的入口。
  • 插件卸载或热更新时清理路由、上传任务、DOM、React Root、样式和监听器。

本地构建

要求 Node.js >=22.19.0 和 pnpm。

pnpm install
pnpm typecheck
pnpm test
pnpm build

安装到源码版 DSH

先完成构建,再进入 DSH 源码根目录,以 link bundle 加入 web profile:

pnpm dsh plugin --profile web add 'link:<插件目录的绝对路径>'
pnpm dsh web

进入 Web UI 后验证:

  1. 打开“设置 > 插件 > 插件配置”,填写 COS 配置。
  2. 点击“测试连接”,确认可以访问存储桶,再保存配置。
  3. 刷新页面,确认普通配置恢复,密钥不回显但仍显示已配置。
  4. 确认左侧“COS 云存储”位于工作区上方,且页面切换正常。

移除插件:

pnpm dsh plugin --profile web remove dsh-cos