dsh-mobile 0.1.0-alpha.19 → 0.1.0-alpha.20

package/README.en.md

@@ -44,6 +44,14 @@ pnpm dsh --profile web
 
 Open **Mobile Access** in the lower-left DeepSeek Harness sidebar, enable it, and select **Create and copy key**. In the Android app, tap **Scan**, select the computer, and enter the key. The paired device remains trusted until it is revoked, expires, or its app data is cleared.
 
+## Compatibility
+
+| DSH Mobile | Verified DeepSeek Harness releases |
+| --- | --- |
+| `0.1.0-alpha.20` | `0.1.0-rc.5`, `0.1.0-rc.6` |
+
+At startup, the plugin verifies the DSH Host version and the frontend dependencies required by the mobile layout. An unverified release fails with a clear error instead of serving a broken page. CI also tracks the DSH main branch layout slots and mobile semantic markers. If a DSH upgrade reports an incompatibility, update DSH Mobile first.
+
 ## Connection options
 
 | Client | Best for | Notes |

package/README.md

@@ -7,9 +7,9 @@
 <p align="center">在手机上安全、实时地使用电脑中的 DeepSeek Harness。</p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/dsh-mobile"><img src="https://img.shields.io/npm/v/dsh-mobile?tag=alpha&amp;label=npm&amp;color=CB3837" alt="npm 版本"></a>
+  <a href="https://www.npmjs.com/package/dsh-mobile"><img src="https://img.shields.io/npm/v/dsh-mobile?tag=alpha&label=npm&color=CB3837" alt="npm 版本"></a>
   <a href="https://github.com/saya-ch/dsh-mobile/actions/workflows/ci.yml"><img src="https://github.com/saya-ch/dsh-mobile/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://github.com/saya-ch/dsh-mobile/releases"><img src="https://img.shields.io/badge/Android-10%2B-3DDC84?logo=android&amp;logoColor=white" alt="Android 10+"></a>
+  <a href="https://github.com/saya-ch/dsh-mobile/releases"><img src="https://img.shields.io/badge/Android-10%2B-3DDC84?logo=android&logoColor=white" alt="Android 10+"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-0F172A" alt="Apache-2.0"></a>
 </p>
 
@@ -20,7 +20,7 @@
   <a href="README.en.md">English</a>
 </p>
 
-> Alpha 版本，当前原生 App 仅支持 Android。本项目是社区插件，不是 DeepSeek 官方产品。
+> Alpha 版本，当前原生 App 仅支持 Android。本项目为 DeepSeek Harness 社区插件。
 
 <p align="center"><a href="https://github.com/saya-ch/dsh-mobile/releases"><strong>下载 Android App</strong></a></p>
 
@@ -65,12 +65,21 @@ pnpm dsh --profile web
 
 插件不会修改 DeepSeek Harness 源码。设置、证书、设备和自定义文件保存在 `$DSH_HOME/mobile-access/`。
 
+## 兼容性
+
+| DSH Mobile | 已验证的 DeepSeek Harness |
+| --- | --- |
+| `0.1.0-alpha.20` | `0.1.0-rc.5`、`0.1.0-rc.6` |
+
+插件会在启动时检查 DSH Host 版本和移动布局所需的前端依赖；遇到未经验证的版本会直接给出错误，不会带着不兼容页面继续启动。CI 也会持续检查 DSH 主分支的布局插槽和移动端语义标记。升级 DSH 后如遇兼容提示，请先升级 DSH Mobile。
+
 ## 连接方式
 
-| 方式 | 适合场景 | 说明 |
-| --- | --- | --- |
-| Android App | 日常使用 | 自动发现、无浏览器栏、App 内私有证书固定 |
-| 手机浏览器 | 临时或跨平台访问 | 打开“移动访问”卡片显示的 HTTPS 地址 |
+
+| 方式        | 适合场景         | 说明                                     |
+| ------------- | ------------------ | ------------------------------------------ |
+| Android App | 日常使用         | 自动发现、无浏览器栏、App 内私有证书固定 |
+| 手机浏览器  | 临时或跨平台访问 | 打开“移动访问”卡片显示的 HTTPS 地址    |
 
 Android 同时使用 mDNS/NSD、UDP 公告、主动 UDP 查询和 HTTPS 探测发现 DeepSeek Harness。发现只广播设备名、地址、端口、协议版本和稳定 `instanceId`，不会广播密钥或令牌。
 

package/lib/index.d.mts

@@ -302,6 +302,15 @@ declare function parseControlFile(value: unknown): string;
 /** Parse configuration and reject unsafe topology, credential, and resource combinations. */
 declare function parseGatewayConfig(raw: unknown): ResolvedGatewayConfig;
 //#endregion
