deepseek-harness-deepin

配置

所有可调项集中在 config.json，改它不用动代码。每个键旁边都有 _comment_* 中文说明，这里列出常用项：

配置文件有两份，改「生效的那份」（start-shell.sh 启动横幅里也会打印当前 用的是哪份）：

位置	权限	何时用
/opt/deepseek-harness-desktop/config.json	root 只读	全局默认，deb 安装自带，所有人共用
~/.config/dsh-desktop/config.json	用户可写	每用户覆盖份，优先生效

规则：读取顺序是用户覆盖份 → 全局份，键级合并（用户份有该键就用用户份的）。 多用户机器上不要改全局份（普通用户也改不动），把要改的键写进自己的覆盖份即可； 首次启动壳会自动创建覆盖份并把检测到的运行时路径写进去。改完重启壳生效。

launcher —— 怎么把壳拉起来

键	取值	说明
electron	路径	Electron 可执行文件。系统内核模式下它就是壳的运行环境，必填
systemDsh	路径	系统 dsh。Shell 把它作为 DSH_KERNEL_BIN 传给内核，即「系统内核模式」
nodeBinDir	目录	系统 node 所在目录，会被加进 PATH 供内核使用
userDataDir	路径	壳的 Electron userData 目录，日志也落这里。相对路径以壳根目录为基准
telemetryMode	DISABLED 等	传给环境变量 DSH_TELEMETRY_MODE

electron / systemDsh / nodeBinDir 三项可以由 bootstrap.sh install 自动写入， 不用手工填。装完 deb 跑一次自检即可。

kernel —— 内核怎么起、数据放哪

键	取值	说明
homeSubdir	路径	DSH_HOME 的位置。支持 ~ 展开（~/.dsh → /home/你/.dsh）；相对路径则拼在 userDataDir 下
profile	web 等	启动 profile
noOpen	true/false	true 表示不让 dsh 自己开浏览器，由壳加载页面
directoryPicker	auto/browse/native	auto 时：Linux 上有 zenity 或 kdialog 就用原生对话框，两者都没有则自动降级为浏览模式
exitPolicy	ask-always/ask-if-busy/never	退出确认策略。默认 ask-always 最保守（本壳无法像官方那样精确查询 Host 任务，故取保守档）

homeSubdir 的 ~ 展开是必须的：Node 的 path.isAbsolute('~/.dsh') 返回 false， 不展开就会被当成相对路径拼到 data-shell/ 下，生成一个名字字面叫 ~ 的空目录， 内核会在错误的 home 里启动、看不到你的任何插件。

supervisor —— 内核守护

键	默认	说明
maxRestartsInWindow	5	滚动窗口内最多重试次数，超出则放弃并报错
restartWindowMs	600000	重试计数的滚动窗口（10 分钟）
baseDelayMs	2000	首次重试延迟，之后每次翻倍
maxDelayMs	30000	重试延迟上限
readinessTimeoutMs	240000	单次启动等待内核打出 dsh web: 行的超时。实测本机内核启动耗时在 45~120 秒间波动（插件与 MCP 服务器串行初始化），原 90 秒不够，故放宽到 240 秒

renderer / tray / 其他

键	说明
renderer.maxRecoveries / recoveryWindowMs	渲染进程崩溃后自动 reload 的次数与窗口（默认 3 次 / 60 秒）
splashMinMs	启动页最短展示时长（默认 3000ms）。内核就绪后至少再停这么久，让你看清启动日志；0 表示就绪即切走
tray.summonAccelerator	全局快捷键，一键召唤/隐藏窗口（默认 CommandOrControl+Shift+Space）
tray.showBalance / rechargeUrl	是否显示充值入口及其地址
updates.*	自动更新源（仅打包版生效）

---