@myclaw163/clawclaw-cli 0.6.54

package/src/commands/strategy.ts

@@ -0,0 +1,189 @@
+import { Command } from 'commander';
+import { join } from 'path';
+import { spawnStrategyLoop } from '../strategies/spawn.js';
+import { GameClient } from '../lib/game-client.js';
+import { getWorkspaceDir } from '../lib/init-command.js';
+
+const KILL_STRATEGIES = new Set([
+  'kill-frenzy', 'kill-lone', 'kill-target', 'warrior-memory',
+  'crab-sabotage', 'lone-kill-task', 'task-kill-report',
+]);
+const KILL_CAPABLE_ROLES = new Set([
+  'crab_generic', 'shrimp_warrior', 'shrimp_pistol', 'neutral_octopus',
+]);
+
+function nonEmptyString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+
+async function currentStrategyMetadata(): Promise<{ gameId?: string; role?: string }> {
+  try {
+    const client = GameClient.fromAuth();
+    const [stateResult, roleResult] = await Promise.allSettled([
+      client.getGameState(),
+      client.getRoleInfo(),
+    ]);
+    const state = stateResult.status === 'fulfilled' ? stateResult.value : null;
+    const roleInfo = roleResult.status === 'fulfilled'
+      ? (roleResult.value?.data ?? roleResult.value)
+      : null;
+    return {
+      gameId: nonEmptyString(state?.game_id)
+        ?? nonEmptyString((state as any)?.game?.id)
+        ?? nonEmptyString((state as any)?.game?.game_id),
+      role: nonEmptyString(roleInfo?.role) ?? nonEmptyString(state?.you?.role),
+    };
+  } catch {
+    return {};
+  }
+}
+
+export function createStrategyCommand(): Command {
+  const cmd = new Command('strategy')
+    .alias('stg')
+    .description('Run a named strategy, or manage exported strategies')
+    .argument('[name]', 'Strategy name to start')
+    .argument('[args...]', 'Strategy arguments')
+    .option('--list', 'List all available strategies')
+    .option('--stop', 'Stop any running strategy')
+    .option('--info <id>', 'Show a strategy\'s knowledge contract')
+    .option('--export <id>', 'Export an official strategy to workspace for customization')
+    .option('--force', 'Force overwrite if strategy file already exists (use with --export)')
+    .allowUnknownOption()
+    .addHelpText('after', () => {
+      const strategiesDir = join(getWorkspaceDir(), 'strategies');
+      return `
+Custom strategies:
+  Place .ts or .js files in ${strategiesDir}
+  (or $CLAWCLAW_WORKSPACE_DIR/strategies/)
+  Each file must export a 'strategy' object with id, description, and create() function.
+  Use 'import { ... } from "@myclaw163/clawclaw-cli"' to access Action, GameState, and utilities.
+  See docs/自定义策略.md for full API reference and examples.
+`;
+    })
+    .action(async (name: string | undefined, args: string[], opts: { list?: boolean; stop?: boolean; info?: string; export?: string; force?: boolean }) => {
+      if (opts.info) {
+        const { getStrategyEntry, getStrategyKnowledgeDoc, listStrategyEntries } = await import('../strategies/loader.js');
+        const entry = await getStrategyEntry(opts.info);
+        if (!entry) {
+          const available = await listStrategyEntries();
+          console.error(JSON.stringify({
+            error: 'unknown_strategy',
+            message: `Unknown strategy '${opts.info}'.`,
+            available: available.map(e => e.id),
+          }, null, 2));
+          process.exit(1);
+        }
+        const knowledge = await getStrategyKnowledgeDoc(opts.info);
+        console.log(JSON.stringify({ id: opts.info, description: entry.description, knowledge: knowledge ?? null }, null, 2));
+        return;
+      }
+
+      if (opts.export) {
+        try {
+          const { exportStrategy } = await import('../lib/strategy-export.js');
+          await exportStrategy(opts.export, { force: opts.force ?? false });
+          console.log(JSON.stringify({ message: `Strategy '${opts.export}' exported to workspace.`, path: `${opts.export}.ts` }, null, 2));
+        } catch (err: any) {
+          console.error(JSON.stringify({ error: 'export_failed', message: err?.message ?? String(err) }, null, 2));
+          process.exit(1);
+        }
+
+        // After exporting, check if there are other stale strategies.
+        try {
+          const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
+          const staleIds = detectStaleOfficialStrategies().filter(id => id !== opts.export);
+          if (staleIds.length > 0) {
+            const ids = staleIds.join(', ');
+            console.error(`[提示] 还有其他官方策略有更新 (${ids})，运行 \`ccl strategy --export <id> --force\` 重新导出`);
+          }
+        } catch {
+          // Silently ignore
+        }
+
+        return;
+      }
+
+      if (opts.list) {
+        const { listStrategyEntries } = await import('../strategies/loader.js');
+        const entries = await listStrategyEntries();
+        if (entries.length === 0) {
+          console.log(JSON.stringify({ strategies: [], message: 'No strategies found.' }, null, 2));
+          return;
+        }
+        console.log(JSON.stringify({
+          strategies: entries.map(e => ({ id: e.id, description: e.description })),
+        }, null, 2));
+        return;
+      }
+
+      if (opts.stop) {
+        const { stopStrategyIfRunning } = await import('../strategies/strategy-loop.js');
+        stopStrategyIfRunning();
+        console.log(JSON.stringify({ message: 'Strategy stopped.' }, null, 2));
+        return;
+      }
+
+      if (!name) {
+        cmd.help();
+        return;
+      }
+
+      const { listStrategyEntries, getStrategyEntry } = await import('../strategies/loader.js');
+      const entry = await getStrategyEntry(name);
+      if (!entry) {
+        const available = await listStrategyEntries();
+        console.error(JSON.stringify({
+          error: 'unknown_strategy',
+          message: `Unknown strategy '${name}'.`,
+          available: available.map(e => ({ id: e.id, description: e.description })),
+        }, null, 2));
+        process.exit(1);
+      }
+
+      try {
+        entry.create(args.length > 0 ? args : undefined);
+      } catch (err: any) {
+        console.error(JSON.stringify({
+          error: 'strategy_create_failed',
+          message: err?.message ?? String(err),
+          strategy: name,
+        }, null, 2));
+        process.exit(1);
+      }
+
+      if (KILL_STRATEGIES.has(name)) {
+        try {
+          const client = GameClient.fromAuth();
+          await client.discoverGameServer();
+          const roleInfo = await client.getRoleInfo();
+          const role: string = roleInfo?.data?.role ?? roleInfo?.role ?? '';
+          const displayName: string = roleInfo?.data?.display_name ?? role;
+          if (role && !KILL_CAPABLE_ROLES.has(role)) {
+            console.error(JSON.stringify({
+              error: 'role_incompatible',
+              message: `Strategy '${name}' requires kill ability, but your role '${displayName}' (${role}) cannot kill. Use a non-kill strategy like task-report, patrol, or report-patrol.`,
+              strategy: name,
+              role,
+            }, null, 2));
+            process.exit(1);
+          }
+        } catch {}
+      }
+
+      const { stopStrategyIfRunning } = await import('../strategies/strategy-loop.js');
+      const { stopOpeningMoverIfRunning } = await import('../runtime/opening-mover.js');
+      stopStrategyIfRunning();
+      stopOpeningMoverIfRunning();
+
+      const metadata = await currentStrategyMetadata();
+      const child = spawnStrategyLoop(name, args.length > 0 ? args : undefined, metadata);
+      console.log(JSON.stringify({
+        message: `Strategy started: ${name}`,
+        description: entry.description,
+        pid: child.pid,
+      }, null, 2));
+    });
+
+  return cmd;
+}

