kita / notes
← 回到全部笔记

记录日期 阅读约 2 分钟

DSH 启动白屏报 requires options.id,顺着多 Profile 目录找对配置文件

发布于 · 修订

本文目录(2 节)
  1. 多 Profile 架构下的真实配置与依赖位置
  2. 改目录名与 --skip-plugins 的坑

打开 DSH(DeepSeek Harness)桌面端时,界面一直停在中间的转圈动画,控制台报错:

HARNESS   Failed to load plugins
@oil-oil/dsh-vision failed to apply loader entry 21cad614 (@oil-oil/dsh-vision):
list slot "settings.plugin.item" requires options.id

报错本身很明确:@oil-oil/dsh-vision 插件往 settings.plugin.item 插槽注册设置项时漏传了必填的 options.id,UI 插槽校验抛异常,把整个主界面启动流程顶停了。但我想把它禁用掉时,却在目录结构上绕了一大圈。

多 Profile 架构下的真实配置与依赖位置

一开始我按常规 Node 项目习惯去根目录找 dsh.config.json、plugins.json 和根目录下的 node_modules,全都没找到这个插件。

后来翻到用户主目录下的 deepseek/logs/server.log,才搞清楚它用的是多 Profile 目录结构:

  1. 真正生效的配置文件是对应 profile 下的 settings.yaml 和 whale-purse.settings.json。
  2. 插件包并不装在程序根目录,而是装在 profiles/<profile_name>/node_modules/@oil-oil/dsh-vision。

改目录名与 --skip-plugins 的坑

找到插件目录后,我先试着直接把文件夹改名成 dsh-vision.bak,结果白屏变成了进程直接退出:

dsh web exited with code 1 before serving

因为 settings.yaml 里的插件注册表还记着这个 loader entry,启动器按表加载时找不到包直接崩了。接着试命令行参数:

.\DeepSeekHarness.exe start --skip-plugins

以及环境变量 DSH_SKIP_PLUGINS=@oil-oil/dsh-vision,在当时的 rc 版本里都管不到已经写进 profile 状态文件的 loader 条目。正确的拆法是先在 profile 的 settings.yaml 里把 @oil-oil/dsh-vision 的注册项清掉(或者给它的插槽注册对象补上 id 字段),再去动 profiles/.../node_modules。

同一晚在 Windows 上调 DSH 还记下了两条环境边界:一是 terminal inspection is unsupported on platform win32(强依赖 UNIX pty/termios 的子模块在原生 Windows 下不可用,后来迁到了 Linux 服务器跑);二是把整晚日志塞进上下文时触发了 1048979 > 1048576 tokens(792,979 输入 + 256,000 预留 completion),哪怕是百万窗口也要留意 max_tokens 预留占掉的额度。

← 返回全部手记