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