@co0ontty/wand 4.63.0 → 4.64.0-beta.g3402a64

package/dist/terminal-daemon-protocol.d.ts

@@ -1,4 +1,3 @@
-import type { StructuredRunState, StructuredSpawnRequest } from "./structured-exec-host.js";
 import type { TerminalSessionState, TerminalSpawnRequest } from "./terminal-host.js";
 export declare const TERMINAL_DAEMON_PROTOCOL_VERSION = 2;
 export interface TerminalDaemonPaths {
@@ -36,11 +35,6 @@ export type TerminalDaemonEvent = {
     signal?: number;
     stream?: "stdout" | "stderr";
 };
-export interface TerminalDaemonStructuredAttachPayload {
-    state: StructuredRunState | null;
-}
-export interface TerminalDaemonStructuredSpawnParams extends StructuredSpawnRequest {
-}
 export interface TerminalDaemonCreateParams extends TerminalSpawnRequest {
     afterSeq?: number;
 }

package/dist/terminal-daemon-server.js

@@ -6,6 +6,7 @@ import path from "node:path";
 import { StringDecoder } from "node:string_decoder";
 import pty from "node-pty";
 import { ensureNodePtyHelperExecutable } from "./ensure-node-pty-helper.js";
+import { signalNumberFromName } from "./signal-utils.js";
 import { STRUCTURED_RUN_LOG_MAX_CHARS, createUtf8TextDecoder, } from "./structured-exec-host.js";
 import { TERMINAL_DAEMON_PROTOCOL_VERSION, terminalDaemonPaths, } from "./terminal-daemon-protocol.js";
 import { appendTerminalChunkWindow, } from "./terminal-host.js";
@@ -463,15 +464,6 @@ function isProcessAlive(pid) {
         return false;
     }
 }
