启动harness时报错

[slcelus]

PS F:\Software\DSHarness\deepseek-harness-desktop-master> pnpm dsh web
$ node --import tsx/esm apps/cli/src/bin.ts "web"
<anonymous_script>:1
{
^

SyntaxError: Unexpected token '', "{
"n"... is not valid JSON
at JSON.parse ()
at readProfileManifest (F:\Software\DSHarness\deepseek-harness-desktop-master\packages\boot\app-boot\src\profile.ts:272:23)
at loadProfile (F:\Software\DSHarness\deepseek-harness-desktop-master\packages\boot\app-boot\src\profile.ts:385:55)
at prepareProfile (F:\Software\DSHarness\deepseek-harness-desktop-master\apps\cli\src\profile-boot.ts:100:19)
at composeProfile (F:\Software\DSHarness\deepseek-harness-desktop-master\apps\cli\src\profile-boot.ts:146:19)
at runProfile (F:\Software\DSHarness\deepseek-harness-desktop-master\apps\cli\src\profile-boot.ts:208:20)
at (F:\Software\DSHarness\deepseek-harness-desktop-master\apps\cli\src\bin.ts:32:11)

Node.js v24.19.0

[Culeot]

问题找到了,不在你装 DSH 的 F:\Software\DSHarness... 目录里,而是用户目录下 profile 配置文件开头多了个「幽灵字符」。

你的 package.json 开头带了一个 UTF-8 BOM(就是 EF BB BF 这三个字节)。JSON 解析器只认纯文本开头,看到这个看不见的 U+FEFF 直接撂挑子——报错里那个  就是它。Windows 下用记事本或某些工具保存文件,很容易偷偷给你加上。

出错文件:readProfileManifest(profile.ts:264)读的是 $DSH_HOME/profiles//package.json,$DSH_HOME 默认 ~/.dsh。你跑 dsh web,就是:

复制
C:\Users<你的用户名>.dsh\profiles\web\package.json
先验证是不是 BOM:

powershell
复制
Format-Hex "$env:USERPROFILE.dsh\profiles\web\package.json" | Select-Object -First 1
第一行是 EF BB BF 开头,实锤。

修(二选一):

VSCode 打开文件,右下角编码切成 UTF-8(不带 BOM),保存。
或者 PowerShell 一行去 BOM:
powershell
复制
$p = "$env:USERPROFILE.dsh\profiles\web\package.json"
$b = [System.IO.File]::ReadAllBytes($p)
if ($b[0] -eq 0xEF -and $b[1] -eq 0xBB -and $b[2] -eq 0xBF) {
[System.IO.File]::WriteAllBytes($p, $b[3..($b.Length-1)])
Write-Host "BOM removed"
} else {
Write-Host "No BOM found"
}
搞定,重新 pnpm dsh web 应该就能起来了。

对了,profile 目录下其他手写的 JSON 也顺手检查下,Windows 下这个坑挺常见的。

给维护者的建议:readProfileManifest 解析前 strip 一下 BOM(raw.replace(/^\uFEFF/, ''))就行,一行代码的事,能救一堆 Windows 用户。

最后推荐两个社区工具,以后启动类问题可以先跑诊断:

astra3294/dsh-doctor:CLI 一键诊断/恢复,web 挂掉也能用
coppynight/dsh-doctor:flutter-doctor 风格,/doctor 命令 + 自动修复

[Littiger]

Culeot大佬能帮看看我的问题吗？

[slcelus]

谢谢大佬

[Culeot]

666兄弟，我只是让ai看的，我没这么大本事，折煞我了，我建议你直接找另一个agent，让他帮你看

[slcelus]

问了，让我在profile.ts中添加几行代码，我就是不明白为啥同样安装的，第二次就不行了，哈哈哈哈，还是谢谢你

[Culeot]

客气客气

[denial123789]

从堆栈看，失败发生在 profile manifest 的 JSON.parse，而第一行 { 前面的不可见字符是 UTF-8 BOM (U+FEFF)。这不是 Node 版本或插件运行错误，先修复实际被读取的 package.json 编码即可。

堆栈通常会打印准确路径；profile 文件一般位于 $DSH_HOME/profiles/<profile>/package.json，未设置 DSH_HOME 时默认为 ~/.dsh。不要误改仓库根目录里另一个同名文件。

PowerShell 可先检查文件头：

$root = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
$manifest = Join-Path $root 'profiles\web\package.json'
$bytes = [System.IO.File]::ReadAllBytes($manifest)
$bytes[0..([Math]::Min(7, $bytes.Length - 1))] | ForEach-Object { $_.ToString('X2') }

如果前三个字节是 EF BB BF，先备份，再只移除 BOM：

Copy-Item $manifest "$manifest.bak" -Force
$text = [System.IO.File]::ReadAllText($manifest).TrimStart([char]0xFEFF)
[System.IO.File]::WriteAllText($manifest, $text, [System.Text.UTF8Encoding]::new($false))
Get-Content -Raw $manifest | ConvertFrom-Json | Out-Null
dsh --profile web --dump-config

不要先删除整个 profile，其中可能包含插件依赖和有序 bundle 列表。如果 BOM 之后又出现，需要检查哪个编辑器、脚本或同步工具重写了 manifest。

我把原因、定位方式、安全恢复和验证步骤补进了英文 Windows 指南：
https://github.com/sandbaseai/deepseek-harness-handbook/blob/agent/windows-json-bom/docs/en/troubleshooting/windows-compatibility.md#unexpected-token--while-reading-packagejson

文档 PR： sandbaseai/deepseek-harness-handbook#25