@lihuu/dsh-about 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# dsh-about
+
+"About" settings section for DeepSeek Harness web GUI. Registers a "关于" page in the settings panel that shows the running version and build date, read live from the host — zero main-repo changes.
+
+## What it does
+
+- **Host half** (`src/index.ts`): registers the `aboutInfo` Typert Remote service. `aboutInfo/get` reads the running version from `apps/cli/package.json` and the build date from the built CLI's mtime (`apps/cli/lib/bin.js`).
+- **Browser half** (`lib/client.js`): registers a "关于" page into the `settings.section` list slot and resolves the data through `connection.rpc.call('/api', 'aboutInfo/get')`.
+
+## Install
+
+From the `dsh-plugins` repo root:
+
+```sh
+./install.sh
+```
+
+This symlinks the plugin into `$DSH_HOME/plugins/dsh-about` and adds its row to `$DSH_HOME/cordis.patch.yml`. Then restart dsh-web:
+
+```sh
+launchctl kickstart -k gui/501/com.lihu.dsh-web
+```
+
+## Build
+
+The host half is TypeScript; rebuild it after editing `src/index.ts`:
+
+```sh
+cd plugins/dsh-about && ./node_modules/typescript/bin/tsc -p tsconfig.json
+```
+
+The browser half (`lib/client.js`) is hand-written plain JS and needs no build.
+
+## Notes
+
+- The harness checkout path is read from `$DSH_REPO` (falling back to the
+  process working directory), so the plugin carries no machine-specific path.
+  Export `DSH_REPO` in your launchd env (the dsh-plugins `env.sh` does) or run
+  dsh from its checkout.
+- Version and build date are read live on each page open, so they always reflect the currently running build.

package/lib/client.js

@@ -0,0 +1,68 @@
+/**
+ * dsh-about — independent "About" settings section (BROWSER half).
+ *
+ * Plain-JS client bundle served as `/plugins/@local/dsh-about/client.js`.
+ * Registers the "关于" page into the settings.section list slot and resolves
+ * the running version + build date through the host's runtime Typert Remote
+ * endpoint `aboutInfo/get` via the generic `/api` RPC channel — no generated
+ * artifacts, no main-repo changes.
+ */
+(function () {
+  // The registration id MUST equal the boot graph row id (loader entry name
+  // == package name). The host composes rows from the cordis patch `name`.
+  var PLUGIN_ID = '@lihuu/dsh-about'
+
+  window.__ModuleLoader__.load({
+    id: PLUGIN_ID,
+    factory: function (require) {
+      var React = require('react')
+
+      return {
+        inject: ['slots', 'connection'],
+        apply: function (ctx) {
+          var slots = ctx.get('slots')
+          var connection = ctx.get('connection')
+          if (slots === undefined || connection === undefined) return
+
+          slots.inject('settings.section', function () {
+            return slots.register(
+              { name: 'settings.section', id: 'about', order: 30, label: '关于' },
+              function () {
+                var state = React.useState(null)
+                var info = state[0]
+                var setInfo = state[1]
+
+                React.useEffect(function () {
+                  var alive = true
+                  try {
+                    connection.rpc.call('/api', 'aboutInfo/get', { args: {} })
+                      .then(function (result) {
+                        if (alive && result && result.ok) setInfo(result.value)
+                      })
+                      .catch(function () {})
+                  } catch (e) {
+                    // RPC unavailable — leave the loading state
+                  }
+                  return function () { alive = false }
+                }, [])
+
+                function row(label, value) {
+                  return React.createElement('div', { style: { display: 'flex', gap: '8px', alignItems: 'center' } },
+                    React.createElement('span', { style: { color: 'var(--dsh-text-secondary, #888)', minWidth: '64px' } }, label),
+                    React.createElement('span', null, value),
+                  )
+                }
+
+                return React.createElement('div', { style: { padding: '16px', display: 'flex', flexDirection: 'column', gap: '10px' } },
+                  React.createElement('h2', { style: { margin: '0 0 4px' } }, '关于'),
+                  row('版本', info ? info.version : '加载中…'),
+                  row('构建日期', info ? info.buildDate : '加载中…'),
+                )
+              },
+            )
+          })
+        },
+      }
+    },
+  })
+})()

