前言¶
DeepSeek Harness（DSH）允许通过插件扩展能力。在云资源管理的场景中，开发者需要将现有的命令行工具能力迁移到 DSH 环境。UCloud Skill for DeepSeek Harness 旨在解决这个问题，它将 ucloud-cli 技能迁移到 DSH 0.1.0-rc.6，使模型能够通过 DSH 接口调用 UCloud 资源。
插件定位¶
该插件由 UCloud 维护，遵循 MIT 协议。其核心作用是将 ucloud-cli 技能适配到 DeepSeek Harness 0.1.0-rc.6 环境，注册完整的打包 skill 及其引用，而不实现额外的 API 客户端或命令包装器。
工作原理¶
插件通过 DSH 的 Bash 工具调用官方 CLI，而非直接调用 API。请求流程如下：
User request
-> bundled ucloud-cli skill
-> DSH Bash tool
-> official ucloud CLI
-> UCloud API
核心功能¶
该 skill 提供了以下能力：
* 资源操作：支持资源的巡检、创建、更新和删除。
* 配置与部署：支持初始化 OAuth 配置、部署应用程序。
* 命令执行：支持使用产品命令，并在必要时回退到 ucloud api。
安装与前置要求¶
安装前请确保环境满足以下条件：
1. DeepSeek Harness 版本为 0.1.0-rc.6，且启用了标准 Skill 和 Bash 插件。
2. Node.js 版本为 22 或更新版本。
3. 官方 CLI：ucloud CLI 版本为 0.3.1 或更新版本，且已安装在系统 PATH 中。
4. 凭证：插件不读取或管理 UCloud 凭证，认证由官方 CLI 及其 Profile/OAuth 状态负责。
安装插件到目标 Profile：
dsh plugin --profile <profile-name> add @ucloud-ai/ucloud-dsh-plugin
使用方式¶
安装后，Skill 可以被模型自动选择，或通过 DSH Skill 接口显式调用 ucloud-cli。
权限与注意事项¶
- 执行控制：插件不添加自定义执行工具，所有命令执行均通过 DSH 的现有 Bash 工具进行。因此，文件系统、网络、变更审批权限由 DSH Profile 控制。
- 生产环境：由于原 Skill 支持真实变更（创建计费资源、中断服务等），生产环境 Profile 应保留 DSH 的审批提示，并使用最小权限的 UCloud IAM 策略。
结语¶
该插件为 DSH 生态提供了标准化的 UCloud 资源管理入口。对于需要集成云资源操作的智能体开发，该方案提供了兼容性与安全性保障。
- GitHub: https://github.com/ucloud/ucloud-dsh-plugin
- 目录: https://www.skillhub.cn/plugins/ucloud/ucloud-dsh-plugin
