DeepSeek Harness Agent 预设全加载失败:parent 未定义排查与规避
DeepSeek Harness(DSH)设置页里四个内置 Agent 预设同时显示「加载失败」,hover 全是同一句 Cannot read properties of undefined (reading 'parent')——这几乎可以断定不是你的预设配置写坏,而是预设注册表在 0.2.2-alpha.2 这条预览线上崩在了公共代码路径。 关键判据有三条:四个预设报完全相同的错、全新 DSH_HOME 且只有 @deepseek-ai/dsh-base 与 @deepseek-ai/dsh-web-app 也能复现、同机切到 0.2.1-rc.5 后四个预设全部正常。三条同时成立,排查方向就应该从「我的预设哪里写错了」转到「这个版本的注册表出了什么问题」(#11994)。
DeepSeek Harness 四个预设同时失败说明坏在注册表,而不是某个预设
一句话结论:预设加载是「先诊断、再展示」的流程,诊断由注册表统一对全部实现执行一次;任何一条祖先链断点都会让整批诊断失败,表现成四个预设一起挂。 据社区成员逐行核对 0.2.2-alpha.2 的打包产物,@deepseek-ai/dsh-agent-preset-registry 的 withinFiber(fiber, root) 实现如下:
function withinFiber(fiber, root) {
let current = fiber;
while (true) {
if (current === root) return true;
const parent = current.parent.fiber; // ← parent 为空时 TypeError
if (parent === current) return false;
current = parent;
}
}
leakedServices() 与 serviceForMount() 会对 root 服务 store 中的全部实现调用这个函数。只要有一条 fiber 的祖先链在某个跳跃点上没有 parent,抛出的 TypeError 就会让整批诊断整体失败——这就是为什么四个预设给出的是同一句报错,而不是各自不同的内容错误(#11994)。
这也解释了一个容易误判的现象:会话和聊天功能完全正常,只有预设选择不可用。预设诊断与聊天主链路是两条独立的初始化路径,前者挂了不会连带后者,所以「能聊天」不能拿来证明预设没问题。
用三步判据把注册表故障与单个预设写坏区分开
关键判据是:报错在四个内置预设上完全一致,且在没有任何第三方插件的最小环境里照样复现。 按下面顺序做:
- 开一个全新的
DSH_HOME做最小复现。 用临时目录起一个干净实例,避免把旧 profile 的残留带进来:
DSH_HOME=$(mktemp -d) npx @deepseek-ai/dsh@0.2.2-alpha.2 web --no-open
预期:首启初始化完成后打开 设置 → Agent 预设,四个内置预设(标准 / PTC / 极简 / 创造)仍然全部显示「加载失败」。
-
把鼠标挨个悬停在四个预设上,对比报错原文。 预期:四条 tooltip 完全相同,都是
Cannot read properties of undefined (reading 'parent')。如果四个预设报的是四种不同的错误(比如某个预设缺模型、某个预设缺工具),那才是预设内容问题,与本条无关。 -
确认 profile 里没有第三方插件。 profile 只应包含
@deepseek-ai/dsh-base和@deepseek-ai/dsh-web-app。如果此时仍复现,就可以排除「某个插件把服务 store 改坏了」这种解释;如果只有装了某个插件才复现,排查方向应转到插件侧。 -
同机同 profile 做一次稳定线对照。 这一步是整篇最有价值的一步,见下一节。
版本对照:为什么清缓存、换 Node 都改变不了结论
一句话结论:这条故障在 0.2.2 alpha 线的代码本身,不在安装来源、不在缓存、不在 Node 版本;同机切到 0.2.1-rc.5 即可自证。 报告者做过的隔离实验很完整,可以直接照抄:
-
删掉旧的 npx 安装副本。 原副本约 756MB,删除后避免复用旧的解包结果。
-
换一个全新的 npm 缓存目录全量重装。 预期:安装过程本身成功,但启动后四个预设依旧全部「加载失败」,tooltip 不变。这一步排除了「npm 缓存污染」。
-
在 Node v24.22.2(LTS)与 v26.13.0 上分别跑一遍。 预期:两个版本都复现。这一步排除了「Node 版本不兼容」。
-
在同一台机器、同一个 profile、同一个 Node 上运行
0.2.1-rc.5。 预期:四个预设全部正常加载、没有 broken 标记;同一实例里设置写入也能正常落盘到 profile patch。这一步把范围锁死在 alpha 线。
npx @deepseek-ai/dsh@0.2.1-rc.5 web --no-open
做完这四步,结论就只剩一个:0.2.2-alpha.2 引入了回归。至于是注册表这一处、还是同版本里还有别的初始化变更,需要维护者按 alpha 线 diff 继续查;用户侧不必再折腾环境(#11994)。
同一版本里还有第二个独立故障:设置改完立刻回弹
一句话结论:预设失败与设置回弹是两套机制,只是碰巧同版本同机出现;把两者合并成一个 bug 会让排查走偏。 在 0.2.2-alpha.2 里,切换通用设置的权限下拉、点首启「预览版说明」的「继续」,都会立即回弹,cordis.patch.yml 没有任何变化,界面也不报错。独立复现给出的证据是:/api/settings/mutate 返回 HTTP 200,但 RPC 层 ok: false,拒绝码 settings/rejected,message 为 next is not a function。
这指向 Cordis 4.0.6-alpha.2 的 internal/update 改成了两参数 (resolved, restart),而 dsh-app-boot@0.2.2-alpha.2 仍注册三参数 (_config, _noSave, next) 并调用 next(),第三个形参拿不到 continuation。要做的是核对实际解析到的 vendor 版本与 app-boot 的调用约定,而不是只比 DSH 版本号或清 npm 缓存。
预设这一支的处置办法不适用于设置这一支,反之亦然。设置写入的完整取证路径见 DeepSeek Harness 设置改了立刻回弹。
现在能做什么:回退稳定线、绕开弹窗、别手改注册表
一句话结论:在 alpha 线修复前,唯一完整可用的方案是回退到稳定线;手工补 welcomeNoticeVersion 只能绕开一个弹窗,不能恢复预设。 按优先级:
- 回退到
0.2.1-rc.5。 这是讨论里被验证过的方案:同机同 profile 下四个预设正常、设置写入正常:
npx @deepseek-ai/dsh@0.2.1-rc.5 web
-
如果只是想先跳过首启「预览版说明」弹窗,可以手工往 profile 的
cordis.patch.yml写入ui-settings-general.welcomeNoticeVersion。预期:弹窗不再出现。但要说清楚——这只是绕过欢迎弹窗,预设依然全部不可选,别把它当成修复。 -
不要手工去改预设注册表的产物文件。
withinFiber被打包进lib/index.js,手改产物既会破坏完整性校验,也会在下次安装时被覆盖,无法作为长期方案。 -
不要指望
0.2.2-alpha.3。 该版本的安装本身就会失败:npm i @deepseek-ai/dsh@0.2.2-alpha.3报ETARGET,因为它 pin 了一个从未发布的叶子包。细节见 DeepSeek Harness alpha 渠道安装报 ETARGET。 -
等官方修复后再升级。 判断标准很简单:升级后开全新
DSH_HOME,四个预设全部正常加载,且设置改动能落盘,两条都满足才算这版可用。
排查注意事项
这类「整批功能同时失效」的问题,最重要的原则是先找公共路径,再找个体差异。 六条要点:
- 先数失败的个数与报错是否一致:四个内置预设全挂且报错逐字相同 = 公共路径;只有某一个挂或报错各不相同 = 个体内容。
- 最小环境优先于阅读配置:全新
DSH_HOME+ 仅内置 bundle,比逐行读自己的 profile 快得多,也更能排除干扰。 - 对照实验比任何猜测都可靠:同一台机器换版本,其他变量全部不变,这是最干净的因果证据。
- 不要用「能聊天」证明预设没问题:预设诊断与聊天主链路独立,前者挂了后者照常。
- 不要把同版本的两个 bug 合并处理:预设与设置写入各有各的拒绝点,混在一起会同时失去两条线索。
- 修复状态要如实看待:截至该讨论,
0.2.2-alpha.2的预设加载失败未修复;alpha.3又因缺包无法安装。现阶段唯一被验证的出路是回退稳定线。
常见问题
DeepSeek Harness 的预设没有被写坏。四个内置预设同时报同一句 Cannot read properties of undefined (reading 'parent'),说明问题在预设注册表的公共代码路径上,与某一个预设的内容无关。社区核对 0.2.2-alpha.2 的打包产物后定位到 withinFiber 沿 fiber 祖先链上溯时裸读 parent,只要服务 store 里有一条祖先链断点,全部预设的诊断都会失败。
因为 DeepSeek Harness 这条故障不在安装来源与 Node 版本上,而在 0.2.2 alpha 线的代码本身。报告者用全新 npm 缓存重装、删除 756MB 的 npx 副本、在 Node v24.22.2 与 v26.13.0 上分别复现,结果一致;同机同 profile 切到 0.2.1-rc.5 后四个预设全部正常加载。对照实验说明清缓存和换 Node 都改变不了结论。
在 DeepSeek Harness 里,这两个故障不是同一个机制,只是恰好出现在同一版本、同一台机器上。预设失败来自 dsh-agent-preset-registry 的 withinFiber 空 parent 上溯;设置回弹来自另一组独立复现,/api/settings/mutate 返回 HTTP 200 但 RPC 拒绝码是 settings/rejected、message 为 next is not a function。两者应当分开取证,不要用修 settings 的办法去修预设。
截至该讨论,DeepSeek Harness 的 0.2.2 alpha 线没有修复,最实际的办法是回到 0.2.1-rc.5 稳定线,四个内置预设会全部正常加载。另一个被提到的本地手法是手工往 profile 的 cordis.patch.yml 写入 ui-settings-general.welcomeNoticeVersion 来绕开首启弹窗,但它只跳过欢迎弹窗,预设仍然不可选,不能当成修复。
相关术语
- Agent 预设(Agent preset)
- Agent 预设是 DeepSeek Harness 里一组预先配置好的 Agent 装配方案,包含模型、工具与行为策略的组合,用户可在设置页直接选择标准、PTC、极简、创造等内置预设来创建会话。预设本身是数据与装配描述,不是用户手写的配置文件。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994
- withinFiber
- withinFiber 是 @deepseek-ai/dsh-agent-preset-registry 内部用于判断某个 fiber 是否位于指定根 fiber 之下的辅助函数,做法是沿 current.parent.fiber 逐级上溯。0.2.2-alpha.2 的打包产物里该函数未对 parent 为空设防,是四个预设同时诊断失败的根因。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994
- fiber 祖先链
- fiber 祖先链是 DeepSeek Harness 插件运行时里由 parent 引用串起来的服务挂载层级,用于表达一个服务由谁挂载、归属于哪个根。上溯祖先链遇到空 parent 时,任何依赖这条链做归属判断的代码都必须显式判空,否则会抛 TypeError。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994
来源
- #11994 — [0.2.2-alpha.2] 内置 Agent 预设全部「加载失败」(Cannot read properties of undefined (reading 'parent')),且 settings 写入全部静默失败· deepseek-ai(GitHub Discussions)