dshtui-format-setting 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## 0.3.1 (2026-09-13)
+
+- Documentation only: added an English `README.md` and moved the Chinese copy to
+  `README.zh.md`, with reciprocal language links. The settings card was already
+  bilingual and the code is unchanged.
+- Both READMEs now state the platform limitation and the settings surface
+  explicitly, and the published `files` list carries `README.zh.md` and this
+  changelog.
+
+## 0.3.0 (2026-09-12)
+
+- The “Style / Startup window settings” group page was removed: the section is
+  now named **Window** and the maximize switch sits directly on the card.
+
+## 0.2.0 (2026-09-07)
+
+- Removed the font settings (5+ families, 12–28 sizes, per-user font
+  installation), the size presets and “save current size”.
+- Kept a single window control: maximize the terminal on startup.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VviLliAm-qwq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# dshtui-format-setting
+
+**English** · [中文](README.zh.md)
+
+Lightweight window settings for dsh-tui.
+
+- **Maximize on startup** — dsh-tui maximizes the terminal window when it starts.
+  It lives in the **Window** section of the settings screen: one switch, applied
+  the moment it is turned on.
+- The switch is shown directly on the section card; there is no group page to
+  open first (since 0.3.0).
+- The settings card is bilingual (Chinese/English), rendered by the host in the
+  language `/lang` selected.
+- Window control goes through Win32 APIs (the classic console host); any other
+  host degrades to a warning log instead of failing.
+- **Removed in 0.2.0:** font settings (5+ families, 12–28 sizes, per-user font
+  installation), size presets and “save current size”.
+- **0.3.0:** the “Style / Startup window settings” group page is gone; the
+  section is named **Window** and the switch sits directly on it.
+
+Restart dsh-tui after installing.
+
+## Install
+
+```sh
+dsh plugin --profile dsh-tui add dshtui-format-setting
+```
+
+Restart dsh-tui (`/restart`) afterwards.
+
+## Settings
+
+| Field | Type | Default | Meaning |
+| --- | --- | --- | --- |
+| Maximize on startup | boolean | `false` | Maximize the terminal window when dsh-tui starts; turning it on applies immediately. |
+
+## Limitations
+
+- Window control is Win32-only (the classic console host). On other hosts the
+  plugin logs a warning and does nothing.
+- The plugin registers the settings namespace `dshtui-format-setting`; a host
+  without a settings service keeps the switch inert rather than failing.
+
+## Publishing
+
+- **Repository**: <https://github.com/VviLliAm-qwq/dshtui-format-setting> (public)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/README.zh.md

@@ -0,0 +1,41 @@
+# dshtui-format-setting
+
+**中文** · [English](README.md)
+
+dsh-tui 窗口设置插件（精简版）。
+
+- **开机时最大化**：dsh-tui 启动时将终端窗口最大化。设置项位于设置页的「窗口设置」分区：单个开关，打开即立即应用。
+- 开关**直接显示在分区卡片上**，无需再点进分组页面（0.3.0 起）。
+- 设置卡片中英双语，由宿主按 `/lang` 当前语言渲染。
+- 窗口控制通过 Win32 API（经典控制台宿主）完成；其他宿主降级为一条警告日志，不会导致启动失败。
+- **0.2.0 起移除**：字体设置（5+ 字体种类、12–28 档大小、随包字体用户级安装）、尺寸预设、保存当前尺寸。
+- **0.3.0**：「样式 / 启动窗口设置」分组页移除，分区更名为「窗口设置」，开关直达。
+
+安装后需重启 dsh-tui 生效。
+
+## 安装
+
+```sh
+dsh plugin --profile dsh-tui add dshtui-format-setting
+```
+
+之后在 dsh-tui 内 `/restart` 生效。
+
+## 设置
+
+| 字段 | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| Maximize on startup / 开机时最大化 | boolean | `false` | dsh-tui 启动时将终端窗口最大化；打开此开关时立即应用。 |
+
+## 已知限制
+
+- 窗口控制仅支持 Win32（经典控制台宿主）；其他宿主只记一条警告，不做任何事。
+- 插件读写设置命名空间 `dshtui-format-setting`；宿主没有设置服务时，开关保持惰性而不会报错。
+
+## 发布
+
+- **仓库**：<https://github.com/VviLliAm-qwq/dshtui-format-setting>（公开）
+
+## 许可
+
+MIT — 见 [LICENSE](LICENSE)。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dshtui-format-setting bundle patch: mounts the style-settings plugin.
+- insert:
+    - id: dshtui-format-setting
+      name: 'dshtui-format-setting'

