@myclaw163/clawclaw-cli 0.6.71 → 0.6.74

package/src/commands/strategy.ts

@@ -1,181 +1,181 @@
-import { Command } from 'commander';
-import { join } from 'path';
-import { GameClient } from '../lib/game-client.js';
-import { getProfileStateDir, getWorkspaceDir } from '../lib/init-command.js';
-import { AuthStore } from '../lib/auth.js';
-import { sendOwnerControlRequest } from '../runtime/owner-control.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',
-]);
-
-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, name (中文别名), 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(entry.id);
-        console.log(JSON.stringify({ id: entry.id, name: entry.name ?? entry.id, 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, name: e.name ?? e.id, description: e.description })),
-        }, null, 2));
-        return;
-      }
-
-      if (opts.stop) {
-        const profile = new AuthStore().getActive();
-        const response = profile
-          ? await sendOwnerControlRequest(getProfileStateDir(profile), 'stop_strategy')
-          : null;
-        if (!response?.ok) {
-          console.error(JSON.stringify({
-            error: 'no_game_start_owner',
-            message: 'No active ccl game start owner is available to stop strategy.',
-          }, null, 2));
-          process.exit(1);
-        }
-        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, name: e.name ?? 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(entry.id)) {
-        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 '${entry.id}' requires kill ability, but your role '${displayName}' (${role}) cannot kill. Use a non-kill strategy like task-report, patrol, or report-patrol.`,
-              strategy: entry.id,
-              role,
-            }, null, 2));
-            process.exit(1);
-          }
-        } catch {}
-      }
-
-      const profile = new AuthStore().getActive();
-      const response = profile
-        ? await sendOwnerControlRequest(getProfileStateDir(profile), 'switch_strategy', {
-          strategy: entry.id,
-          args: args.length > 0 ? args : undefined,
-        })
-        : null;
-      if (!response?.ok) {
-        console.error(JSON.stringify({
-          error: 'no_game_start_owner',
-          message: 'Run `ccl game start` before switching strategy; strategy processes are owned by the game start runtime.',
-        }, null, 2));
-        process.exit(1);
-      }
-      console.log(JSON.stringify({
-        message: `Strategy started: ${entry.id}`,
-        name: entry.name ?? entry.id,
-        description: entry.description,
-        pid: response.pid,
-      }, null, 2));
-    });
-
-  return cmd;
-}
+import { Command, Option } from 'commander';
+import { join } from 'path';
+import { GameClient } from '../lib/game-client.js';
+import { getProfileStateDir, getWorkspaceDir } from '../lib/init-command.js';
+import { AuthStore } from '../lib/auth.js';
+import { sendOwnerControlRequest } from '../runtime/owner-control.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',
+]);
+
+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')
+    .addOption(new Option('--stop', 'Stop any running strategy').hideHelp())
+    .option('--info <id>', 'Show a strategy\'s knowledge contract')
+    .addOption(new Option('--export <id>', 'Export an official strategy to workspace for customization').hideHelp())
+    .addOption(new Option('--force', 'Force overwrite if strategy file already exists (use with --export)').hideHelp())
+    .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, name (中文别名), 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(entry.id);
+        console.log(JSON.stringify({ id: entry.id, name: entry.name ?? entry.id, 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, name: e.name ?? e.id, description: e.description })),
+        }, null, 2));
+        return;
+      }
+
+      if (opts.stop) {
+        const profile = new AuthStore().getActive();
+        const response = profile
+          ? await sendOwnerControlRequest(getProfileStateDir(profile), 'stop_strategy')
+          : null;
+        if (!response?.ok) {
+          console.error(JSON.stringify({
+            error: 'no_game_start_owner',
+            message: 'No active ccl game start owner is available to stop strategy.',
+          }, null, 2));
+          process.exit(1);
+        }
+        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, name: e.name ?? 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(entry.id)) {
+        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 '${entry.id}' requires kill ability, but your role '${displayName}' (${role}) cannot kill. Use a non-kill strategy like task-report, patrol, or report-patrol.`,
+              strategy: entry.id,
+              role,
+            }, null, 2));
+            process.exit(1);
+          }
+        } catch {}
+      }
+
+      const profile = new AuthStore().getActive();
+      const response = profile
+        ? await sendOwnerControlRequest(getProfileStateDir(profile), 'switch_strategy', {
+          strategy: entry.id,
+          args: args.length > 0 ? args : undefined,
+        })
+        : null;
+      if (!response?.ok) {
+        console.error(JSON.stringify({
+          error: 'no_game_start_owner',
+          message: 'Run `ccl game start` before switching strategy; strategy processes are owned by the game start runtime.',
+        }, null, 2));
+        process.exit(1);
+      }
+      console.log(JSON.stringify({
+        message: `Strategy started: ${entry.id}`,
+        name: entry.name ?? entry.id,
+        description: entry.description,
+        pid: response.pid,
+      }, null, 2));
+    });
+
+  return cmd;
+}

package/src/commands/tts.ts

@@ -1,128 +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;
-}
+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;
+}