dsh-zspace 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 变更日志
 
+## 0.3.1 — 2026-10-07
+
+- WebDAV 地址也支持环境变量 `ZS_WEBDAV_URL`：**三个环境变量即可启用直连，零 patch 改动**（避开 profile 层同 id 插两次导致挂载两次的坑）；`zspace_status` 报告统一走同一取值。
+- 测试 36 → 37（新增"仅靠环境变量也能启用直连"用例）。
+- README 补 macOS 上给 GUI 进程注入环境变量的做法（`launchctl setenv` + 完全重启桌面端）。
+
 ## 0.3.0 — 2026-10-07
 
 **双通道**：同一网络时直连 NAS 的 WebDAV，跨网络继续走桌面客户端云中转，插件自动选路。工具名与参数**完全不变**（仍是 13 个），既有配置继续可用。

package/README.md

@@ -44,7 +44,17 @@ dsh plugin --profile desktop add /绝对路径/dsh-zspace-0.1.0.tgz
 - `transportMode`：`auto`（默认）/ `webdav`（强制，失败直接报错）/ `relay`（保持旧行为）。
 - 路径映射：NAS 的 `/sata1/my/data/...` ↔ WebDAV 的 `<webdavHomePath>/...`（默认根 `/`）；公共空间由 `webdavPublicPath` 指定（默认空＝不在 WebDAV 暴露，相关路径自动回到中转）。
 - 极空间要在「系统设置 → 文件服务」里开启 WebDAV（默认端口 `5005`，本机实测可用；`5006` 是自签 HTTPS，证书校验会失败）。
-- 密码只走环境变量（`ZS_WEBDAV_PASSWORD`，可选 `ZS_WEBDAV_USER`），**不要写进 patch 文件**——patch 是明文，会被备份/截图带走。
+- **零 patch 配置**：三个环境变量就能启用直连，不需要改任何 patch 文件（避开"同 id 插两次导致挂载两次"的坑）：
+  `ZS_WEBDAV_URL`（如 `http://<nas-ip>:5005/`）、`ZS_WEBDAV_USER`（NAS 账号）、`ZS_WEBDAV_PASSWORD`。
+  插件跑在 DSH Desktop 进程里，所以要让**桌面端**能看到这些变量（macOS）：
+  ```sh
+  launchctl setenv ZS_WEBDAV_URL 'http://<nas-ip>:5005/'
+  launchctl setenv ZS_WEBDAV_USER '<NAS账号>'
+  launchctl setenv ZS_WEBDAV_PASSWORD '<密码>'
+  # 然后 Cmd+Q 完全退出 DSH Desktop 再重新打开（launchctl setenv 只影响之后启动的进程）
+  ```
+  想改回只走中转：`launchctl unsetenv ZS_WEBDAV_URL`（或设 `transportMode: relay`）。
+- 密码不写进 patch 文件——patch 是明文，会被备份/截图带走。
 - `zspace_remove` 在 WebDAV 通道下是 NAS 侧的删除语义（是否进回收站由 NAS 决定）；要确保进回收站请用 `transportMode: relay`。
 
 ## 工具

package/lib/client/webdav.js

@@ -37,6 +37,20 @@ export const PASSWORD_ENV = "ZS_WEBDAV_PASSWORD";
 /** Environment variable carrying the WebDAV user name. */
 export const USER_ENV = "ZS_WEBDAV_USER";
 
+/** Environment variable carrying the WebDAV base URL. */
+export const URL_ENV = "ZS_WEBDAV_URL";
+
+/**
+ * Effective WebDAV base URL: config first, environment as the fallback, so the
+ * fast path can be enabled without touching any patch file.
+ *
+ * @param {import("../client.js").ZSpaceClient} client - live client.
+ * @returns {string} base URL ("" when unset).
+ */
+export function webdavUrl(client) {
+	return String(client.webdavUrl || process.env[URL_ENV] || "").trim();
+}
+
 export const name = "webdav";
 
 /**
@@ -58,7 +72,7 @@ export function credentials(client) {
  * @returns {boolean} true when a URL and complete credentials are configured.
  */
 export function configured(client) {
-	return Boolean(String(client.webdavUrl ?? "").trim()) && credentials(client).complete;
+	return Boolean(webdavUrl(client)) && credentials(client).complete;
 }
 
 /**
@@ -68,7 +82,7 @@ export function configured(client) {
  * @returns {string} base URL.
  */
 function baseUrl(client) {
-	return String(client.webdavUrl ?? "").replace(/\/+$/, "");
+	return webdavUrl(client).replace(/\/+$/, "");
 }
 
 /**
@@ -281,8 +295,8 @@ export async function nasRoots(client) {
  * @returns {Promise<{reachable: boolean, usable: boolean, status?: number, reason: string}>} probe result.
  */
 export async function probe(client) {
-	if (!String(client.webdavUrl ?? "").trim()) {
-		return { reachable: false, usable: false, reason: "未配置 webdavUrl" };
+	if (!webdavUrl(client)) {
+		return { reachable: false, usable: false, reason: `未配置 WebDAV 地址（设置 ${URL_ENV} 或配置项 webdavUrl）` };
 	}
 	if (!credentials(client).complete) {
 		return { reachable: false, usable: false, reason: `缺少 WebDAV 凭据（设置 ${USER_ENV} 与 ${PASSWORD_ENV}）` };

package/lib/tools/status.js

@@ -5,6 +5,7 @@
  */
 
 import { humanSize } from "../format.js";
+import { webdavUrl } from "../client/webdav.js";
 
 export function createStatusTool(ctx) {
 	const { config, getClient, guarded } = ctx;
@@ -78,7 +79,7 @@ export function createStatusTool(ctx) {
 						ok: false,
 						baseUrl,
 						transport: transport.transport,
-						webdavUrl: client.webdavUrl ?? "",
+						webdavUrl: webdavUrl(client),
 						webdavProbe,
 						username: "",
 						nasId: "",
@@ -116,7 +117,7 @@ export function createStatusTool(ctx) {
 					ok: home.error === "" || publicSpace.error === "",
 					baseUrl,
 					transport: transport.transport,
-					webdavUrl: client.webdavUrl ?? "",
+					webdavUrl: webdavUrl(client),
 					webdavProbe,
 					username: identity.username,
 					nasId: identity.nasId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-zspace",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "极空间（ZSpace）NAS plugin for DeepSeek Harness: cross-network agent tools for browsing, searching, reading, uploading and organizing NAS files through the desktop client's relay — no LAN, no WebDAV, no SSH, no Python.",
   "type": "module",
   "license": "MIT",