package/lib/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * dsh-about — independent "About" settings section for DeepSeek Harness web GUI
+ * (HOST half).
+ *
+ * Provides the `aboutInfo` Typert Remote service: the browser half's settings
+ * "关于" page resolves the running version and build date through the runtime
+ * `aboutInfo/get` endpoint. The host gateway (`dsh-api-gateway`) dispatches
+ * `/api/aboutInfo/get` to this live service via source-mode discovery
+ * (`typertRemote` binding + `Remote` markers), so NO compile-time generated
+ * artifacts and NO main-repo changes are involved: the whole feature mounts as
+ * an installable `@local` plugin.
+ *
+ * @module dsh-about
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+/** Stable plugin row name (used by the cordis loader entry). */
+export declare const name = "dsh-about";
+/** The about payload the settings page renders. */
+export interface AboutInfo {
+    /** Running version, read from apps/cli/package.json. */
+    readonly version: string;
+    /** Build date, from the built CLI's mtime. */
+    readonly buildDate: string;
+}
+/**
+ * About info remote service. Registered under `aboutInfo`; the `get` method is
+ * the single `@Remote` endpoint the browser half calls through
+ * `connection.rpc.call('/api', 'aboutInfo/get', { args })`.
+ */
+export declare class AboutInfoService extends TypertRemoteService {
+    private readonly fs;
+    private readonly shell;
+    /**
+     * @param ctx - owning host context (fs/shell read optionally).
+     */
+    constructor(ctx: Context);
+    /**
+     * Read the running version and build date.
+     * @Remote('get') — invoked by the host gateway in source mode.
+     * @returns version + build date; unknown fields degrade to 'unknown'.
+     */
+    get(): Promise<AboutInfo>;
+}
+/**
+ * Plugin body: construct the `aboutInfo` service (the Service base constructor
+ * registers it under this fiber via `ctx.reflect.provide`).
+ * @param ctx - host root context.
+ */
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/index.js