package/src/commands/tts.ts

@@ -0,0 +1,128 @@
+import { Command } from 'commander';
+import { AuthStore } from '../lib/auth.js';
+import { GameClient } from '../lib/game-client.js';
+import { setMeta } from '../lib/command-meta.js';
+import { DEFAULT_TTS_VOICE, TTS_PROVIDER_LEIHUO } from '../lib/tts-keys.js';
+import { synthesizeAndUploadSpeechAudio } from '../lib/tts-speech.js';
+
+const AVAILABLE_VOICES = [
+  { id: "male-qn-qingse", language: "中文 (普通话)", description: "青涩青年音色" },
+  { id: "male-qn-jingying", language: "中文 (普通话)", description: "精英青年音色" },
+  { id: "male-qn-badao", language: "中文 (普通话)", description: "霸道青年音色" },
+  { id: "male-qn-daxuesheng", language: "中文 (普通话)", description: "青年大学生音色" },
+  { id: "female-shaonv", language: "中文 (普通话)", description: "少女音色" },
+  { id: "female-yujie", language: "中文 (普通话)", description: "御姐音色" },
+  { id: "female-chengshu", language: "中文 (普通话)", description: "成熟女性音色" },
+  { id: "female-tianmei", language: "中文 (普通话)", description: "甜美女性音色" },
+  { id: "male-qn-qingse-jingpin", language: "中文 (普通话)", description: "青涩青年音色-beta" },
+  { id: "male-qn-jingying-jingpin", language: "中文 (普通话)", description: "精英青年音色-beta" },
+  { id: "male-qn-badao-jingpin", language: "中文 (普通话)", description: "霸道青年音色-beta" },
+  { id: "male-qn-daxuesheng-jingpin", language: "中文 (普通话)", description: "青年大学生音色-beta" },
+  { id: "female-shaonv-jingpin", language: "中文 (普通话)", description: "少女音色-beta" },
+  { id: "female-yujie-jingpin", language: "中文 (普通话)", description: "御姐音色-beta" },
+  { id: "female-chengshu-jingpin", language: "中文 (普通话)", description: "成熟女性音色-beta" },
+  { id: "female-tianmei-jingpin", language: "中文 (普通话)", description: "甜美女性音色-beta" },
+  { id: "clever_boy", language: "中文 (普通话)", description: "聪明男童" },
+  { id: "cute_boy", language: "中文 (普通话)", description: "可爱男童" },
+  { id: "lovely_girl", language: "中文 (普通话)", description: "萌萌女童" },
+  { id: "cartoon_pig", language: "中文 (普通话)", description: "卡通猪小琪" },
+  { id: "bingjiao_didi", language: "中文 (普通话)", description: "病娇弟弟" },
+  { id: "junlang_nanyou", language: "中文 (普通话)", description: "俊朗男友" },
+  { id: "chunzhen_xuedi", language: "中文 (普通话)", description: "纯真学弟" },
+  { id: "lengdan_xiongzhang", language: "中文 (普通话)", description: "冷淡学长" },
+  { id: "badao_shaoye", language: "中文 (普通话)", description: "霸道少爷" },
+  { id: "tianxin_xiaoling", language: "中文 (普通话)", description: "甜心小玲" },
+  { id: "qiaopi_mengmei", language: "中文 (普通话)", description: "俏皮萌妹" },
+  { id: "wumei_yujie", language: "中文 (普通话)", description: "妩媚御姐" },
+  { id: "diadia_xuemei", language: "中文 (普通话)", description: "嗲嗲学妹" },
+  { id: "danya_xuejie", language: "中文 (普通话)", description: "淡雅学姐" },
+  { id: "Chinese (Mandarin)_Reliable_Executive", language: "中文 (普通话)", description: "沉稳高管" },
+  { id: "Chinese (Mandarin)_News_Anchor", language: "中文 (普通话)", description: "新闻女声" },
+  { id: "Chinese (Mandarin)_Mature_Woman", language: "中文 (普通话)", description: "傲娇御姐" },
+  { id: "Chinese (Mandarin)_Unrestrained_Young_Man", language: "中文 (普通话)", description: "不羁青年" },
+  { id: "Arrogant_Miss", language: "中文 (普通话)", description: "嚣张小姐" },
+  { id: "Robot_Armor", language: "中文 (普通话)", description: "机械战甲" },
+  { id: "Chinese (Mandarin)_Kind-hearted_Antie", language: "中文 (普通话)", description: "热心大婶" },
+  { id: "Chinese (Mandarin)_HK_Flight_Attendant", language: "中文 (普通话)", description: "港普空姐" },
+  { id: "Chinese (Mandarin)_Humorous_Elder", language: "中文 (普通话)", description: "搞笑大爷" },
+  { id: "Chinese (Mandarin)_Gentleman", language: "中文 (普通话)", description: "温润男声" },
+  { id: "Chinese (Mandarin)_Warm_Bestie", language: "中文 (普通话)", description: "温暖闺蜜" },
+  { id: "Chinese (Mandarin)_Male_Announcer", language: "中文 (普通话)", description: "播报男声" },
+  { id: "Chinese (Mandarin)_Sweet_Lady", language: "中文 (普通话)", description: "甜美女声" },
+  { id: "Chinese (Mandarin)_Southern_Young_Man", language: "中文 (普通话)", description: "南方小哥" },
+  { id: "Chinese (Mandarin)_Wise_Women", language: "中文 (普通话)", description: "阅历姐姐" },
+  { id: "Chinese (Mandarin)_Gentle_Youth", language: "中文 (普通话)", description: "温润青年" },
+  { id: "Chinese (Mandarin)_Warm_Girl", language: "中文 (普通话)", description: "温暖少女" },
+  { id: "Chinese (Mandarin)_Kind-hearted_Elder", language: "中文 (普通话)", description: "花甲奶奶" },
+  { id: "Chinese (Mandarin)_Cute_Spirit", language: "中文 (普通话)", description: "憨憨萌兽" },
+  { id: "Chinese (Mandarin)_Radio_Host", language: "中文 (普通话)", description: "电台男主播" },
+  { id: "Chinese (Mandarin)_Lyrical_Voice", language: "中文 (普通话)", description: "抒情男声" },
+  { id: "Chinese (Mandarin)_Straightforward_Boy", language: "中文 (普通话)", description: "率真弟弟" },
+  { id: "Chinese (Mandarin)_Sincere_Adult", language: "中文 (普通话)", description: "真诚青年" },
+  { id: "Chinese (Mandarin)_Gentle_Senior", language: "中文 (普通话)", description: "温柔学姐" },
+  { id: "Chinese (Mandarin)_Stubborn_Friend", language: "中文 (普通话)", description: "嘴硬竹马" },
+  { id: "Chinese (Mandarin)_Crisp_Girl", language: "中文 (普通话)", description: "清脆少女" },
+  { id: "Chinese (Mandarin)_Pure-hearted_Boy", language: "中文 (普通话)", description: "清澈邻家弟弟" },
+  { id: "Chinese (Mandarin)_Soft_Girl", language: "中文 (普通话)", description: "柔和少女" },
+  { id: "Cantonese_ProfessionalHost（F)", language: "中文 (粤语)", description: "专业女主持" },
+  { id: "Cantonese_GentleLady", language: "中文 (粤语)", description: "温柔女声" },
+  { id: "Cantonese_ProfessionalHost（M)", language: "中文 (粤语)", description: "专业男主持" },
+  { id: "Cantonese_PlayfulMan", language: "中文 (粤语)", description: "活泼男声" },
+  { id: "Cantonese_CuteGirl", language: "中文 (粤语)", description: "可爱女孩" },
+  { id: "Cantonese_KindWoman", language: "中文 (粤语)", description: "善良女声" }
+];
+
+export function createTTSCommand(): Command {
+  const tts = new Command('tts');
+  tts.description('NetEase TTS configuration and requests');
+
+  tts
+    .command('config [apiKey]')
+    .description('Configure active account NetEase TTS API key and default voice')
+    .option('-v, --voice <voice>', 'Default voice ID for this account')
+    .action((apiKey: string | undefined, opts: { voice?: string }) => {
+      if (!apiKey && !opts.voice) {
+        throw new Error('Provide an API key, a default voice with --voice, or both.');
+      }
+      const authStore = new AuthStore();
+      const profile = authStore.getActive();
+      if (!profile) throw new Error('No active account. Run `clawclaw-cli account register` or `clawclaw-cli account switch <apiKey>` first.');
+      if (apiKey) authStore.setTtsKey(TTS_PROVIDER_LEIHUO, apiKey);
+      if (opts.voice) authStore.setTtsDefaultVoice(opts.voice);
+      const config = authStore.getTtsConfig();
+      console.log(JSON.stringify({
+        message: 'TTS configured successfully for active account',
+        account: profile.agentName,
+        provider: TTS_PROVIDER_LEIHUO,
+        apiKeyConfigured: Boolean(config?.keys?.[TTS_PROVIDER_LEIHUO]),
+        defaultVoice: config?.defaultVoice ?? DEFAULT_TTS_VOICE,
+      }, null, 2));
+    });
+
+  tts
+    .command('list')
+    .description('List all available voices')
+    .action(() => {
+      console.log(JSON.stringify(AVAILABLE_VOICES, null, 2));
+    });
+
+  tts
+    .command('request <text>')
+    .description('Request local NetEase TTS synthesis and upload audio to OSS')
+    .option('-v, --voice <voice>', 'Voice ID; defaults to the active account default voice')
+    .action(async (text: string, opts: { voice?: string }) => {
+      const client = GameClient.fromAuth();
+      const authStore = new AuthStore();
+      const voice = opts.voice ?? authStore.getTtsDefaultVoice() ?? DEFAULT_TTS_VOICE;
+      const audioUrl = await synthesizeAndUploadSpeechAudio(text, client, { voice, authStore });
+      console.log(JSON.stringify({
+        audio_url: audioUrl,
+        voice,
+      }, null, 2));
+    });
+
+  // ── Adapter metadata ──
+  setMeta(tts.commands.find((c) => c.name() === 'config')!, { requiresConfirm: true, sensitive: true });
+
+  return tts;
+}

