jishushell 0.4.2 → 0.4.17

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 if (process.platform === "darwin") {
-    const extra = ["/usr/local/bin", "/opt/homebrew/bin", "/opt/homebrew/sbin", "/Applications/Docker.app/Contents/Resources/bin"];
+    const extra = ["/usr/local/bin", "/opt/homebrew/bin", "/opt/homebrew/sbin"];
     const current = process.env.PATH ?? "";
     const missing = extra.filter(p => !current.split(":").includes(p));
     if (missing.length > 0)
@@ -10,12 +10,17 @@ import { existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import { exec } from "child_process";
-import { createServer } from "./server.js";
-import { runInstall, parseInstallArgs } from "./install.js";
-import { startPanel, stopPanel, stopWithJobs, restartPanel, runDoctor, runOnboard, showStatus, resetAll, checkUpdate, runUpdate } from "./control.js";
-const JISHUSHELL_HOME = process.env.JISHUSHELL_HOME || join(homedir(), ".jishushell");
-const NOMAD_BIN = join(JISHUSHELL_HOME, "bin", "nomad");
-const PANEL_PORT = 8090;
+if (process.platform === "darwin") {
+    const jHome = process.env.JISHUSHELL_HOME || join(homedir(), ".jishushell");
+    const sock = join(jHome, "colima", "jishushell", "docker.sock");
+    if (existsSync(sock))
+        process.env.DOCKER_HOST = `unix://${sock}`;
+}
+const [subcommand, ...rest] = process.argv.slice(2);
+function cliError(err) {
+    console.error(err.message || err);
+    process.exit(1);
+}
 function openBrowser(url) {
     const platform = process.platform;
     const cmd = platform === "darwin" ? `open "${url}"`
@@ -23,265 +28,517 @@ function openBrowser(url) {
             : `xdg-open "${url}"`;
     exec(cmd, () => { });
 }
-const [subcommand, ...rest] = process.argv.slice(2);
-// ── Helper to parse --port from remaining args ─────────────────────────────
-function parsePort(args) {
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--port" && args[i + 1]) {
-            const p = parseInt(args[i + 1], 10);
-            if (!isNaN(p) && p > 0 && p < 65536)
-                return p;
-        }
-    }
-    return undefined;
-}
-// ── install subcommand ─────────────────────────────────────────────────────
-if (subcommand === "install") {
-    const opts = parseInstallArgs(rest);
-    runInstall(opts).catch((err) => {
-        console.error("Installation failed:", err);
-        process.exit(1);
+// ── HTTP thin-client helpers (used by backup/restore/export/import commands) ──
+async function apiCall(path, opts = {}) {
+    const port = process.env.JISHUSHELL_PORT || "8090";
+    const url = `http://127.0.0.1:${port}/api${path}`;
+    const res = await fetch(url, {
+        method: opts.method || "GET",
+        headers: opts.body ? { "Content-Type": "application/json" } : {},
+        body: opts.body ? JSON.stringify(opts.body) : undefined,
     });
-    // runInstall is async and calls process.exit() itself
-    // ── start ──────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "start") {
-    startPanel(parsePort(rest)).then(() => process.exit(0)).catch((err) => {
-        console.error("start failed:", err.message);
-        process.exit(1);
-    });
-    // ── stop ───────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "stop") {
-    // --jobs: also stop (but not purge) all Nomad jobs before stopping the panel
-    const withJobs = rest.includes("--jobs") || rest.includes("-j");
-    const stopFn = withJobs ? stopWithJobs : stopPanel;
-    stopFn().then(() => process.exit(0)).catch((err) => {
-        console.error("stop failed:", err.message);
-        process.exit(1);
-    });
-    // ── restart ────────────────────────────────────────────────────────────────
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ detail: res.statusText }));
+        throw new Error(err.detail || `HTTP ${res.status}`);
+    }
+    return res.json();
 }
-else if (subcommand === "restart") {
-    restartPanel(parsePort(rest)).then(() => process.exit(0)).catch((err) => {
-        console.error("restart failed:", err.message);
-        process.exit(1);
-    });
-    // ── status ─────────────────────────────────────────────────────────────────
+async function waitForJob(jobId) {
+    while (true) {
+        const job = await apiCall(`/backup/jobs/${jobId}`);
+        if (job.status === "completed")
+            return job;
+        if (job.status === "failed")
+            throw new Error(job.error || "Job failed");
+        process.stdout.write(`\r  ${job.progress || job.status}...`);
+        await new Promise(r => setTimeout(r, 1500));
+    }
 }
-else if (subcommand === "status") {
-    showStatus().then(() => process.exit(0)).catch((err) => {
-        console.error("status failed:", err.message);
-        process.exit(1);
-    });
-    // ── doctor ─────────────────────────────────────────────────────────────────
+// ── Subcommand dispatch ────────────────────────────────────────────────────
+if (["install", "uninstall", "start", "stop", "restart", "status", "serve", "onboard", "reset", "update-check", "update", "config"].includes(subcommand)) {
+    const { run } = await import("./cli/panel.js");
+    run([subcommand, ...rest]).catch(cliError);
 }
 else if (subcommand === "doctor") {
-    const fix = rest.includes("--fix") || rest.includes("-f");
-    runDoctor({ fix }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-        console.error("doctor failed:", err.message);
-        process.exit(1);
-    });
-    // ── onboard ────────────────────────────────────────────────────────────────
+    const { run } = await import("./cli/doctor.js");
+    run(rest).catch(cliError);
 }
-else if (subcommand === "onboard") {
-    const force = rest.includes("--force") || rest.includes("-f");
-    runOnboard({ force }).then(() => process.exit(0)).catch((err) => {
-        console.error("onboard failed:", err.message);
-        process.exit(1);
-    });
-    // ── reset ──────────────────────────────────────────────────────────────────
+else if (subcommand === "openclaw") {
+    const { run } = await import("./cli/openclaw.js");
+    run(rest).catch(cliError);
 }
-else if (subcommand === "reset") {
-    const yes = rest.includes("--yes") || rest.includes("-y");
-    resetAll({ yes }).then(() => process.exit(0)).catch((err) => {
-        console.error("reset failed:", err.message);
-        process.exit(1);
-    });
-    // ── update-check ───────────────────────────────────────────────────────────
+else if (subcommand === "pairing") {
+    // Backward-compat alias: jishushell pairing ... → jishushell openclaw pairing ...
+    const { run } = await import("./cli/openclaw.js");
+    run(["pairing", ...rest]).catch(cliError);
 }
-else if (subcommand === "update-check") {
-    checkUpdate().then((info) => {
-        console.log(JSON.stringify(info));
-        process.exit(info.hasUpdate ? 0 : 1);
-    }).catch((err) => {
-        console.error("update-check failed:", err.message);
-        process.exit(2);
-    });
-    // ── update-run ─────────────────────────────────────────────────────────────
+else if (subcommand === "job") {
+    const { run } = await import("./cli/job.js");
+    run(rest).catch(cliError);
 }
-else if (subcommand === "update") {
-    runUpdate().then(() => process.exit(0)).catch((err) => {
-        console.error("update-run failed:", err.message);
-        process.exit(1);
-    });
-    // ── pairing: approve / list DM pairing requests inside running containers ──
+else if (subcommand === "app") {
+    const { run } = await import("./cli/app.js");
+    run(rest).catch(cliError);
 }
-else if (subcommand === "pairing") {
-    const action = rest[0];
-    // Parse --instance <id> flag
-    let instanceId;
-    const instIdx = rest.indexOf("--instance");
-    if (instIdx !== -1 && rest[instIdx + 1])
-        instanceId = rest[instIdx + 1];
-    if (action === "list") {
-        const { runPairingList } = await import("./control.js");
-        runPairingList({ instanceId }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-            console.error("pairing list failed:", err.message);
+else if (subcommand === "llm") {
+    const { run } = await import("./cli/llm.js");
+    run(rest).catch(cliError);
+    // ── backup ─────────────────────────────────────────────────────────────────
+}
+else if (subcommand === "backup") {
+    // Handle "backup verify <instance-id> <filename>" subcommand
+    if (rest[0] === "verify") {
+        const instanceId = rest[1];
+        const filename = rest[2];
+        if (!instanceId || !filename) {
+            console.error("Usage: jishushell backup verify <instance-id> <filename>");
             process.exit(1);
-        });
+        }
+        try {
+            const result = await apiCall(`/instances/${instanceId}/backup/verify/${encodeURIComponent(filename)}`, { method: "POST" });
+            console.log(result.valid ? "Verification PASSED." : "Verification FAILED.");
+            for (const check of result.checks || []) {
+                console.log(`  ${check.passed ? "+" : "x"} ${check.name}${check.detail ? ": " + check.detail : ""}`);
+            }
+            if (rest.includes("--json"))
+                console.log(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            console.error(`Verify failed: ${e.message}`);
+            process.exit(1);
+        }
+        process.exit(0);
     }
-    else if (action === "approve") {
-        // args after "approve": [channel, code] or [code] (single-arg form)
-        const actionArgs = rest.slice(1).filter((a) => !a.startsWith("--") && a !== instanceId);
-        let channel;
-        let code;
-        if (actionArgs.length >= 2) {
-            [channel, code] = actionArgs;
+    const id = rest[0];
+    if (!id) {
+        console.error("Usage: jishushell backup <id> [--with-sessions] [--only-config] [--state-only] [--no-workspace]");
+        process.exit(1);
+    }
+    const withSessions = rest.includes("--with-sessions");
+    const onlyConfig = rest.includes("--only-config");
+    const stateOnly = rest.includes("--state-only");
+    const noWorkspace = rest.includes("--no-workspace");
+    try {
+        console.log(`Creating backup for ${id}...`);
+        const result = await apiCall(`/instances/${id}/backup`, {
+            method: "POST",
+            body: {
+                include_sessions: withSessions,
+                only_config: onlyConfig,
+                scope: stateOnly ? "state" : "home",
+                ...(noWorkspace ? { include_workspace: false } : {}),
+            },
+        });
+        if (result.job_id) {
+            const job = await waitForJob(result.job_id);
+            console.log(`\nBackup complete: ${job.result?.filename} (${job.result?.size} bytes)`);
         }
-        else if (actionArgs.length === 1) {
-            channel = "feishu";
-            code = actionArgs[0];
+        if (rest.includes("--verify") && result.job_id) {
+            const job = await apiCall(`/backup/jobs/${result.job_id}`);
+            if (job.result?.filename) {
+                console.log("Verifying...");
+                const v = await apiCall(`/instances/${id}/backup/verify/${encodeURIComponent(job.result.filename)}`, { method: "POST" });
+                console.log(v.valid ? "Verification passed." : "Verification FAILED.");
+            }
+        }
+    }
+    catch (e) {
+        console.error(`Backup failed: ${e.message}`);
+        process.exit(1);
+    }
+    process.exit(0);
+    // ── restore ────────────────────────────────────────────────────────────────
+}
+else if (subcommand === "restore") {
+    if (rest.includes("--new")) {
+        const fromIdx = rest.indexOf("--from");
+        const idxNewId = rest.indexOf("--id");
+        if (fromIdx !== -1) {
+            const sourceId = rest[fromIdx + 1];
+            if (!sourceId) {
+                console.error("Usage: jishushell restore --new --from <src-id> --latest|--pick [--id <new-id>]");
+                process.exit(1);
+            }
+            let backups;
+            try {
+                backups = await apiCall(`/instances/${sourceId}/backups`);
+            }
+            catch (e) {
+                console.error(`Restore failed: ${e.message}`);
+                process.exit(1);
+            }
+            if (!backups.length) {
+                console.error("No backups found.");
+                process.exit(1);
+            }
+            let backupFile = "";
+            if (rest.includes("--latest")) {
+                backupFile = backups[0].filename;
+            }
+            else {
+                console.log("Available backups:");
+                backups.forEach((b, i) => {
+                    console.log(`  ${i + 1}. [${b.type}] ${new Date(b.created_at).toLocaleString()} (${(b.size / 1024 / 1024).toFixed(1)}MB)`);
+                });
+                const readline = await import("readline");
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const answer = await new Promise(r => rl.question("Select number: ", r));
+                rl.close();
+                const idx = parseInt(answer, 10) - 1;
+                if (idx < 0 || idx >= backups.length) {
+                    console.error("Invalid selection.");
+                    process.exit(1);
+                }
+                backupFile = backups[idx].filename;
+            }
+            const newId = idxNewId !== -1 ? rest[idxNewId + 1] : `${sourceId}-copy`;
+            console.log(`Creating new instance ${newId} from ${sourceId}/${backupFile}...`);
+            try {
+                const result = await apiCall("/instances/create-from-backup", { method: "POST", body: { source_id: sourceId, backup_file: backupFile, new_id: newId, new_name: newId } });
+                if (result.ok) {
+                    console.log(`Instance created: ${result.instance_id}`);
+                    if (result.warnings?.length)
+                        result.warnings.forEach((w) => console.log(`  Warning: ${w}`));
+                }
+                else {
+                    console.error(`Create from backup failed: ${result.detail || "unknown error"}`);
+                    process.exit(1);
+                }
+            }
+            catch (e) {
+                console.error(`Restore --new failed: ${e.message}`);
+                process.exit(1);
+            }
         }
         else {
-            console.error("Usage: jishushell pairing approve <channel> <code> [--instance <id>]");
+            const file = rest.find((a) => !a.startsWith("--"));
+            if (!file) {
+                console.error("Usage: jishushell restore --new <file> [--id <new-id>]");
+                process.exit(1);
+            }
+            console.log(`Use: jishushell import ${file}`);
+        }
+        process.exit(0);
+    }
+    const id = rest[0];
+    if (!id) {
+        console.error("Usage: jishushell restore <id> <--latest|--pick|file>");
+        process.exit(1);
+    }
+    let file = "";
+    if (rest.includes("--latest") || rest.includes("--pick")) {
+        let backups;
+        try {
+            backups = await apiCall(`/instances/${id}/backups`);
+        }
+        catch (e) {
+            console.error(`Restore failed: ${e.message}`);
             process.exit(1);
         }
-        const notify = rest.includes("--notify");
-        const { runPairingApprove } = await import("./control.js");
-        runPairingApprove({ instanceId, channel, code, notify }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-            console.error("pairing approve failed:", err.message);
+        if (!backups.length) {
+            console.error("No backups found.");
             process.exit(1);
-        });
+        }
+        if (rest.includes("--latest")) {
+            file = backups[0].filename;
+        }
+        else {
+            console.log("Available backups:");
+            backups.forEach((b, i) => {
+                console.log(`  ${i + 1}. ${b.type} ${new Date(b.created_at).toLocaleString()} (${(b.size / 1024 / 1024).toFixed(1)}MB)`);
+            });
+            const readline = await import("readline");
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise(r => rl.question("Select number: ", r));
+            rl.close();
+            const idx = parseInt(answer, 10) - 1;
+            if (idx < 0 || idx >= backups.length) {
+                console.error("Invalid selection.");
+                process.exit(1);
+            }
+            file = backups[idx].filename;
+        }
     }
     else {
-        console.log(`
-Usage: jishushell pairing <command> [options]
-
-Commands:
-  list                               列出等待审批的配对请求
-  approve <channel> <code>           审批配对码（例: feishu LVU7PNYK）
-  approve <code>                     默认 channel=feishu 简写形式
-
-Options:
-  --instance <id>   指定实例 ID（只有一个实例时可省略）
-  --notify          审批后通知申请方
-
-Examples:
-  jishushell pairing list
-  jishushell pairing approve feishu LVU7PNYK
-  jishushell pairing approve LVU7PNYK
-  jishushell pairing approve feishu LVU7PNYK --instance my-instance
-`);
+        file = rest[1];
+    }
+    if (!file) {
+        console.error("No backup file specified.");
         process.exit(1);
     }
-    // ── serve: foreground server (used by systemd/launchd ExecStart) ──────────
-}
-else if (subcommand === "serve") {
-    const args = rest;
-    let port = PANEL_PORT;
-    let host = "0.0.0.0";
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--port" && args[i + 1]) {
-            const parsed = parseInt(args[i + 1], 10);
-            if (isNaN(parsed) || parsed < 1 || parsed > 65535) {
-                console.error(`Invalid port: ${args[i + 1]}. Must be 1-65535.`);
-                process.exit(1);
+    try {
+        console.log(`Restoring ${id} from ${file}...`);
+        const result = await apiCall(`/instances/${id}/restore/${encodeURIComponent(file)}`, { method: "POST" });
+        if (result.job_id) {
+            const job = await waitForJob(result.job_id);
+            const r = job.result || {};
+            if (r.ok) {
+                console.log(`\nRestore complete.`);
+                if (r.api_key_status === "lost")
+                    console.log("Warning: API Key may need re-verification on this host.");
+                if (r.warnings?.length)
+                    r.warnings.forEach((w) => console.log(`  Warning: ${w}`));
             }
-            port = parsed;
-            i++;
+            else {
+                console.error(`\nRestore failed.${r.rolled_back ? " Auto-rollback completed." : ""}`);
+                if (r.warnings?.length)
+                    r.warnings.forEach((w) => console.log(`  ${w}`));
+            }
+        }
+    }
+    catch (e) {
+        console.error(`Restore failed: ${e.message}`);
+        process.exit(1);
+    }
+    process.exit(0);
+    // ── export ─────────────────────────────────────────────────────────────────
+}
+else if (subcommand === "export") {
+    const id = rest[0];
+    if (!id) {
+        console.error("Usage: jishushell export <id> [--with-sessions]");
+        process.exit(1);
+    }
+    const withSessions = rest.includes("--with-sessions");
+    try {
+        console.log(`Exporting ${id}...`);
+        const result = await apiCall(`/instances/${id}/export`, { method: "POST", body: { include_sessions: withSessions } });
+        if (result.job_id) {
+            const job = await waitForJob(result.job_id);
+            const r = job.result || {};
+            console.log(`\nExport complete: ${r.filename}`);
+            console.log(`Download: http://127.0.0.1:${process.env.JISHUSHELL_PORT || "8090"}/api/instances/${id}/export/download/${encodeURIComponent(r.filename)}`);
+            if (r.warnings?.length)
+                r.warnings.forEach((w) => console.log(`  Warning: ${w}`));
         }
-        else if (args[i] === "--host" && args[i + 1]) {
-            host = args[i + 1];
-            i++;
+    }
+    catch (e) {
+        console.error(`Export failed: ${e.message}`);
+        process.exit(1);
+    }
+    process.exit(0);
+    // ── import ─────────────────────────────────────────────────────────────────
+}
+else if (subcommand === "import") {
+    const file = rest[0];
+    if (!file) {
+        console.error("Usage: jishushell import <file> [--id <id>] [--name <name>]");
+        process.exit(1);
+    }
+    const idIdx = rest.indexOf("--id");
+    const nameIdx = rest.indexOf("--name");
+    const customId = idIdx !== -1 ? rest[idIdx + 1] : undefined;
+    const customName = nameIdx !== -1 ? rest[nameIdx + 1] : undefined;
+    try {
+        const { readFileSync } = await import("fs");
+        const { basename } = await import("path");
+        const port = process.env.JISHUSHELL_PORT || "8090";
+        console.log("Uploading file...");
+        const fileData = readFileSync(file);
+        const boundary = "----JishuShellCLI" + Date.now();
+        const fileName = basename(file);
+        const body = Buffer.concat([
+            Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${fileName}"\r\nContent-Type: application/gzip\r\n\r\n`),
+            fileData,
+            Buffer.from(`\r\n--${boundary}--\r\n`),
+        ]);
+        const uploadRes = await fetch(`http://127.0.0.1:${port}/api/instances/import/upload`, {
+            method: "POST",
+            headers: { "Content-Type": `multipart/form-data; boundary=${boundary}` },
+            body,
+        });
+        if (!uploadRes.ok) {
+            const err = await uploadRes.json().catch(() => ({ detail: uploadRes.statusText }));
+            throw new Error(err.detail || `Upload failed: ${uploadRes.status}`);
+        }
+        const { temp_id } = await uploadRes.json();
+        console.log("Previewing...");
+        const preview = await apiCall("/instances/import/preview", { method: "POST", body: { temp_id } });
+        console.log(`  Name: ${preview.manifest?.name || "unknown"}`);
+        console.log(`  Type: ${preview.manifest?.type || "unknown"}`);
+        console.log(`  Size: ${((preview.estimated_size || 0) / 1024 / 1024).toFixed(1)}MB`);
+        if (preview.warnings?.length)
+            for (const w of preview.warnings)
+                console.log(`  Warning: ${w}`);
+        const instanceId = customId || preview.manifest?.name?.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 63) || `import-${Date.now()}`;
+        const instanceName = customName || preview.manifest?.name || instanceId;
+        console.log(`Creating instance ${instanceId}...`);
+        const result = await apiCall("/instances/import", { method: "POST", body: { temp_id, id: instanceId, name: instanceName } });
+        if (result.ok) {
+            console.log(`Instance created: ${result.instance_id}`);
+            if (result.warnings?.length)
+                for (const w of result.warnings)
+                    console.log(`  Warning: ${w}`);
+        }
+        else {
+            console.error(`Import failed: ${result.detail || "unknown error"}`);
+            process.exit(1);
         }
     }
-    createServer({ port, host }).catch((err) => {
-        console.error("serve failed:", err.message);
+    catch (e) {
+        console.error(`Import failed: ${e.message}`);
         process.exit(1);
-    });
-    // ── uninstall ─────────────────────────────────────────────────────────────
+    }
+    process.exit(0);
+    // ── clone ──────────────────────────────────────────────────────────────────
 }
-else if (subcommand === "uninstall") {
-    const yes = rest.includes("--yes") || rest.includes("-y");
-    const { spawnSync } = await import("child_process");
-    const uninstallSh = join(JISHUSHELL_HOME, "install", "post-uninstall.sh");
-    if (!existsSync(uninstallSh)) {
-        console.error(`Uninstall script not found: ${uninstallSh}`);
-        console.error("Please run: sudo bash ~/.jishushell/install/jishu-uninstall.sh --data --yes");
+else if (subcommand === "clone") {
+    const src = rest[0];
+    const newId = rest[1];
+    if (!src || !newId) {
+        console.error("Usage: jishushell clone <src-id> <new-id> [--with-sessions] [--no-memory]");
+        process.exit(1);
+    }
+    const withSessions = rest.includes("--with-sessions");
+    const noMemory = rest.includes("--no-memory");
+    try {
+        console.log(`Cloning ${src} to ${newId}...`);
+        const result = await apiCall("/instances", { method: "POST", body: { id: newId, name: newId, clone_from: src, clone_options: { include_sessions: withSessions, include_memory: !noMemory } } });
+        console.log(`Clone created: ${result.id || newId}`);
+    }
+    catch (e) {
+        console.error(`Clone failed: ${e.message}`);
         process.exit(1);
     }
-    if (!yes) {
-        const { createInterface } = await import("readline");
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        await new Promise((resolve) => {
-            rl.question("This will stop all services, remove auto-start and delete ~/.jishushell. Continue? [y/N] ", (ans) => {
+    process.exit(0);
+    // ── backups ────────────────────────────────────────────────────────────────
+}
+else if (subcommand === "backups") {
+    const sub = rest[0];
+    if (sub === "list") {
+        const id = rest[1];
+        try {
+            if (id) {
+                const backups = await apiCall(`/instances/${id}/backups`);
+                if (!backups.length)
+                    console.log("No backups.");
+                else
+                    backups.forEach((b, i) => console.log(`  ${i + 1}. [${b.type}] ${new Date(b.created_at).toLocaleString()} ${(b.size / 1024 / 1024).toFixed(1)}MB ${b.filename}`));
+            }
+            else {
+                const orphans = await apiCall("/backups/orphaned");
+                if (orphans.length) {
+                    console.log("Orphaned backups:");
+                    for (const o of orphans)
+                        console.log(`  ${o.instance_id}: ${o.backups?.length || 0} files`);
+                }
+                else
+                    console.log("No orphaned backups.");
+            }
+        }
+        catch (e) {
+            console.error(`backups list failed: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    else if (sub === "clean") {
+        try {
+            const orphans = await apiCall("/backups/orphaned");
+            if (!orphans.length) {
+                console.log("No orphaned backups to clean.");
+                process.exit(0);
+            }
+            const force = rest.includes("--force");
+            console.log(`Found ${orphans.length} orphaned backup(s):`);
+            for (const o of orphans)
+                console.log(`  ${o.instance_id}: ${o.backups?.length || 0} files`);
+            if (!force) {
+                const readline = await import("readline");
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const answer = await new Promise(r => rl.question("Delete all orphaned backups? (y/N): ", r));
                 rl.close();
-                if (ans.toLowerCase() !== "y") {
+                if (answer.toLowerCase() !== "y") {
                     console.log("Cancelled.");
                     process.exit(0);
                 }
-                resolve();
-            });
-        });
+            }
+            for (const o of orphans) {
+                for (const b of o.backups || [])
+                    await apiCall(`/backups/orphaned/${encodeURIComponent(o.instance_id)}/${encodeURIComponent(b.filename)}`, { method: "DELETE" });
+                console.log(`  Cleaned: ${o.instance_id}`);
+            }
+            console.log("Done.");
+        }
+        catch (e) {
+            console.error(`backups clean failed: ${e.message}`);
+            process.exit(1);
+        }
     }
-    // Step 1: stop services and remove ~/.jishushell via the backed-up script
-    const cleanResult = spawnSync("bash", [uninstallSh], { stdio: "inherit" });
-    // Step 2: remove the npm global package (now ~/.jishushell is already gone)
-    const npmResult = spawnSync("npm", ["uninstall", "-g", "jishushell"], { stdio: "inherit" });
-    process.exit((cleanResult.status ?? 0) || (npmResult.status ?? 0));
-    // ── help ───────────────────────────────────────────────────────────────────
+    else {
+        console.error("Usage: jishushell backups list [id]\n       jishushell backups clean [--force]");
+        process.exit(1);
+    }
+    process.exit(0);
+    // ── auto-backup ────────────────────────────────────────────────────────────
+}
+else if (subcommand === "auto-backup") {
+    const id = rest[0];
+    const action = rest[1];
+    if (!id || !action) {
+        console.error("Usage: jishushell auto-backup <id> enable|disable|status");
+        process.exit(1);
+    }
+    try {
+        if (action === "status") {
+            const config = await apiCall(`/instances/${id}/auto-backup`);
+            console.log(JSON.stringify(config, null, 2));
+        }
+        else if (action === "enable") {
+            const interval = parseInt(rest[rest.indexOf("--interval") + 1], 10) || 24;
+            const keep = parseInt(rest[rest.indexOf("--keep") + 1], 10) || 7;
+            await apiCall(`/instances/${id}/auto-backup`, { method: "PUT", body: { enabled: true, interval_hours: interval, keep_count: keep } });
+            console.log(`Auto-backup enabled for ${id} (every ${interval}h, keep ${keep})`);
+        }
+        else if (action === "disable") {
+            await apiCall(`/instances/${id}/auto-backup`, { method: "PUT", body: { enabled: false } });
+            console.log(`Auto-backup disabled for ${id}`);
+        }
+        else {
+            console.error(`Unknown action: ${action}. Use enable|disable|status`);
+            process.exit(1);
+        }
+    }
+    catch (e) {
+        console.error(`auto-backup failed: ${e.message}`);
+        process.exit(1);
+    }
+    process.exit(0);
 }
 else if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+    const [{ brief: panelBrief }, { brief: doctorBrief }, { brief: openclawBrief }, { brief: jobBrief }, { brief: appBrief }, { brief: llmBrief },] = await Promise.all([
+        import("./cli/panel.js"),
+        import("./cli/doctor.js"),
+        import("./cli/openclaw.js"),
+        import("./cli/job.js"),
+        import("./cli/app.js"),
+        import("./cli/llm.js"),
+    ]);
     console.log(`
 JishuShell — OpenClaw 实例管理面板
 
 Usage:
-  jishushell                       前台启动面板服务器
+  jishushell serve [--port N]      前台启动面板服务器（默认端口 8090）
   jishushell <command> [options]
 
 Commands:
-  status                           显示各模块运行状态（面板、Docker、Nomad 及所有 Job）
-  serve [--port N] [--host H]       前台启动面板服务器（供 systemd/launchd 使用）
-  start [--port N]                 在后台启动面板
-  stop [--jobs]                    停止面板；加 --jobs 同时停止所有 Nomad Job
-  restart [--port N]               重启面板
-  doctor                           检查所有组件健康状态
-  doctor --fix                     检查并尝试自动修复问题
-  onboard [--force]                首次引导：设置管理员密码
-  reset [--yes]                    重置配置与所有 Nomad Job（保留实例数据目录）
-  uninstall [--yes]                停止服务、删除 ~/.jishushell 并卸载 npm 包
-  update-check                     检查是否有新版本（0=有新版本，1=已是最新）
-  update                           安装最新版本并重启面板
-  install [options]                安装依赖并配置 JishuShell
-  pairing list                     列出等待审批的 DM 配对请求
-  pairing approve <ch> <code>      审批飞书/Lark 配对码（在容器内执行）
-  help                             显示此帮助信息
-
-Server options:
-  --port <port>    监听端口（默认 8090 或 panel.json 中的值）
-  --host <host>    监听地址（默认 0.0.0.0）
-
-Install options:
-  --port <port>    面板端口（默认 8090）
-  --yes, -y        跳过所有交互提示（非交互模式）
-  --no-service     跳过 systemd/launchd 注册
-  --skip-docker    跳过 Docker 安装
-  --skip-nomad     跳过 Nomad 安装
-  --skip-openclaw  跳过 OpenClaw 安装
-  --force, -f      即使已配置也强制重新安装
-  --dry-run, -n    预演，不实际执行任何变更
+${panelBrief()}
+${doctorBrief()}
+${openclawBrief()}
+${jobBrief()}
+${appBrief()}
+${llmBrief()}
+  backup <id> [--with-sessions]           备份实例
+  restore <id> <--latest|--pick|file>     还原实例
+  export <id>                             导出实例为归档包
+  import <file> [--id <id>]               导入归档包为新实例
+  clone <src-id> <new-id>                 克隆实例
+  backups list [id]                       列出备份文件
+  auto-backup <id> enable|disable|status  管理定时自动备份
+  help                                    显示此帮助
 
-Examples:
-  jishushell status               # 查看当前所有组件状态
-  jishushell start                # 后台启动面板
-  jishushell stop --jobs          # 停止面板及所有实例 Job
-  jishushell restart              # 重启面板
-  jishushell doctor --fix         # 检查并自动修复
-  jishushell reset --yes          # 非交互式重置（CI 场景）
+运行 'jishushell <command> help' 查看详细用法。
 `);
     process.exit(0);
-    // ── unknown command ────────────────────────────────────────────────────────
 }
 else {
     console.error(`Unknown command: ${subcommand}\nRun 'jishushell help' for usage.`);