@linxin666/dsh-remote-web-ui 0.3.2 → 0.3.4

package/lib/types/mobile-api.js

@@ -45,6 +45,7 @@ const MOBILE_ALLOWLIST = new Set([
     'session.models',
     'session.selectModel',
     'session.rename',
+    'session.cancel',
 ]);
 /**
  * Locally answered display-preference method (the phone's read-only
@@ -54,6 +55,8 @@ const MOBILE_ALLOWLIST = new Set([
 const MOBILE_PREFERENCES_METHOD = 'mobile.preferences';
 const MOBILE_PENDING_METHOD = 'mobile.pending';
 const MOBILE_RESPOND_METHOD = 'mobile.respond';
+/** Execute a slash command through the host command registry (#1125). */
+const MOBILE_COMMAND_METHOD = 'mobile.command';
 /** One session.list page (thin phones load incrementally). */
 const SESSION_PAGE_SIZE = 20;
 /** SSE keep-alive ping cadence for the live mux stream (single connection). */
@@ -129,7 +132,8 @@ export function makeMobileApiRoutes(deps) {
         const method = pathname.slice(MOBILE_API_METHOD_PREFIX.length);
         const local = method === MOBILE_PREFERENCES_METHOD
             || method === MOBILE_PENDING_METHOD
-            || method === MOBILE_RESPOND_METHOD;
+            || method === MOBILE_RESPOND_METHOD
+            || method === MOBILE_COMMAND_METHOD;
         if (!MOBILE_ALLOWLIST.has(method) && !local) {
             writeJson(res, 403, { ok: false, error: { code: 'forbidden', message: `method ${method} is not exposed to the mobile surface` } });
             return;
@@ -187,6 +191,55 @@ export function makeMobileApiRoutes(deps) {
                     });
                 }
             }