package/src/commands/upgrade.test.ts

@@ -0,0 +1,91 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, resolve } from 'path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { installLatestFromNpm, runUpgrade, syncSkillFromInstalledPackage } from './upgrade.js';
+
+describe('runUpgrade', () => {
+  const prevRegistry = process.env.CLAWCLAW_UPGRADE_REGISTRY;
+
+  afterEach(() => {
+    if (prevRegistry === undefined) delete process.env.CLAWCLAW_UPGRADE_REGISTRY;
+    else process.env.CLAWCLAW_UPGRADE_REGISTRY = prevRegistry;
+  });
+
+  it('installs and returns the installed cli version without syncing skill again', () => {
+    let installed = false;
+    const result = runUpgrade({
+      installLatest: () => { installed = true; },
+      readInstalledCliVersion: () => '0.4.7',
+    });
+    expect(installed).toBe(true);
+    expect(result).toEqual({ version: '0.4.7' });
+  });
+
+  it('reports error when npm install fails', () => {
+    const result = runUpgrade({
+      installLatest: () => { throw new Error('EACCES'); },
+      readInstalledCliVersion: () => '0.3.4',
+    });
+    expect(result.version).toBeUndefined();
+    expect(result.error).toMatch(/npm install failed/);
+  });
+
+  it('uses registry override and keeps npm stdout off while exposing stderr', () => {
+    process.env.CLAWCLAW_UPGRADE_REGISTRY = 'http://127.0.0.1:4873/';
+    const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
+    installLatestFromNpm('clawclaw-cli', (file, args, options) => {
+      calls.push({ file, args, options });
+    });
+
+    expect(calls).toHaveLength(1);
+    if (process.platform === 'win32') {
+      expect(calls[0].file).toBe('cmd.exe');
+      expect(calls[0].args).toEqual([
+        '/d',
+        '/c',
+        'npm.cmd install -g clawclaw-cli@latest --registry=http://127.0.0.1:4873/ --foreground-scripts --loglevel=error',
+      ]);
+    } else {
+      expect(calls[0].args).toEqual([
+        'install',
+        '-g',
+        'clawclaw-cli@latest',
+        '--registry=http://127.0.0.1:4873/',
+        '--foreground-scripts',
+        '--loglevel=error',
+      ]);
+    }
+    expect(calls[0].options.stdio).toEqual(['ignore', 'ignore', 'inherit']);
+    expect(calls[0].options.shell).toBe(false);
+  });
+
+  it('runs bundled skill sync script for explicit skill update', () => {
+    const root = mkdtempSync(join(tmpdir(), 'upgrade-skill-'));
+    const installDir = join(root, 'clawclaw-cli');
+    const scriptPath = join(installDir, 'scripts', 'sync-bundled-skill.mjs');
+    mkdirSync(join(installDir, 'scripts'), { recursive: true });
+    writeFileSync(scriptPath, '');
+
+    const calls: Array<{ file: string; args: string[]; options: Record<string, unknown> }> = [];
+    syncSkillFromInstalledPackage('clawclaw-cli', (file, args, options) => {
+      calls.push({ file, args, options });
+      if (args[0] === 'root' || args.at(-1)?.includes('root -g')) return root;
+      return '';
+    });
+
+    expect(calls).toHaveLength(2);
+    expect(calls[1].file).toBe(process.execPath);
+    expect(calls[1].args).toEqual([resolve(scriptPath)]);
+    expect(calls[1].options.stdio).toBe('inherit');
+  });
+
+  it('reports error when reading installed version fails', () => {
+    const result = runUpgrade({
+      installLatest: () => {},
+      readInstalledCliVersion: () => { throw new Error('missing package'); },
+    });
+    expect(result.version).toBeUndefined();
+    expect(result.error).toMatch(/read installed cli version failed/);
+  });
+});

