feat: add region-aware apiDocs support to command help

Add DOCS_HOSTS constant mapping regions to their docs platform hosts
(global → platform.minimax.io, cn → platform.minimaxi.com). Commands
can now set apiDocs to a path (e.g. /docs/api-reference/music-generation)
and the correct host is resolved from the user's region at display time.

Author: tars90percent

src/command.ts

@@ -14,6 +14,7 @@ export interface Command {
   usage?: string;
   options?: OptionDef[];
   examples?: string[];
+  apiDocs?: string;
   execute(config: Config, flags: GlobalFlags): Promise<void>;
 }
 
@@ -23,6 +24,7 @@ export interface CommandSpec {
   usage?: string;
   options?: OptionDef[];
   examples?: string[];
+  apiDocs?: string;
   run(config: Config, flags: GlobalFlags): Promise<void>;
 }
 
@@ -33,6 +35,7 @@ export function defineCommand(spec: CommandSpec): Command {
     usage: spec.usage,
     options: spec.options,
     examples: spec.examples,
+    apiDocs: spec.apiDocs,
     execute: spec.run,
   };
 }

src/config/schema.ts

@@ -3,6 +3,11 @@ export const REGIONS = {
   cn: 'https://api.minimaxi.com',
 } as const;
 
+export const DOCS_HOSTS = {
+  global: 'https://platform.minimax.io',
+  cn: 'https://platform.minimaxi.com',
+} as const;
+
 export type Region = keyof typeof REGIONS;
 
 export interface ConfigFile {

src/main.ts

@@ -2,9 +2,9 @@ import { scanCommandPath, parseFlags } from './args';
 import { registry } from './registry';
 import { GLOBAL_OPTIONS } from './command';
 import { handleError } from './errors/handler';
-import { loadConfig } from './config/loader';
+import { loadConfig, readConfigFile } from './config/loader';
 import { detectRegion, saveDetectedRegion } from './config/detect-region';
-import { REGIONS } from './config/schema';
+import { REGIONS, type Region } from './config/schema';
 import { checkForUpdate, getPendingUpdateNotification } from './update/checker';
 import { loadCredentials } from './auth/credentials';
 import { ensureApiKey } from './auth/setup';
@@ -44,7 +44,9 @@ async function main() {
   const commandPath = scanCommandPath(argv, GLOBAL_OPTIONS);
 
   if (argv.includes('--help') || argv.includes('-h')) {
-    registry.printHelp(commandPath, process.stderr);
+    const ri = argv.indexOf('--region');
+    const region = ((ri >= 0 && argv[ri + 1]) || process.env.MINIMAX_REGION || readConfigFile().region || 'global') as Region;
+    registry.printHelp(commandPath, process.stderr, region);
     process.exit(0);
   }
 

src/registry.ts

@@ -1,6 +1,7 @@
 import type { Command } from './command';
 import { CLIError } from './errors/base';
 import { ExitCode } from './errors/codes';
+import { DOCS_HOSTS, type Region } from './config/schema';
 
 import authLogin from './commands/auth/login';
 import authStatus from './commands/auth/status';
@@ -119,7 +120,7 @@ class CommandRegistry {
   private accent = (s: string, out: NodeJS.WriteStream) => out.isTTY ? `\x1b[38;2;248;103;58m${s}\x1b[0m` : s;
   private dim   = (s: string, out: NodeJS.WriteStream) => out.isTTY ? `\x1b[2m${s}\x1b[0m` : s;
 
-  printHelp(commandPath: string[], out: NodeJS.WriteStream = process.stdout): void {
+  printHelp(commandPath: string[], out: NodeJS.WriteStream = process.stdout, region: Region = 'global'): void {
     if (commandPath.length === 0) {
       this.printRootHelp(out);
       return;
@@ -136,7 +137,7 @@ class CommandRegistry {
     }
 
     if (node.command) {
-      this.printCommandHelp(node.command, out);
+      this.printCommandHelp(node.command, out, region);
       return;
     }
 
@@ -217,7 +218,7 @@ ${b('Getting Help:')}
 `);
   }
 
-  private printCommandHelp(cmd: Command, out: NodeJS.WriteStream): void {
+  private printCommandHelp(cmd: Command, out: NodeJS.WriteStream, region: Region = 'global'): void {
     const b = (s: string) => this.bold(s, out);
     const a = (s: string) => this.accent(s, out);
     const d = (s: string) => this.dim(s, out);
@@ -237,6 +238,9 @@ ${b('Getting Help:')}
         out.write(`  ${d(ex)}\n`);
       }
     }
+    if (cmd.apiDocs) {
+      out.write(`\n${b('API Reference:')} ${d(DOCS_HOSTS[region] + cmd.apiDocs)}\n`);
+    }
     out.write(`\n${d('Global flags (--api-key, --output, --quiet, etc.) are always available.')}\n`);
     out.write(`${d("Run")} mmx --help ${d('for the full list.')}\n`);
   }