Deepseek harness增加桌面版端序列：命令解析pnpm dsh desktop的第一步

你在终端输入                    实际发生
─────────────────────────────────────────────────────────────
pnpm dsh desktop    ──►   package.json 的 "dsh" script
                            └─► node --import tsx/esm apps/cli/src/bin.ts desktop
                                    └─► parseDshArgs(argv) → DshInvocation
                                            └─► mode: 'profile', profile: 'desktop'
                                                    └─► bin.ts switch → spawnDesktop()

"dsh": "node --import tsx/esm apps/cli/src/bin.ts",

  #!/usr/bin/env node
  /**
    * dsh — command-line entry. Dynamic imports per mode keep unrelated modes out
    * of each dispatch path; the adapter prints and exits for
    * `--help`/`--version`/a parse error, so only a valid mode reaches the switch.
    * @module @deepseek-ai/dsh/bin
    */
   /* v8 ignore file -- built-bin acceptance exercises this self-executing dispatch. */
  import { readFileSync } from 'node:fs'
  import { fileURLToPath } from 'node:url'
  import { loadLayeredEnv } from '@deepseek-ai/dsh-app-boot'
  import { parseDshArgs } from './args.ts'
  // Both the source tree (apps/cli/src) and the bundled bin (apps/cli/lib) sit
  // one directory under apps/cli, so the checked-in manifest resolves with the
  // same relative hop from either artifact.
  /** This app's version, read from its checked-in package.json. */
  function readVersion(): string {
    const manifest = JSON.parse(
      readFileSync(fileURLToPath(new URL('../package.json', import.meta.url)), 'utf8'),
    ) as { version?: unknown }
    return typeof manifest.version === 'string' ? manifest.version : '0.0.0'
  }
  const invocation = parseDshArgs(process.argv.slice(2), readVersion())
  switch (invocation.mode) {
    case 'profile': {
      if (invocation.profile === 'desktop') {
        const { spawnDesktop } = await import('./spawn-desktop.ts')
        await spawnDesktop(invocation)
        break
      }
      const { runProfile } = await import('./profile-boot.ts')
      await runProfile({
        environment: loadLayeredEnv('dsh'),
        profile: invocation.profile,
        patchFiles: invocation.patches,
        args: invocation.args,
      })
      break
    }
    case 'plugin': {
      const { runPlugin } = await import('./plugin.ts')
      process.exit(runPlugin(invocation.profile, invocation.args))
      break
    }
    case 'dump-config': {
      const { runDumpConfig } = await import('./dump-config.ts')
      runDumpConfig(invocation.profile, invocation.defaultOnly, invocation.patches)
      break
    }
    default:
      invocation satisfies never
      throw new Error(`dsh: unhandled invocation mode ${JSON.stringify(invocation)}`)
  }

import { readFileSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
import { loadLayeredEnv } from '@deepseek-ai/dsh-app-boot'
import { parseDshArgs } from './args.ts'

function readVersion(): string {
  const manifest = JSON.parse(
    readFileSync(fileURLToPath(new URL('../package.json', import.meta.url)), 'utf8'),
  ) as { version?: unknown }
  return typeof manifest.version === 'string' ? manifest.version : '0.0.0'
}

const invocation = parseDshArgs(process.argv.slice(2), readVersion())

switch (invocation.mode) {
  case 'profile': {
    if (invocation.profile === 'desktop') {
      const { spawnDesktop } = await import('./spawn-desktop.ts')
      await spawnDesktop(invocation)
      break
    }
    ...

114  export function parseDshArgs(argv: readonly string[], version: string): DshInvocation {
115    let resolved: DshInvocation | undefined
118    const program: Command = new Command()
119    program
120      .name('dsh')
121      .version(version, '-V, --version', 'output the version number')
122      .description('dsh: boot a DeepSeek Harness profile — an ordered stack of plugin-bundle patch layers under your own overrides.')
124      .exitOverride()
128      .helpOption(false)
129      .allowUnknownOption()
130      .passThroughOptions()
131      .enablePositionalOptions()
132      .argument('[args...]', 'arguments for the booted profile\'s app (see: dsh --profile  --help)')
133      .option('--profile ', 'the profile under $DSH_HOME/profiles to boot')
134      .option('--patch ', 'extra patch-list overlay applied after the profile layer (repeatable)', collect)
135      .option('--dump-config', 'print the composed profile tree and exit')
136      .option('--dump-default-config', 'print the profile tree without its user layer or --patch overlays and exit')
137      .action((args: string[], options: BootOptions & { profile?: string }) => {
140        if (options.profile === undefined) {
141          if (args.some(argument => argument === '-h' || argument === '--help')) program.help()
142          program.error('error: --profile  is required')
143        }
144        const profile = options.profile
145        if (profile === '') program.error('error: --profile needs a name')
146        resolved = resolveBoot(program, profile, options, args)
147      })

173  const desktop = program.command('desktop').description('boot the desktop profile (alias of --profile desktop); spawns Electron')
174  desktop
175    .helpOption(false)
176    .allowUnknownOption()
177    .passThroughOptions()
178    .enablePositionalOptions()
179    .argument('[args...]', 'arguments for the desktop app (see: dsh desktop --help)')
180    .option('--patch ', 'extra patch-list overlay applied after the profile layer (repeatable)', collect)
181    .option('--dump-config', 'print the composed desktop-profile tree (with the user layer and any --patch) and exit')
182    .option('--dump-default-config', 'print the desktop profile\'s bundle layers (no user layer) and exit')
183    .action((args: string[], options: BootOptions) => {
184      rejectParentOptions('desktop')
185      resolved = resolveBoot(desktop, 'desktop', options, args)
186    })

# 1) 看 dsh 自身的帮助（注意：看不到 -h，因为 -h 属于 app）
cd D:\code\deepseek-harness
npx pnpm@11.7.0 dsh --help
# 2) 验证 desktop 是 --profile desktop 的别名（输出 Usage 首行即可证明）
npx pnpm@11.7.0 dsh desktop --help
# 3) 验证 dump 模式不接受参数
npx pnpm@11.7.0 dsh desktop --dump-config some-arg   # 应报错
# 4) 看 desktop profile 组合后的插件树（不启动 Electron，纯 Node 打印）
node apps/cli/lib/bin.js --profile desktop --dump-config | head -30