+//#region src/compatibility.d.ts
+/** DeepSeek Harness prereleases verified by this plugin release. */
+declare const SUPPORTED_DSH_VERSIONS: readonly ["0.1.0-rc.5", "0.1.0-rc.6"];
+/**
+ * Reject an unverified DeepSeek Harness Host before opening the LAN listener.
+ * @param version - Version reported by the installed DSH WebServer package.
+ */
+declare function assertSupportedDshVersion(version: unknown): asserts version is typeof SUPPORTED_DSH_VERSIONS[number];
+//#endregion
 //#region src/control.d.ts
 /** Versioned durable preference for the resident mobile-access runtime. */
 interface MobileAccessControlState {
@@ -429,5 +438,5 @@ declare const inject: string[];
 /** Mount the resident control route and its optional authenticated LAN gateway. */
 declare function apply(ctx: Context, config: PluginConfig): Promise<void>;
 //#endregion
-export { AUTH_PREFIX, AccessController, type AccessControllerOptions, AccessError, type AuthoritySpec, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, DEVICE_COOKIE, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, JsonDeviceStore, JsonMobileAccessControlStore, LOCAL_ADMIN_PREFIX, MemoryDeviceStore, type MobileAccessControlState, type MobileAccessControlStore, MobileAccessGateway, MobileAccessGatewayController, type MobileAccessRuntime, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type RenewalResult, RequestTrustPolicy, type ResolvedGatewayConfig, SESSION_COOKIE, type SessionAuthorization, type StoredDevice, type TlsConfig, WS_PATHS, addressAllowed, apply, inject, isLoopbackAddress, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseGatewayConfig, parseMobileAccessControlState, resolveAuthority, rewriteMobileIndex };
+export { AUTH_PREFIX, AccessController, type AccessControllerOptions, AccessError, type AuthoritySpec, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, DEVICE_COOKIE, type DeviceSnapshot, type DeviceStore, type DeviceSummary, type DisabledTlsConfig, JsonDeviceStore, JsonMobileAccessControlStore, LOCAL_ADMIN_PREFIX, MemoryDeviceStore, type MobileAccessControlState, type MobileAccessControlStore, MobileAccessGateway, MobileAccessGatewayController, type MobileAccessRuntime, type PairingResult, type ParsedCidr, type PluginConfig, type ProvidedTlsConfig, type RenewalResult, RequestTrustPolicy, type ResolvedGatewayConfig, SESSION_COOKIE, SUPPORTED_DSH_VERSIONS, type SessionAuthorization, type StoredDevice, type TlsConfig, WS_PATHS, addressAllowed, apply, assertSupportedDshVersion, inject, isLoopbackAddress, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseGatewayConfig, parseMobileAccessControlState, resolveAuthority, rewriteMobileIndex };
 //# sourceMappingURL=index.d.mts.map

package/lib/index.mjs

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { X509Certificate, createHash, createPrivateKey, createPublicKey, randomBytes, timingSafeEqual } from "node:crypto";
 import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -694,6 +695,18 @@ function parseGatewayConfig(raw) {
 	});
 }
 //#endregion