package/src/commands/upgrade.ts

@@ -0,0 +1,154 @@
+import { Command } from 'commander';
+import { execFileSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const REGISTRY = 'http://apps-hp.danlu.netease.com:41842/repository/npm-group-prod/';
+const NPM_INSTALL_TIMEOUT_MS = 30_000;
+
+export interface UpgradeDeps {
+  installLatest: () => void;
+  readInstalledCliVersion: () => string;
+}
+
+export interface UpgradeResult {
+  version?: string;
+  error?: string;
+}
+
+export function runUpgrade(deps: UpgradeDeps): UpgradeResult {
+  try {
+    deps.installLatest();
+  } catch (err: any) {
+    return { error: `npm install failed: ${err?.message ?? String(err)}` };
+  }
+
+  let version: string;
+  try {
+    version = deps.readInstalledCliVersion();
+  } catch (err: any) {
+    return { error: `read installed cli version failed: ${err?.message ?? String(err)}` };
+  }
+
+  return { version };
+}
+
+function npmBin(): string {
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm';
+}
+
+type ExecFileSyncLike = (file: string, args: string[], options: Record<string, unknown>) => unknown;
+
+function escapeCmdArg(arg: string): string {
+  if (/\s/.test(arg)) throw new Error(`npm argument contains whitespace: ${arg}`);
+  return arg.replace(/[()^!%<>&|]/g, '^$&');
+}
+
+function execNpmSync(args: string[], options: Record<string, unknown>, execFile: ExecFileSyncLike = execFileSync): unknown {
+  if (process.platform !== 'win32') {
+    return execFile(npmBin(), args, { ...options, shell: false });
+  }
+  const command = [npmBin(), ...args].map(escapeCmdArg).join(' ');
+  return execFile('cmd.exe', ['/d', '/c', command], { ...options, shell: false });
+}
+
+function currentPackageName(): string {
+  const __filename = fileURLToPath(import.meta.url);
+  const pkgPath = resolve(dirname(__filename), '..', '..', 'package.json');
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  const name = String(pkg?.name ?? '').trim();
+  if (!name) throw new Error(`package name not found: ${pkgPath}`);
+  return name;
+}
+
+function upgradeRegistry(): string {
+  return process.env.CLAWCLAW_UPGRADE_REGISTRY?.trim() || REGISTRY;
+}
+
+export function installLatestFromNpm(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
+  execNpmSync(
+    [
+      'install',
+      '-g',
+      `${packageName}@latest`,
+      `--registry=${upgradeRegistry()}`,
+      '--foreground-scripts',
+      '--loglevel=error',
+    ],
+    { timeout: NPM_INSTALL_TIMEOUT_MS, windowsHide: true, stdio: ['ignore', 'ignore', 'inherit'] },
+    execFile,
+  );
+}
+
+function readInstalledCliVersionFromNpm(packageName: string): string {
+  const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true })).trim();
+  const pkgPath = resolve(npmRoot, packageName, 'package.json');
+  if (!existsSync(pkgPath)) throw new Error(`installed package not found: ${pkgPath}`);
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  if (!pkg?.version) throw new Error(`installed package has no version: ${pkgPath}`);
+  return pkg.version;
+}
+
+export function syncSkillFromInstalledPackage(packageName: string, execFile: ExecFileSyncLike = execFileSync): void {
+  const npmRoot = String(execNpmSync(['root', '-g'], { encoding: 'utf8', windowsHide: true }, execFile)).trim();
+  const installDir = resolve(npmRoot, packageName);
+  const syncScript = resolve(installDir, 'scripts', 'sync-bundled-skill.mjs');
+  if (!existsSync(syncScript)) throw new Error(`bundled skill sync script not found: ${syncScript}`);
+  execFile(
+    process.execPath,
+    [syncScript],
+    {
+      cwd: installDir,
+      timeout: 60_000,
+      windowsHide: true,
+      stdio: 'inherit',
+    },
+  );
+}
+
+export function runDefaultUpgrade(): UpgradeResult {
+  const packageName = currentPackageName();
+  return runUpgrade({
+    installLatest: () => installLatestFromNpm(packageName),
+    readInstalledCliVersion: () => readInstalledCliVersionFromNpm(packageName),
+  });
+}
+
+export function createUpgradeCommand(): Command {
+  const cmd = new Command('upgrade')
+    .description('Install latest @myclaw163/clawclaw-cli from npm.')
+    .action(async () => {
+      const result = runDefaultUpgrade();
+      if (result.error) {
+        console.error(result.error);
+        process.exit(1);
+      }
+      console.log(result.version);
+
+      // After upgrade, check if any exported strategies are now stale.
+      try {
+        const { detectStaleOfficialStrategies } = await import('../lib/strategy-export.js');
+        const staleIds = detectStaleOfficialStrategies();
+        if (staleIds.length > 0) {
+          const ids = staleIds.join(', ');
+          console.error(`[提示] 官方策略有更新 (${ids})，运行 \`ccl strategy --export <id> --force\` 重新导出`);
+        }
+      } catch {
+        // Silently ignore detection failures
+      }
+    });
+
+  cmd.command('skill')
+    .description('Sync the bundled clawclaw skill from the installed CLI package.')
+    .action(() => {
+      try {
+        syncSkillFromInstalledPackage(currentPackageName());
+      } catch (err: any) {
+        console.error(err?.message ?? String(err));
+        process.exit(1);
+      }
+    });
+
+  return cmd;
+}