[Bug] 桌面端启动即崩：profile manifest 的 UTF-8 BOM 未被容忍；dsh plugin add 中断后无法自愈

[xinyuli815]

环境

项	值
产品	@deepseek-ai/dsh-desktop 0.2.1-rc.2
Electron / Node	44.7.0 / 24.21.0
系统	Windows 11 x64
Shell	仅 Windows PowerShell 5.1（pwsh 7 未安装）
触发	通过 GUI 安装第三方插件 dsh-dafeiyu@0.1.18 后重启应用

现象

安装插件后重启桌面端，应用无法启动，只留下一条崩溃日志：

DesktopHostFatalError: Unexpected token '锘?, "锘縶
    "n"... is not valid JSON
    at ChildProcess.<anonymous> (<INSTALL_DIR>/resources/app.asar/lib/main.js:3831:49)

SyntaxError: Unexpected token ... is not valid JSON
  at JSON.parse (<anonymous>)
  at readProfileManifest (app.asar/dsh/node_modules/@deepseek-ai/dsh-app-boot/lib/index.js:913:22)
  at loadProfileDirectory (...:1016:42)
  at main (.../@deepseek-ai/dsh-desktop-host/lib/index.js:224:18)

锘? 是 UTF-8 BOM（EF BB BF）被按 GBK 渲染的产物。日志里能直接看到原始字节：
Unexpected token '<EF BB BF>', "<EF BB BF>{\r\n。

最小复现

A. BOM 导致启动失败（可 100% 复现）

1. 在 <HOME>/.dsh/profiles/desktop/package.json 文件开头插入 UTF-8 BOM（3 字节 EF BB BF）。Windows 记事本、Visual Studio、PowerShell 5.1 的 Set-Content -Encoding utf8 都会这么做。
2. 启动 DeepSeek Harness Desktop。
3. 结果：启动阶段 fatal，应用起不来。删除 BOM 后立即恢复正常。

B. dsh plugin add 中断后重试无法补齐

1. dsh plugin --profile desktop add <某个声明了 dsh.bundle 的插件>
2. 在 pnpm 已把依赖写进 package.json、但命令还没结束时 kill 进程。
3. 重新执行同样的 add 命令：pnpm 报 + <pkg> <version>，退出码 0。
4. 结果：package.json 的 dependencies 有该插件，dsh.profile.bundles 里始终没有它 —— 插件"装了但没启用"，重试也不会修。

根因

1. readProfileManifest 不容忍 BOM，且解析异常不带路径

app.asar/dsh/node_modules/@deepseek-ai/dsh-app-boot/lib/index.js:905-916

function readProfileManifest(binName, dir) {
	const path = join(dir, "package.json");
	let raw;
	try {
		raw = readFileSync(path, "utf8");      // 只包装了 I/O 失败，并带 path
	} catch (error) {
		throw new Error(`${binName}: failed to read profile manifest ${path}: ${String(error)}`);
	}
	const parsed = JSON.parse(raw);            // :913 裸 parse：不剥 U+FEFF，异常也不带 path
	...
}

• Node 的 readFileSync(p, "utf8") 不会去掉 BOM，JSON.parse('\uFEFF{...}') 直接抛。
• BOM 在 Windows 上是合法的 UTF-8 写法，属于常见输入，不该等价于"配置损坏"。
• 更严重的是：loadProfileDirectory（:1015-1040）对每个 bundle 都有 try/catch → skippedBundles 降级，唯独清单本身没有降级路径。一个坏插件可以跳过，一个坏字节却让整个应用拒绝启动。

2. pwsh 工具静默降级到 PowerShell 5.1，但仍按 pwsh 7 宣称

app.asar/dsh/node_modules/@deepseek-ai/dsh-pwsh-local/lib/index.js:23-33

