企业官网建设流程全解析

DSH Desktop窗口模式怎么选？兼容、扩展与增强三模式横评+原生材质指南

【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop

DSH Desktop 是为 DeepSeek Harness（DSH）插件生态打造的现代化桌面端应用，提供兼容模式、扩展窗口、增强模式三种窗口呈现模式，并支持 macOS 透明材质与 Windows Mica 原生材质。本文横评三种桌面窗口模式的差异，帮你快速选到最合适的窗口模式，并附上原生材质的配置要点。

三种窗口模式，一句话说清

在 DSH Desktop 中，"窗口模式"决定了桌面外壳如何包裹官方 Web 客户端界面。三种模式的官方定义见 runtime.ts：

export type DesktopShellMode = 'compatibility' | 'extended' | 'advanced'

兼容模式：兼容性最好的默认之选

• 保留官方客户端完整布局，只在顶部加一条36 像素的独立 Desktop frame，可拖动、图标可点击
• 唯一支持"浏览器访问"的模式——用普通浏览器访问 Desktop 必须先切到兼容模式，相关逻辑见 desktop-network.ts
• Linux 上唯一可用的模式，跨平台稳定性最佳

默认 shell 模式即compatibility（见 profile.ts），新手和追求稳定的用户直接用它即可。

扩展窗口：玻璃侧边栏的倒 L 材质布局

扩展窗口（extended）会安装 Desktop 自有的布局与侧边栏表面，其中承载官方 sidebar、conversation 和 details 内容。36 像素顶部 frame 与左侧侧边栏组成一个带圆角内拐角的倒 L 材质区域，视觉一体感更强，官方内容区保持不变。

实现上，扩展窗口共享"独立框架"外壳逻辑，与兼容模式使用同一套框架代码，见 extended-shell.ts 与 advanced-shell.ts。

⚠️ 扩展窗口目前支持macOS 和 Windows，Linux 暂不可用（见 desktop-settings-locales.ts）。

增强模式：为桌面端深度优化的布局

增强模式（advanced）不复用扩展窗口的独立 frame，而是保留独立的 root 注册与紧凑内部 caption：

这些几何常量统一定义在 window-chrome.ts 中，便于跨平台精确对齐原生控件。

⚠️ 增强模式同样目前支持macOS 和 Windows。

三模式横评速查表

更多细节可阅读官方用户指南：docs/user-guide.md 的"窗口模式与材质"一节。

原生材质指南：macOS 透明 + Windows Mica

窗口材质与模式相互独立，由 window-material.ts 统一管理：

• macOS：默认透明材质（transparent），可随时关闭；Linux 上材质一律关闭
• Windows：默认关闭材质；仅 **Windows 11（build 22621 及以上）**在系统支持时显示Mica
• 旧版本的"亚克力（acrylic）"偏好已被移除，旧设置会安全降级为关闭并在设置文件可写时自动迁移，不会导致启动失败

切换模式的两个注意事项

1. 切换模式或材质都会有序重启应用——不会在运行中的界面里热替换窗口结构，重启后生效
2. 设置入口：在桌面设置中即可切换三种模式，每个选项都有明确的界面说明文案（文案定义见 desktop-settings-locales.ts）

总结：怎么选？

• 🏆刚上手 / 需要浏览器访问 / 用 Linux→ 兼容模式
• 🎨喜欢玻璃质感、想要一体化桌面视觉（macOS/Windows）→ 扩展窗口
• 🚀追求最贴近原生桌面应用的交互（macOS/Windows）→ 增强模式

三种模式都不会修改上游客户端源码，切换零成本，放心按需试错即可。

【免费下载链接】deepseek-harness-desktop为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness-desktop