@okclaw-build/cli 1.0.0-beta.6 → 1.0.0-beta.61

package/dist/commands/skill.d.ts

@@ -0,0 +1 @@
+export declare function skillCommand(args: string[]): Promise<void>;

package/dist/commands/skill.js

@@ -0,0 +1,137 @@
+import { readFileSync } from 'node:fs';
+import { SkillInstaller } from '../installers/skill.js';
+import { configureMirrors } from '../utils/mirror.js';
+import { info, error, success } from '../utils/logger.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+import { assertSafeInstallName, assertSafePackageVersion, parsePackageSource, } from '../utils/install-safety.js';
+export async function skillCommand(args) {
+    const subCommand = args[0];
+    const skillName = args[1];
+    if (!subCommand || !['install', 'uninstall'].includes(subCommand)) {
+        const emitter = new NdjsonEmitter('skill_install');
+        registerExitHandlers(emitter);
+        error('Usage: okclaw skill <install|uninstall> <name> [options]');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const op = subCommand === 'install' ? 'skill_install' : 'skill_uninstall';
+    const emitter = new NdjsonEmitter(op);
+    registerExitHandlers(emitter);
+    if (!skillName) {
+        error(`Usage: okclaw skill ${subCommand} <name>${subCommand === 'install' ? ' --version <ver> [--package-url <url>]' : ''}`);
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    let safeSkillName;
+    try {
+        safeSkillName = assertSafeInstallName('skill', skillName);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_INVALID_ARGS', { error: msg });
+        process.exit(1);
+    }
+    const installer = new SkillInstaller(safeSkillName);
+    if (subCommand === 'uninstall') {
+        emitter.start(`uninstalling skill ${safeSkillName}`, { skillName: safeSkillName });
+        info(`Uninstalling skill ${safeSkillName}...`);
+        try {
+            emitter.stepStart('validate', `validating skill name ${safeSkillName}`);
+            // installer 内部校验名称，SkillInstaller.uninstall 会在目标不存在时快速返回
+            emitter.stepDone('validate', 'skill name ok');
+            emitter.stepStart('uninstall', `removing ${safeSkillName}`);
+            await installer.uninstall();
+            emitter.stepDone('uninstall', 'skill removed');
+            success(`Skill ${safeSkillName} uninstalled.`);
+            emitter.end(true, 0, undefined, { skillName: safeSkillName });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            error(msg);
+            emitter.end(false, 1, 'E_SKILL_UNINSTALL_FAILED', { error: msg });
+            process.exit(1);
+        }
+        return;
+    }
+    // install
+    let version = '';
+    let config;
+    let packageUrl;
+    for (let i = 2; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--version' || arg.startsWith('--version=')) && !version) {
+            version = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+        if (arg === '--config' && args[i + 1]) {
+            try {
+                config = JSON.parse(args[++i]);
+            }
+            catch {
+                error('Invalid --config JSON');
+                emitter.end(false, 1, 'E_CONFIG_JSON');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--config-file' || arg.startsWith('--config-file=')) && !config) {
+            const filePath = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            try {
+                config = JSON.parse(readFileSync(filePath, 'utf8'));
+            }
+            catch (e) {
+                error(`Failed to read config file: ${e}`);
+                emitter.end(false, 1, 'E_CONFIG_FILE');
+                process.exit(1);
+            }
+            continue;
+        }
+        if ((arg === '--package-url' || arg.startsWith('--package-url=')) && !packageUrl) {
+            packageUrl = arg.includes('=') ? arg.split('=')[1] : args[++i];
+            continue;
+        }
+    }
+    if (!version) {
+        error('--version is required for install');
+        emitter.end(false, 1, 'E_VERSION_REQUIRED');
+        process.exit(1);
+    }
+    let safeVersion;
+    let packageSource;
+    try {
+        safeVersion = assertSafePackageVersion(version);
+        packageSource = packageUrl ? parsePackageSource(packageUrl) : undefined;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_INVALID_ARGS', { error: msg });
+        process.exit(1);
+    }
+    emitter.start(`installing skill ${safeSkillName}@${safeVersion}`, { skillName: safeSkillName, version: safeVersion });
+    info(`Installing skill ${safeSkillName}@${safeVersion}...`);
+    try {
+        emitter.stepStart('validate', 'validating install args');
+        await installer.checkDeps();
+        emitter.stepDone('validate', 'args ok, deps ready');
+        emitter.stepStart('download', `downloading skill ${safeSkillName}@${safeVersion}`);
+        await configureMirrors();
+        await installer.install(safeVersion, packageSource);
+        emitter.stepDone('download', 'skill downloaded');
+        emitter.stepStart('install', `applying skill ${safeSkillName}`);
+        if (config) {
+            await installer.configure(config);
+        }
+        emitter.stepDone('install', 'skill installed');
+        success(`Skill ${safeSkillName}@${safeVersion} installed.`);
+        emitter.end(true, 0, undefined, { skillName: safeSkillName, version: safeVersion });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_SKILL_INSTALL_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"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"}

package/dist/commands/uninstall.d.ts

@@ -0,0 +1 @@
+export declare function uninstallCommand(args: string[]): Promise<void>;

package/dist/commands/uninstall.js

@@ -0,0 +1,46 @@
+import { OpenclawInstaller } from '../installers/openclaw.js';
+import { error, info, success } from '../utils/logger.js';
+import { NdjsonEmitter, registerExitHandlers } from '../output/ndjson.js';
+function getInstaller(component) {
+    switch (component) {
+        case 'openclaw': return new OpenclawInstaller();
+        default: return null;
+    }
+}
+export async function uninstallCommand(args) {
+    const emitter = new NdjsonEmitter('uninstall');
+    registerExitHandlers(emitter);
+    const component = args[0];
+    if (!component) {
+        error('Usage: okclaw uninstall <component>');
+        emitter.end(false, 1, 'E_USAGE');
+        process.exit(1);
+    }
+    const installer = getInstaller(component);
+    if (!installer) {
+        error(`Uninstall not supported for component: ${component}`);
+        emitter.end(false, 1, 'E_UNSUPPORTED');
+        process.exit(1);
+    }
+    if (!installer.uninstall) {
+        error(`Component ${component} does not support uninstall`);
+        emitter.end(false, 1, 'E_UNSUPPORTED');
+        process.exit(1);
+    }
+    emitter.start(`uninstalling ${component}`, { component });
+    info(`Uninstalling ${component}...`);
+    try {
+        emitter.stepStart('uninstall', `running uninstall for ${component}`);
+        await installer.uninstall();
+        emitter.stepDone('uninstall', `${component} uninstalled`);
+        success(`${component} uninstalled.`);
+        emitter.end(true, 0, undefined, { component });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        error(msg);
+        emitter.end(false, 1, 'E_UNINSTALL_FAILED', { error: msg });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,SAAS,YAAY,CAAC,SAAiB;IACrC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IAC/C,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,0CAA0C,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,aAAa,SAAS,6BAA6B,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,gBAAgB,SAAS,KAAK,CAAC,CAAC;IAErC,IAAI,CAAC;QACH,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,SAAS,cAAc,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,SAAS,eAAe,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -1,21 +1,77 @@
 import { readFileSync } from 'node:fs';
 import { installCommand } from './commands/install.js';
+import { uninstallCommand } from './commands/uninstall.js';
 import { checkCommand } from './commands/check.js';
 import { editCommand } from './commands/edit.js';
+import { showCommand } from './commands/show.js';
 import { feedCommand } from './commands/feed.js';
+import { backupCommand } from './commands/backup.js';
+import { restoreCommand } from './commands/restore.js';
 import { startCommand, stopCommand, restartCommand, statusCommand } from './commands/service.js';
+import { skillCommand } from './commands/skill.js';
+import { bridgeCommand } from './commands/bridge.js';
 import { ensureRoot } from './utils/shell.js';
 import { error } from './utils/logger.js';
-const [command, ...args] = process.argv.slice(2);
+import { setNdjsonPath, setOutputMode, isNdjson } from './output/mode.js';
+import { getActiveEmitter, NdjsonEmitter } from './output/ndjson.js';
+/**
+ * 从 argv 里抽出全局 flag --output=<mode> 和 --op-id=<uuid>，返回剩余参数。
+ * 支持 "--flag=value" 与 "--flag value" 两种写法。
+ */
+function extractGlobalFlags(argv) {
+    const rest = [];
+    let output = 'text';
+    let opId;
+    let ndjsonPath;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--output' && argv[i + 1]) {
+            output = argv[++i] === 'ndjson' ? 'ndjson' : 'text';
+            continue;
+        }
+        if (arg.startsWith('--output=')) {
+            output = arg.slice('--output='.length) === 'ndjson' ? 'ndjson' : 'text';
+            continue;
+        }
+        if (arg === '--op-id' && argv[i + 1]) {
+            opId = argv[++i];
+            continue;
+        }
+        if (arg.startsWith('--op-id=')) {
+            opId = arg.slice('--op-id='.length);
+            continue;
+        }
+        if (arg === '--ndjson-path' && argv[i + 1]) {
+            ndjsonPath = argv[++i];
+            continue;
+        }
+        if (arg.startsWith('--ndjson-path=')) {
+            ndjsonPath = arg.slice('--ndjson-path='.length);
+            continue;
+        }
+        rest.push(arg);
+    }
+    return { rest, output, opId, ndjsonPath };
+}
+const { rest, output, opId, ndjsonPath } = extractGlobalFlags(process.argv.slice(2));
+setOutputMode(output, opId);
+setNdjsonPath(ndjsonPath);
+const [command, ...args] = rest;
 async function main() {
     // All commands require root (or auto-sudo)
     if (command && command !== '--help' && command !== '-h' && command !== '--version' && command !== '-v') {
         ensureRoot();
     }
     switch (command) {
+        case 'skill':
+            await skillCommand(args);
+            break;
         case 'install':
             await installCommand(args);
             break;
+        case 'uninstall':
+            await uninstallCommand(args);
+            break;
         case 'check':
             await checkCommand();
             break;
@@ -34,13 +90,24 @@ async function main() {
         case 'edit':
             await editCommand(args);
             break;
+        case 'show':
+            await showCommand(args);
+            break;
         case 'feed':
             await feedCommand(args);
             break;
+        case 'backup':
+            await backupCommand(args);
+            break;
+        case 'restore':
+            await restoreCommand(args);
+            break;
+        case 'bridge':
+            await bridgeCommand(args, readCliVersion());
+            break;
         case '--version':
         case '-v': {
-            const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-            console.log(pkg.version);
+            console.log(readCliVersion());
             break;
         }
         case '--help':
@@ -54,34 +121,53 @@ async function main() {
             process.exit(1);
     }
 }
+function readCliVersion() {
+    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+}
 function printHelp() {
     console.log(`
 okclaw - OKClaw Deployment CLI
 
-Usage: okclaw <command> [args...]
+Usage: okclaw [global-flags] <command> [args...]
 
+Global flags (before the command):
+  --output text|ndjson                  Output mode (default: text)
+  --op-id <uuid>                        Operation id, echoed in every ndjson event's fields.opId
+  --ndjson-path <path>                  Append ndjson to file instead of stdout (used in detached mode)
+
+  okclaw skill install <name> --version <ver> [--package-url <url>]   Install a skill
+  okclaw skill uninstall <name>                                       Uninstall a skill
   okclaw install <component> --version <ver> [--config '<json>'] [--config-file <path>] [--package-url <url>]
+  okclaw uninstall <component>                                        Uninstall a component (currently: openclaw)
   okclaw check                          Check & install system dependencies
   okclaw start                          Start openclaw gateway
   okclaw stop                           Stop openclaw gateway
   okclaw restart                        Restart openclaw gateway
   okclaw status                         Show gateway status
-  okclaw edit <target> --file <path>    Write config file (user/identity/soul/agents)
+  okclaw edit <target> --file <path>    Write config file (user/identity/soul/agents/memory/tools/openclaw-json)
+  okclaw show <target...>               Read config file content to stdout (batch requires --output=ndjson)
   okclaw feed --file <path>             Feed file into knowledge base
+  okclaw backup openclaw-user-data --archive [--archive-path <path>] [--scope user-data|clone] [--include-workspace-extra]
+  okclaw restore openclaw-user-data --archive <path> [--scope user-data|clone] [--include-workspace-extra]
+  okclaw install bridge --config-file <path>                          Install and start bridge daemon
+  okclaw bridge daemon|status|restart|uninstall                       Manage bridge daemon
 
 Components:
   openclaw       Core AI Agent framework (npm install)
-  openviking     Long-term memory plugin (pip + openclaw plugin, needs --package-url)
-  dingtalk       DingTalk channel (npm: @largezhou/ddingtalk)
-  feishu         Feishu/Lark channel (npm: @openclaw/feishu)
-  wechat         WeChat channel (npm: @tencent-weixin/openclaw-weixin)
+  bridge         OKClaw bridge daemon bundled in this CLI
+  dingtalk       DingTalk channel (npm: @soimy/dingtalk)
+  feishu         Feishu/Lark channel (bundled with OpenClaw, config only)
+  wechat         WeChat channel alias for openclaw-weixin (npm: @tencent-weixin/openclaw-weixin)
   s3             S3 IM channel (needs --package-url)
 
 Examples:
   okclaw install openclaw --version 2026.3.24 --config-file /root/okclaw/config/openclaw.json
-  okclaw install openviking --version 0.2.15 --package-url /tmp/ov-plugin.tar.gz --config-file /root/okclaw/config/openviking.json
   okclaw install dingtalk --version 2.0.1 --config '{"clientId":"xxx","clientSecret":"xxx"}'
   okclaw install s3 --version 1.0.0 --package-url /tmp/channel-s3.tar.gz
+  okclaw uninstall openclaw
+  okclaw skill install my-skill --version 1.0.0 --package-url https://example.com/skill.zip
+  okclaw skill uninstall my-skill
   okclaw restart
   okclaw status
 
@@ -89,11 +175,29 @@ Notes:
   - All commands auto-elevate to root via sudo if needed
   - All paths are anchored to /root/ (forced HOME=/root)
   - npm uses npmmirror, pip uses tsinghua mirror (China acceleration)
-  - Node.js >= 22.16 and Python >= 3.11 are auto-installed if missing
+  - Node.js >= 24 (LTS) is auto-installed/upgraded via nvm if missing or too old
+  - openclaw-user-data defaults to core workspace files and skills only
+  - --scope clone backs up/restores only IDENTITY.md, SOUL.md, TOOLS.md, AGENTS.md, and workspace/skills
+  - --include-workspace-extra also migrates other OpenClaw workspace root entries, but never /root/.openclaw/openclaw.json
 `);
 }
 main().catch((err) => {
-    error(String(err.message || err));
+    const msg = String(err?.message || err);
+    // bug#4 修：顶层 catch 兜底发 end，防止 os-api 永远等不到终态。
+    // 有活 emitter 就用它；没有（比如 extractGlobalFlags/ensureRoot 阶段崩）→ 直接写一行 fallback。
+    if (isNdjson()) {
+        const active = getActiveEmitter();
+        if (active && !active.hasEnded()) {
+            active.end(false, 1, 'E_TOPLEVEL', { error: msg });
+        }
+        else if (!active) {
+            // 没有任何 emitter 被注册过：手写一条 end 行
+            const fallback = new NdjsonEmitter('unknown');
+            fallback.start('top-level error');
+            fallback.end(false, 1, 'E_TOPLEVEL', { error: msg });
+        }
+    }
+    error(msg);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,2CAA2C;IAC3C,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACvG,UAAU,EAAE,CAAC;IACf,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,OAAO;YACV,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,cAAc,EAAE,CAAC;YACvB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,aAAa,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/installers/base.d.ts

@@ -1,5 +1,7 @@
+import type { PackageSource, SafePackageVersion } from '../utils/install-safety.js';
 export interface Installer {
     checkDeps(): Promise<void>;
-    install(version: string, packageUrl?: string): Promise<void>;
+    install(version: SafePackageVersion, packageSource?: PackageSource): Promise<void>;
     configure(config: Record<string, unknown>): Promise<void>;
+    uninstall?(): Promise<void>;
 }

package/dist/installers/channel.d.ts

@@ -1,9 +1,10 @@
 import type { Installer } from './base.js';
+import type { PackageSource } from '../utils/install-safety.js';
 export declare class ChannelInstaller implements Installer {
-    private channelName;
+    private readonly channelName;
     constructor(channelName: string);
     checkDeps(): Promise<void>;
-    install(version: string, packageUrl?: string): Promise<void>;
+    install(version: string, packageSource?: PackageSource): Promise<void>;
     private verifyInstalled;
     configure(config: Record<string, unknown>): Promise<void>;
     /**
@@ -15,6 +16,7 @@ export declare class ChannelInstaller implements Installer {
      */
     private cleanupStaleState;
     private hasJsonRef;
+    private reportLegacyWechatAliasState;
     private installFromLocalPackage;
     /**
      * Download tgz from npm (npmmirror) first, then install locally.
@@ -22,5 +24,11 @@ export declare class ChannelInstaller implements Installer {
      */
     private installViaNpmPack;
     private addToPluginsAllow;
+    /**
+     * Push the absolute extension dir into plugins.load.paths so the gateway
+     * scans it on startup. Idempotent — dedup against trailing-slash variants
+     * (e.g. `/.../dingtalk` vs `/.../dingtalk/` both count as the same entry).
+     */
+    private addToLoadPaths;
     private applyConfig;
 }