westanke/dsh-desktop-deepin ↗★ 0
deepseek-harness-deepin
Deepin/UOS desktop shell for the DeepSeek Harness (dsh) agent runtime — community-maintained Linux build of the official desktop shell. 适合在Deepin或UOS等Linux系统下运行DSH桌面客户端的用户。
インストール
検証済み bundle がないか、互換性チェックに失敗しています。先にリポジトリの説明を読んでください。 README 全文を読む ↗
ドキュメント
README 全文を読む ↗配置
所有可调项集中在 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.* | 自动更新源（仅打包版生效） |