v0.3.5

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.1-rc.2

更新内容

依赖与运行时

• 全量升级 @deepseek-ai/dsh* 依赖至 0.1.1-rc.2。
• 修复打包应用运行时插件模块缺失问题。
• 版本管理安装与切换时自动保持 DSH 插件族版本一致。
• 同步 native 依赖构建脚本白名单，提升 npm 12 安装兼容性。

安装

从 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名，首次打开如遇拦截，请右键选择“打开”，或前往“系统设置 → 隐私与安全性”放行。

v0.3.4

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

Note

更新提示：若您当前正在使用 v0.3.3，由于旧版本中存在自动重启退出拦截逻辑，在自动下载完更新提示「立即重启」时需手动退出应用一次以完成替换，或建议直接在本 Release 下载最新的 DMG 安装包进行覆盖升级。从 v0.3.4 开始已彻底修复此问题，后续版本均支持 100% 自动平滑重启升级。

更新内容

新增

内置斜杠命令说明汉化（中文提示与热切换）

• 新增内置斜杠命令（/compact、/plan、/permission、/export、/feedback、/goal 等）的中文说明提示扩展，在会话中输入 / 即可获得清晰直观的中文功能指引。
• 采用双向动态热切换机制，支持在设置面板中一键开启/关闭，修改后立即生效无需重启服务或刷新窗口。
• 切换路径：顶部菜单栏 DSH → 设置…（快捷键 ⌘,）→ 通用 → 命令说明汉化。

全量中英文双向实时同步

• 系统主菜单栏（macOS Menu Bar）与独立设置管理窗口全面支持双语国际化（简体中文 / English）。
• 实时跟随 DSH Web 宿主语言偏好设置，在宿主设置中切换「中文」或「English」时，菜单栏与管理设置页所有面板、卡片、徽标与提示信息自动无缝同步切换。

README 架构与视觉预览升级

• 全新优化 README 结构与排版布局，新增 Claude Code 暖色风主题以及通用设置、版本管理、插件管理高清界面图示与详细指引。

修复

自动更新重启流程

• 修复了自动更新下载完成后因退出保护逻辑冲突导致主进程无法自动退出的问题，保障后续版本无缝平滑自动升级体验。

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.3.3

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

新增

内置界面主题支持（Claude Code 暖色风）

• 新增「Claude Code 主题」，深度定制 warm paper 纸感调色板（#FAF9F5 / #1F1E1D 暖底色、#D97757 陶土橙品牌主色、#ECEBE6 中性文本色与专属 Hero 发光光晕）。
• 保留 DSH 原生排版、字阶与交互布局，支持一键即时无缝换肤。
• 切换路径：顶部菜单栏 DSH → 设置…（快捷键 ⌘,）→ 通用 → 界面主题。

第三方主题与皮肤全链路防冲突锁定体系

• 全层级智能识别：覆盖 Cordis Theme 服务层、Profile package.json 配置层、__ModuleLoader__ 模块加载层以及 DOM/CSS 皮肤特征，精准识别第三方主题与各类独立皮肤插件（如 @dsh-external/dsh-client-ui-skin-*）。
• 自动熔断与冲突规避：检测到外部主题生效时，宿主立即熔断跳过内置主题 Token 注入；管理设置面板同步锁定切换并以纯净默认主题呈现，防止样式层叠污染。
• 全自动实时感知与无感还原：结合文件监听（Profile Watcher）、模块加载钩子与 DOM MutationObserver，安装第三方主题时立即自动置灰禁用；卸载后立即解除锁定并自动还原回用户原先设定的主题偏好。

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.3.2

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

• 在通用设置中新增 「DSH 启动端口」 配置项（默认 3080，支持 1024~65535 范围自定义），持久化保存后重启服务生效。

• 服务启动时自动透传 --port 参数，应用窗口无缝连接到指定端口。

• 当用户将端口设置为非默认的 3080 端口时，系统会弹出与 macOS 系统风格一致的警示对话框。

• 详细说明修改端口对系统提示词（System Prompt）注入与大模型上下文缓存（Prompt Cache）有效期的影响，以及对外部插件/工具调用的潜在影响，需用户二次确认后方可修改。

• 管理窗口侧边栏重构为三大功能分区：「通用」、「版本」、「插件」。

• 将自动更新开关、npm 镜像源地址和启动端口整合至「通用」面板中，权责划分更清晰。

• 将原「帮助」菜单中的「设置」（原为「dsh 版本管理…」）、「重启 dsh 服务」与「检查更新…」移至应用主菜单（macOS DSH 菜单），更加符合 macOS 系统交互习惯。

• 为菜单项与系统托盘菜单集成了专属矢量图标。

• 品牌规范合规：全面遵从 DeepSeek 官方开源生态规范（BRAND_GUIDELINES），应用名称统一采用官方推荐的缩写 DSH，避免使用完整注册商标字标引发官方背书误解。

• Logo 视觉升级：设置页左上角 Logo 升级为 [小鲸鱼] DSH [DESKTOP]，采用全大写现代几何粗体与紧凑的黑色胶囊徽章，并完美适配明暗主题自动反白。

• 定制 macOS 经典白银外置磁盘驱动器造型与 DSH 专属浮雕水印图标，使挂载到桌面时的磁盘图标小巧精致，比例协调。

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.3.1

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

新增

切换到高于内置版本时二次确认