package/dsh-plugin.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://dsh.community/schemas/dsh-plugin-0.15.json",
+  "manifestVersion": "0.15",
+  "id": "com.dsh-tui.dshtui-format-setting",
+  "name": "dshtui-format-setting",
+  "version": "0.3.1",
+  "facets": {
+    "host": {
+      "entry": "lib/index.js",
+      "apiVersion": "v1alpha1"
+    }
+  },
+  "requires": {
+    "contracts": [
+      {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "SettingsSection"
+      }
+    ]
+  },
+  "contributes": {
+    "commands": []
+  },
+  "permissions": [],
+  "subscriptions": [],
+  "license": "MIT",
+  "source": {
+    "repository": "https://github.com/VviLliAm-qwq/dshtui-format-setting"
+  }
+}

package/lib/index.js

@@ -0,0 +1,151 @@
+/**
+ * dshtui-format-setting — startup-window "maximize on startup" toggle for
+ * dsh-tui, surfaced as a native "Window" settings section (zh/en). On
+ * dsh-tui start (and again when the toggle is switched on) the user's
+ * terminal window is maximized.
+ *
+ * Since 0.3.0 the toggle is rendered directly on the section card — the
+ * "Startup Window" group page was removed so no subpage click is needed.
+ *
+ * Font settings (family/size/pixel-font install), size presets and
+ * save-current-size were removed in 0.2.0.
+ *
+ * @module dshtui-format-setting
+ */
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import z from '@deepseek-ai/schemastery';
+import { appendFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import * as win32 from './win32.js';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const DIAG_LOG = join(homedir(), '.dsh-tui', 'dshtui-format-setting.log');
+
+/** Append a diagnostic line (best-effort; never throws). */
+function diag(line) {
+    try { appendFileSync(DIAG_LOG, `${new Date().toISOString()} ${line}\n`); } catch { /* ignore */ }
+}
+
+export const name = 'dshtui-format-setting';
+
+/** Settings schema (stored in the dsh settings service as `dshtui-format-setting`). */
+export const Config = z.object({
+    maximizeOnStartup: z.boolean().default(true),
+});
+/** Explicit boot defaults (mirrors the schema defaults). */
+const DEFAULT_CONFIG = {
+    maximizeOnStartup: true,
+};
+
+/** Register the native "Window" settings section: a single maximize toggle,
+ *  rendered directly on the card (no group page, no extra click). */
+function registerSection(sections) {
+    return sections.register({
+        ns: 'dshtui-format-setting',
+        title: 'Window',
+        descriptions: { zh: '窗口设置', en: 'Window' },
+        fields: [
+            {
+                path: ['maximizeOnStartup'], label: 'Maximize on startup', descriptions: { zh: '开机时最大化', en: 'Maximize on startup' },
+                kind: 'boolean',
+                hint: 'Maximizes the terminal window when dsh-tui starts; toggling this on applies it immediately.',
+                hintDescriptions: { zh: 'dsh-tui 启动时将终端窗口最大化;打开此开关时立即应用。', en: 'Maximizes the terminal window when dsh-tui starts; toggling this on applies it immediately.' },
+            },
+        ],
+    });
+}
+
+/** Maximize the user's terminal window (best-effort, diag-logged). */
+function applyMaximize(cfg, source) {
+    if (!cfg.maximizeOnStartup) {
+        diag(`${source}: maximizeOnStartup off — skipped`);
+        return;
+    }
+    const hwnd = win32.findHostWindow();
+    if (hwnd === null) {
+        diag(`${source}: no terminal window found`);
+        ctxLogger?.warn?.('dshtui-format-setting: no terminal window found — maximize skipped');
+        return;
+    }
+    const res = win32.setWindowState(hwnd, 'maximized');
+    diag(`${source}: setWindowState maximized => ${res.ok ? 'ok' : res.error}`);
+    if (!res.ok) ctxLogger?.warn?.(`dshtui-format-setting: maximize failed: ${res.error}`);
+}
+
+// module-level logger bridge (set in apply)
+let ctxLogger = null;
+
+const RETRY_MS = 400;
+const RETRY_LIMIT = 60; // ~24s of service readiness attempts
+
+export function apply(ctx, config) {
+    diag('apply started');
+    ctxLogger = ctx.logger;
+    ctx.effect(function* () {
+        let scope = null;
+        let sectionRegistered = false;
+        let sectionDisposer = null;
+        let watchDisposer = null;
+        let applied = false;
+        let attempts = 0;
+        let retryTimer = null;
+
+        function tryOnce() {
+            // settings namespace
+            if (scope === null) {
+                const settings = ctx.get('settings');
+                if (settings !== undefined) {
+                    try {
+                        scope = settings.register('dshtui-format-setting', Config);
+                        diag('settings namespace registered');
+                        ctxLogger?.info?.('dshtui-format-setting: settings namespace registered');
+                    }
+                    catch (error) {
+                        ctxLogger?.warn?.(`dshtui-format-setting: settings register failed: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+            // settings section
+            if (!sectionRegistered) {
+                const sections = ctx.get('tuiSettingsSections');
+                if (sections !== undefined) {
+                    try {
+                        sectionDisposer = registerSection(sections);
+                        sectionRegistered = true;
+                    }
+                    catch (error) {
+                        ctxLogger?.warn?.(`dshtui-format-setting: settings section failed: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+            // boot application + live watch, once the namespace is registered
+            if (scope !== null && !applied) {
+                applied = true;
+                const bootCfg = { ...DEFAULT_CONFIG, ...scope.get() };
+                applyMaximize(bootCfg, 'boot');
+                watchDisposer = scope.watch((next) => {
+                    applyMaximize({ ...DEFAULT_CONFIG, ...next }, 'watch');
+                });
+            }
+            // done?
+            if (scope !== null && sectionRegistered && applied) {
+                if (retryTimer !== null) { clearInterval(retryTimer); retryTimer = null; }
+            }
+            else if (++attempts >= RETRY_LIMIT) {
+                ctxLogger?.warn?.(`dshtui-format-setting: services did not all appear within ${(RETRY_LIMIT * RETRY_MS) / 1000}s (settings=${scope !== null}, section=${sectionRegistered}, applied=${applied})`);
+                if (retryTimer !== null) { clearInterval(retryTimer); retryTimer = null; }
+            }
+        }
+
+        retryTimer = setInterval(tryOnce, RETRY_MS);
+        tryOnce();
+
+        yield () => {
+            if (retryTimer !== null) clearInterval(retryTimer);
+            try { watchDisposer?.(); } catch { /* best-effort */ }
+            try { sectionDisposer?.(); } catch { /* best-effort */ }
+            ctxLogger = null;
+        };
+    }, 'dshtui-format-setting lifecycle');
+}

package/lib/win32.js

@@ -0,0 +1,117 @@
+/**
+ * Thin koffi wrappers for the Win32 window APIs the dshtui-format-setting
+ * plugin needs: locate the user's terminal window and maximize it.
+ *
+ * Architecture note (verified): the dsh-tui plugin runs in the profile-host
+ * process, whose own console is a hidden ConPTY (0x0). The USER's terminal
+ * window is a separate top-level window — `CASCADIA_HOSTING_WINDOW_CLASS`
+ * (Windows Terminal) or `ConsoleWindowClass` (classic console). We enumerate
+ * visible host-class windows and pick by priority: the foreground window when
+ * it is a host-class window, then the first visible one whose title mentions
+ * a shell/dsh keyword, then the first visible one.
+ *
+ * Font-default and window-size APIs were removed in 0.2.0.
+ *
+ * Every call returns a plain result ({ok:true,...} | {ok:false, error}).
+ */
+import koffi from 'koffi';
+
+const PVOID = koffi.pointer('void');
+const CALLBACK = koffi.pointer(koffi.proto('int (void* hwnd)'));
+
+const SW_MINIMIZE = 6;
+const SW_MAXIMIZE = 3;
+const SW_RESTORE = 9;
+const HOST_CLASSES = new Set(['ConsoleWindowClass', 'CASCADIA_HOSTING_WINDOW_CLASS']);
+const TITLE_KEYWORDS = ['powershell', 'command prompt', 'cmd', 'deepseek', 'dsh', 'terminal'];
+
+let libs = null;
+function bind() {
+    if (libs !== null) return libs;
+    const user32 = koffi.load('user32.dll');
+    const api = (lib, n, r, a) => lib.func('__stdcall', n, r, a);
+    libs = {
+        user32,
+        isWindowVisible: api(user32, 'IsWindowVisible', 'int', [PVOID]),
+        getClassNameW: api(user32, 'GetClassNameW', 'int', [PVOID, 'void*', 'int']),
+        getWindowTextW: api(user32, 'GetWindowTextW', 'int', [PVOID, 'void*', 'int']),
+        enumWindows: api(user32, 'EnumWindows', 'int', [CALLBACK, 'void*']),
+        getForegroundWindow: api(user32, 'GetForegroundWindow', PVOID, []),
+        showWindow: api(user32, 'ShowWindow', 'int', [PVOID, 'int']),
+    };
+    return libs;
+}
+
+function wstr(buf) {
+    let i = 0;
+    for (i = 0; i + 1 < buf.length; i += 2) {
+        if (buf[i] === 0 && buf[i + 1] === 0) break;
+    }
+    return buf.subarray(0, i).toString('utf16le');
+}
+
+function classNameOf(hwnd) {
+    const buf = Buffer.alloc(400);
+    bind().getClassNameW(hwnd, buf, 200);
+    return wstr(buf);
+}
+
+/**
+ * Locate the user's terminal window.
+ * Strategy — enumerate visible host-class windows and pick by priority:
+ *   1. the foreground window when it is a host-class window;
+ *   2. the first visible host-class window whose title mentions a shell/dsh
+ *      keyword (powershell/cmd/dsh/deepseek/…);
+ *   3. the first visible host-class window.
+ */
+export function findHostWindow() {
+    try {
+        const b = bind();
+        const fg = b.getForegroundWindow();
+        if (fg !== null && b.isWindowVisible(fg) && HOST_CLASSES.has(classNameOf(fg))) return fg;
+        const windows = enumerateHostWindows(b);
+        if (windows.length === 0) return null;
+        const byKeyword = windows.filter(w => TITLE_KEYWORDS.some(k => w.title.toLowerCase().includes(k)));
+        if (byKeyword.length > 0) return byKeyword[0].hwnd;
+        return windows[0].hwnd;
+    }
+    catch {
+        return null;
+    }
+}
+
+/** All visible top-level windows whose class is a console host. */
+function enumerateHostWindows(b) {
+    const list = [];
+    let cb = null;
+    const instance = koffi.register((hwnd) => {
+        if (!b.isWindowVisible(hwnd)) return 1;
+        let cls;
+        try { cls = classNameOf(hwnd); } catch { return 1; }
+        if (!HOST_CLASSES.has(cls)) return 1;
+        const titleBuf = Buffer.alloc(1200);
+        b.getWindowTextW(hwnd, titleBuf, 600);
+        list.push({ hwnd, title: wstr(titleBuf) });
+        return 1;
+    }, CALLBACK);
+    cb = instance;
+    try {
+        b.enumWindows(cb, null);
+    }
+    finally {
+        try { cb?.unref?.(); } catch { /* best-effort */ }
+    }
+    return list;
+}
+
+/** Minimize / restore / maximize the given terminal window. */
+export function setWindowState(hwnd, state) {
+    try {
+        const cmd = state === 'minimized' ? SW_MINIMIZE : state === 'maximized' ? SW_MAXIMIZE : SW_RESTORE;
+        bind().showWindow(hwnd, cmd);
+        return { ok: true, state };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "dshtui-format-setting",
+  "version": "0.3.1",
+  "description": "Window settings for dsh-tui (lightweight): startup-window maximize toggle, native Window settings section (toggle directly on card, no group page), zh/en. Font and size-preset settings removed in 0.2.0; group page removed in 0.3.0.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VviLliAm-qwq/dshtui-format-setting.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "dsh-plugin.json",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "node": "^22.19 || >=24"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "koffi": "^3.1.0"
+  }
+}