前言¶
在 DeepSeek Harness 裏做自動化時，NAS 上的文件、容器和下載任務往往還在另一套界面裏操作：要麼 SSH 進機器，要麼單獨開管理頁。綠聯 UGOS Pro 提供了基於 HTTPS 的 OpenCLI，以及控制面板裏可簽發的「訪問令牌」，按大類勾選權限。維護者 BuvkB 的 dsh-ugreen-nas 把這套接口封裝成 DSH 插件工具：對話裏能查狀態、讀文件，在令牌允許時也能執行寫操作；權限邊界由 NAS 端令牌決定，插件側還會按授予情況註冊工具，並支持只讀模式。下面介紹它是什麼、能做什麼，以及如何安裝與配置。
這是什麼¶
dsh-ugreen-nas 是 DeepSeek Harness 的 UGREEN NAS OpenCLI 連接器（npm 包名 dsh-ugreen-nas，當前版本 0.3.5，MIT 許可證）。它通過 NAS 控制面板簽發的訪問令牌（ugpoa_v1 開頭）經 HTTPS 連接設備，不依賴賬號密碼，也不走 SSH。插件在 SkillHub 社區目錄中歸類爲聯網工具；倉庫 GitHub 與目錄頁 SkillHub 由社區維護，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
README 中歸納的能力如下，均對應 UGOS Pro 訪問令牌在 8 個大類上的 70 項權限面；插件提供 59 個工具，激活時按大類探測，未授予的大類不會註冊對應工具。
| 大類 | 典型操作 |
|---|---|
| 文件 | 讀寫、建目錄、複製/移動/改名/刪除、回收站恢復、標籤、配額 |
| Docker | 容器啓停與日誌、Compose 項目全生命週期、鏡像搜索與拉取、端口/目錄/獨顯佔用檢查 |
| 下載 | HTTP 下載任務的創建、暫停、恢復、重試、移除 |
| 應用 | 應用中心安裝/卸載/更新、啓動/停用（含流式安裝/卸載/更新） |
| 存儲 | 磁盤、存儲池、卷狀態，S.M.A.R.T. 健康診斷 |
| 任務 | CPU/內存/GPU/網絡/磁盤/卷指標，服務與進程佔用 |
| 控制面板 | 系統版本、網絡配置、硬件（風扇/UPS）、賬號與用戶組 |
| 全局搜索 | 按名稱、類型、大小、時間搜索文件 |
權限即邊界：令牌沒勾的能力，對應工具不註冊；細粒度校驗在 NAS 端，例如同一大類只勾刪除未勾寫入時，調用可能返回 403 並指明缺哪項。改權限需在 NAS 端重建令牌，插件設置頁可一鍵重新探測。
只讀開關：配置項 mode=readonly 時只註冊只讀工具；刪除、卸載、停機等寫操作在工具側帶【寫/危險操作】標註，由 DSH 工具審批逐步確認。
設置頁會實時顯示 8 個大類的「已授予 / 未授予」狀態。
安裝與啓用¶
1、在 NAS「控制面板 → 賬號 → 訪問令牌」創建令牌，按需勾選權限。日常可先只勾 read，需要寫操作再單獨簽發令牌。
2、安裝插件（官方推薦 npm 包，需 Node >= 20）：
dsh plugin --profile web add dsh-ugreen-nas # npm 包，推薦
也可從源碼構建後在插件管理頁選擇本地目錄（README 說明爲 clone 倉庫後 npm install && bash scripts/build.sh；本文不展開 clone 步驟）。
3、在 DSH「設置 → 插件 → 綠聯 NAS」填寫連接信息，保存後點「測試連接」。
| 配置 | 默認 | 說明 |
|---|---|---|
| endpoint | — | NAS 地址；裸 IP 自動補 https://:9443，也支持 UGREENlink / DDNS |
| accessToken | — | 訪問令牌（ugpoa_v1 開頭），只存本機設置，不回顯 |
| mode | full | full 註冊全部已授權工具；readonly 只註冊只讀工具 |
| timeoutMs | 15000 | 單次請求超時（毫秒） |
| rejectUnauthorized | false | 自簽證書時保持關閉；換可信證書後可打開 |
典型用法¶
連接成功後，模型在對話中調用以 ugreen_ 爲前綴的工具。例如：
- 探活：
ugreen_connection_test - 文件：
ugreen_file_list、ugreen_file_read、ugreen_file_stat等（寫操作需令牌與mode允許） - Docker：
ugreen_docker_list、ugreen_docker_logs、ugreen_compose_list等 - 系統與資源：
ugreen_system_info、ugreen_task_overview、ugreen_task_metrics - 搜索：
ugreen_search
完整 59 個工具名見 GitHub README 摺疊表格。協議與流式幀格式見倉庫內 docs/ugreen-opencli-protocol.md。
適用場景與注意¶
適合：已在用 DSH 編排任務，希望把綠聯 NAS 上的文件、容器、下載、應用和監控指標納入同一套工具調用，且願意用訪問令牌而不是共享主賬號密碼。
安全與權限：
- 訪問令牌權限等於創建時勾選範圍；Files 權限按賬號授權，不支持按文件夾限權。
- 令牌僅應保存在本機插件 secret 字段，不要寫入代碼、日誌或對話。
- 插件以當前 DSH 進程權限運行；安裝前建議閱讀源碼與 MIT 許可證，確認工具行爲符合預期。
生態：DSH 採用「一切皆插件」思路；SkillHub 爲獨立社區目錄站點，安裝命令以 README 爲準，勿憑倉庫名自行拼接未文檔化的 add 參數。
結尾¶
dsh-ugreen-nas 把 UGOS Pro OpenCLI 與 scoped 訪問令牌接到 DSH：59 個工具覆蓋令牌 70 項權限面，支持只讀模式與設置頁權限可見性。需要細節時查閱目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/BuvkB/dsh-ugreen-nas
- GitHub：https://github.com/BuvkB/dsh-ugreen-nas