+//#region src/compatibility.ts
+/** DeepSeek Harness prereleases verified by this plugin release. */
+const SUPPORTED_DSH_VERSIONS = Object.freeze(["0.1.0-rc.5", "0.1.0-rc.6"]);
+/**
+* Reject an unverified DeepSeek Harness Host before opening the LAN listener.
+* @param version - Version reported by the installed DSH WebServer package.
+*/
+function assertSupportedDshVersion(version) {
+	if (typeof version === "string" && SUPPORTED_DSH_VERSIONS.some((candidate) => candidate === version)) return;
+	throw new Error(`unsupported DeepSeek Harness version ${typeof version === "string" ? version : "(unknown)"}; supported versions: ${SUPPORTED_DSH_VERSIONS.join(", ")}`);
+}
+//#endregion
 //#region src/control.ts
 /** Keeps one runtime aligned with a changing network selection. */
 var FollowingMobileAccessRuntime = class {
@@ -1164,6 +1177,7 @@ const DISCOVERY_INTERVAL_MS = 3e3;
 const MDNS_SERVICE_TYPE = "dsh-mobile";
 const MOBILE_LAYOUT_MODULE = "@deepseek-ai/dsh-client-ui-layout";
 const MOBILE_LAYOUT_PATH = `${AUTH_PREFIX}/mobile-layout.js`;
+const MOBILE_LAYOUT_DEPENDENCIES = Object.freeze(["@deepseek-ai/dsh-client-runtime", "@deepseek-ai/dsh-client-ui-theme"]);
 const PAIR_PAGE = `<!doctype html>
 <html lang="en">
 <meta charset="utf-8">
@@ -1194,6 +1208,7 @@ function rewriteMobileIndex(html) {
 	if (typeof parsed.rev !== "string" || !Array.isArray(parsed.entries)) throw new Error("upstream DSH boot manifest is malformed");
 	const layout = parsed.entries.filter((entry) => entry !== null && typeof entry === "object" && entry.id === MOBILE_LAYOUT_MODULE);
 	if (layout.length !== 1 || typeof layout[0]?.url !== "string" || typeof layout[0].rev !== "string") throw new Error("upstream DSH boot manifest has no unique layout module");
+	if (!Array.isArray(layout[0].inject) || MOBILE_LAYOUT_DEPENDENCIES.some((dependency) => !layout[0]?.inject?.includes(dependency))) throw new Error("upstream DSH layout module has unsupported dependencies");
 	layout[0].url = MOBILE_LAYOUT_PATH;
 	layout[0].rev = "dsh-mobile-layout-v1";
 	const replacement = `window.__DSH_MOBILE_FRONTEND__="dedicated";${assignment}${JSON.stringify(parsed)};`;
@@ -2650,6 +2665,11 @@ async function materializeManagedSetup(setup, table) {
 const name = "dsh-mobile";
 /** The stock WebServer is the only DSH Host service this plugin requires. */
 const inject = ["webServer"];
+function installedDshVersion() {
+	const manifest = createRequire(import.meta.url)("@deepseek-ai/dsh-host-webserver/package.json");
+	if (manifest === null || typeof manifest !== "object") return void 0;
+	return manifest.version;
+}
 function mapAdminError(error) {
 	if (error instanceof HttpError) return error;
 	const code = error.code;
@@ -2716,6 +2736,7 @@ async function loadSetup(config) {
 }
 /** Mount the resident control route and its optional authenticated LAN gateway. */
 async function apply(ctx, config) {
+	assertSupportedDshVersion(installedDshVersion());
 	const loaded = await loadSetup(config);
 	let gateway;
 	const startGateway = async (candidateConfig) => {
@@ -2796,6 +2817,6 @@ async function apply(ctx, config) {
 	}, "dsh-mobile: local control and authenticated LAN gateway");
 }
 //#endregion
-export { AUTH_PREFIX, AccessController, AccessError, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, DEVICE_COOKIE, JsonDeviceStore, JsonMobileAccessControlStore, LOCAL_ADMIN_PREFIX, MemoryDeviceStore, MobileAccessGateway, MobileAccessGatewayController, RequestTrustPolicy, SESSION_COOKIE, WS_PATHS, addressAllowed, apply, inject, isLoopbackAddress, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseGatewayConfig, parseMobileAccessControlState, resolveAuthority, rewriteMobileIndex };
+export { AUTH_PREFIX, AccessController, AccessError, BoundedRateLimiter, CSRF_COOKIE, CSRF_HEADER, Config, DEVICE_COOKIE, JsonDeviceStore, JsonMobileAccessControlStore, LOCAL_ADMIN_PREFIX, MemoryDeviceStore, MobileAccessGateway, MobileAccessGatewayController, RequestTrustPolicy, SESSION_COOKIE, SUPPORTED_DSH_VERSIONS, WS_PATHS, addressAllowed, apply, assertSupportedDshVersion, inject, isLoopbackAddress, name, parseAuthority, parseCidr, parseControlFile, parseDeviceSnapshot, parseGatewayConfig, parseMobileAccessControlState, resolveAuthority, rewriteMobileIndex };
 
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.20",
   "private": false,
   "description": "DeepSeek Harness 移动端适配与安全局域网访问插件，支持 Android App 和手机浏览器。",
   "type": "module",
@@ -50,7 +50,8 @@
   },
   "scripts": {
     "build": "tsdown",
-    "check:mobile-release": "node ./scripts/check-mobile-release.mjs",
+    "check:mobile-release": "node ./scripts/check-mobile-release.mjs",
+    "check:dsh-compatibility": "node ./scripts/check-dsh-compatibility.mjs",
     "check:release-tag": "node ./scripts/check-release-version.mjs --tag-env",
     "check:version": "node ./scripts/check-release-version.mjs",
     "clean": "node ./scripts/clean.mjs",
@@ -88,7 +89,7 @@
   "license": "Apache-2.0",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.5 <0.1.0",
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.5 || 0.1.0-rc.6",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {