@jingyi0605/codingns4dsh 0.1.7-rc.3 → 0.2.0-beta.1

package/data/build/dist/transport/carrier.js

@@ -2,10 +2,20 @@
 import { decodeFrame } from './frame.js';
 import { createDshTransportDebugLogger } from './debug.js';
 export const TUNNEL_DATA_CHANNEL_LABEL = 'codingns-tunnel';
-/** DataChannel 单消息保守上限；实际对端协商值可能只有 256 KiB。 */
+/** 单个分片的正文上限；整帧为正文加上分片头。 */
 export const DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES = 64 * 1024;
 export const DATA_CHANNEL_FRAGMENT_HEADER_BYTES = 20;
 export const DATA_CHANNEL_MAX_REASSEMBLY_BYTES = 16 * 1024 * 1024;
+/**
+ * Host 侧向浏览器宣告的 SCTP max-message-size（256 KiB）。
+ *
+ * 浏览器按对端 SDP 里的 max-message-size 限制 `RTCDataChannel.send()`；werift 默认
+ * 只宣告 64 KiB，而 Carrier 的整分片是 64 KiB 正文加 20 字节头，因此浏览器侧只要
+ * 发送超过 64 KiB 的消息就会抛 `Trying to send message larger than max-message-size`。
+ * 中继下的设置写入、附件和大字段都属于这一类，必须把上限抬到浏览器自身
+ * （Chrome/Firefox 为 256 KiB）能接受的水平。
+ */
+export const DATA_CHANNEL_MAX_MESSAGE_BYTES = 256 * 1024;
 const DATA_CHANNEL_FRAGMENT_MAGIC = new Uint8Array([0x44, 0x53, 0x46, 0x01]);
 /** Host 侧剥离父仓库 relay-tunnel-wire 的首个 hello，随后只转发 DSH Envelope 二进制。 */
 export function createRelayTunnelHostCarrier(base, debug) {
@@ -83,6 +93,24 @@ export function createDataChannelCarrier(channel, options = {}) {
         closeListeners.clear();
     };
     const onClose = () => { state = 'closed'; clearFragments(); logger.log('data-channel.close', { label: channel.label ?? null }); notifyClosed('DataChannel closed'); listeners.clear(); };
+    /**
+     * 物理线路已经不可继续使用时统一收敛：分片缺帧、非法帧和背压超时都必须让上层
+     * 立刻失败。早期实现只在重组超时时删掉半成品分片，请求因此永远得不到回应，
+     * 表现成「设置页一直空白但没有任何报错」。
+     */
+    const failCarrier = (error) => {
+        if (state === 'closed')
+            return;
+        logger.log('carrier.failed', { error: error.message });
+        state = 'closed';
+        clearFragments();
+        notifyClosed(error.message);
+        listeners.clear();
+        try {
+            channel.close();
+        }
+        catch { /* 关闭路径尽力而为 */ }
+    };
     const processBytes = (bytes, value) => {
         if (!bytes) {
             logger.log('carrier.receive.invalid', { dataType: Object.prototype.toString.call(value), valueType: typeof value });
@@ -98,10 +126,7 @@ export function createDataChannelCarrier(channel, options = {}) {
         }
         catch (error) {
             logger.log('carrier.fragment.error', { physicalBytes: bytes.byteLength, prefix: bytesToHex(bytes.subarray(0, 8)), error: error instanceof Error ? error.message : String(error) });
-            state = 'closed';
-            clearFragments();
-            listeners.clear();
-            channel.close();
+            failCarrier(error instanceof Error ? error : new Error(String(error)));
         }
     };
     const onMessage = (event) => {
@@ -172,7 +197,10 @@ export function createDataChannelCarrier(channel, options = {}) {
         const parsed = decodeFragment(data, maxReassemblyBytes);
         let assembly = fragments.get(parsed.fragmentId);
         if (!assembly) {
-            const timer = setTimeout(() => fragments.delete(parsed.fragmentId), reassemblyTimeoutMs);
+            const timer = setTimeout(() => {
+                fragments.delete(parsed.fragmentId);
+                failCarrier(new Error(`DataChannel 分片重组超时（${String(parsed.chunkCount)} 片，共 ${String(parsed.totalBytes)} 字节）`));
+            }, reassemblyTimeoutMs);
             assembly = { totalBytes: parsed.totalBytes, chunkCount: parsed.chunkCount, chunks: new Map(), receivedBytes: 0, timer };
             fragments.set(parsed.fragmentId, assembly);
             logger.log('carrier.fragment.receive', { fragmentId: parsed.fragmentId, chunkCount: parsed.chunkCount, totalBytes: parsed.totalBytes });
@@ -187,17 +215,7 @@ export function createDataChannelCarrier(channel, options = {}) {
             return null;
         clearTimeout(assembly.timer);
         fragments.delete(parsed.fragmentId);
-        const result = new Uint8Array(assembly.totalBytes);
-        let offset = 0;
-        for (let index = 0; index < assembly.chunkCount; index += 1) {
-            const chunk = assembly.chunks.get(index);
-            if (!chunk)
-                throw new Error('DataChannel 分片缺失');
-            result.set(chunk, offset);
-            offset += chunk.byteLength;
-        }
-        if (offset !== assembly.totalBytes)
-            throw new Error('DataChannel 分片总长度不一致');
+        const result = assembleChunks(assembly);
         logger.log('carrier.fragment.complete', { fragmentId: parsed.fragmentId, chunks: assembly.chunkCount, totalBytes: result.byteLength });
         return result;
     };
@@ -206,8 +224,10 @@ export function createDataChannelCarrier(channel, options = {}) {
         send(data) {
             if (!(data instanceof Uint8Array))
                 return Promise.reject(new TypeError('Carrier 只接受 Uint8Array'));
-            chain = chain.then(() => sendLogical(data));
-            return chain;
+            const result = chain.then(() => sendLogical(data));
+            // 串行链只负责保序：单次发送失败不能让后续发送永久失败。
+            chain = result.then(() => undefined, () => undefined);
+            return result;
         },
         subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
         onClosed(listener) { if (closeNotified) {
@@ -233,24 +253,55 @@ function encodeFragment(fragmentId, index, chunkCount, totalBytes, body) {
     result.set(body, DATA_CHANNEL_FRAGMENT_HEADER_BYTES);
     return result;
 }
+/**
+ * 按分片头校验单个分片，不假设发送端的固定正文长度。
+ *
+ * 旧版本（以及线上已部署的 H5 运行时）以 64 KiB 正文分片，只有最后一片更短；
+ * 分片长度由发送端决定，接收端必须按「除最后一片外长度一致」来校验，否则任何
+ * 分片长度调整都会让新旧两端无法互通。单帧正文仍限制在
+ * `DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES` 以内，避免一次分配过大内存。
+ */
 function decodeFragment(data, maxReassemblyBytes) {
     const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
     const fragmentId = view.getUint32(4);
     const index = view.getUint32(8);
     const chunkCount = view.getUint32(12);
     const totalBytes = view.getUint32(16);
-    if (chunkCount === 0 || totalBytes <= DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES || totalBytes > maxReassemblyBytes || index >= chunkCount)
+    if (chunkCount < 2 || totalBytes < 2 || totalBytes > maxReassemblyBytes || index >= chunkCount)
         throw new Error('DataChannel 分片头无效');
-    const expectedCount = Math.ceil(totalBytes / DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES);
-    if (chunkCount !== expectedCount)
-        throw new Error('DataChannel 分片数量无效');
-    const offset = index * DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES;
-    const expectedBytes = Math.min(DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES, totalBytes - offset);
     const body = data.subarray(DATA_CHANNEL_FRAGMENT_HEADER_BYTES);
-    if (body.byteLength !== expectedBytes)
+    if (body.byteLength === 0 || body.byteLength > DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES)
         throw new Error('DataChannel 分片长度无效');
     return { fragmentId, index, chunkCount, totalBytes, body: body.slice() };
 }
+/** 收齐全部索引后按发送端的分片长度重组，并校验长度自洽。 */
+function assembleChunks(assembly) {
+    const first = assembly.chunks.get(0);
+    if (first === undefined)
+        throw new Error('DataChannel 分片缺失');
+    const chunkBytes = first.byteLength;
+    if (chunkBytes === 0 || chunkBytes > DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES)
+        throw new Error('DataChannel 分片长度无效');
+    if (assembly.chunkCount !== Math.ceil(assembly.totalBytes / chunkBytes))
+        throw new Error('DataChannel 分片数量无效');
+    const lastBytes = assembly.totalBytes - chunkBytes * (assembly.chunkCount - 1);
+    if (lastBytes < 1 || lastBytes > chunkBytes)
+        throw new Error('DataChannel 分片长度无效');
+    const result = new Uint8Array(assembly.totalBytes);
+    let offset = 0;
+    for (let index = 0; index < assembly.chunkCount; index += 1) {
+        const chunk = assembly.chunks.get(index);
+        if (!chunk)
+            throw new Error('DataChannel 分片缺失');
+        if (chunk.byteLength !== (index === assembly.chunkCount - 1 ? lastBytes : chunkBytes))
+            throw new Error('DataChannel 分片长度不一致');
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    if (offset !== assembly.totalBytes)
+        throw new Error('DataChannel 分片总长度不一致');
+    return result;
+}
 function toBytes(value) {
     if (value instanceof Uint8Array)
         return new Uint8Array(value);

package/data/build/dist/transport/debug.d.ts

@@ -20,6 +20,11 @@ export declare function createDshTransportDebugLogger(options?: DshTransportDebu
 /**
  * 调试字段采用正向白名单。Transport 可能同时处理 token、URL、命令和正文，
  * 因此不能依赖调用方自觉脱敏；未知字段和错误正文直接丢弃。
+ *
+ * `path` / `method` / `status` / `errorCode` 是 DSH Web 请求的路由元数据：
+ * 没有它们就无法区分「请求没到达 Host」和「请求到达但返回空结果」，
+ * 中继设置页空白这类问题只能靠日志猜。这些字段只能是 HTTP 路径与状态，
+ * 禁止把查询串、Cookie、请求/响应正文塞进来。
  */
 export declare function sanitizeDshTransportDebugFields(fields: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
 /** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */

package/data/build/dist/transport/debug.js

@@ -26,6 +26,11 @@ export function createDshTransportDebugLogger(options = {}) {
 /**
  * 调试字段采用正向白名单。Transport 可能同时处理 token、URL、命令和正文，
  * 因此不能依赖调用方自觉脱敏；未知字段和错误正文直接丢弃。
+ *
+ * `path` / `method` / `status` / `errorCode` 是 DSH Web 请求的路由元数据：
+ * 没有它们就无法区分「请求没到达 Host」和「请求到达但返回空结果」，
+ * 中继设置页空白这类问题只能靠日志猜。这些字段只能是 HTTP 路径与状态，
+ * 禁止把查询串、Cookie、请求/响应正文塞进来。
  */
 export function sanitizeDshTransportDebugFields(fields) {
     const allowed = new Set([
@@ -34,17 +39,27 @@ export function sanitizeDshTransportDebugFields(fields) {
         'channel', 'channelLabel', 'operation', 'feature', 'type', 'code', 'state', 'role',
         'streams', 'activeStreams', 'openingStreams', 'maxStreams', 'fragmentId', 'chunkCount',
         'totalBytes', 'payloadBytes', 'bufferedAmount', 'highWaterMark', 'lowWaterMark', 'dataType',
-        'valueType', 'trafficRemainingBytes',
+        'valueType', 'trafficRemainingBytes', 'path', 'method', 'status', 'errorCode',
     ]);
     const result = {};
     for (const [key, value] of Object.entries(fields)) {
         if (!allowed.has(key))
             continue;
-        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' || value === null)
+        if (typeof value === 'string') {
+            result[key] = key === 'path' ? sanitizeDebugPath(value) : value;
+            continue;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean' || value === null)
             result[key] = value;
     }
     return result;
 }
+/** 路径只保留 pathname，去掉查询串与可能带凭据的片段。 */
+function sanitizeDebugPath(value) {
+    const query = value.indexOf('?');
+    const trimmed = query === -1 ? value : value.slice(0, query);
+    return trimmed.length > 200 ? `${trimmed.slice(0, 200)}…` : trimmed;
+}
 /** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */
 export function resolveDshTransportDebugEnabled() {
     return resolveCodingNsDebugEnabled();

package/data/build/dist/transport/dsh-session.d.ts

@@ -19,7 +19,7 @@ export interface DshSessionOptions {
     acceptInitialGeneration?: boolean;
     debug?: DshTransportDebugLogger;
 }
-/** 负责 DSH hello/ready、版本能力协商和心跳，不执行任何业务。 */
+/** 负责 DSH hello/ready、协议与能力协商和心跳，不执行任何业务。 */
 export declare class DshSession {
     private readonly options;
     private stateValue;
@@ -45,11 +45,28 @@ export declare class DshSession {
     close(reason?: string): void;
     private sendHello;
     private sendReady;
+    /**
+     * 握手只校验隧道协议版本：对端缺省不带协议时按 v1 处理。
+     * DSH 应用版本不再参与握手门槛；只有插件升级 DSH_ENVELOPE_PROTOCOL
+     * （对应不再兼容的 WebRTC 变更）时，才会在此拒绝旧协议对端。
+     */
+    private handshakeProtocolMatches;
+    /** 协议不兼容时先回发 session.close 让对端拿到明确原因，再收敛本地会话。 */
+    private rejectHandshake;
     private receive;
     private receiveSession;
     private validateScope;
     private createEnvelope;
     private startHeartbeat;
+    /**
+     * 会话失败必须同时收敛物理线路。
+     *
+     * 早期实现只把本地状态改成 `degraded`、拒绝 `waitReady`：对端既收不到
+     * `session.close`，DataChannel 也不会关闭，于是一次发送失败（例如浏览器宣告的
+     * max-message-size 太小、分片发送被拒、背压超时）之后，对端会在一个已经死掉的
+     * 线路上等一个永远不回来的响应。中继页面的原生设置 `settings/describe` 正是这样
+     * 永久停在 loading：页面空白、没有任何报错。
+     */
     private fail;
 }
 //# sourceMappingURL=dsh-session.d.ts.map

package/data/build/dist/transport/dsh-session.js

@@ -1,7 +1,7 @@
 import { DSH_ENVELOPE_PROTOCOL, decodeDshEnvelope, encodeDshEnvelope, } from './dsh-envelope.js';
-import { DSH_VERSION, isDshVersionCompatible } from '../shared/contracts/version.js';
+import { DSH_VERSION } from '../shared/contracts/version.js';
 import { createDshTransportDebugLogger } from './debug.js';
-/** 负责 DSH hello/ready、版本能力协商和心跳，不执行任何业务。 */
+/** 负责 DSH hello/ready、协议与能力协商和心跳，不执行任何业务。 */
 export class DshSession {
     options;
     stateValue = 'idle';
@@ -93,15 +93,31 @@ export class DshSession {
             capabilities: [...this.options.capabilities ?? []],
         }));
     }
-    sendReady(capabilities) {
+    sendReady(capabilities, peerDshVersion) {
         this.send(this.createEnvelope('session.ready', 'session', {
             protocol: this.options.protocol ?? DSH_ENVELOPE_PROTOCOL,
-            dshVersion: this.options.dshVersion ?? DSH_VERSION,
+            // 回显对端上报的版本：旧客户端按自身兼容区间校验 ready，回显其自身版本才能放行。
+            dshVersion: peerDshVersion ?? this.options.dshVersion ?? DSH_VERSION,
+            hostDshVersion: this.options.dshVersion ?? DSH_VERSION,
             capabilities: [...capabilities],
             byteCredit: 64 * 1024,
             messageCredit: 32,
         }));
     }
+    /**
+     * 握手只校验隧道协议版本：对端缺省不带协议时按 v1 处理。
+     * DSH 应用版本不再参与握手门槛；只有插件升级 DSH_ENVELOPE_PROTOCOL
+     * （对应不再兼容的 WebRTC 变更）时，才会在此拒绝旧协议对端。
+     */
+    handshakeProtocolMatches(envelope) {
+        const protocol = envelope.meta.protocol ?? DSH_ENVELOPE_PROTOCOL;
+        return protocol === (this.options.protocol ?? DSH_ENVELOPE_PROTOCOL);
+    }
+    /** 协议不兼容时先回发 session.close 让对端拿到明确原因，再收敛本地会话。 */
+    rejectHandshake(reason) {
+        this.send(this.createEnvelope('session.close', 'session', { reason }));
+        this.fail(new Error(reason));
+    }
     receive(data) {
         if (this.stateValue === 'closed')
             return;
@@ -133,18 +149,17 @@ export class DshSession {
                 this.fail(new Error('非法 session.hello'));
                 return;
             }
-            const protocol = envelope.meta.protocol;
-            const dshVersion = envelope.meta.dshVersion;
-            if (protocol !== (this.options.protocol ?? DSH_ENVELOPE_PROTOCOL) || typeof dshVersion !== 'string' || !isDshVersionCompatible(dshVersion)) {
-                this.fail(new Error('PROTOCOL_VERSION_UNSUPPORTED'));
+            if (!this.handshakeProtocolMatches(envelope)) {
+                this.rejectHandshake('PROTOCOL_VERSION_UNSUPPORTED');
                 return;
             }
+            const peerDshVersion = typeof envelope.meta.dshVersion === 'string' ? envelope.meta.dshVersion : undefined;
             const offered = readCapabilities(envelope.meta.capabilities);
             const allowed = new Set(this.options.capabilities ?? offered);
             this.remoteCapabilities = offered.filter((capability) => allowed.has(capability));
             this.stateValue = 'ready';
             this.debug.log('session.ready', { role: this.options.role, capabilities: this.remoteCapabilities });
-            this.sendReady(this.remoteCapabilities);
+            this.sendReady(this.remoteCapabilities, peerDshVersion);
             this.readyResolve?.();
             this.options.onReady?.(this);
             return;
@@ -154,10 +169,8 @@ export class DshSession {
                 this.fail(new Error('非法 session.ready'));
                 return;
             }
-            const protocol = envelope.meta.protocol;
-            const dshVersion = envelope.meta.dshVersion;
-            if (protocol !== (this.options.protocol ?? DSH_ENVELOPE_PROTOCOL) || typeof dshVersion !== 'string' || !isDshVersionCompatible(dshVersion)) {
-                this.fail(new Error('PROTOCOL_VERSION_UNSUPPORTED'));
+            if (!this.handshakeProtocolMatches(envelope)) {
+                this.rejectHandshake('PROTOCOL_VERSION_UNSUPPORTED');
                 return;
             }
             this.remoteCapabilities = readCapabilities(envelope.meta.capabilities);
@@ -228,11 +241,33 @@ export class DshSession {
             }
         }, interval);
     }
+    /**
+     * 会话失败必须同时收敛物理线路。
+     *
+     * 早期实现只把本地状态改成 `degraded`、拒绝 `waitReady`：对端既收不到
+     * `session.close`，DataChannel 也不会关闭，于是一次发送失败（例如浏览器宣告的
+     * max-message-size 太小、分片发送被拒、背压超时）之后，对端会在一个已经死掉的
+     * 线路上等一个永远不回来的响应。中继页面的原生设置 `settings/describe` 正是这样
+     * 永久停在 loading：页面空白、没有任何报错。
+     */
     fail(error) {
+        if (this.stateValue === 'closed' || this.stateValue === 'degraded')
+            return;
+        const wasReady = this.stateValue === 'ready';
         this.stateValue = 'degraded';
         this.debug.log('session.error', { error: error.message });
         this.readyReject?.(error);
         this.options.onError?.(error);
+        if (wasReady) {
+            // 先尽力通知对端失败原因；发送本身失败也已经不影响后续收敛。
+            try {
+                this.send(this.createEnvelope('session.close', 'session', { reason: error.message }));
+            }
+            catch { /* 线路不可用时尽力而为 */ }
+        }
+        const carrier = this.options.carrier;
+        // 让已排队的收尾帧先进入发送链，再关闭物理线路。
+        setTimeout(() => { void carrier.close(`DSH Session 失败：${error.message}`); }, 0);
     }
 }
 function envelopeDebugFields(envelope) {

package/data/build/dist/transport/index.d.ts

@@ -1,4 +1,4 @@
-export { createDataChannelCarrier, createRelayTunnelHostCarrier, TUNNEL_DATA_CHANNEL_LABEL, DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES, DATA_CHANNEL_FRAGMENT_HEADER_BYTES, DATA_CHANNEL_MAX_REASSEMBLY_BYTES, type CodingNsCarrier, type DataChannelLike, type DataChannelCarrierOptions } from './carrier.js';
+export { createDataChannelCarrier, createRelayTunnelHostCarrier, TUNNEL_DATA_CHANNEL_LABEL, DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES, DATA_CHANNEL_FRAGMENT_HEADER_BYTES, DATA_CHANNEL_MAX_REASSEMBLY_BYTES, DATA_CHANNEL_MAX_MESSAGE_BYTES, type CodingNsCarrier, type DataChannelLike, type DataChannelCarrierOptions } from './carrier.js';
 export { encodeFrame, decodeFrame, decodeFrames, createFrameDecoder, decodeTunnelFrame, encodeTunnelFrame, TUNNEL_WIRE_VERSION, TUNNEL_FRAME_HEADER_BYTES, TUNNEL_MAX_META_BYTES, TUNNEL_MAX_FRAME_BODY_BYTES, TUNNEL_FRAME_TYPE_CODES, TUNNEL_PROTOCOL_VERSION, validateTunnelFrame, tunnelFrameByteLength, DEFAULT_MAX_TUNNEL_FRAME_BYTES, type TunnelChannel, type TunnelFrame, type TunnelFrameKind, type TunnelFrameCodecOptions, type TunnelFrameType, type TunnelClientContext, } from './frame.js';
 export { DshTunnelMultiplexer, type DshTunnelMultiplexerOptions, type TunnelFlowControl } from './multiplexer.js';
 export { createDshTransportDebugLogger, resolveDshTransportDebugEnabled, type DshTransportDebugLogger, type DshTransportDebugOptions, type DshTransportDebugSide } from './debug.js';

package/data/build/dist/transport/index.js

@@ -1,4 +1,4 @@
-export { createDataChannelCarrier, createRelayTunnelHostCarrier, TUNNEL_DATA_CHANNEL_LABEL, DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES, DATA_CHANNEL_FRAGMENT_HEADER_BYTES, DATA_CHANNEL_MAX_REASSEMBLY_BYTES } from './carrier.js';
+export { createDataChannelCarrier, createRelayTunnelHostCarrier, TUNNEL_DATA_CHANNEL_LABEL, DATA_CHANNEL_FRAGMENT_PAYLOAD_BYTES, DATA_CHANNEL_FRAGMENT_HEADER_BYTES, DATA_CHANNEL_MAX_REASSEMBLY_BYTES, DATA_CHANNEL_MAX_MESSAGE_BYTES } from './carrier.js';
 export { encodeFrame, decodeFrame, decodeFrames, createFrameDecoder, decodeTunnelFrame, encodeTunnelFrame, TUNNEL_WIRE_VERSION, TUNNEL_FRAME_HEADER_BYTES, TUNNEL_MAX_META_BYTES, TUNNEL_MAX_FRAME_BODY_BYTES, TUNNEL_FRAME_TYPE_CODES, TUNNEL_PROTOCOL_VERSION, validateTunnelFrame, tunnelFrameByteLength, DEFAULT_MAX_TUNNEL_FRAME_BYTES, } from './frame.js';
 export { DshTunnelMultiplexer } from './multiplexer.js';
 export { createDshTransportDebugLogger, resolveDshTransportDebugEnabled } from './debug.js';

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@jingyi0605/codingns4dsh",
-  "version": "0.1.7-rc.3",
+  "version": "0.2.0-beta.1",
   "description": "Codingns4DSH 插件骨架与连接契约",
   "repository": {
     "type": "git",
     "url": "https://github.com/jingyi0605/Codingns4DSH"
   },
+  "license": "GPL-3.0-or-later",
   "type": "module",
   "main": "./data/build/dist/index.js",
   "types": "./data/build/dist/index.d.ts",
@@ -53,11 +54,11 @@
     "./package.json": "./package.json"
   },
   "engines": {
-    "dsh": ">=0.1.5-rc.3 <=0.1.7-rc.2",
+    "dsh": ">=0.2.0-rc.1 <=0.2.0-rc.1",
     "node": ">=22.19.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.5-rc.3 <=0.1.7-rc.2"
+    "@deepseek-ai/dsh": ">=0.2.0-rc.1 <=0.2.0-rc.1"
   },
   "dsh": {
     "manifestVersion": 1,
@@ -98,6 +99,9 @@
     "bundle:h5": "tsdown --config tsdown.h5.config.ts",
     "dev:link": "node scripts/link-dsh-dev.mjs",
     "dev:watch": "node scripts/dev-watch.mjs",
+    "dsh:web": "bash scripts/run-dsh-web.sh",
+    "dsh:stage0": "bash scripts/run-dsh-stage0.sh",
+    "dsh:stage0:clean-link": "bash scripts/clean-stage0-dev-link.sh",
     "watch:client": "tsdown --watch",
     "test": "pnpm run build && node --test tests/*.spec.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
@@ -114,22 +118,22 @@
     "scripts/check-dsh-install.mjs"
   ],
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-theme": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.3",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-theme": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "@types/react": "~18.3.1",
     "@types/ws": "^8.18.1",
     "react": "^18.2.0",

package/profile/README.md

@@ -1,6 +1,6 @@
 # Codingns4DSH Profile
 
-这是独立的 Codingns4DSH Profile，插件版本为 `0.1.7-rc.3`，兼容 DSH `>=0.1.5-rc.3 <=0.1.7-rc.2`，当前测试版本为 `0.1.6-alpha.2`。
+这是独立的 Codingns4DSH Profile，插件版本为 `0.2.0-beta.1`，兼容 DSH `>=0.2.0-rc.1 <=0.2.0-rc.1`，当前测试版本为 `0.2.0-rc.1`。
 
 Profile 只选择 `codingns4dsh` Bundle。`cordis.patch.yml` 保持 `[]`，因为启动期
 Transport 必须由外部 pre-Cordis 启动胶水在 DSH Client/Cordis 创建前登记，不能由
@@ -9,7 +9,7 @@ Transport 必须由外部 pre-Cordis 启动胶水在 DSH Client/Cordis 创建前
 发布后，在 DSH 的 Profile 中安装精确版本的插件 Bundle：
 
 ```bash
-dsh plugin --profile codingns4dsh add @jingyi0605/codingns4dsh@0.1.7-rc.3
+dsh plugin --profile codingns4dsh add @jingyi0605/codingns4dsh@0.2.0-beta.1
 ```
 
 Profile 安装完成后，使用 DSH 官方启动器启动：

package/profile/package.json

@@ -1,16 +1,17 @@
 {
   "name": "codingns4dsh-profile",
-  "version": "0.1.7-rc.3",
+  "version": "0.2.0-beta.1",
+  "license": "GPL-3.0-or-later",
   "private": true,
   "type": "module",
   "engines": {
-    "dsh": ">=0.1.5-rc.3 <=0.1.7-rc.2"
+    "dsh": ">=0.2.0-rc.1 <=0.2.0-rc.1"
   },
   "scripts": {
     "preinstall": "node scripts/check-dsh-install.mjs"
   },
   "dependencies": {
-    "@jingyi0605/codingns4dsh": "0.1.7-rc.3"
+    "@jingyi0605/codingns4dsh": "0.2.0-beta.1"
   },
   "dsh": {
     "profile": {

package/profile/version.json

@@ -1,5 +1,5 @@
 {
-  "pluginVersion": "0.1.7-rc.3",
-  "dshCompatibility": ">=0.1.5-rc.3 <=0.1.7-rc.2",
-  "dshTestedVersion": "0.1.6-alpha.2"
+  "pluginVersion": "0.2.0-beta.1",
+  "dshCompatibility": ">=0.2.0-rc.1 <=0.2.0-rc.1",
+  "dshTestedVersion": "0.2.0-rc.1"
 }

package/version.json

@@ -1,6 +1,6 @@
 {
-  "pluginVersion": "0.1.7-rc.3",
-  "dshCompatibility": ">=0.1.5-rc.3 <=0.1.7-rc.2",
-  "dshTestedVersion": "0.1.6-alpha.2",
+  "pluginVersion": "0.2.0-beta.1",
+  "dshCompatibility": ">=0.2.0-rc.1 <=0.2.0-rc.1",
+  "dshTestedVersion": "0.2.0-rc.1",
   "dshProtocolVersion": 1
 }