runProfile：五层拼齐 + 热更新 + 信号

195async function composeProfile(
196  name: string,
197  patchFiles: readonly string[],
198  fromDefaultProfile?: string,
199  resolvedProfile?: ResolvedProfileRuntime,   // 0.1.6-alpha.2 新增应用自带的 profile
200): Promise<ComposedProfile> {
201  const profile = resolvedProfile?.profile ?? prepareProfile(name, true, fromDefaultProfile)
202  if (resolvedProfile !== undefined) writeFileSync(join(profile.dir, PROFILE_ROOT_FILENAME), PROFILE_ROOT_CONFIG)
203  const resolutionOptions = { installAnchor: resolvedProfile?.installAnchor ?? INSTALL_ANCHOR, profile }
204  const resolution = await createRuntimeResolution(resolutionOptions)   // 0.1.7：唯一路径不再有三态模式
205  const overlays = patchFiles.flatMap(file => loadOverlayPatches(NAME, resolve(file)))
206  return { profile, resolution, overlays }
207}

100export function initializeProfileFromDefault(
101  name: string,
102  fromDefaultProfile: string,
103  home: string = resolveDshHome(),
104): void {
105  const dir = resolveProfileDir(name, home)
106  const template = Object.hasOwn(PROFILE_TEMPLATES, fromDefaultProfile)
107    ? PROFILE_TEMPLATES[fromDefaultProfile]
108    : undefined
109  if (template === undefined) {
110    const expected = Object.keys(PROFILE_TEMPLATES).sort().map(value => JSON.stringify(value)).join(', ')
111    throw new Error(
112      `${NAME}: unknown default profile ${JSON.stringify(fromDefaultProfile)}; expected one of ${expected}`,
113    )
114  }
115  if (Object.hasOwn(PROFILE_TEMPLATES, name)) {出货名保留
116    throw new Error(
117      `${NAME}: profile ${JSON.stringify(name)} is shipped and cannot be a custom profile target; `
118      + 'omit --from-default-profile to use it',
119    )
120  }
121  mkdirSync(dirname(dir), { recursive: true })
122  try {
123    mkdirSync(dir)   // 独占创建：不用 recursive，目录已存在即 EEXIST并发安全
124  } catch (error) {
125    if ((error as NodeJS.ErrnoException).code !== 'EEXIST') throw error
126    const manifestPath = join(dir, 'package.json')
127    if (existsSync(manifestPath)) {
128      throw new Error(
129        `${NAME}: profile ${JSON.stringify(name)} already exists at ${manifestPath}; `
130        + 'omit --from-default-profile to use it',
131      )
132    }
133    throw new Error(
134      `${NAME}: profile directory ${dir} already exists; choose an unused profile name`,
135    )
136  }
137  try {
133    initProfile(dir, template.bundles)   // 0.1.6-alpha.2：patchReload 参数已移除
139  } catch (error) {
140    try {
141      rmSync(dir, { recursive: true, force: true })   // 失败即回滚，不留半成品原子性
142    } catch (cleanupError) {
143      throw new AggregateError(
144        [error, cleanupError],
145        `${NAME}: profile initialization failed and ${dir} could not be removed`,
146      )
147    }
148    throw error
149  }
150}

203  const resolutionOptions = { installAnchor: resolvedProfile?.installAnchor ?? INSTALL_ANCHOR, profile }
204  const resolution = await createRuntimeResolution(resolutionOptions)0.1.7：无分支

242export async function runProfile(options: RunProfileOptions): Promise<{ ctx; shutdown }> {
247  const disposeProxy = await installProxyFromEnvironment(  // HTTP 代理引导
248    options.environment,
249    (message) => { process.stderr.write(`${NAME}: ${message}\n`) },
250  )
252  const app: { current?: Context } = {}
253-261  // 单次幂等的 dispose（0.1.6-alpha.2 新增）聚合清理失败
262  try {
263    const composed = await composeProfile(
264      options.profile, options.patchFiles, options.fromDefaultProfile, options.resolvedProfile,
265    )
266    // 0.1.7：打包探测与 resolutionMode 三态判断已删除直接进 appReady
267    const shutdown = createProcessShutdown(dispose)
268    const signalShutdown = new AbortController()
278    process.on('SIGTERM', () => { interrupt(0) })
279    process.on('SIGINT', () => { interrupt(130) })
280    installFailLoud(NAME, process, async () => { await app.current?.fiber.dispose() })
284    const rootConfig = join(composed.profile.dir, PROFILE_ROOT_FILENAME)
285-293    const profileContext: ProfileContext = { ... }   // 交给 HMR 的 profile 事实热重载需要它
294    const ctx = await boot(NAME, rootConfig, readProfilePatches(NAME, profileContext, composed.profile), async (hostCtx) => {五层在这里组装
295      app.current = hostCtx
296      hostCtx.provide('profileContext', profileContext)
299      hostCtx.provide(DSH_LAUNCH_ENVIRONMENT_KEY, options.environment)
300-302      await hostCtx.plugin(PluginPackages, { resolution: composed.resolution })0.1.7：只传 resolution
305-309      provideCmdline(hostCtx, { args: options.args, exit: ..., ready: appReady.service })
310    })
311    app.current = ctx
312    if (!signalShutdown.signal.aborted
313      && ctx.fiber.state === FiberState.ACTIVE
314      && ctx.get('loader') !== undefined) {
315      appReady.commit()
316    }
317    return { ctx, shutdown }
318  } catch (error) {   // 启动失败也要清理
319    try { await dispose() } catch (cleanupError) {
320      throw new AggregateError([error, cleanupError], 'dsh: profile startup and cleanup failed')
321    }
322    throw error
323  }
324}

253  let disposal: Promise<void> | undefined
254  const dispose = (): Promise<void> => disposal ??= (async () => {??= 记忆化：只跑一次
255    const failures: unknown[] = []
256    for (const release of [() => app.current?.fiber.dispose(), disposeProxy]) {
257      try { await release() } catch (error) { failures.push(error) }
258    }
259    if (failures.length === 1) throw failures[0]
260    if (failures.length > 1) throw new AggregateError(failures, 'dsh: profile cleanup failed')
261  })()

198  async* [Service.init](): AsyncGenerator<() => Promise<void>, void, unknown> {
199    yield async () => {                      // disposer：先关 watcher
200      this.closing = true
201      await this.watcher?.close()
206    const profile = this.ownerContext.get('profileContext')   // ← 04 页 308 行 provide 的闭环在这里合上
207    if (profile !== undefined) {
214      const manifestPath = join(profile.dir, 'package.json')
215      const patchFiles = [profile.patchPath, join(profile.home, PROFILE_PATCH_FILENAME)]
218      const refresh = async (manifestOnly: boolean): Promise<void> => {
229        const patches = readProfilePatches('dsh', profile)
230        const warnings = await reconcileProfilePatches(this.ownerContext.root, patches, 'dsh')
235      for (const filename of patchFiles) await this.watchConfig(filename, () => refresh(false))
236      await this.watchConfig(manifestPath, () => refresh(true))
237    }