+            else if (method === MOBILE_COMMAND_METHOD) {
+                const payload = parsed.payload;
+                const sessionId = payload?.sessionId;
+                const line = payload?.line;
+                if (typeof sessionId !== 'string' || typeof line !== 'string') {
+                    writeJson(res, 200, {
+                        type: 'server-response',
+                        rpcId,
+                        result: { ok: false, error: { code: 'bad-request', message: 'missing sessionId or line' } },
+                    });
+                }
+                else if (deps.commandDispatcher === undefined) {
+                    writeJson(res, 200, {
+                        type: 'server-response',
+                        rpcId,
+                        result: { ok: false, error: { code: 'unavailable', message: 'command dispatcher is not available' } },
+                    });
+                }
+                else {
+                    try {
+                        const abort = new AbortController();
+                        res.on('close', () => { if (!res.writableEnded)
+                            abort.abort(); });
+                        const outcome = await deps.commandDispatcher.execute(sessionId, line, abort.signal);
+                        if ('error' in outcome) {
+                            writeJson(res, 200, {
+                                type: 'server-response',
+                                rpcId,
+                                result: { ok: false, error: { code: outcome.error, message: outcome.error } },
+                            });
+                        }
+                        else {
+                            writeJson(res, 200, {
+                                type: 'server-response',
+                                rpcId,
+                                result: { ok: true, value: { matched: true, result: outcome.result } },
+                            });
+                        }
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        writeJson(res, 200, {
+                            type: 'server-response',
+                            rpcId,
+                            result: { ok: false, error: { code: 'internal', message } },
+                        });
+                    }
+                }
+            }
             return;
         }
         try {
@@ -345,5 +398,7 @@ async function dispatch(apiProxy, method, payload, rpcId, signal) {
         return wrap(await apiProxy.sessions.selectModel(request));
     if (method === 'session.rename')
         return wrap(await apiProxy.sessions.rename(request));
+    if (method === 'session.cancel')
+        return wrap(await apiProxy.sessions.cancel(request));
     throw new Error(`unhandled allowlisted method ${method}`);
 }

package/lib/types/mobile-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile-routes.d.ts","sourceRoot":"","sources":["../../src/mobile-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAwH/D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,EAAE,CAyE7C"}
+{"version":3,"file":"mobile-routes.d.ts","sourceRoot":"","sources":["../../src/mobile-routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAwH/D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,EAAE,CA8F7C"}

package/lib/types/mobile-routes.js

@@ -7,6 +7,7 @@
 import { readFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { gzipSync } from 'node:zlib';
 const MOBILE_ROOT = '/m/';
 const MOBILE_BUNDLE_URL = '/m/mobile.js';
 const MOBILE_MANIFEST_URL = '/m/manifest.webmanifest';
@@ -132,7 +133,8 @@ export function makeMobileRoutes() {
     // The bundle is immutable for the process lifetime (a rebuild requires a
     // host restart), so the body is read from disk once, not per phone.
     let bundleBody;
-    const handleBundle = async (_req, res) => {
+    let bundleGzip;
+    const handleBundle = async (req, res) => {
         if (bundleBody === undefined) {
             const path = mobileBundlePath();
             if (!existsSync(path)) {
@@ -141,13 +143,34 @@ export function makeMobileRoutes() {
             }
             try {
                 bundleBody = await readFile(path, 'utf8');
+                bundleGzip = gzipSync(Buffer.from(bundleBody, 'utf8'));
             }
             catch {
                 writeStatic(res, 500, 'text/plain', 'failed to read the mobile bundle');
                 return;
             }
         }
-        writeStatic(res, 200, 'text/javascript', bundleBody);
+        const acceptEncoding = req.headers['accept-encoding'] ?? '';
+        const acceptsGzip = typeof acceptEncoding === 'string' && acceptEncoding.includes('gzip') && bundleGzip !== undefined;
+        if (acceptsGzip) {
+            res.writeHead(200, {
+                'content-type': 'text/javascript; charset=utf-8',
+                'content-encoding': 'gzip',
+                'cache-control': 'no-cache',
+                vary: 'Accept-Encoding',
+                'referrer-policy': 'no-referrer',
+            });
+            res.end(bundleGzip);
+        }
+        else {
+            res.writeHead(200, {
+                'content-type': 'text/javascript; charset=utf-8',
+                'cache-control': 'no-cache',
+                vary: 'Accept-Encoding',
+                'referrer-policy': 'no-referrer',
+            });
+            res.end(bundleBody);
+        }
     };
     let workerBody;
     const handleWorker = async (_req, res) => {

package/lib/types/mount-once.d.ts

@@ -1,6 +1,6 @@
 /**
  * Host single-instance guard shared by the plugin family. The family bundle
- * (dsh-web-ui-all / dsh-skins) namespaces every child row id (web-ui-*), so
+ * (dsh-web-all / dsh-skins) namespaces every child row id (web-ui-*), so
  * the loader accepts a standalone install of the same package side by side;
  * without this guard the second instance would still re-register the same
  * webserver routes, tools, settings namespaces, and system-prompt sections

package/lib/types/mount-once.js

@@ -1,7 +1,7 @@
 // Generated by scripts/sync-shared.mjs from shared/host/mount-once.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
 /**
  * Host single-instance guard shared by the plugin family. The family bundle
- * (dsh-web-ui-all / dsh-skins) namespaces every child row id (web-ui-*), so
+ * (dsh-web-all / dsh-skins) namespaces every child row id (web-ui-*), so
  * the loader accepts a standalone install of the same package side by side;
  * without this guard the second instance would still re-register the same
  * webserver routes, tools, settings namespaces, and system-prompt sections
@@ -14,7 +14,7 @@
  * `ctx.effect` runs its callback immediately and treats the callback's
  * return value as the fiber disposer, so the unmarker is returned, not run.
  */
-const MOUNTED = Symbol.for('dsh-web-ui.mounted-plugins');
+const MOUNTED = Symbol.for('dsh-web.mounted-plugins');
 function mountedSet() {
     const registry = globalThis;
     return (registry[MOUNTED] ??= new Set());

package/lib/types/update.d.ts

@@ -1,6 +1,6 @@
 /**
- * Remote update support for the dsh-web-ui family — host half. Detects the
- * installed aggregate package (@linxin666/dsh-web-ui-all), or the directly
+ * Remote update support for the dsh-web family — host half. Detects the
+ * installed aggregate package (@linxin666/dsh-web-all), or the directly
  * installed family packages when the aggregate is absent, probes npm for newer
  * releases, and runs `pnpm update --latest` inside the owning dsh profile.
  *
@@ -11,12 +11,16 @@
 import { spawn } from 'node:child_process';
 /** npm registry base used for version probes. */
 export declare const NPM_REGISTRY = "https://registry.npmjs.org";
-/** The family scope every dsh-web-ui package is published under. */
+/** The family scope every dsh-web package is published under. */
 export declare const FAMILY_SCOPE = "@linxin666/";
 /** The aggregate package that is the canonical update entry point. */
-export declare const AGGREGATE_PACKAGE = "@linxin666/dsh-web-ui-all";
+export declare const AGGREGATE_PACKAGE = "@linxin666/dsh-web-all";
 /** Fallback anchor: this plugin's own package when the aggregate is absent. */
 export declare const SELF_PACKAGE = "@linxin666/dsh-remote-web-ui";
+/** GitHub repository used to surface human-readable release notes. */
+export declare const UPDATE_RELEASE_REPO = "zhu1090093659/dsh-web";
+/** Release-notes cache freshness window (host process). */
+export declare const RELEASE_NOTES_CACHE_TTL_MS: number;
 /** A parsed semantic version (prerelease identifiers kept as strings). */
 export interface SemverParts {
     major: number;
@@ -74,6 +78,17 @@ export interface UpdatePackageStatus {
     /** Whether npm carries a strictly newer release. */
     outdated: boolean;
 }
+/** Structured release-note sections shown in the update panel. */
+export interface UpdateReleaseNotes {
+    /** Version the notes describe. */
+    version: string;
+    /** New feature bullets. */
+    features: string[];
+    /** Bug-fix bullets. */
+    fixes: string[];
+    /** Other-change bullets. */
+    other: string[];
+}
 /** The full update-status snapshot served to the browser half. */
 export interface UpdateStatus {
     /** npm = registry-managed (updatable); link = local dev install; missing = no anchor package. */
@@ -86,6 +101,8 @@ export interface UpdateStatus {
     packages: UpdatePackageStatus[];
     /** True when any package has a newer npm release. */
     outdated: boolean;
+    /** Human-readable release notes for the target release, when available. */
+    notes?: UpdateReleaseNotes;
     /** Whole-check failure (e.g. registry unreachable). */
     error?: string;
 }
@@ -97,6 +114,8 @@ export interface UpdateCheckDeps {
     resolve(specifier: string): string | undefined;
     /** Probe one package's latest npm version; undefined on failure. */
     fetchLatest(name: string): Promise<string | undefined>;
+    /** Fetch structured release notes for one target version, when available. */
+    fetchReleaseNotes?(version: string): Promise<UpdateReleaseNotes | undefined>;
 }
 /**
  * Resolve the anchor package's manifest path. The aggregate package is the
@@ -141,6 +160,18 @@ export declare function fetchLatestVersion(name: string, fetchImpl: (url: string
     ok: boolean;
     json(): Promise<unknown>;
 }>, timeoutMs?: number): Promise<string | undefined>;
+export declare function parseReleaseNotesBody(version: string, body: string): UpdateReleaseNotes | undefined;
+/**
+ * Fetch and parse the GitHub Release for one `dsh-web` version.
+ * @param version - the npm release version (without the `v` prefix).
+ * @param fetchImpl - injected fetch; global `fetch` in the host.
+ * @param timeoutMs - hard timeout for the GitHub API probe.
+ * @returns structured notes, or undefined when unavailable.
+ */
+export declare function fetchGitHubReleaseNotes(version: string, fetchImpl?: (url: string, init?: RequestInit) => Promise<{
+    ok: boolean;
+    json(): Promise<unknown>;
+}>, timeoutMs?: number): Promise<UpdateReleaseNotes | undefined>;
 /**
  * Build the update status: locate the anchor, detect the install mode, and
  * compare every family package against the npm registry.

package/lib/types/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,iDAAiD;AACjD,eAAO,MAAM,YAAY,+BAA+B,CAAA;AAExD,iEAAiE;AACjE,eAAO,MAAM,YAAY,gBAAgB,CAAA;AAEzC,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,2BAA2B,CAAA;AAEzD,+EAA+E;AAC/E,eAAO,MAAM,YAAY,iCAAiC,CAAA;AAE1D,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,0BAA0B,CAAA;AAE1D,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,QAAc,CAAA;AAQrD,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA2B5D;AAYD,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,kBAAkB,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAahF;AAED,6DAA6D;AAC7D,KAAK,cAAc,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAE9D,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAG1D;AAcD,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,uBAAuB;IACvB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;IAChC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,QAAQ,EAAE,mBAAmB,EAAE,CAAA;IAC/B,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAA;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,4EAA4E;IAC5E,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9C,oEAAoE;IACpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACtD,6EAA6E;IAC7E,iBAAiB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAA;CAC7E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACjD,MAAM,GAAG,SAAS,CAUpB;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,YAAY,GAAG;IAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,CAoBhD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAQhF;AAiBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,EAClG,SAAS,SAAS,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;AA8CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAMnG;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAS,EAC1G,SAAS,SAAS,GACjB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAqBzC;AA4BD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CA4D/E;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe;AACzB,2BAA2B;AACzB,cAAc;AAChB,6CAA6C;GAC3C,SAAS;AACX,2CAA2C;GACzC,WAAW;AACb,iEAAiE;GAC/D,MAAM;AACR,4BAA4B;GAC1B,aAAa;AACf,6DAA6D;GAC3D,OAAO;AACT,iFAAiF;GAC/E,eAAe,CAAA;AAEnB,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAC3B;AAuBD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA8HvE;AAED,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,GAAG,EAAE,aAAa,CAAA;IAClB,8DAA8D;IAC9D,KAAK,EAAE,eAAe,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgE7F"}

package/lib/types/update.js

@@ -1,6 +1,6 @@
 /**
- * Remote update support for the dsh-web-ui family — host half. Detects the
- * installed aggregate package (@linxin666/dsh-web-ui-all), or the directly
+ * Remote update support for the dsh-web family — host half. Detects the
+ * installed aggregate package (@linxin666/dsh-web-all), or the directly
  * installed family packages when the aggregate is absent, probes npm for newer
  * releases, and runs `pnpm update --latest` inside the owning dsh profile.
  *
@@ -13,12 +13,16 @@ import { dirname, join } from 'node:path';
 import { spawn } from 'node:child_process';
 /** npm registry base used for version probes. */
 export const NPM_REGISTRY = 'https://registry.npmjs.org';
-/** The family scope every dsh-web-ui package is published under. */
+/** The family scope every dsh-web package is published under. */
 export const FAMILY_SCOPE = '@linxin666/';
 /** The aggregate package that is the canonical update entry point. */
-export const AGGREGATE_PACKAGE = '@linxin666/dsh-web-ui-all';
+export const AGGREGATE_PACKAGE = '@linxin666/dsh-web-all';
 /** Fallback anchor: this plugin's own package when the aggregate is absent. */
 export const SELF_PACKAGE = '@linxin666/dsh-remote-web-ui';
+/** GitHub repository used to surface human-readable release notes. */
+export const UPDATE_RELEASE_REPO = 'zhu1090093659/dsh-web';
+/** Release-notes cache freshness window (host process). */
+export const RELEASE_NOTES_CACHE_TTL_MS = 10 * 60_000;
 /** A profile manifest `name` prefix (e.g. `dsh-profile-web`). */
 const PROFILE_NAME_PREFIX = 'dsh-profile-';
 /** How many ancestor directories a profile search walks before giving up. */
@@ -242,6 +246,91 @@ export async function fetchLatestVersion(name, fetchImpl, timeoutMs = 10_000) {
         return undefined;
     }
 }
+/** Normalize one release-note bullet. */
+function cleanNoteItem(text) {
+    // Keep the visible label and drop Markdown link targets; issue references
+    // become plain #123 because the panel has no Markdown renderer.
+    return text.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/^[-*]\s+/, '').trim();
+}
+/** Determine the section kind for a Markdown heading line. */
+function noteSectionOf(line) {
+    const heading = /^#{1,6}\s+(.+)$/.exec(line.trim());
+    if (heading === null)
+        return undefined;
+    const title = heading[1].replace(/[:：].*$/, '').trim().toLowerCase();
+    if (title === '新功能' || title === 'new features')
+        return 'features';
+    if (title === '修复' || title === 'bug fixes' || title === 'bugfixes')
+        return 'fixes';
+    if (title === '其他改动' || title === 'other changes')
+        return 'other';
+    return undefined;
+}
+/**
+ * Parse the GitHub Release body into the three conventional sections.
+ *
+ * The committed release notes are bilingual: Chinese is the default view and
+ * English lives inside a `<details>` block. Prefer the Chinese sections when
+ * present and fall back to the whole body for English-only releases. Bullets
+ * are escaped as plain text for the panel (no Markdown renderer).
+ */
+function parseReleaseNotesSource(version, source) {
+    const notes = { version, features: [], fixes: [], other: [] };
+    let current;
+    for (const rawLine of source.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        const section = noteSectionOf(line);
+        if (section !== undefined) {
+            current = section;
+            continue;
+        }
+        if (current === undefined || !/^-\s+/.test(line))
+            continue;
+        const item = cleanNoteItem(line);
+        if (item !== '')
+            notes[current].push(item);
+    }
+    if (notes.features.length === 0 && notes.fixes.length === 0 && notes.other.length === 0)
+        return undefined;
+    return notes;
+}
+export function parseReleaseNotesBody(version, body) {
+    // The committed release notes put Chinese in the default view and English in
+    // a <details> block. Parse only the default view first, then fall back to
+    // the full body for English-only releases.
+    return parseReleaseNotesSource(version, body.split('<details>')[0] ?? body)
+        ?? parseReleaseNotesSource(version, body);
+}
+/**
+ * Fetch and parse the GitHub Release for one `dsh-web` version.
+ * @param version - the npm release version (without the `v` prefix).
+ * @param fetchImpl - injected fetch; global `fetch` in the host.
+ * @param timeoutMs - hard timeout for the GitHub API probe.
+ * @returns structured notes, or undefined when unavailable.
+ */
+export async function fetchGitHubReleaseNotes(version, fetchImpl = fetch, timeoutMs = 10_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => { controller.abort(); }, timeoutMs);
+    try {
+        const response = await fetchImpl(`https://api.github.com/repos/${UPDATE_RELEASE_REPO}/releases/tags/v${version}`, {
+            headers: { accept: 'application/vnd.github+json', 'user-agent': 'dsh-web-update' },
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return undefined;
+        const body = await response.json();
+        if (typeof body !== 'object' || body === null)
+            return undefined;
+        const text = body.body;
+        return typeof text === 'string' ? parseReleaseNotesBody(version, text) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 /**
  * Sentinel for an installed version that could not be read (missing manifest
  * or resolve failure). It is a real-looking version so `checkUpdates` can
@@ -319,12 +408,17 @@ export async function checkUpdates(deps) {
     // Registry unreachable: every probe failed — report the outage distinctly
     // instead of a misleading "all up to date" (the panel needs the reason).
     const error = probeFailures === names.length && names.length > 0 ? 'registry-unreachable' : undefined;
+    const targetVersion = packages.find(packageStatus => packageStatus.latest !== undefined)?.latest;
+    const notes = targetVersion !== undefined && deps.fetchReleaseNotes !== undefined
+        ? await deps.fetchReleaseNotes(targetVersion).catch(() => undefined)
+        : undefined;
     return {
         mode: linked ? 'link' : 'npm',
         profileName: profile.name,
         anchor,
         packages,
         outdated: packages.some(packageStatus => packageStatus.outdated),
+        ...(notes !== undefined ? { notes } : {}),
         ...(error !== undefined ? { error } : {}),
     };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-remote-web-ui",
   "description": "Scan-to-pair mobile and PC remote control for the dsh web GUI: QR entry beside the settings button, one-time pairing tokens, a gated /remote/api desktop channel, live device status, and revocable sessions",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -75,6 +75,8 @@
     "@deepseek-ai/dsh-host-webserver": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",
@@ -90,7 +92,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/zhu1090093659/dsh-web-ui.git"
+    "url": "https://github.com/zhu1090093659/dsh-web.git"
   },
   "scripts": {
     "build": "tsc -b && tsdown",

package/src/client/PluginSettingsCard.tsx

@@ -39,6 +39,8 @@ export interface PluginSettingsCardProps<TKey extends string = string> {
   titleKey: TKey
   /** Locale key of the line describing what this plugin's settings govern. */
   descriptionKey: TKey
+  /** Optional rich header description rendered instead of the plain t(descriptionKey) text (the plain text stays as the tooltip). */
+  descriptionNode?: ReactNode
   /** The card's form state: availability, writability, and what a save would do. */
   state: CardShell
   /** Write every staged edit. */
@@ -87,7 +89,7 @@ export function PluginSettingsCard<TKey extends string = string>(props: PluginSe
       <div className={css.headerStatic}>
         <span className={css.headText}>
           <span className={css.name} title={title}>{title}</span>
-          <span className={css.description} title={description}>{description}</span>
+          <span className={css.description} title={description}>{props.descriptionNode ?? description}</span>
         </span>
         {state.dirty ? <span className={css.pending} title={props.t('settings.unsaved')}>{props.t('settings.unsaved')}</span> : null}
       </div>
@@ -102,7 +104,7 @@ export function PluginSettingsCard<TKey extends string = string>(props: PluginSe
       >
         <span className={css.headText}>
           <span className={css.name} title={title}>{title}</span>
-          <span className={css.description} title={description}>{description}</span>
+          <span className={css.description} title={description}>{props.descriptionNode ?? description}</span>
         </span>
         {state.dirty ? <span className={css.pending} title={props.t('settings.unsaved')}>{props.t('settings.unsaved')}</span> : null}
         <svg

package/src/client/RemoteEntry.tsx

@@ -3,7 +3,7 @@
  * trigger beside the settings button, and the pairing panel modal. Owns the
  * panel behavior — token minting on open, the status SSE subscription,
  * stop/refresh/copy — and renders the pure {@link RemotePanel} body. The
- * update seat (the dsh-web-ui self-update flow) rides the same footer row,
+ * update seat (the dsh-web self-update flow) rides the same footer row,
  * rendered by {@link UpdateEntry}. Component-local state per the client
  * stack rules: nothing here survives remounts or crosses entries.
  */

package/src/client/UpdatePanel.tsx

@@ -6,7 +6,7 @@
  */
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'
 import { IconCloseOutline16, IconRefreshOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'
-import type { UpdateRunResult, UpdateStatus } from '../update.ts'
+import type { UpdateReleaseNotes, UpdateRunResult, UpdateStatus } from '../update.ts'
 import css from "./remote.module.css"
 
 /** The panel view state, owned by the entry component. */
@@ -73,7 +73,7 @@ export function UpdatePanel({ t, view, onClose, onRecheck, onStartUpdate }: Upda
             {t("update.updating", { name: anchorName(status) ?? "", version: anchorLatest(status) ?? "" })}
           </p>
           <p className={css.updateDetail}>{t("update.cooldownNotice")}</p>
-          <PackageList status={status} />
+          <PackageSummary t={t} status={status} />
         </div>
       )}
       {view.kind === "done" && <DoneBody t={t} result={view.result} />}
@@ -147,6 +147,7 @@ function ResultBody({ t, status }: { t: TranslateNS<"remote">; status: UpdateSta
           {anchor !== undefined ? t("update.foundDetail", { name: anchor, version: latest ?? "" }) : ""}
         </p>
         <p className={css.updateDetail}>{t("update.cooldownNotice")}</p>
+        <PackageSummary t={t} status={status} />
       </div>
     )
   }
@@ -156,7 +157,46 @@ function ResultBody({ t, status }: { t: TranslateNS<"remote">; status: UpdateSta
       {anchor !== undefined && latest !== undefined && (
         <p className={css.updateDetail}>{t("update.upToDateDetail", { name: anchor, version: latest })}</p>
       )}
-      <PackageList status={status} />
+      <PackageSummary t={t} status={status} />
+    </div>
+  )
+}
+
+/** Release-note summary when available; otherwise fall back to the package list. */
+function PackageSummary({ t, status }: { t: TranslateNS<'remote'>; status: UpdateStatus }) {
+  if (status.notes === undefined) return <PackageList status={status} />
+  return (
+    <div>
+      <ReleaseNotes t={t} notes={status.notes} />
+      <details className={css.updateVersions}>
+        <summary className={css.updateVersionsSummary}>{t("update.componentVersions")}</summary>
+        <PackageList status={status} />
+      </details>
+    </div>
+  )
+}
+
+/** Render GitHub Release sections as a compact three-group list. */
+function ReleaseNotes({ t, notes }: { t: TranslateNS<'remote'>; notes: UpdateReleaseNotes }) {
+  const sections = [
+    { key: 'features', title: t("update.releaseFeatures"), items: notes.features },
+    { key: 'fixes', title: t("update.releaseFixes"), items: notes.fixes },
+    { key: 'other', title: t("update.releaseOther"), items: notes.other },
+  ].filter(section => section.items.length > 0)
+  if (sections.length === 0) return <p className={css.updateDetail}>{t("update.releaseUnavailable")}</p>
+  return (
+    <div className={css.updateNotes}>
+      <h3 className={css.updateNotesTitle}>{t("update.releaseNotes", { version: notes.version })}</h3>
+      {sections.map(section => (
+        <section key={section.key} className={css.updateNoteSection}>
+          <h4 className={css.updateNoteHeading}>{section.title}</h4>
+          <ul className={css.updateNoteList}>
+            {section.items.map((item, index) => (
+              <li key={index} className={css.updateNoteItem}>{item}</li>
+            ))}
+          </ul>
+        </section>
+      ))}
     </div>
   )
 }

package/src/client/index.ts

@@ -33,6 +33,7 @@ import {
   type RemoteChannelBootSeat,
 } from './remote-channel.ts'
 import { FenceNotice } from './FenceNotice.tsx'
+import { reportDailyHeartbeat } from './telemetry.ts'
 
 export type { RemoteEntryProps } from './RemoteEntry.tsx'
 export type { PanelState, RemotePanelProps } from './RemotePanel.tsx'
@@ -80,7 +81,7 @@ export interface SettingsPluginItemOwnerProps {
 declare module '@deepseek-ai/cordis' {
   interface Context {
     /**
-     * Optional rc.6 compatibility binder provided by dsh-web-ui-settings;
+     * Optional rc.6 compatibility binder provided by dsh-web-settings;
      * absent when that group plugin is not installed, so callers fall back to
      * the official settings scope.
      */
@@ -106,6 +107,10 @@ export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote
  * @param ctx - client root context.
  */
 export function apply(ctx: ClientContext): void {
+  // Anonymous install heartbeat (docs/telemetry.md): one beat per browser per
+  // UTC day, package name only, silent failure.
+  reportDailyHeartbeat([{ name: '@linxin666/dsh-remote-web-ui' }])
+
   ctx.effect(() => {
     try {
       return ctx.locale.register(NS, { zh, en })