refactor(cli): 重构命令行参数解析并优化启动流程

- 使用 yargs 库替代原有手写解析，增强参数解析的健壮性和可维护性
- 添加严格参数校验，提升错误提示的清晰度
- 统一处理 --resume 和 --prompt 参数的组合逻辑，避免冲突使用
- 改进启动流程，确保先恢复会话再提交初始提示
- 将 resetStaticView 方法修改为异步以支持启动流程等待
- 替换部分异步调用为 await 确保顺序执行，避免竞态问题
- 更新 CLI 帮助文案，优化用户体验和信息表达
- 调整欢迎界面文本样式，增加标题加粗显示
- 添加相关单元测试 covering 新的参数解析和校验逻辑
- 引入 yargs 及其类型依赖，更新 package.json 和锁文件依赖清单

Author: hqwlkj

package-lock.json

@@ -37,6 +37,10 @@
     "ignore": "^7.0.5",
     "ink": "^7.0.4",
     "ink-gradient": "^4.0.1",
-    "react": "^19.2.5"
+    "react": "^19.2.5",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@types/yargs": "^17.0.35"
   }
 }

packages/cli/package.json

@@ -1,31 +1,102 @@
 /**
  * CLI argument parsing helpers.
- * Extracted from cli.tsx for testability.
+ * Uses yargs for robust argument parsing and validation.
  */
 
-export function extractInitialPrompt(args: string[]): string | undefined {
-  const promptIndex = args.findIndex((arg) => arg === "-p" || arg === "--prompt");
-  if (promptIndex !== -1 && promptIndex + 1 < args.length) {
-    return args[promptIndex + 1];
-  }
-  return undefined;
+import Yargs from "yargs";
+
+export interface ParsedCliArgs {
+  /** Prompt text from -p / --prompt */
+  prompt: string | undefined;
+  /**
+   * Resume session identifier:
+   *   - `undefined` — --resume was not used
+   *   - `true`       — --resume was used without a session ID (show picker)
+   *   - `string`     — --resume <sessionId> was used
+   */
+  resume: string | true | undefined;
+  /** True when --version / -v was passed */
+  version: boolean;
+  /** True when --help / -h was passed */
+  help: boolean;
+}
+
+export interface CliParseError {
+  message: string;
 }
 
 /**
- * Extract the --resume flag value.
- *
- * Returns:
- *   - `undefined` — `--resume` was not used
- *   - `true`       — `--resume` was used without a session ID (show session picker)
- *   - `string`     — `--resume <sessionId>` was used (resume specific session)
+ * Parse CLI arguments with validation.
+ * Returns parsed args on success, or an error object if the arguments are invalid.
  */
-export function extractResumeSessionId(args: string[]): string | true | undefined {
-  const idx = args.findIndex((arg) => arg === "--resume");
-  if (idx === -1) {
-    return undefined;
+export function parseCliArgs(argv: string[]): ParsedCliArgs | CliParseError {
+  let validationError: string | null = null;
+
+  const y = Yargs(argv)
+    .locale("en")
+    .scriptName("deepcode")
+    .version(false)
+    .help(false)
+    .option("version", {
+      alias: "v",
+      type: "boolean",
+      describe: "Print the version",
+    })
+    .option("help", {
+      alias: "h",
+      type: "boolean",
+      describe: "Show this help",
+    })
+    .option("resume", {
+      alias: "r",
+      type: "string",
+      describe: "Resume a specific session by its ID. Use without an ID to show session picker.",
+    })
+    .option("prompt", {
+      alias: "p",
+      type: "string",
+      describe: "Submit a prompt on launch",
+    })
+    .strict()
+    .exitProcess(false)
+    .fail((msg) => {
+      validationError = msg;
+    })
+    .check((parsed) => {
+      // bare --resume conflicts with --prompt
+      if (parsed.resume === "" && parsed.prompt) {
+        throw new Error(
+          "Cannot use --resume without a session ID together with --prompt.\n" +
+            "Use --resume <sessionId> -p <prompt> to resume a session and send a prompt."
+        );
+      }
+      // empty prompt is meaningless
+      if (parsed.prompt === "") {
+        throw new Error("--prompt / -p requires a non-empty value.");
+      }
+      return true;
+    });
+
+  const parsed = y.parseSync() as Record<string, unknown>;
+
+  if (validationError) {
+    return { message: validationError };
   }
-  if (idx + 1 < args.length && !args[idx + 1].startsWith("-")) {
-    return args[idx + 1];
+
+  const resumeRaw = parsed.resume as string | undefined;
+  let resume: ParsedCliArgs["resume"];
+  if (resumeRaw === undefined) {
+    resume = undefined;
+  } else if (resumeRaw === "") {
+    resume = true;
+  } else {
+    resume = resumeRaw;
   }
-  return true;
+
+  return {
+    prompt: parsed.prompt as string | undefined,
+    resume,
+    version: parsed.version === true,
+    help: parsed.help === true,
+  };
 }