前言¶
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
