args.ts：解析与分发

21interface ProfileInvocation {
22  mode: 'profile'
23  profile: string
25  fromDefaultProfile?: string | undefined   // 0.1.5 新增--from-default-profile
27  patches: string[]
29  args: string[]   // 内部参数：原样交给 booted 插件树
30}
33interface DumpConfigInvocation {
34  mode: 'dump-config'
35  profile: string
37  fromDefaultProfile?: string | undefined
39  defaultOnly: boolean   // true = 只打印 bundle 层（跳过用户层与 --patch）
40  patches: string[]
41}
44interface DumpConfigSchemaInvocation {   // 0.1.7-rc.1 新增第四个成员
45  mode: 'dump-config-schema'
46  profile: string
48  fromDefaultProfile?: string | undefined
49  patches: string[]   // 与 dump-config 不同：这里允许 --patch
50}
53interface PluginInvocation {
54  mode: 'plugin'
55  profile: string
57  args: string[]   // pnpm 参数，原样转发
58}
61export type DshInvocation = ProfileInvocation | DumpConfigInvocation | DumpConfigSchemaInvocation | PluginInvocation四个成员

145export function parseDshArgs(argv: readonly string[], version: string): DshInvocation {0.1.6-alpha.2：这里多一行
146  const first = argv[0]   // 只看第一个 token，决定是否展开前缀新增
147  let resolved: DshInvocation | undefined
150  const program: Command = new Command()
151  program
152    .name('dsh')
153    .version(version, '-V, --version', 'output the version number')
154    .usage('[--profile] <name> [options] [app-args...]\n       dsh plugin --profile <name> <pnpm-args...>')新增：显式声明两种形态
155    .description('dsh: boot a DeepSeek Harness profile — an ordered stack of plugin-bundle patch layers under your own overrides.')
156    .addHelpText('after', HELP_EXAMPLES)
157    .exitOverride()          // 不让 commander 直接 process.exit，改抛 CommanderError
161    .helpOption(false)       // launcher 自己禁用 -h：它属于应用
162    .helpCommand(false)      // 0.1.6-alpha.2 新增：也不接受 help 子命令保证 dsh help 交给应用
163    .allowUnknownOption()
164    .passThroughOptions()
165    .enablePositionalOptions()
166    .argument('[args...]', 'arguments for the booted profile\'s app ...')
167    .option('--profile <name>', 'the profile under $DSH_HOME/profiles to boot', selectProfile)0.1.6-alpha.2：加了去重校验器
168    .option('--from-default-profile <name>', ...)
169    .option('--patch <path>', ..., collect)
170    .option('--dump-config', ...)
171    .option('--dump-config-schema', ...)   // 0.1.7-rc.1 新增第三个 dump 开关
172    .option('--dump-default-config', ...)
173    .action((args: string[], options: BootOptions & { profile?: string }) => {
176      if (options.profile === undefined) {
177        if (args.some(argument => argument === '-h' || argument === '--help')) program.help()
178        program.error('error: --profile <name> is required')
179      }
180      const profile = options.profile
181      if (profile === '') program.error('error: --profile needs a name')
182      rejectElectronProfile(program, profile)
183      resolved = resolveBoot(program, profile, options, args)
184    })

111function resolveBoot(program: Command, profile: string, options: BootOptions, args: string[]): DshInvocation {
112  const patches = options.patch ?? []
113  if (patches.includes('')) program.error('error: --patch needs a path')
114  if (options.fromDefaultProfile === '') program.error('error: --from-default-profile needs a name')
115  const dumps = [options.dumpConfig, options.dumpDefaultConfig, options.dumpConfigSchema].filter(Boolean)0.1.7-rc.1：三个开关一起数
116  if (dumps.length === 0) {
117    return { mode: 'profile', profile, fromDefaultProfile: options.fromDefaultProfile, patches, args }主路径
118  }
119  if (dumps.length > 1) {
120    program.error('error: --dump-config, --dump-default-config, and --dump-config-schema are mutually exclusive')
121  }
125  if (args.length > 0) {
126    program.error(`error: config dumps take no app arguments, got ${args...}`)
127  }
128  if (options.dumpConfigSchema === true) {   // 0.1.7-rc.1 新增分支schema 先分流
129    return { mode: 'dump-config-schema', profile, fromDefaultProfile: options.fromDefaultProfile, patches }
130  }
131  const defaultOnly = options.dumpDefaultConfig === true
132  if (defaultOnly && patches.length > 0) {
133    program.error('error: --dump-default-config prints the bundle layers and takes no --patch')
134  }
135  return { mode: 'dump-config', profile, fromDefaultProfile: options.fromDefaultProfile, defaultOnly, patches }
136}
201    const expanded = first !== undefined && !first.startsWith('-') && first !== 'plugin'0.1.6-alpha.2：通用前缀展开
202      ? ['--profile', ...argv]
203      : argv
204    program.parse(expanded, { from: 'user' })
205  } catch (error) {
206    return process.exit(error instanceof CommanderError ? error.exitCode : 1)
207  }
209  if (resolved === undefined) throw new Error('dsh: no invocation resolved')
210  return resolved
211}