Releases: krystal-cao/deepseek-harness-desktop
Release list
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 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。
v0.2.5
非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7
更新内容
修复
- 插件安装失败时完整显示 pnpm 真实诊断（404、依赖冲突等），不再只显示 'pnpm failed' 包装行
- 安装 npm 源插件前先检查包是否存在：拼写错误或未发布的包会立即给出中文提示，无需等 pnpm 跑完报 404
维护
- 测试工作流升级到 actions v5 + Node 24，消除 Node 20 弃用警告
安装
从本 Release 下载对应架构的 DMG 或 ZIP 安装。
macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。
v0.2.4
非官方社区封装，基于官方 @deepseek-ai/dsh@0.1.0-rc.7
更新内容
修复
- 插件更新改用 pnpm 原生 update（不再用 add 模拟），GitHub 源插件明确拒绝自动更新并给出提示
- 内置桥接插件死引用自愈守卫：当 profile 中的 file: 引用指向已被 clean-dist 删除的路径时，启动时自动改写为当前实例的 bundle 路径并重装
- 中文 README 同步版本号描述（不再硬编码 rc 版本，避免再次过时）
重构
- 抽取 dsh 版本管理 IPC 为独立可测试模块（version-manager-api），行为不变
- 增加版本管理 API、插件更新路径等单元测试（124 个测试全过）
安装
从本 Release 下载对应架构的 DMG 或 ZIP 安装。
macOS 构建为 ad-hoc 签名、未经 Apple 公证，首次打开请右键选择「打开」或前往「系统设置 → 隐私与安全性」放行。