@jingyi0605/codingns4dsh 0.1.0 → 0.1.1

package/data/build/dist/shared/contracts/cli-adapter.d.ts

@@ -36,6 +36,8 @@ export interface CodingNsCliSessionConfig {
     readonly adapterId: CodingNsCliAdapterId;
     readonly modelId?: string;
     readonly effortId?: string;
+    /** DSH 原生模型提供商，例如 deepseek-official、glor；不包含凭据。 */
+    readonly providerId?: string;
     /** 外部运行时会话标识，只保存在 Host 会话表中。 */
     readonly providerSessionId?: string;
     readonly rawStoreRef?: string;
@@ -77,6 +79,8 @@ export interface CodingNsCliTurnInput {
     readonly signal?: AbortSignal;
     readonly providerSessionId?: string;
     readonly rawStoreRef?: string;
+    /** 仅由 Host 的 DSH 分段桥接使用；让支持的 Provider 在工具完成处结束当前 step。 */
+    readonly splitToolSteps?: boolean;
 }
 export interface CodingNsAgentPermissionResponse {
     readonly requestId: string;
@@ -146,15 +150,25 @@ export interface CodingNsAgentToolEvent {
 export type CodingNsAgentEvent = {
     readonly type: 'reasoning-delta';
     readonly text: string;
+    readonly messageId?: string;
 } | {
     readonly type: 'reasoning-snapshot';
     readonly text: string;
 } | {
     readonly type: 'text-delta';
     readonly text: string;
+    readonly messageId?: string;
 } | {
     readonly type: 'text-snapshot';
     readonly text: string;
+} | {
+    /** Provider 在同一回合中切换 assistant item 时的内容块边界。 */
+    readonly type: 'message-boundary';
+    readonly channel: 'reasoning' | 'text';
+    readonly messageId: string;
+} | {
+    /** Provider 已完成一个外部工具，Host 应在当前流结束后注入下一个 DSH step。 */
+    readonly type: 'step-boundary';
 } | CodingNsAgentToolEvent | {
     readonly type: 'usage';
     /** Command Code 的 inputTokens 是包含缓存读写的完整输入。 */

package/data/build/dist/shared/contracts/config.d.ts

@@ -30,6 +30,12 @@ export interface CodingNsSettings {
     /** 适配器级最近选择；新建会话时作为默认模型和思考强度。 */
     agentAdapterPreferences?: Record<string, CodingNsCliAdapterPreference>;
 }
+/** 0.1.7 ConfigForm 面向用户的持久化配置；Host-only 会话索引不在其中。 */
+export type CodingNsConfig = Omit<CodingNsSettings, 'cliSessions'>;
+/** Host 运行时状态，与可编辑配置分离，避免泄露到 Client 配置表单。 */
+export interface CodingNsRuntimeState {
+    readonly cliSessions: CodingNsCliSessionRecord[];
+}
 /** 跨平台终端 profile；`system` 由 Host 根据平台和已安装 shell 解析。 */
 export type TerminalProfileId = 'system' | 'zsh' | 'bash' | 'powershell' | 'cmd' | 'git-bash';
 /** 终端持久记录的归属范围；工作区模式允许不同 DSH 会话共享终端。 */
@@ -60,9 +66,26 @@ export interface WorkspaceSessionEnhancementSettings {
     showAdapterLogo: boolean;
     /** 是否在每个有归档会话的工作区中显示归档入口。 */
     showArchivedSessions: boolean;
+    /** 是否在工作区菜单提供隐藏与恢复工作区入口。 */
+    showWorkspaceHiding: boolean;
+    /** 插件本地隐藏的工作区 ID；不改变 DSH 原生工作区数据。 */
+    hiddenWorkspaceIds: string[];
     /** 是否在对话底部显示订阅与上游用量检测。 */
     showSubscriptionUsage: boolean;
+    /** 是否在输入工具区显示快捷会话入口。 */
+    showQuickPhrases: boolean;
+    /** 插件本地保存的快捷会话条目。 */
+    quickPhrases: QuickPhrase[];
+    /** 内置快捷会话是否已经完成首次初始化；仅用于兼容旧配置。 */
+    quickPhrasesSeeded: boolean;
+}
+/** 可复用的快捷会话文本。 */
+export interface QuickPhrase {
+    id: string;
+    text: string;
 }
+/** 首次启用快捷会话时提供的内置指令。 */
+export declare const DEFAULT_QUICK_PHRASES: QuickPhrase[];
 /** 局域网访问 DSH 的持久化配置；dshPort 为 0 表示启动时自动探测。 */
 export interface LanAccessDshSettings {
     autoStart: boolean;
@@ -73,7 +96,7 @@ export interface LanAccessDshSettings {
 export interface LoginProtectionScopes {
     /** 局域网网卡入口。 */
     lan: boolean;
-    /** DSH-Codingns4DSH 中继入口。 */
+    /** Codingns4DSH 中继入口。 */
     relay: boolean;
 }
 /** 登录保护的公开设置；密码哈希仅保存在 Host 私有凭据文件中。 */
@@ -85,6 +108,9 @@ export interface LanAccessDshLoginSettings {
     scopes: LoginProtectionScopes;
 }
 export declare const CODINGNS_SETTINGS_NAMESPACE = "codingns";
+/** DSH 配置表单可能使用的插件 entry id；scoped 包名是当前 Bundle 的正式 ID。 */
+export declare const CODINGNS_SETTINGS_ENTRY_IDS: readonly ["@jingyi0605/codingns4dsh", "codingns4dsh", "codingns"];
+export declare function isCodingNsSettingsEntryId(value: unknown): value is typeof CODINGNS_SETTINGS_ENTRY_IDS[number];
 export declare const CODINGNS_CONTROL_BASE_URL_FIELD = "controlBaseUrl";
 export declare const CODINGNS_CONTROL_BASE_URLS_FIELD = "controlBaseUrls";
 export declare const CODINGNS_MODULES_FIELD = "modules";
@@ -93,6 +119,10 @@ export declare const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = "terminalEnhancement"
 export declare const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = "workspaceSessionEnhancement";
 export declare const DEFAULT_CODINGNS_CONTROL_BASE_URL = "https://channel.codingns.com:1443";
 export declare const DEFAULT_CODINGNS_CONTROL_BASE_URLS: string[];
+/** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */
+export declare const CODINGNS_CONTROL_STATION_URL = "https://channel.codingns.com:1443";
+/** 独立 H5 登录页面地址；登录控制站后可从设置页复制给其他设备。 */
+export declare const CODINGNS_H5_LOGIN_URL = "https://dsh.codingns.com";
 export declare const DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS: TerminalEnhancementSettings;
 export declare const DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS: WorkspaceSessionEnhancementSettings;
 export declare const DEFAULT_CODINGNS_SETTINGS: CodingNsSettings;

package/data/build/dist/shared/contracts/config.js

@@ -1,5 +1,21 @@
 import { isDshVersionAtLeast } from './version.js';
+/** 首次启用快捷会话时提供的内置指令。 */
+export const DEFAULT_QUICK_PHRASES = [
+    { id: 'builtin-quick-1', text: '请将本次会话变更的所有代码提交到git暂存区，然后总结一条中文的提交信息' },
+    { id: 'builtin-quick-2', text: '分析本项目模块的代码实现，并分析存在的问题' },
+    { id: 'builtin-quick-3', text: '分析当前项目中的未提交文件，按照功能模块进行分类提交，提交信息格式请参考我最近的提交记录' },
+    { id: 'builtin-quick-4', text: '请给出完整的开发提示词，我将在新的页面中继续开发' },
+];
 export const CODINGNS_SETTINGS_NAMESPACE = 'codingns';
+/** DSH 配置表单可能使用的插件 entry id；scoped 包名是当前 Bundle 的正式 ID。 */
+export const CODINGNS_SETTINGS_ENTRY_IDS = [
+    '@jingyi0605/codingns4dsh',
+    'codingns4dsh',
+    CODINGNS_SETTINGS_NAMESPACE,
+];
+export function isCodingNsSettingsEntryId(value) {
+    return typeof value === 'string' && CODINGNS_SETTINGS_ENTRY_IDS.includes(value);
+}
 export const CODINGNS_CONTROL_BASE_URL_FIELD = 'controlBaseUrl';
 export const CODINGNS_CONTROL_BASE_URLS_FIELD = 'controlBaseUrls';
 export const CODINGNS_MODULES_FIELD = 'modules';
@@ -8,6 +24,10 @@ export const CODINGNS_TERMINAL_ENHANCEMENT_FIELD = 'terminalEnhancement';
 export const CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD = 'workspaceSessionEnhancement';
 export const DEFAULT_CODINGNS_CONTROL_BASE_URL = 'https://channel.codingns.com:1443';
 export const DEFAULT_CODINGNS_CONTROL_BASE_URLS = [DEFAULT_CODINGNS_CONTROL_BASE_URL];
+/** 控制站的网页登录地址，用于注册 Codingns4DSH 账号。 */
+export const CODINGNS_CONTROL_STATION_URL = 'https://channel.codingns.com:1443';
+/** 独立 H5 登录页面地址；登录控制站后可从设置页复制给其他设备。 */
+export const CODINGNS_H5_LOGIN_URL = 'https://dsh.codingns.com';
 export const DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS = {
     bindingScope: 'workspace',
     defaultProfile: 'system',
@@ -27,7 +47,12 @@ export const DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS = {
 export const DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS = {
     showAdapterLogo: true,
     showArchivedSessions: true,
+    showWorkspaceHiding: true,
+    hiddenWorkspaceIds: [],
     showSubscriptionUsage: true,
+    showQuickPhrases: true,
+    quickPhrases: DEFAULT_QUICK_PHRASES.map((phrase) => ({ ...phrase })),
+    quickPhrasesSeeded: true,
 };
 export const DEFAULT_CODINGNS_SETTINGS = {
     controlBaseUrl: DEFAULT_CODINGNS_CONTROL_BASE_URL,

package/data/build/dist/shared/contracts/dsh-device.d.ts

@@ -1,11 +1,15 @@
 import type { RelayIceServer, RelaySignalingTicketResponse } from './signaling.js';
-/** DSH-Codingns4DSH 自己的设备记录，不与 Codingns4DSH Host binding 共用身份。 */
+/** Codingns4DSH 自己的设备记录，不与 Codingns4DSH Host binding 共用身份。 */
 export interface DshDeviceSummary {
     /** DSH 独立设备身份；不能与 Codingns4DSH host bindingId 混用。 */
     dshDeviceId: string;
     /** 旧 DTO 兼容字段，服务端迁移期间可存在。 */
     deviceId?: string;
     displayName: string;
+    /** 当前 Host 运行的 DSH 应用版本。 */
+    dshVersion?: string;
+    /** Host 所在操作系统返回的计算机名。 */
+    computerName?: string;
     protocolVersion: string;
     capabilities: string[];
     dtlsFingerprint: string;
@@ -18,6 +22,8 @@ export interface DshDeviceSummary {
 }
 export interface DshDeviceRegistrationRequest {
     displayName: string;
+    dshVersion?: string;
+    computerName?: string;
     devicePublicKey: string;
     dtlsFingerprint: string;
     protocolVersion: string;
@@ -36,6 +42,10 @@ export interface DshDeviceHeartbeatResponse {
     device: DshDeviceSummary;
     credentialVersion: number;
 }
+export interface DshDeviceHeartbeatRequest {
+    dshVersion?: string;
+    computerName?: string;
+}
 export interface DshRelayTicketRequest {
     dshDeviceId: string;
     deviceCredential: string;
@@ -67,6 +77,8 @@ export interface DshDeviceCredentialRecord {
     dtlsFingerprint: string;
     tunnelDomain: string | null;
     displayName: string;
+    dshVersion?: string;
+    computerName?: string;
     savedAt: string;
 }
 //# sourceMappingURL=dsh-device.d.ts.map

package/data/build/dist/shared/contracts/errors.d.ts

@@ -21,7 +21,7 @@ export declare const CODINGNS_DSH_ERROR_CODES: {
     readonly DEBUG_DSH_HOST_API_UNAVAILABLE: "DEBUG_DSH_HOST_API_UNAVAILABLE";
 };
 export declare const SUPPORTED_DSH_VERSION: "0.1.6-alpha.2";
-export declare const SUPPORTED_DSH_COMPATIBILITY: ">=0.1.5-rc.3 <0.1.7-0";
+export declare const SUPPORTED_DSH_COMPATIBILITY: ">=0.1.5-rc.3 <=0.1.7-rc.2";
 export type CodingNsDshErrorCode = typeof CODINGNS_DSH_ERROR_CODES[keyof typeof CODINGNS_DSH_ERROR_CODES];
 /** 统一错误形状；阶段 0 只定义，不主动产生这些业务错误。 */
 export declare class CodingNsDshError extends Error {

package/data/build/dist/shared/contracts/feature.d.ts

@@ -1,4 +1,6 @@
+import type { DshCapabilityDiagnostic, FeatureCapabilityRequirement } from '../../dsh-capabilities/types.js';
 export type FeatureState = 'disabled' | 'enabling' | 'enabled' | 'draining' | 'failed';
+export type { FeatureCapabilityRequirement };
 /** 功能模块的承载端：Host 进程、浏览器，或两端都需要。 */
 export type FeatureRuntime = 'host' | 'client' | 'both';
 /** 功能开关的生效时机；未声明时按实时生效处理。 */
@@ -40,6 +42,8 @@ export interface FeatureDescriptor {
     activation?: FeatureActivation;
     /** 模块要求的最低 DSH 版本；低于该版本时不得启动。 */
     minimumDshVersion?: string;
+    /** 模块依赖的宿主能力；版本差异由能力注册表负责路由。 */
+    requires?: readonly FeatureCapabilityRequirement[];
     /** 提供后该模块出现在设置页；缺省表示它没有界面。 */
     ui?: FeatureUiDescriptor;
 }
@@ -60,6 +64,8 @@ export interface FeatureContext<S = unknown> {
     readonly descriptor: FeatureDescriptor;
     readonly resources: FeatureResourceScope;
     readonly services: S;
+    /** 本次启动解析出的能力诊断，供模块记录降级原因。 */
+    readonly capabilityDiagnostics?: readonly DshCapabilityDiagnostic[];
 }
 /** 可由模块注册表管理的功能模块。 */
 export interface FeatureModule<S = unknown> {

package/data/build/dist/shared/contracts/git.d.ts

@@ -0,0 +1,82 @@
+/** Git 工作区面板在 Host 与 Client 之间传输的稳定契约。 */
+export interface GitRepoSnapshot {
+    readonly workspaceId: string;
+    readonly repoRoot: string;
+    /** 当前工作区是否已经初始化为 Git 仓库；旧 Host 未提供时按 true 兼容。 */
+    readonly enabled?: boolean;
+    readonly branch: string;
+    readonly ahead: number;
+    readonly behind: number;
+    readonly hasRemote: boolean;
+    readonly isDirty: boolean;
+    readonly lastFetchedAt: string | null;
+}
+export interface GitChangeItem {
+    readonly path: string;
+    readonly status: string;
+    readonly staged: boolean;
+    readonly oldPath: string | null;
+    readonly binary: boolean;
+    readonly stagedStatus: string | null;
+    readonly worktreeStatus: string | null;
+}
+export interface GitStatus {
+    readonly snapshot: GitRepoSnapshot;
+    readonly changes: readonly GitChangeItem[];
+}
+export interface GitDiff {
+    readonly workspaceId: string;
+    readonly path: string;
+    readonly staged: boolean;
+    readonly binary: boolean;
+    readonly truncated: boolean;
+    readonly content: string;
+}
+export interface GitHistoryItem {
+    readonly commitHash: string;
+    readonly authorName: string;
+    readonly authoredAt: string;
+    readonly subject: string;
+    readonly body: string;
+    readonly refs: readonly GitHistoryRef[];
+}
+export interface GitHistoryRef {
+    readonly name: string;
+    readonly kind: 'head' | 'local' | 'remote';
+    readonly remoteName: string | null;
+}
+export interface GitHistoryPage {
+    readonly items: readonly GitHistoryItem[];
+    readonly cursor: string | null;
+    readonly nextCursor: string | null;
+    readonly totalCount: number;
+}
+export interface GitBranchItem {
+    readonly name: string;
+    readonly current: boolean;
+    readonly upstream: string | null;
+    readonly remote: boolean;
+}
+export interface GitBranchSnapshot {
+    readonly currentBranch: string;
+    readonly local: readonly GitBranchItem[];
+    readonly remote: readonly GitBranchItem[];
+}
+export interface GitCommitResult {
+    readonly commitHash: string;
+    readonly summary: string;
+}
+export interface GitCommitChangedFile {
+    readonly path: string;
+    readonly oldPath: string | null;
+    readonly status: string;
+    readonly binary: boolean;
+}
+export interface GitCommitDiff {
+    readonly commitHash: string;
+    /** 旧版 Host 未提供时由 Client 从 diff 头部回退解析。 */
+    readonly files?: readonly GitCommitChangedFile[];
+    readonly content: string;
+    readonly truncated: boolean;
+}
+//# sourceMappingURL=git.d.ts.map

package/data/build/dist/shared/contracts/git.js

@@ -0,0 +1,3 @@
+/** Git 工作区面板在 Host 与 Client 之间传输的稳定契约。 */
+export {};
+//# sourceMappingURL=git.js.map

package/data/build/dist/shared/contracts/subscription.d.ts

@@ -25,8 +25,54 @@ export interface CliSubscriptionUsage {
         }[];
     };
     readonly capturedAt: string;
+    /** 统一模型提供商摘要；同一提供商可被多个 Agent 复用。 */
+    readonly provider?: CliSubscriptionProvider;
     /** 第三方上游的账户余额和用量摘要；原始 API key 永不进入此结构。 */
     readonly sub2api?: Sub2ApiUsage;
+    /** 官方 DeepSeek API 的账户余额摘要；原始 API key 永不进入此结构。 */
+    readonly deepseek?: DeepseekUsage;
+    /** 其他官方模型提供商的账户余额/用量摘要；原始 API key 永不进入此结构。 */
+    readonly providerBalance?: ProviderBalanceUsage;
+}
+/** 订阅归属的模型提供商，不包含任何凭据。 */
+export interface CliSubscriptionProvider {
+    readonly id: string;
+    readonly displayName: string;
+    readonly baseUrl: string;
+    readonly capability: 'official-balance' | 'official-usage' | 'subscription-window' | 'sub2api' | 'unsupported';
+    readonly logoUrl: string;
+    readonly logoDataUrl?: string;
+}
+/** 官方 DeepSeek API 返回的单个币种余额。金额单位由 currency 指定。 */
+export interface DeepseekBalance {
+    readonly currency: string;
+    readonly totalBalance: number;
+    readonly grantedBalance: number;
+    readonly toppedUpBalance: number;
+}
+/** 官方 DeepSeek API 的安全余额摘要。 */
+export interface DeepseekUsage {
+    readonly upstreamUrl: string;
+    readonly isAvailable: boolean | null;
+    readonly balances: readonly DeepseekBalance[];
+}
+/** 官方提供商账户余额或 Coding Plan 余量的统一安全摘要。 */
+export interface ProviderBalanceUsage {
+    readonly upstreamUrl: string;
+    readonly currency: string | null;
+    readonly unit: string | null;
+    readonly balance: number | null;
+    readonly remaining: number | null;
+    readonly used: number | null;
+    readonly total: number | null;
+    readonly requests: number | null;
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly planName: string | null;
+    readonly details: readonly {
+        readonly label: string;
+        readonly value: string | number;
+    }[];
 }
 export interface Sub2ApiUsagePoint {
     readonly requests: number;

package/data/build/dist/shared/contracts/terminal.d.ts

@@ -61,7 +61,7 @@ export interface CodingNsTerminalShell {
     readonly args: readonly string[];
     readonly name: string;
 }
-/** 与 DSH 0.1.6-alpha.2 `remote.terminal` wire shape 对齐。 */
+/** 与 DSH 0.1.6-alpha.2 官方终端 wire shape 对齐，但由 Codingns4DSH 独立命名空间承载。 */
 export interface CodingNsWebTerminalInfo {
     readonly id: string;
     readonly title: string;
@@ -100,6 +100,9 @@ export interface CodingNsTerminalStatus {
     readonly platform: 'darwin' | 'linux' | 'win32' | 'unsupported';
     readonly controllerMode: 'baseline' | 'enhanced';
     readonly effectiveEnabled: boolean;
+    /** 当前 Host 实际注册的 backend；调试启动必须以此为准。 */
+    readonly runtimeTypes?: readonly CodingNsTerminalRuntimeType[];
+    readonly runtimeWarning?: string;
     readonly profiles: readonly {
         readonly profileId: CodingNsTerminalShell['profileId'];
         readonly name: string;

package/data/build/dist/shared/contracts/version.d.ts

@@ -3,7 +3,7 @@ export declare const DSH_VERSION: "0.1.6-alpha.2";
 /** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
 export declare const DSH_TESTED_VERSION: "0.1.6-alpha.2";
 /** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
-export declare const DSH_COMPATIBILITY: ">=0.1.5-rc.3 <0.1.7-0";
+export declare const DSH_COMPATIBILITY: ">=0.1.5-rc.3 <=0.1.7-rc.2";
 /** DSH Envelope/Tunnel 协议主版本。 */
 export declare const DSH_PROTOCOL_VERSION: 1;
 /** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
@@ -11,7 +11,7 @@ export declare const CODINGNS_DSH_VERSION_GLOBAL: "__CODINGNS_DSH_VERSION__";
 /** 识别没有 alpha2 Sidebar 扩展 API 的 DSH 旧版运行时。 */
 export declare function isLegacyDshVersion(version: string): boolean;
 /** Codingns4DSH 插件自身的 npm 版本。 */
-export declare const CODINGNS_VERSION: "0.1.0";
+export declare const CODINGNS_VERSION: "0.1.1";
 /** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
 export declare function isDshVersionCompatible(version: string): boolean;
 /** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */

package/data/build/dist/shared/contracts/version.js

@@ -3,7 +3,7 @@ export const DSH_VERSION = '0.1.6-alpha.2';
 /** DSH 测试版本别名，供新代码表达语义，保留 DSH_VERSION 兼容旧调用方。 */
 export const DSH_TESTED_VERSION = DSH_VERSION;
 /** 插件支持的 DSH 版本范围；插件版本与宿主版本独立发布。 */
-export const DSH_COMPATIBILITY = '>=0.1.5-rc.3 <0.1.7-0';
+export const DSH_COMPATIBILITY = '>=0.1.5-rc.3 <=0.1.7-rc.2';
 /** DSH Envelope/Tunnel 协议主版本。 */
 export const DSH_PROTOCOL_VERSION = 1;
 /** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
@@ -13,18 +13,16 @@ export function isLegacyDshVersion(version) {
     return /^0\.1\.5(?:-|$)/u.test(version);
 }
 /** Codingns4DSH 插件自身的 npm 版本。 */
-export const CODINGNS_VERSION = '0.1.0';
+export const CODINGNS_VERSION = '0.1.1';
 /** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内。 */
 export function isDshVersionCompatible(version) {
-    const match = /^>=([^ ]+) <([^ ]+)$/u.exec(DSH_COMPATIBILITY);
+    const match = /^>=([^ ]+) <=([^ ]+)$/u.exec(DSH_COMPATIBILITY);
     const actual = parseVersion(version);
     const minimum = parseVersion(match?.[1] ?? '');
     const maximum = parseVersion(match?.[2] ?? '');
     if (!actual || !minimum || !maximum)
         return version === DSH_VERSION;
-    if (actual.major === maximum.major && actual.minor === maximum.minor && actual.patch === maximum.patch && actual.prerelease.length > 0)
-        return false;
-    return compareVersions(actual, minimum) >= 0 && compareVersions(actual, maximum) < 0;
+    return compareVersions(actual, minimum) >= 0 && compareVersions(actual, maximum) <= 0;
 }
 /** 判断 DSH 版本是否达到某个功能模块要求的最低版本。 */
 export function isDshVersionAtLeast(version, minimum) {

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

@@ -0,0 +1,14 @@
+/**
+ * Codingns4DSH 调试日志开关。
+ *
+ * 调试输出默认关闭。需要查看启动或 RPC 追踪时，使用
+ * `CODINGNS4DSH_DEBUG=1 dsh ...` 启动 DSH；浏览器侧同时支持 `?dshDebug=1`。
+ */
+export declare const CODINGNS4DSH_DEBUG_ENV = "CODINGNS4DSH_DEBUG";
+/** 当前运行环境是否明确要求输出调试日志。 */
+export declare function resolveCodingNsDebugEnabled(): boolean;
+/** 输出受统一开关控制的调试信息。 */
+export declare function debugInfo(message: unknown, ...args: unknown[]): void;
+/** 输出受统一开关控制的调试警告。 */
+export declare function debugWarn(message: unknown, ...args: unknown[]): void;
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1,53 @@
+/**
+ * Codingns4DSH 调试日志开关。
+ *
+ * 调试输出默认关闭。需要查看启动或 RPC 追踪时，使用
+ * `CODINGNS4DSH_DEBUG=1 dsh ...` 启动 DSH；浏览器侧同时支持 `?dshDebug=1`。
+ */
+export const CODINGNS4DSH_DEBUG_ENV = 'CODINGNS4DSH_DEBUG';
+const LEGACY_DEBUG_ENV = 'CODINGNS4DSH_TUNNEL_DEBUG';
+/** 当前运行环境是否明确要求输出调试日志。 */
+export function resolveCodingNsDebugEnabled() {
+    const globals = globalThis;
+    const globalValue = globals.__CODINGNS4DSH_DEBUG_ENABLED__ ?? globals.__CODINGNS4DSH_TUNNEL_DEBUG__;
+    if (globalValue !== undefined)
+        return parseDebugValue(globalValue);
+    if (typeof location !== 'undefined') {
+        const queryValue = new URL(location.href).searchParams.get('dshDebug');
+        if (queryValue !== null)
+            return parseDebugValue(queryValue);
+    }
+    if (typeof localStorage !== 'undefined') {
+        try {
+            const stored = localStorage.getItem('codingns4dsh-debug')
+                ?? localStorage.getItem('codingns4dsh-tunnel-debug');
+            if (stored !== null)
+                return parseDebugValue(stored);
+        }
+        catch {
+            // 隐私模式或受限 iframe 可能禁止读取 localStorage，继续检查进程环境变量。
+        }
+    }
+    if (typeof process !== 'undefined') {
+        return parseDebugValue(process.env[CODINGNS4DSH_DEBUG_ENV] ?? process.env[LEGACY_DEBUG_ENV]);
+    }
+    return false;
+}
+/** 输出受统一开关控制的调试信息。 */
+export function debugInfo(message, ...args) {
+    if (resolveCodingNsDebugEnabled())
+        console.info(message, ...args);
+}
+/** 输出受统一开关控制的调试警告。 */
+export function debugWarn(message, ...args) {
+    if (resolveCodingNsDebugEnabled())
+        console.warn(message, ...args);
+}
+function parseDebugValue(value) {
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value !== 'string')
+        return false;
+    return /^(1|true|yes|on)$/iu.test(value.trim());
+}
+//# sourceMappingURL=debug.js.map

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

@@ -1,5 +1,6 @@
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, type CodingNsSettings, type CodingNsCliAdapterPreference, type LanAccessDshSettings, type LanAccessDshLoginSettings, type LoginProtectionScopes, type RestartFeatureStates, type TerminalAppearanceSettings, type TerminalAppearanceTheme, type TerminalBindingScope, type TerminalCursorStyle, type TerminalEnhancementSettings, type TerminalProfileId, type WorkspaceSessionEnhancementSettings, } from './contracts/config.js';
-export type { FeatureContext, FeatureActivation, FeatureDescriptor, FeatureDisposer, FeatureModule, FeatureResourceScope, FeatureRuntime, FeatureState, FeatureUiDescriptor, } from './contracts/feature.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, type CodingNsSettings, type CodingNsConfig, type CodingNsRuntimeState, type CodingNsCliAdapterPreference, type LanAccessDshSettings, type LanAccessDshLoginSettings, type LoginProtectionScopes, type RestartFeatureStates, type TerminalAppearanceSettings, type TerminalAppearanceTheme, type TerminalBindingScope, type TerminalCursorStyle, type TerminalEnhancementSettings, type TerminalProfileId, type QuickPhrase, type WorkspaceSessionEnhancementSettings, } from './contracts/config.js';
+export type { FeatureContext, FeatureActivation, FeatureDescriptor, FeatureCapabilityRequirement, FeatureDisposer, FeatureModule, FeatureResourceScope, FeatureRuntime, FeatureState, FeatureUiDescriptor, } from './contracts/feature.js';
+export type { DshCapabilityDiagnostic, DshCapabilityId, DshCapabilityProfile, DshCapabilityResolution, DshCapabilityResolutionStatus, DshCapabilityRoute, DshCapabilityRouteStatus, DshCapabilityRuntime, } from '../dsh-capabilities/types.js';
 export { CODINGNS_DSH_ERROR_CODES, CodingNsDshError, SUPPORTED_DSH_COMPATIBILITY, SUPPORTED_DSH_VERSION, assertSupportedDshVersion, type CodingNsDshErrorCode, } from './contracts/errors.js';
 export { CODINGNS_VERSION, DSH_COMPATIBILITY, DSH_PROTOCOL_VERSION, CODINGNS_DSH_VERSION_GLOBAL, DSH_TESTED_VERSION, DSH_VERSION, isDshVersionAtLeast, isLegacyDshVersion, isDshVersionCompatible, } from './contracts/version.js';
 export type { CodingNsRpcRequest, CodingNsStreamRequest, CodingNsTransport, CodingNsTransportErrorShape, CodingNsTransportGeneration, CodingNsTransportHooks, } from './contracts/transport.js';
@@ -7,16 +8,18 @@ export { DSH_ENVELOPE_PROTOCOL, DSH_ENVELOPE_VERSION, DEFAULT_MAX_DSH_ENVELOPE_B
 export { CODINGNS_RPC_CHANNEL } from './contracts/transport.js';
 export type { CodingNsCliAdapterDescriptor, CodingNsCliAdapterId, CodingNsCliCapability, CodingNsAgentEvent, CodingNsAgentQuestion, CodingNsAgentQuestionResponse, CodingNsAgentToolEvent, CodingNsCliMessage, CodingNsCliModel, CodingNsCliModelCatalog, CodingNsCliModelGroup, CodingNsAgentPermissionResponse, CodingNsCliSessionConfig, CodingNsCliSessionRecord, CodingNsCliProviderSessionState, CodingNsCliSessionStatus, CodingNsSessionAdapterBinding, CodingNsCliTurnInput, } from './contracts/cli-adapter.js';
 export type { CommandCodeSubscriptionUsage, CommandCodeSubscriptionWindow, } from './contracts/command-code.js';
-export type { CliSubscriptionUsage, CliSubscriptionWindow, Sub2ApiDailyUsage, Sub2ApiModelUsage, Sub2ApiUsage, Sub2ApiUsagePoint, } from './contracts/subscription.js';
+export type { GitBranchItem, GitBranchSnapshot, GitChangeItem, GitCommitResult, GitDiff, GitHistoryItem, GitHistoryPage, GitHistoryRef, GitRepoSnapshot, GitStatus, } from './contracts/git.js';
+export type { CliSubscriptionProvider, CliSubscriptionUsage, CliSubscriptionWindow, DeepseekBalance, DeepseekUsage, ProviderBalanceUsage, Sub2ApiDailyUsage, Sub2ApiModelUsage, Sub2ApiUsage, Sub2ApiUsagePoint, } from './contracts/subscription.js';
 export type { PeerHostRecord, PeerHostStatus, ResourceScopeDisposer, ResourceScopeInput, ResourceScopeRef, ResourceScopeSnapshot, } from './contracts/peer-host.js';
 export { ResourceScopeStaleError } from './contracts/peer-host.js';
 export { DEBUG_ERROR_CODES, DEBUG_RPC_ENDPOINTS, parseDebugMutationScope, parseDebugPtyLaunchRequest, parseDebugRpcScope, type DebugAiFallbackState, type DebugCompatibilityLevel, type DebugErrorCode, type DebugMutationScope, type DebugPortState, type DebugProcessInstance, type DebugProcessOwnership, type DebugPlanState, type DebugProxyProtocol, type DebugPtyLaunchRequest, type DebugRpcEndpoint, type DebugRpcScope, type DebugRuntimeMode, type DebugRuntimeState, } from './contracts/debug.js';
 export type { LanAccessDshConfig, LanAccessDshLoginConfig, LanAccessDshSnapshot, LanAccessDshState, } from './contracts/lan-access-dsh.js';
 export type { CodingNsTerminalCreateRequest, CodingNsTerminalEnvironment, CodingNsTerminalFrame, CodingNsTerminalRetentionFrame, CodingNsTerminalRuntimeType, CodingNsTerminalShell, CodingNsTerminalShellOption, CodingNsTerminalStatus, CodingNsTerminalState, CodingNsWebTerminalInfo, PersistentTerminalRecord, TerminalAttachmentRecord, TerminalOwnerScope, TerminalRecordIdentity, } from './contracts/terminal.js';
 export { EMPTY_DEBUG_CONFIG, parseDebugConfig, type DebugConfig, type DebugProfile, type DebugProxyConfig, type DebugRuntimeType, type DebugShell, } from './contracts/debug-config.js';
-export type { DshDeviceSummary, DshDeviceRegistrationRequest, DshDeviceRegistrationResponse, DshDeviceListResponse, DshDeviceHeartbeatResponse, DshRelayTicketRequest, DshRelayTicketResponse, DshRelayTicketLike, DshIceServer, DshDeviceCredentialRecord, } from './contracts/dsh-device.js';
+export type { DshDeviceSummary, DshDeviceRegistrationRequest, DshDeviceRegistrationResponse, DshDeviceListResponse, DshDeviceHeartbeatResponse, DshDeviceHeartbeatRequest, DshRelayTicketRequest, DshRelayTicketResponse, DshRelayTicketLike, DshIceServer, DshDeviceCredentialRecord, } from './contracts/dsh-device.js';
 export type { TerminalLaunchProfile, TerminalProcessInstance, TerminalProcessLaunchRequest, TerminalProcessLaunchResult, TerminalProcessState, } from './contracts/terminal-process.js';
 export type { AccountProfile, AuthClientType, AuthDeviceManagementSnapshotDto, AuthDeviceViewDto, CodingNsAuthLoginResult, CodingNsAuthSessionSnapshot, CodingNsAuthStatus, HostBindRequest, HostBindResponse, HostBindingsResponse, HostLabelAvailabilityResponse, HostUnbindResponse, LoginByEmailRequest, TunnelBindingSummary, } from './contracts/auth.js';
 export type { RelayIceServer, RelaySignalingTicketRequest, RelaySignalingClientMessage, RelaySignalingServerMessage, RelaySignalingTicketResponse, } from './contracts/signaling.js';
 export type { DshHostStatus } from './contracts/host-status.js';
+export { CODINGNS4DSH_DEBUG_ENV, debugInfo, debugWarn, resolveCodingNsDebugEnabled, } from './debug.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,4 @@
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, } from './contracts/config.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_CONTROL_STATION_URL, CODINGNS_H5_LOGIN_URL, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_TERMINAL_ENHANCEMENT_FIELD, CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_QUICK_PHRASES, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, captureRestartFeatureStates, enabledFeatureNames, isFeatureDshVersionCompatible, isFeatureEnabled, isCodingNsSettingsEntryId, } from './contracts/config.js';
 export { CODINGNS_DSH_ERROR_CODES, CodingNsDshError, SUPPORTED_DSH_COMPATIBILITY, SUPPORTED_DSH_VERSION, assertSupportedDshVersion, } from './contracts/errors.js';
 export { CODINGNS_VERSION, DSH_COMPATIBILITY, DSH_PROTOCOL_VERSION, CODINGNS_DSH_VERSION_GLOBAL, DSH_TESTED_VERSION, DSH_VERSION, isDshVersionAtLeast, isLegacyDshVersion, isDshVersionCompatible, } from './contracts/version.js';
 export { DSH_ENVELOPE_PROTOCOL, DSH_ENVELOPE_VERSION, DEFAULT_MAX_DSH_ENVELOPE_BYTES, DEFAULT_MAX_DSH_META_BYTES, decodeDshEnvelope, encodeDshEnvelope, validateDshEnvelope, } from '../transport/dsh-envelope.js';
@@ -6,4 +6,5 @@ export { CODINGNS_RPC_CHANNEL } from './contracts/transport.js';
 export { ResourceScopeStaleError } from './contracts/peer-host.js';
 export { DEBUG_ERROR_CODES, DEBUG_RPC_ENDPOINTS, parseDebugMutationScope, parseDebugPtyLaunchRequest, parseDebugRpcScope, } from './contracts/debug.js';
 export { EMPTY_DEBUG_CONFIG, parseDebugConfig, } from './contracts/debug-config.js';
+export { CODINGNS4DSH_DEBUG_ENV, debugInfo, debugWarn, resolveCodingNsDebugEnabled, } from './debug.js';
 //# sourceMappingURL=index.js.map

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

@@ -17,6 +17,6 @@ export interface DshTransportDebugOptions {
 }
 /** 创建一个可注入测试 sink 的调试 logger。默认开关由当前运行环境决定。 */
 export declare function createDshTransportDebugLogger(options?: DshTransportDebugOptions): DshTransportDebugLogger;
-/** 解析 Host 环境变量、H5 URL/localStorage 和调试全局变量。 */
+/** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */
 export declare function resolveDshTransportDebugEnabled(): boolean;
 //# sourceMappingURL=debug.d.ts.map

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

@@ -1,4 +1,4 @@
-const DEBUG_ENV = 'CODINGNS4DSH_TUNNEL_DEBUG';
+import { resolveCodingNsDebugEnabled } from '../shared/debug.js';
 /** 创建一个可注入测试 sink 的调试 logger。默认开关由当前运行环境决定。 */
 export function createDshTransportDebugLogger(options = {}) {
     const enabled = options.enabled ?? resolveDshTransportDebugEnabled();
@@ -23,35 +23,8 @@ export function createDshTransportDebugLogger(options = {}) {
         },
     };
 }
-/** 解析 Host 环境变量、H5 URL/localStorage 和调试全局变量。 */
+/** 解析统一的 Codingns4DSH 调试开关，保留旧隧道变量作为兼容别名。 */
 export function resolveDshTransportDebugEnabled() {
-    const globalValue = globalThis.__CODINGNS4DSH_TUNNEL_DEBUG__;
-    if (globalValue !== undefined)
-        return parseDebugValue(globalValue);
-    if (typeof location !== 'undefined') {
-        const queryValue = new URL(location.href).searchParams.get('dshDebug');
-        if (queryValue !== null)
-            return parseDebugValue(queryValue);
-    }
-    if (typeof localStorage !== 'undefined') {
-        try {
-            const stored = localStorage.getItem('codingns4dsh-tunnel-debug');
-            if (stored !== null)
-                return parseDebugValue(stored);
-        }
-        catch {
-            // 隐私模式或受限 iframe 可能禁止读取 localStorage，继续检查其他来源。
-        }
-    }
-    if (typeof process !== 'undefined')
-        return parseDebugValue(process.env[DEBUG_ENV]);
-    return false;
-}
-function parseDebugValue(value) {
-    if (typeof value === 'boolean')
-        return value;
-    if (typeof value !== 'string')
-        return false;
-    return /^(1|true|yes|on)$/iu.test(value.trim());
+    return resolveCodingNsDebugEnabled();
 }
 //# sourceMappingURL=debug.js.map