• 在版本管理器中切换到比本应用内置版本（当前 0.1.0-rc.7）更高的 DSH 版本时，弹出确认框提示兼容性风险，用户确认后才执行切换。
• 避免误切到未经本应用充分适配的新版本导致异常。

修复

避免 dsh 服务启动时自动打开系统浏览器

• 上游 @deepseek-ai/dsh 自 0.1.0-rc.8 起新增默认行为——dsh web 就绪后会自动打开默认浏览器（deepseek-ai/deepseek-harness#2410）。桌面壳自己托管窗口，无需额外打开系统浏览器。
• 桌面壳在启动 dsh 服务时追加 --no-open 参数，阻止其自动打开浏览器。
• 兼容处理：--no-open 仅在上游 0.1.0-rc.8 及以后支持（更早版本会拒绝未知参数导致启动失败），因此会根据当前运行的 dsh 版本判断：
  • >= 0.1.0-rc.8 → 传 --no-open，不打开浏览器
  • <= 0.1.0-rc.7 → 不传，保持原有行为（兼容旧版本，避免崩溃）

说明

• 当前内置基线版本仍为 0.1.0-rc.7；切换到 rc.8 及以上版本时自动生效。

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.3.0

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

修复

• 内置桥接插件在插件市场将其卸载后可自动恢复：新增 30 秒轮询检测，缺失时自动重装；本地文件系统插件（file:/link: 等）不再被 npm 预检误判为包名，修复自愈重装失效的问题
• 轮询自愈需要重启 dsh 服务前会弹窗确认「稍后 / 立即重启」，避免打断当前进行的工作（仅运行期提示，启动时静默自愈）

新增

桌面任务完成通知

• 当 Agent 执行耗时任务时，如果应用窗口失去焦点或被隐藏（关闭到 Dock），任务完成后会弹出系统通知提醒你
• 窗口前台聚焦时不打扰（不弹通知），仅在失焦/隐藏时提醒
• 点击通知可唤回窗口
• 通知内容：任务完成 + 会话标题 + 工作区名

通知权限提前预热

• 首次启动即请求通知权限，避免使用中途突然弹权限提示
• 仅首次触发一次，之后启动不再重复请求

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.2.9

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

修复

内置桥接插件的自愈重装失效

• 问题：插件市场可卸载内置的 dsh-desktop-host 桥接插件，导致 ready/主题上报等功能失效；自愈能发现缺失，但重装时失败。
• 根因：addPlugin 的 npm 预检把 file:/本地路径 误当成 npm 包名去 registry 查询 → 404 → 抛「未找到 npm 包」，重装中断。
• 修复：addPlugin 对本地文件系统 spec（file:/link:/workspace:/相对路径）跳过 registry 预检，只对真实 npm 包名校验。自愈重装恢复正常。

运行期自愈轮询

• 新增 30 秒轮询检测桥接插件是否仍安装：被卸载后自动重装（启动自愈仍是主防线，轮询兜底运行期被卸）。

重启前确认（避免打断工作）

• 轮询自愈需要重启 dsh 服务前，弹窗询问「是否现在重启」，可选「稍后 / 立即重启」。
• 选「稍后」则插件已装好、暂不重启、不打断当前进行的工作；选「立即重启」才重启服务。
• 仅运行期轮询提醒；启动时自愈静默处理（应用刚启动，无工作可打断）。

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.2.8

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

样式

管理窗口 UI 优化

• 主按钮 Hover 交互：恢复经典极简黑白底色，悬浮时明显提亮（#323742）并叠加立体微阴影，反馈清晰分明。
• 内置按钮 Tooltip 修复：解决 Chromium 禁用表单元素拦截原生 hover 的问题，稳定弹出系统气泡提示。
• 开关控件宿主化：开状态纯黑底配白滑块，关状态白底细边框配灰滑块，切换时完全静默无提示。
• 状态条精简与悬浮滚动：无消息时不占位，有消息时以 32px 紧凑实体卡片置于页面顶部，内容滚动时优雅 sticky 悬浮且不透光叠印。
• 内置插件按钮布局统一：将「内置」灰色徽标改为禁用态按钮，与卸载按钮对齐；点击提示「应用内置核心插件，由桌面宿主统一管理」。

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.2.7

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

样式

• 管理窗口 UI 进一步优化，与宿主应用设计语言对齐：重构版本列表条目（激活态「当前运行」徽标、独立操作区、加载中/卸载中态）、统一组件风格，提升界面一致性与可读性

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。

v0.2.6

非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7

更新内容

修复

• 桥接插件在应用移动/重装后不再失效：此前仅在 file: 目标已删除（clean-dist 场景）时才自动重指向；若应用整体被移动或重装到新路径，旧 bundle 可能仍在磁盘上导致版本不匹配的桥接被继续锁定。现在只要 spec 不再指向本实例的 bundle 即自动重指向并重装，同时覆盖「目标已删除」与「应用被移动/重装」两种场景

样式

• 管理窗口 UI 与宿主应用设计语言对齐：换用 dsh 设计 token 调色板（DeepSeek 蓝主色、偏蓝中性色、半透明发丝边框、16/12 圆角、画布分层、模糊顶栏）
• 中性的侧边栏选中态、弱化的危险/禁用按钮、无边框徽标、着色插件图标、蓝色开关、caption 风格分区标题
• 用自研组合框替换无法定制的原生 datalist：可编辑输入 + 风格化下拉（焦点/点击/外部点击/Esc 处理）

安装

从本 Release 下载对应架构的 DMG 或 ZIP 安装。

macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。