dsh-zspace：極空間 NAS 的 DeepSeek Harness 原生工具插件

前言¶

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。