@@ -0,0 +1,133 @@
+/**
+ * dsh-about — independent "About" settings section for DeepSeek Harness web GUI
+ * (HOST half).
+ *
+ * Provides the `aboutInfo` Typert Remote service: the browser half's settings
+ * "关于" page resolves the running version and build date through the runtime
+ * `aboutInfo/get` endpoint. The host gateway (`dsh-api-gateway`) dispatches
+ * `/api/aboutInfo/get` to this live service via source-mode discovery
+ * (`typertRemote` binding + `Remote` markers), so NO compile-time generated
+ * artifacts and NO main-repo changes are involved: the whole feature mounts as
+ * an installable `@local` plugin.
+ *
+ * @module dsh-about
+ */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol';
+/** Stable plugin row name (used by the cordis loader entry). */
+export const name = 'dsh-about';
+/**
+ * Harness source checkout this deployment runs from. Read from `$DSH_REPO`
+ * (the launchd env.sh exports it) so the plugin carries no machine-specific
+ * path; falls back to the process working directory, which is the repo root
+ * when dsh is launched from its checkout. A wrong value degrades to 'unknown'
+ * via the try/catch below.
+ */
+const REPO = process.env.DSH_REPO ?? process.cwd();
+/**
+ * About info remote service. Registered under `aboutInfo`; the `get` method is
+ * the single `@Remote` endpoint the browser half calls through
+ * `connection.rpc.call('/api', 'aboutInfo/get', { args })`.
+ */
+let AboutInfoService = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _get_decorators;
+    return class AboutInfoService extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _get_decorators = [Remote('get')];
+            __esDecorate(this, null, _get_decorators, { kind: "method", name: "get", static: false, private: false, access: { has: obj => "get" in obj, get: obj => obj.get }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        fs = __runInitializers(this, _instanceExtraInitializers);
+        shell;
+        /**
+         * @param ctx - owning host context (fs/shell read optionally).
+         */
+        constructor(ctx) {
+            super(ctx, 'aboutInfo');
+            this.fs = ctx.get('fs');
+            this.shell = ctx.get('shell');
+        }
+        /**
+         * Read the running version and build date.
+         * @Remote('get') — invoked by the host gateway in source mode.
+         * @returns version + build date; unknown fields degrade to 'unknown'.
+         */
+        async get() {
+            let version = 'unknown';
+            let buildDate = 'unknown';
+            if (this.fs !== undefined) {
+                try {
+                    const target = await this.fs.resolve(`${REPO}/apps/cli/package.json`);
+                    const text = await this.fs.readText(target);
+                    const m = text.match(/"version"\s*:\s*"([^"]+)"/);
+                    if (m !== null)
+                        version = m[1];
+                }
+                catch {
+                    // fs unavailable or read failed — keep 'unknown'
+                }
+            }
+            if (this.shell !== undefined) {
+                try {
+                    const spec = this.shell.resolve({
+                        command: `stat -f "%Sm" -t "%Y-%m-%d %H:%M" ${REPO}/apps/cli/lib/bin.js`,
+                    });
+                    const result = await this.shell.run(spec);
+                    const out = result.stdout.text.trim();
+                    if (out !== '')
+                        buildDate = out;
+                }
+                catch {
+                    // shell unavailable or stat failed — keep 'unknown'
+                }
+            }
+            return { version, buildDate };
+        }
+    };
+})();
+export { AboutInfoService };
+/**
+ * Plugin body: construct the `aboutInfo` service (the Service base constructor
+ * registers it under this fiber via `ctx.reflect.provide`).
+ * @param ctx - host root context.
+ */
+export const inject = ['fs', 'shell'];
+export function apply(ctx) {
+    new AboutInfoService(ctx);
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@lihuu/dsh-about",
+  "version": "0.1.0",
+  "description": "About section for DeepSeek Harness web GUI settings: shows the running version and build date, read live from the host (apps/cli/package.json + built CLI mtime) — zero main-repo changes.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "cordis",
+    "web",
+    "about",
+    "settings",
+    "plugin"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-typert-protocol": "*"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,119 @@
+/**
+ * dsh-about — independent "About" settings section for DeepSeek Harness web GUI
+ * (HOST half).
+ *
+ * Provides the `aboutInfo` Typert Remote service: the browser half's settings
+ * "关于" page resolves the running version and build date through the runtime
+ * `aboutInfo/get` endpoint. The host gateway (`dsh-api-gateway`) dispatches
+ * `/api/aboutInfo/get` to this live service via source-mode discovery
+ * (`typertRemote` binding + `Remote` markers), so NO compile-time generated
+ * artifacts and NO main-repo changes are involved: the whole feature mounts as
+ * an installable `@local` plugin.
+ *
+ * @module dsh-about
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+import { TypertRemoteService, Remote } from '@deepseek-ai/dsh-typert-protocol'
+
+/** Stable plugin row name (used by the cordis loader entry). */
+export const name = 'dsh-about'
+
+/** The about payload the settings page renders. */
+export interface AboutInfo {
+  /** Running version, read from apps/cli/package.json. */
+  readonly version: string
+  /** Build date, from the built CLI's mtime. */
+  readonly buildDate: string
+}
+
+// ---- Minimal structural faces of the optional host services. Type-only:
+// the plugin reads them with ctx.get() and never imports the packages. ----
+
+/** The `ctx.fs` service surface this plugin uses (dsh-fs FileSystem). */
+interface FileSystemLike {
+  resolve(path: string, options?: { cwd?: string }): Promise<unknown>
+  readText(target: unknown): Promise<string>
+}
+
+/** The `ctx.shell` service surface this plugin uses (dsh-shell ShellExecutor). */
+interface ShellLike {
+  resolve(request: { command: string; workdir?: string }): unknown
+  run(spec: unknown): Promise<{ stdout: { text: string } }>
+}
+
+/**
+ * Harness source checkout this deployment runs from. Read from `$DSH_REPO`
+ * (the launchd env.sh exports it) so the plugin carries no machine-specific
+ * path; falls back to the process working directory, which is the repo root
+ * when dsh is launched from its checkout. A wrong value degrades to 'unknown'
+ * via the try/catch below.
+ */
+const REPO = process.env.DSH_REPO ?? process.cwd()
+
+/**
+ * About info remote service. Registered under `aboutInfo`; the `get` method is
+ * the single `@Remote` endpoint the browser half calls through
+ * `connection.rpc.call('/api', 'aboutInfo/get', { args })`.
+ */
+export class AboutInfoService extends TypertRemoteService {
+  private readonly fs: FileSystemLike | undefined
+  private readonly shell: ShellLike | undefined
+
+  /**
+   * @param ctx - owning host context (fs/shell read optionally).
+   */
+  constructor(ctx: Context) {
+    super(ctx, 'aboutInfo')
+    this.fs = ctx.get('fs') as FileSystemLike | undefined
+    this.shell = ctx.get('shell') as ShellLike | undefined
+  }
+
+  /**
+   * Read the running version and build date.
+   * @Remote('get') — invoked by the host gateway in source mode.
+   * @returns version + build date; unknown fields degrade to 'unknown'.
+   */
+  @Remote('get')
+  async get(): Promise<AboutInfo> {
+    let version = 'unknown'
+    let buildDate = 'unknown'
+
+    if (this.fs !== undefined) {
+      try {
+        const target = await this.fs.resolve(`${REPO}/apps/cli/package.json`)
+        const text = await this.fs.readText(target)
+        const m = text.match(/"version"\s*:\s*"([^"]+)"/)
+        if (m !== null) version = m[1]
+      } catch {
+        // fs unavailable or read failed — keep 'unknown'
+      }
+    }
+
+    if (this.shell !== undefined) {
+      try {
+        const spec = this.shell.resolve({
+          command: `stat -f "%Sm" -t "%Y-%m-%d %H:%M" ${REPO}/apps/cli/lib/bin.js`,
+        })
+        const result = await this.shell.run(spec)
+        const out = result.stdout.text.trim()
+        if (out !== '') buildDate = out
+      } catch {
+        // shell unavailable or stat failed — keep 'unknown'
+      }
+    }
+
+    return { version, buildDate }
+  }
+}
+
+/**
+ * Plugin body: construct the `aboutInfo` service (the Service base constructor
+ * registers it under this fiber via `ctx.reflect.provide`).
+ * @param ctx - host root context.
+ */
+export const inject = ['fs', 'shell']
+
+export function apply(ctx: Context): void {
+  new AboutInfoService(ctx)
+}