-function signalNumberFromName(signalName) {
-    const table = {
-        SIGHUP: 1, SIGINT: 2, SIGQUIT: 3, SIGILL: 4, SIGTRAP: 5, SIGABRT: 6,
-        SIGBUS: 7, SIGFPE: 8, SIGKILL: 9, SIGUSR1: 10, SIGSEGV: 11, SIGUSR2: 12,
-        SIGPIPE: 13, SIGALRM: 14, SIGTERM: 15, SIGCHLD: 17, SIGCONT: 18,
-        SIGSTOP: 19, SIGTSTP: 20,
-    };
-    return table[signalName] ?? 0;
-}
 function waitForProcessExit(pid) {
     return new Promise((resolve) => {
         const timer = setInterval(() => {

package/dist/text-utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 文本裁剪：超长时优先在空格处断句，避免标题被截成半句话。
+ *
+ * 只有当空格出现在靠后的位置（≥ 55%）才按单词断，否则直接硬截，
+ * 防止「一个很长的英文单词 + 少量尾巴」的场景退化成只剩单词头。
+ */
+export declare function clipAtWordBoundary(value: string, maxLength: number): string;

package/dist/text-utils.js

@@ -0,0 +1,15 @@
+/**
+ * 文本裁剪：超长时优先在空格处断句，避免标题被截成半句话。
+ *
+ * 只有当空格出现在靠后的位置（≥ 55%）才按单词断，否则直接硬截，
+ * 防止「一个很长的英文单词 + 少量尾巴」的场景退化成只剩单词头。
+ */
+export function clipAtWordBoundary(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    const sliced = value.slice(0, maxLength);
+    const lastSpace = sliced.lastIndexOf(" ");
+    if (lastSpace >= Math.floor(maxLength * 0.55))
+        return sliced.slice(0, lastSpace);
+    return sliced;
+}

package/dist/tui/attach.js

@@ -5,11 +5,12 @@
  * 日志面板：因为日志在主进程里，attach 端没法直接看；这里改成"活动流"——
  *   监听 snapshot 差分，把会话起止 / 总数变化打到 log 面板。
  */
-import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, readUpdateChannel, serviceRestart, uninstallService, } from "./commands.js";
-import { repairServiceUnitAfterUpdate } from "../service-self-repair.js";
+import { copyToClipboard, openInBrowser, serviceRestart, } from "./commands.js";
 import { IpcClient } from "./ipc-client.js";
 import { buildLayout } from "./layout.js";
 import { openServicePanel } from "./service-panel.js";
+import { runOffMicrotask, safeServiceInstalled } from "./runtime-utils.js";
+import { createServiceActions } from "./service-actions.js";
 const POLL_INTERVAL_MS = 1000;
 export function startAttachTui(deps) {
     const layout = buildLayout();
@@ -118,6 +119,17 @@ export function startAttachTui(deps) {
     }
     const pollTimer = setInterval(() => { void pollOnce(); }, POLL_INTERVAL_MS);
     pollTimer.unref?.();
+    const serviceActions = createServiceActions({
+        configPath: deps.configPath,
+        version: deps.pidInfo.version,
+        layout,
+        updateConfirmBody: ({ current, latest, channelLabel }) => `通道 ${channelLabel}：当前 ${current} → 最新 ${latest}，立即升级？升级后请按 R 重启服务。`,
+        installServiceBody: (isRoot) => process.platform === "linux"
+            ? `将写入 /etc/systemd/system/wand.service，systemctl enable --now，开机自启。\n${isRoot ? "当前是 root，可以直接装。" : "⚠ 需要 root,可以 Ctrl+C 退出 TUI 后跑 sudo wand service:install。"}`
+            : process.platform === "darwin"
+                ? `将写入 /Library/LaunchDaemons/com.wand.web.plist，launchctl load，开机自启。\n${isRoot ? "当前是 root,可以直接装。" : "⚠ 需要 root,退出 TUI 跑 sudo wand service:install。"}`
+                : "当前平台暂不支持。",
+    });
     // —— 键位 —— 服务面板打开时，屏幕级快捷键让位
     const idle = () => !layout.isServicePanelOpen();
     layout.screen.key(["q", "Q"], () => { if (idle())
@@ -139,7 +151,7 @@ export function startAttachTui(deps) {
     layout.screen.key(["S-r"], () => { if (idle())
         void handleRestart(); });
     layout.screen.key(["u", "U"], () => { if (idle())
-        void handleUpdate(); });
+        void serviceActions.handleUpdate(); });
     layout.screen.key(["o", "O"], () => {
         if (!idle())
             return;
@@ -153,9 +165,9 @@ export function startAttachTui(deps) {
         layout.showToast(r.message, r.ok ? "success" : "error", 2500);
     });
     layout.screen.key(["s"], () => { if (idle())
-        void handleInstallService(); });
+        void serviceActions.handleInstallService(); });
     layout.screen.key(["S-s"], () => { if (idle())
-        void handleUninstallService(); });
+        void serviceActions.handleUninstallService(); });
     async function handleRestart() {
         const installed = safeServiceInstalled();
         if (installed) {
@@ -182,74 +194,6 @@ export function startAttachTui(deps) {
         const accepted = await client.shutdownDaemon();
         layout.showToast(accepted ? "已请求主进程退出" : "请求未被接受", accepted ? "success" : "warn", 3500);
     }
-    async function handleUpdate() {
-        layout.showToast("正在检查更新…", "info", 2000);
-        const channel = await runOffMicrotask(() => readUpdateChannel(deps.configPath));
-        const info = await runOffMicrotask(() => checkUpdate(deps.pidInfo.version, channel));
-        if (!info.latest) {
-            layout.showToast(info.channel === "beta" ? "无法读取 npm beta 版本" : "无法连接到 npm registry", "error", 3500);
-            return;
-        }
-        if (!info.hasUpdate) {
-            layout.showToast(info.channel === "beta" ? `已是最新 Beta 版本 (${info.current})` : `已是最新版本 (v${info.current})`, "success", 3000);
-            return;
-        }
-        const channelLabel = info.channel === "beta" ? "Beta" : "正式版";
-        const go = await layout.confirm({
-            title: "发现新版本",
-            body: `通道 ${channelLabel}：当前 ${info.current} → 最新 ${info.latest}，立即升级？升级后请按 R 重启服务。`,
-            yes: "回车 / y 安装",
-            no: "Esc / n 取消",
-        });
-        if (!go)
-            return;
-        layout.showToast("正在执行 npm install -g …", "info", 5000);
-        const r = await runOffMicrotask(() => installUpdate(info.channel));
-        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "更新输出" : "更新失败", r.detail);
-        if (r.ok) {
-            // 镜像 install.sh：装完用全局安装刷新服务 unit（ExecStart/PATH），再按 R 重启服务生效。
-            const repair = await runOffMicrotask(() => repairServiceUnitAfterUpdate(deps.configPath));
-            if (repair.scope)
-                layout.showToast(repair.message, repair.repaired ? "success" : "warn", 4500);
-        }
-    }
-    async function handleInstallService() {
-        if (isServiceInstalled()) {
-            layout.showToast("服务已安装，按 Shift+S 卸载", "warn", 2500);
-            return;
-        }
-        const isRoot = typeof process.getuid === "function" ? process.getuid() === 0 : false;
-        const body = process.platform === "linux"
-            ? `将写入 /etc/systemd/system/wand.service，systemctl enable --now，开机自启。\n${isRoot ? "当前是 root，可以直接装。" : "⚠ 需要 root,可以 Ctrl+C 退出 TUI 后跑 sudo wand service:install。"}`
-            : process.platform === "darwin"
-                ? `将写入 /Library/LaunchDaemons/com.wand.web.plist，launchctl load，开机自启。\n${isRoot ? "当前是 root,可以直接装。" : "⚠ 需要 root,退出 TUI 跑 sudo wand service:install。"}`
-                : "当前平台暂不支持。";
-        const ok = await layout.confirm({ title: "注册为系统服务", body });
-        if (!ok)
-            return;
-        const r = await runOffMicrotask(() => installService({ configPath: deps.configPath }));
-        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "服务安装详情" : "服务安装失败", r.detail);
-    }
-    async function handleUninstallService() {
-        if (!isServiceInstalled()) {
-            layout.showToast("当前未安装系统服务", "warn", 2500);
-            return;
-        }
-        const ok = await layout.confirm({
-            title: "卸载系统服务",
-            body: "将禁用并删除 wand 的 systemd / launchd 配置，确认继续？",
-        });
-        if (!ok)
-            return;
-        const r = await runOffMicrotask(() => uninstallService());
-        layout.showToast(r.message, r.ok ? "success" : "error", 4000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "服务卸载详情" : "服务卸载失败", r.detail);
-    }
     async function stop() {
         if (stopping || !active)
             return;
@@ -273,23 +217,3 @@ export function startAttachTui(deps) {
     }
     return { stop };
 }
-function safeServiceInstalled() {
-    try {
-        return isServiceInstalled();
-    }
-    catch {
-        return false;
-    }
-}
-function runOffMicrotask(fn) {
-    return new Promise((resolve, reject) => {
-        setImmediate(() => {
-            try {
-                resolve(fn());
-            }
-            catch (err) {
-                reject(err);
-            }
-        });
-    });
-}

package/dist/tui/commands.d.ts

@@ -90,3 +90,5 @@ export declare function serviceRestart(opts?: ServiceOpts): CommandResult;
 export declare function serviceLogs(lines?: number, opts?: ServiceOpts): CommandResult;
 export declare function installService(ctx: ServiceContext): CommandResult;
 export declare function uninstallService(opts?: ServiceOpts): CommandResult;
+/** 读取已安装服务 unit / plist 的入口命令；未安装或平台不支持时返回 null。 */
+export declare function readServiceEntrypoint(scope: ServiceScope): string | null;

package/dist/tui/commands.js

@@ -607,7 +607,8 @@ function hasLiveTerminalDaemon(configPath) {
     const pid = readTerminalDaemonPid(configPath);
     return pid !== null && isPidAlive(pid);
 }
-function readServiceEntrypointForUpdate(scope) {
+/** 读取已安装服务 unit / plist 的入口命令；未安装或平台不支持时返回 null。 */
+export function readServiceEntrypoint(scope) {
     const servicePath = servicePathFor(scope);
     if (process.platform === "darwin") {
         const result = spawnSync("plutil", ["-extract", "ProgramArguments.1", "raw", "-o", "-", servicePath], { encoding: "utf8", timeout: 5_000 });
@@ -635,7 +636,7 @@ function checkInstalledServiceEntrypointsForUpdate() {
         return { ok: false, message: "npm 全局 wand shim 不存在，已取消更新以保护当前服务。" };
     }
     for (const scope of scopes) {
-        const entrypoint = readServiceEntrypointForUpdate(scope);
+        const entrypoint = readServiceEntrypoint(scope);
         if (!entrypoint || path.resolve(entrypoint) !== path.resolve(stableBin)) {
             const command = scope === "system"
                 ? `sudo ${stableBin} service:install`

package/dist/tui/index.js

@@ -1,9 +1,10 @@
-import { checkUpdate, copyToClipboard, installService, installUpdate, isServiceInstalled, openInBrowser, readUpdateChannel, restartSelf, uninstallService, } from "./commands.js";
-import { repairServiceUnitAfterUpdate } from "../service-self-repair.js";
+import { copyToClipboard, openInBrowser, restartSelf, } from "./commands.js";
 import { buildLayout } from "./layout.js";
 import { installLogBus, restoreLogBus } from "./log-bus.js";
 import { formatSession, sortRows } from "./session-formatter.js";
 import { openServicePanel } from "./service-panel.js";
+import { safeRss, safeServiceInstalled } from "./runtime-utils.js";
+import { createServiceActions } from "./service-actions.js";
 /** 触发 sessions 列表重渲的事件类型。output 太频繁，不订阅。 */
 const SESSIONS_REFRESH_EVENTS = new Set(["status", "started", "ended", "task"]);
 const RELATIVE_TIME_TICK_MS = 5_000;
@@ -103,6 +104,18 @@ export function startTui(deps) {
     tickTimer.unref?.();
     // 服务面板打开时，屏幕级快捷键全部让位给面板自身按键。
     const idle = () => !layout.isServicePanelOpen();
+    const serviceActions = createServiceActions({
+        configPath: deps.configPath,
+        version: deps.version,
+        layout,
+        updateConfirmBody: ({ current, latest, channelLabel }) => `通道 ${channelLabel}：当前 ${current} → 最新 ${latest}，是否立即升级？`,
+        installServiceBody: (isRoot) => process.platform === "linux"
+            ? `将写入 /etc/systemd/system/wand.service，systemctl enable --now，开机自启。\n${isRoot ? "当前是 root，可以直接装。" : "⚠ 需要 root,请退出 TUI 后直接跑 sudo wand service:install。"}\n不想要 root？退出 TUI 跑 wand service:install --user (登出会被回收)。`
+            : process.platform === "darwin"
+                ? `将写入 /Library/LaunchDaemons/com.wand.web.plist，launchctl load，开机自启。\n${isRoot ? "当前是 root,可以直接装。" : "⚠ 需要 root,请退出 TUI 后直接跑 sudo wand service:install。"}`
+                : "当前平台暂不支持。",
+        onServiceChanged: refreshAll,
+    });
     // —— 基本键位 ——
     layout.screen.key(["q", "Q"], () => { if (idle())
         void stop("user"); });
@@ -132,66 +145,18 @@ export function startTui(deps) {
     layout.screen.key(["S-r"], () => { if (idle())
         void handleRestart(); });
     layout.screen.key(["u", "U"], () => { if (idle())
-        void handleUpdate(); });
+        void serviceActions.handleUpdate(); });
     layout.screen.key(["o", "O"], () => { if (idle())
         handleOpenBrowser(); });
     layout.screen.key(["c", "C"], () => { if (idle())
         handleCopyUrl(); });
     layout.screen.key(["s"], () => { if (idle())
-        void handleInstallService(); });
+        void serviceActions.handleInstallService(); });
     layout.screen.key(["S-s"], () => { if (idle())
-        void handleUninstallService(); });
+        void serviceActions.handleUninstallService(); });
     // 首次渲染
     refreshAll();
     // —— 操作处理函数 ——
-    async function handleRestart() {
-        const ok = await layout.confirm({
-            title: "重启 wand",
-            body: "将派生新进程并退出当前进程，活跃会话会因 PTY 中断而中止，是否继续？",
-        });
-        if (!ok)
-            return;
-        layout.showToast("正在重启…", "info", 5000);
-        // 让 toast 有时间渲染，再触发 restart
-        setTimeout(() => {
-            const r = restartSelf();
-            if (!r.ok)
-                layout.showToast(r.message, "error", 4000);
-        }, 200);
-    }
-    async function handleUpdate() {
-        layout.showToast("正在检查更新…", "info", 2000);
-        const channel = await runOffMicrotask(() => readUpdateChannel(deps.configPath));
-        const info = await runOffMicrotask(() => checkUpdate(deps.version, channel));
-        if (!info.latest) {
-            layout.showToast(info.channel === "beta" ? "无法读取 npm beta 版本" : "无法连接到 npm registry", "error", 3500);
-            return;
-        }
-        if (!info.hasUpdate) {
-            layout.showToast(info.channel === "beta" ? `已是最新 Beta 版本 (${info.current})` : `已是最新版本 (v${info.current})`, "success", 3000);
-            return;
-        }
-        const channelLabel = info.channel === "beta" ? "Beta" : "正式版";
-        const go = await layout.confirm({
-            title: "发现新版本",
-            body: `通道 ${channelLabel}：当前 ${info.current} → 最新 ${info.latest}，是否立即升级？`,
-            yes: "回车 / y 安装",
-            no: "Esc / n 取消",
-        });
-        if (!go)
-            return;
-        layout.showToast("正在执行 npm install -g …", "info", 5000);
-        const r = await runOffMicrotask(() => installUpdate(info.channel));
-        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "更新输出" : "更新失败", r.detail);
-        if (r.ok) {
-            // 镜像 install.sh：装完用全局安装刷新服务 unit（ExecStart/PATH），再按 R 重启生效。
-            const repair = await runOffMicrotask(() => repairServiceUnitAfterUpdate(deps.configPath));
-            if (repair.scope)
-                layout.showToast(repair.message, repair.repaired ? "success" : "warn", 4500);
-        }
-    }
     function handleOpenBrowser() {
         const url = deps.urls[0]?.url;
         if (!url) {
@@ -210,43 +175,20 @@ export function startTui(deps) {
         const r = copyToClipboard(url);
         layout.showToast(r.message, r.ok ? "success" : "error", 2500);
     }
-    async function handleInstallService() {
-        if (isServiceInstalled()) {
-            layout.showToast("服务已安装，按 Shift+S 卸载", "warn", 2500);
-            return;
-        }
-        // 默认装 system-wide。非 root 时 installService 会返回明确错误,toast 自然展示。
-        const isRoot = typeof process.getuid === "function" ? process.getuid() === 0 : false;
-        const body = process.platform === "linux"
-            ? `将写入 /etc/systemd/system/wand.service，systemctl enable --now，开机自启。\n${isRoot ? "当前是 root，可以直接装。" : "⚠ 需要 root,请退出 TUI 后直接跑 sudo wand service:install。"}\n不想要 root？退出 TUI 跑 wand service:install --user (登出会被回收)。`
-            : process.platform === "darwin"
-                ? `将写入 /Library/LaunchDaemons/com.wand.web.plist，launchctl load，开机自启。\n${isRoot ? "当前是 root,可以直接装。" : "⚠ 需要 root,请退出 TUI 后直接跑 sudo wand service:install。"}`
-                : "当前平台暂不支持。";
-        const ok = await layout.confirm({ title: "注册为系统服务", body });
-        if (!ok)
-            return;
-        const r = await runOffMicrotask(() => installService({ configPath: deps.configPath }));
-        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "服务安装详情" : "服务安装失败", r.detail);
-        refreshAll();
-    }
-    async function handleUninstallService() {
-        if (!isServiceInstalled()) {
-            layout.showToast("当前未安装系统服务", "warn", 2500);
-            return;
-        }
+    async function handleRestart() {
         const ok = await layout.confirm({
-            title: "卸载系统服务",
-            body: "将禁用并删除 wand 的 systemd / launchd 配置，确认继续？",
+            title: "重启 wand",
+            body: "将派生新进程并退出当前进程，活跃会话会因 PTY 中断而中止，是否继续？",
         });
         if (!ok)
             return;
-        const r = await runOffMicrotask(() => uninstallService());
-        layout.showToast(r.message, r.ok ? "success" : "error", 4000);
-        if (r.detail)
-            layout.showDetail(r.ok ? "服务卸载详情" : "服务卸载失败", r.detail);
-        refreshAll();
+        layout.showToast("正在重启…", "info", 5000);
+        // 让 toast 有时间渲染，再触发 restart
+        setTimeout(() => {
+            const r = restartSelf();
+            if (!r.ok)
+                layout.showToast(r.message, "error", 4000);
+        }, 200);
     }
     async function stop(reason) {
         if (stopping || !active)
@@ -284,32 +226,3 @@ function safeStructuredList(mgr) {
         return [];
     }
 }
-function safeRss() {
-    try {
-        return process.memoryUsage().rss;
-    }
-    catch {
-        return 0;
-    }
-}
-function safeServiceInstalled() {
-    try {
-        return isServiceInstalled();
-    }
-    catch {
-        return false;
-    }
-}
-/** 把同步阻塞操作放到下一 microtask，给 TUI 留出一帧把 toast 画出来。 */
-function runOffMicrotask(fn) {
-    return new Promise((resolve, reject) => {
-        setImmediate(() => {
-            try {
-                resolve(fn());
-            }
-            catch (err) {
-                reject(err);
-            }
-        });
-    });
-}

package/dist/tui/runtime-utils.d.ts

@@ -0,0 +1,7 @@
+/** TUI 运行时探针与小工具，供本地 TUI / attach TUI / snapshot 共享。 */
+/** 读取进程 RSS；失败时返回 0，避免探针异常影响渲染。 */
+export declare function safeRss(): number;
+/** 查询服务安装状态；失败时返回 false。 */
+export declare function safeServiceInstalled(): boolean;
+/** 把同步阻塞操作放到下一 microtask，给 TUI 留出一帧把 toast 画出来。 */
+export declare function runOffMicrotask<T>(fn: () => T): Promise<T>;

package/dist/tui/runtime-utils.js

@@ -0,0 +1,33 @@
+/** TUI 运行时探针与小工具，供本地 TUI / attach TUI / snapshot 共享。 */
+import { isServiceInstalled } from "./commands.js";
+/** 读取进程 RSS；失败时返回 0，避免探针异常影响渲染。 */
+export function safeRss() {
+    try {
+        return process.memoryUsage().rss;
+    }
+    catch {
+        return 0;
+    }
+}
+/** 查询服务安装状态；失败时返回 false。 */
+export function safeServiceInstalled() {
+    try {
+        return isServiceInstalled();
+    }
+    catch {
+        return false;
+    }
+}
+/** 把同步阻塞操作放到下一 microtask，给 TUI 留出一帧把 toast 画出来。 */
+export function runOffMicrotask(fn) {
+    return new Promise((resolve, reject) => {
+        setImmediate(() => {
+            try {
+                resolve(fn());
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    });
+}

package/dist/tui/service-actions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 两种 TUI 模式（前台主进程 / attach）共用的"服务与升级"操作。
+ *
+ * 流程完全一致，只有两处随模式而异：
+ *   - 升级确认弹窗文案（attach 模式要提醒按 R 重启服务）
+ *   - 注册系统服务的说明正文（attach 模式没有本地会话列表，装卸后不刷新界面）
+ */
+import type { LayoutHandle } from "./layout.js";
+export interface UpdateConfirmContext {
+    current: string;
+    latest: string;
+    channelLabel: string;
+}
+export interface ServiceActionsOptions {
+    configPath: string;
+    /** 当前版本；attach 模式传主进程版本。 */
+    version: string;
+    layout: LayoutHandle;
+    /** 升级确认弹窗正文。 */
+    updateConfirmBody(context: UpdateConfirmContext): string;
+    /** 注册系统服务的说明正文，随平台 / 权限而变。 */
+    installServiceBody(isRoot: boolean): string;
+    /** 服务安装 / 卸载后刷新界面；attach 模式没有本地会话列表，可不传。 */
+    onServiceChanged?(): void;
+}
+export interface ServiceActions {
+    handleUpdate(): Promise<void>;
+    handleInstallService(): Promise<void>;
+    handleUninstallService(): Promise<void>;
+}
+export declare function createServiceActions(options: ServiceActionsOptions): ServiceActions;

package/dist/tui/service-actions.js

@@ -0,0 +1,86 @@
+/**
+ * 两种 TUI 模式（前台主进程 / attach）共用的"服务与升级"操作。
+ *
+ * 流程完全一致，只有两处随模式而异：
+ *   - 升级确认弹窗文案（attach 模式要提醒按 R 重启服务）
+ *   - 注册系统服务的说明正文（attach 模式没有本地会话列表，装卸后不刷新界面）
+ */
+import { checkUpdate, installService, installUpdate, isServiceInstalled, readUpdateChannel, uninstallService, } from "./commands.js";
+import { repairServiceUnitAfterUpdate } from "../service-self-repair.js";
+import { runOffMicrotask } from "./runtime-utils.js";
+export function createServiceActions(options) {
+    const { layout } = options;
+    async function handleUpdate() {
+        layout.showToast("正在检查更新…", "info", 2000);
+        const channel = await runOffMicrotask(() => readUpdateChannel(options.configPath));
+        const info = await runOffMicrotask(() => checkUpdate(options.version, channel));
+        if (!info.latest) {
+            layout.showToast(info.channel === "beta" ? "无法读取 npm beta 版本" : "无法连接到 npm registry", "error", 3500);
+            return;
+        }
+        if (!info.hasUpdate) {
+            layout.showToast(info.channel === "beta" ? `已是最新 Beta 版本 (${info.current})` : `已是最新版本 (v${info.current})`, "success", 3000);
+            return;
+        }
+        const go = await layout.confirm({
+            title: "发现新版本",
+            body: options.updateConfirmBody({
+                current: info.current,
+                latest: info.latest,
+                channelLabel: info.channel === "beta" ? "Beta" : "正式版",
+            }),
+            yes: "回车 / y 安装",
+            no: "Esc / n 取消",
+        });
+        if (!go)
+            return;
+        layout.showToast("正在执行 npm install -g …", "info", 5000);
+        const r = await runOffMicrotask(() => installUpdate(info.channel));
+        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
+        if (r.detail)
+            layout.showDetail(r.ok ? "更新输出" : "更新失败", r.detail);
+        if (r.ok) {
+            // 镜像 install.sh：装完用全局安装刷新服务 unit（ExecStart/PATH），再按 R 重启生效。
+            const repair = await runOffMicrotask(() => repairServiceUnitAfterUpdate(options.configPath));
+            if (repair.scope)
+                layout.showToast(repair.message, repair.repaired ? "success" : "warn", 4500);
+        }
+    }
+    async function handleInstallService() {
+        if (isServiceInstalled()) {
+            layout.showToast("服务已安装，按 Shift+S 卸载", "warn", 2500);
+            return;
+        }
+        // 默认装 system-wide。非 root 时 installService 会返回明确错误,toast 自然展示。
+        const isRoot = typeof process.getuid === "function" ? process.getuid() === 0 : false;
+        const ok = await layout.confirm({
+            title: "注册为系统服务",
+            body: options.installServiceBody(isRoot),
+        });
+        if (!ok)
+            return;
+        const r = await runOffMicrotask(() => installService({ configPath: options.configPath }));
+        layout.showToast(r.message, r.ok ? "success" : "error", 5000);
+        if (r.detail)
+            layout.showDetail(r.ok ? "服务安装详情" : "服务安装失败", r.detail);
+        options.onServiceChanged?.();
+    }
+    async function handleUninstallService() {
+        if (!isServiceInstalled()) {
+            layout.showToast("当前未安装系统服务", "warn", 2500);
+            return;
+        }
+        const ok = await layout.confirm({
+            title: "卸载系统服务",
+            body: "将禁用并删除 wand 的 systemd / launchd 配置，确认继续？",
+        });
+        if (!ok)
+            return;
+        const r = await runOffMicrotask(() => uninstallService());
+        layout.showToast(r.message, r.ok ? "success" : "error", 4000);
+        if (r.detail)
+            layout.showDetail(r.ok ? "服务卸载详情" : "服务卸载失败", r.detail);
+        options.onServiceChanged?.();
+    }
+    return { handleUpdate, handleInstallService, handleUninstallService };
+}

package/dist/tui/snapshot.js

@@ -5,6 +5,7 @@
  * processManager / structuredSessions（避免一次额外的对象拷贝）。
  */
 import { formatSession, sortRows } from "./session-formatter.js";
+import { safeRss } from "./runtime-utils.js";
 export function buildSnapshotData(inputs) {
     const ptyList = inputs.processManager.listSlim();
     let structuredList = [];
@@ -48,11 +49,3 @@ export function buildSnapshotData(inputs) {
         sessions: sorted.map((s) => formatSession(s)),
     };
 }
-function safeRss() {
-    try {
-        return process.memoryUsage().rss;
-    }
-    catch {
-        return 0;
-    }
-}