dsh-zspace: Native DeepSeek Harness Tool Plugin for JiSpace NAS

前言¶

DeepSeek Harness (DSH) 插件生态让构建智能体更加灵活。对于使用极空间（ZSpace）NAS 的开发者，传统接入方案往往受限于网络环境（如 WebDAV 需同网段）或需要额外运行 Python 脚本。dsh-zspace 插件直接将 NAS 作为一个原生的 agent 工具接入，不依赖 SSH、WebDAV 或 Python，解决了跨网络访问与本地权限隔离的问题。

插件介绍¶

dsh-zspace 是一个由 439436269-ctrl 维护的 DeepSeek Harness 插件。它把 NAS 变成 agent 的原生工具 —— 跨网络可用，不需要同一局域网、不需要 WebDAV、不需要 SSH、不需要 Python。认证直接复用极空间桌面客户端的登录态，只要桌面客户端在线即可使用。

安装与启用¶

使用 npm 安装插件：

dsh plugin --profile desktop add dsh-zspace@latest

安装完成后，重启 DeepSeek Harness 以加载新工具。
前置条件：
- 极空间桌面客户端已安装、已登录并正在运行。
- 该账号对目标空间有权限（个人空间 / 公共空间）。
- 不需要给 NAS 开任何端口，也不需要 DDNS。

核心功能¶

插件提供以下工具能力：

工具	作用
`zspace_status`	探活：检查当前通道（直连/中转）、账号、存储池余量等。
`zspace_ls`	列目录：支持递归与限制，自动处理 NAS 单页 50 条的限制。
`zspace_stat`	单个文件/目录的元信息（大小、修改/创建时间）。
`zspace_find`	按名称查找：在目录树里查找（大小写不敏感）。
`zspace_read`	读取文本文件（默认上限 256 KB）。
`zspace_download`	下载文件到本地。
`zspace_upload`	上传文件到 NAS。
`zspace_write`	写入文本文件到 NAS（直接写入）。
`zspace_mkdir`	建目录。
`zspace_rename`	重命名。
`zspace_move`	移动到另一个目录。
`zspace_copy`	复制。
`zspace_remove`	删除文件。

典型用法¶

路径写法¶

路径支持多种写法：
- ""：个人空间根。
- home:相册：个人空间下的 相册。
- public:公共分组/skills：公共空间下的路径。
- docs/2026：相对个人空间根。
- /<pool>/my/data/x.txt：NAS 绝对路径。

删除操作¶

删除文件需要显式传 confirm: true，且文件会被移入 NAS 侧回收站。

环境变量（直连模式）¶

若要启用同网络直连 WebDAV，可设置环境变量：
- ZS_WEBDAV_URL：如 http://<nas-ip>:5005/
- ZS_WEBDAV_USER：NAS 账号
- ZS_WEBDAV_PASSWORD：密码

适用场景与注意¶

本插件不存任何凭据，每次调用从桌面客户端的 vuex.json 现读 token。这意味着：
- 换任何网络都能用，只要跑 DSH 的机器上极空间桌面客户端在线。
- 桌面客户端退出登录即失效。

已知限制：
- 极空间没有官方公开 API，本插件走的是社区整理的桌面客户端接口，客户端大版本更新可能改动。
- zspace_find 使用受限目录遍历而非网页接口。
- 单次 list 最多 50 条。

短结尾¶

dsh-zspace 通过复用桌面客户端的中转能力，让 agent 能够无感地操作 NAS 文件系统，省去了配置 WebDAV 或 SSH 的麻烦。相关代码与文档可参考 GitHub：https://github.com/439436269-ctrl/dsh-zspace。