@yezack/dsh-remote-mobile 1.9.2 → 1.10.2

package/lib/routes/register.d.ts

@@ -0,0 +1,9 @@
+import type { WebRoute } from './api.js';
+/**
+ * 将插件路由注册到 DSH WebServer。
+ *
+ * DSH 0.2.1+ 的 `register(route)` 返回一个撤销函数。这里统一收集这些函数，
+ * 并通过 Cordis `ctx.effect` 绑定到插件生命周期，避免插件重复激活时旧路由
+ * 残留导致 `duplicate undefined route`。
+ */
+export declare function registerWebRoutes(ctx: any, routes: WebRoute[]): void;

package/lib/routes/register.js

@@ -0,0 +1,53 @@
+/**
+ * 将插件路由注册到 DSH WebServer。
+ *
+ * DSH 0.2.1+ 的 `register(route)` 返回一个撤销函数。这里统一收集这些函数，
+ * 并通过 Cordis `ctx.effect` 绑定到插件生命周期，避免插件重复激活时旧路由
+ * 残留导致 `duplicate undefined route`。
+ */
+export function registerWebRoutes(ctx, routes) {
+    const webServer = ctx?.webServer;
+    if (!webServer || typeof webServer.register !== 'function')
+        return;
+    const registerAll = () => {
+        const disposers = [];
+        try {
+            for (const route of routes) {
+                const dispose = webServer.register({
+                    ...route,
+                    kind: route.kind ?? 'exact',
+                });
+                if (typeof dispose === 'function') {
+                    disposers.push(dispose);
+                }
+            }
+        }
+        catch (error) {
+            // 中途失败时撤销本轮已经注册的路由，避免留下半套 API。
+            for (const dispose of disposers.reverse()) {
+                try {
+                    dispose();
+                }
+                catch { }
+            }
+            throw error;
+        }
+        return () => {
+            for (const dispose of disposers.reverse()) {
+                try {
+                    dispose();
+                }
+                catch { }
+            }
+        };
+    };
+    if (typeof ctx.effect === 'function') {
+        ctx.effect(registerAll, 'dsh-remote-mobile:web-routes');
+        return;
+    }
+    // 兼容没有 ctx.effect 的旧宿主：至少尝试在 dispose 事件中回收路由。
+    const cleanup = registerAll();
+    if (typeof ctx.on === 'function') {
+        ctx.on('dispose', cleanup);
+    }
+}

package/lib/startup-hint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 在 DSH webserver 校验失败退出后追加一条针对通配地址错误的友好提示。
+ * 只在 stderr 命中 DSH 的 wildcard 报错时触发，其他启动错误不输出。
+ */
+export declare function installStartupFailureHint(): void;

package/lib/startup-hint.js

@@ -0,0 +1,72 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { DSH_HOME } from './auth/token.js';
+const WILDCARD_ERROR_RE = /host\s+["']?(?:0\.0\.0\.0|::)["']?\s+is an unspecified \(wildcard\) address|binding every interface would expose remote code execution/i;
+let installed = false;
+let sawWildcardError = false;
+/** 查找配置中 webserver 使用通配地址的 profile patch 文件 */
+function findWildcardConfigFile() {
+    const files = [join(DSH_HOME, 'cordis.patch.yml')];
+    try {
+        for (const entry of readdirSync(join(DSH_HOME, 'profiles'), { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            files.push(join(DSH_HOME, 'profiles', entry.name, 'cordis.patch.yml'));
+        }
+    }
+    catch { }
+    for (const file of files) {
+        if (!existsSync(file))
+            continue;
+        let content = '';
+        try {
+            content = readFileSync(file, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split(/\r?\n/);
+        for (let i = 0; i < lines.length; i++) {
+            if (!/^\s*-\s*id:\s*['"]?webserver['"]?\s*$/.test(lines[i]))
+                continue;
+            for (let j = i + 1; j < lines.length; j++) {
+                if (/^\s*-\s*id:/.test(lines[j]))
+                    break;
+                if (/^\s*host:\s*['"]?(?:0\.0\.0\.0|::)['"]?\s*$/.test(lines[j]))
+                    return file;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 在 DSH webserver 校验失败退出后追加一条针对通配地址错误的友好提示。
+ * 只在 stderr 命中 DSH 的 wildcard 报错时触发，其他启动错误不输出。
+ */
+export function installStartupFailureHint() {
+    if (installed)
+        return;
+    installed = true;
+    const originalWrite = process.stderr.write.bind(process.stderr);
+    process.stderr.write = ((chunk, encoding, callback) => {
+        try {
+            if (WILDCARD_ERROR_RE.test(String(chunk)))
+                sawWildcardError = true;
+        }
+        catch { }
+        return originalWrite(chunk, encoding, callback);
+    });
+    process.once('exit', () => {
+        if (!sawWildcardError)
+            return;
+        const file = findWildcardConfigFile();
+        console.error(`
+[dsh-remote-mobile] 启动失败提示：
+检测到 DSH webserver 使用了通配地址 0.0.0.0 / ::。
+DSH 0.2.1+ 不允许这种监听方式，插件无法在 webserver 校验前接管。
+${file ? `请删除或注释 ${file} 中的 webserver 配置块；` : '请删除或注释 profile 的 cordis.patch.yml 中的 webserver 配置块；'}
+保持默认 127.0.0.1:3080，然后重启 dsh web。
+重启后 dsh-remote-mobile 会自动使用 3081 安全接入代理。
+`);
+    });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yezack/dsh-remote-mobile",
-  "version": "1.9.2",
-  "description": "DeepSeek Harness 远程与移动端安全网关插件：零修改 DSH 底层代码安全开放局域网与 Tailscale 连接 | DeepSeek Harness (DSH) Remote & Mobile Security Guard: safely opens Tailscale/LAN with zero core modifications, QR scan auth, RSA encryption & brute-force defense.",
+  "version": "1.10.2",
+  "description": "DeepSeek Harness 远程与移动端安全接入代理插件：零修改 DSH 底层代码安全开放局域网与 Tailscale 连接 | DeepSeek Harness (DSH) Remote & Mobile Secure Access Proxy: safely opens Tailscale/LAN with zero core modifications, QR scan auth, RSA encryption & brute-force defense.",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -31,8 +31,8 @@
     "build:server": "tsc",
     "build:client": "node scripts/build-client.js",
     "typecheck": "tsc --noEmit",
-    "pretest": "node scripts/build-client.js",
-    "test": "node --test test/**/*.test.js",
+    "pretest": "npm run build",
+    "test": "node --test",
     "prepublishOnly": "npm run build && npm test",
     "release": "node scripts/release.js",
     "release:patch": "node scripts/release.js patch",