const candidates = [join(programFiles, "PowerShell", "7", "pwsh.exe")];
for (const entry of (env.PATH ?? "").split(";")) candidates.push(join(trimmed, "pwsh.exe"));
candidates.push(join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe")); // 5.1 兜底

而模型看到的工具描述（dsh-tool-pwsh/lib/index.js:255-258）仍是
"Execute a PowerShell command (pwsh -Command) … fresh pwsh process"，没有任何 5.1 提示。
两者编码语义不兼容（实测）：

写法	pwsh 7	Windows PowerShell 5.1
Set-Content -Encoding utf8	UTF-8 无 BOM	UTF-8 带 BOM EF BB BF
Out-File 默认	UTF-8 无 BOM	UTF-16LE FF FE
ENCODING_PREAMBLE（同文件 :100、:204）只为 5.1 修了标准输出解码，管不到写文件；$OutputEncoding 也不影响 Set-Content。于是一个在 pwsh 7 下完全正确的命令，在本机静默写出了 BOM。

3. reconcile 对"已存在但未登记的 bundle"永久跳过

app.asar/dsh/node_modules/@deepseek-ai/dsh-plugin-manager/lib/types/operations.js

// :497
// A terminated run's exit status says nothing about what it wrote,
// so it never reconciles the selection.
if (exitCode === 0 && !control.stalled) { ... }
// :106-108
for (const name of dependencies) {
    if (beforeDeps.has(name)) continue;   // 本轮之前就存在的依赖，永不补 bundles

• 中断的那一次：pnpm 先把依赖写进 package.json，进程被 kill → 不 reconcile → 留下 dep 有 / bundles 无。
• 重试那一次：beforeDeps 已包含该依赖 → continue → 永远补不上（实测清单 mtime 停留在中断那次的时间）。
• 于是用户/agent 只能手改 package.json —— 本次事故正是这样写入了 BOM。

4. 启动失败缺少上下文，且没有恢复入口

dsh-desktop-host/lib/index.js:224 直接调用，无 try/catch：

const profile = loadProfileDirectory("dsh", projectDir, installAnchor);

fatal 上报只取 error.message（同文件 :353-362），而 readProfileManifest 的 parse 异常恰好没有路径信息，所以弹窗/日志里只有一句裸 SyntaxError。产品也没有 "profile 损坏 → 用模板重建/回滚" 的路径。

影响

• 任何以带 BOM 方式保存过 <HOME>/.dsh/profiles/*/package.json 的用户（记事本、VS、PowerShell 5.1、某些同步/备份工具）都会让桌面端完全无法启动，且错误信息无法定位文件。
• 安装器中断后的半成品状态在产品内无法自愈，把用户和 agent 推向手改配置，风险外溢。
• 在未安装 pwsh 7 的 Windows 上（常见），模型无法感知自己实际运行在 5.1 上，同类编码事故（BOM、UTF-16）会反复发生。

建议修复

1. 读取端（最小、最有效）

   const parsed = JSON.parse(raw.replace(/^\uFEFF/, ""));

   并把 parse 包进带 path 的 try/catch；解析失败时降级到模板 + 明确告警，而不是 fatal。
2. 安装器自愈：仓库已有 runRecordPath(dir)（运行中写入、结束时删除）。启动一次操作时若发现残留 run record，说明上次被中断 → 强制做全量 reconcile，而不是用 beforeDeps 跳过。
3. shell 契约：无 pwsh 7 时，在工具描述/返回值里显式标明 "shell = Windows PowerShell 5.1"，并提示 -Encoding utf8 会写 BOM（Out-File 默认 UTF-16）；或直接内置/要求 pwsh 7。
4. 可诊断性：fatal 消息带上清单路径和一句可执行的修复建议（例如备份并重建 profile 的命令）。

附：崩溃日志原文

time: 2026-10-18T14:03:28.579Z
source: host
phase: startup
app: @deepseek-ai/dsh-desktop 0.2.1-rc.2
platform: win32 x64
electron: 44.7.0
node: 24.21.0
--- error ---
DesktopHostFatalError: Unexpected token '锘?, "锘縶
    "n"... is not valid JSON
    at ChildProcess.<anonymous> (file:///<INSTALL_DIR>/resources/app.asar/lib/main.js:3831:49)
    at ChildProcess.emit (node:events:514:28)
    at emit (node:internal/child_process:989:14)
    at process.processTicksAndRejections (node:internal/process/task_queues:91:21)
--- host diagnostic (as reported by the Host process) ---
SyntaxError: Unexpected token '锘?, "锘縶
    "n"... is not valid JSON
    at JSON.parse (<anonymous>)
    at readProfileManifest (file:///<INSTALL_DIR>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-app-boot/lib/index.js:913:22)
    at loadProfileDirectory (file:///<INSTALL_DIR>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-app-boot/lib/index.js:1016:42)
    at main (file:///<INSTALL_DIR>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/index.js:224:18)
    at file:///<INSTALL_DIR>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/index.js:353:23
    at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
    at async ModuleLoader.import (node:internal/modules/esm/loader:647:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/process/run_main:101:5)
--- renderer console (error level, oldest first) ---
(no error-level renderer console output was captured)