v0.1.2-alpha.5

Open DeepSeek Harness Desktop v0.1.2-alpha.5

Open DeepSeek Harness Desktop 是由 FLAQ AI 独立维护的社区桌面发行版，基于开源 DeepSeek Harness 构建，并非 DeepSeek 官方产品。

本版本将核心基线更新至官方 DeepSeek Harness 0.1.2-alpha.5，包含 alpha.2～alpha.5 的累计更新，并新增插件快照回退、自定义应用与托盘图标，进一步完善插件故障恢复和外部工具安装保护。

这是 Alpha 预发布版本。建议升级前备份重要配置与会话；插件快照不能替代完整数据备份。

桌面版新增与增强

插件快照：出问题后，多一个回到可用状态的选择

插件安装、更新或卸载前，客户端会自动保存插件部署状态，并提供手动创建和管理快照的入口。

• 保存插件依赖清单、精确锁文件、构建许可及相关隔离状态。
• 自动识别内容相同的快照，避免重复备份；保留最近 10 个不同的自动状态。
• 客户端完整启动成功后，记录最近的可启动状态。
• 诊断页默认展示最近 3 个回退点，可以展开查看和管理。
• 即使主界面无法启动，也能从启动错误页进入快照恢复。

恢复时会暂停 Harness，先建立安全回退点，再按锁定版本恢复依赖并执行健康检查。只有客户端和事件分发均就绪，才将恢复视为成功；失败时尝试撤销本次恢复，无法确认安全状态时保留恢复入口。

默认优先使用本地缓存离线恢复；缓存不足时，需要用户明确同意才会联网重试。

快照不复制 node_modules，也不会回退会话、凭据、settings.yaml、用户 Patch 或插件业务数据。 丢失的本地插件源码仍需用户自行提供。

自定义应用与托盘图标

Windows 和 macOS 用户可以在通用设置中选择图片，自定义应用图标与托盘图标。

• 支持 PNG、JPEG 图片选择、裁剪和预览。
• 保留透明度，并按系统展示方式处理圆角与留白。
• 支持分别设置应用和托盘图标，以及恢复默认图标。
• 修改后无需重启 Harness，偏好会在下次启动时保留。
• 图标保存在客户端本地，不修改应用安装包，也不随配置目录切换而丢失。

不同系统位置的生效范围会单独提示。Windows 已固定的任务栏快捷方式可能需要重新固定；macOS 修改的是运行时 Dock 和菜单栏图标，不会改写 Finder 中的应用包图标。

诊断与恢复继续加强

在原有依赖安全检查基础上，进一步覆盖“插件装着，但实际加载不起来”的情况：

• 识别带作用域包名与 Loader 引用名称不匹配的问题。
• 识别聚合插件内部依赖缺失，并追踪到责任插件。
• 改进缺失模块和失效 Loader 的诊断与隔离，减少故障在启动阶段反复出现。
• 增加 settings.yaml 格式错误诊断，并提供备份原文件后重置设置的恢复操作。
• 诊断演练新增对应故障场景，用于验证发现、归因、恢复和清理流程。

设置重置会保留原文件备份，但需要重新配置相关设置；不会将其伪装成“无损修复”。

外部工具安装使用经过验证的兼容版本

Codex 与 Claude Code 仍由用户在“外部工具”中按需联网安装，本版本加强了安装版本的选择与校验：

• 使用经过审核的精确 Provider 和运行时版本，不再假定所有关联包都发布了相同版本。
• 支持读取经过签名验证的兼容版本清单。
• 检查签名身份、内容摘要、有效期及客户端兼容范围。
• 网络或校验失败时，回退到安装包内置的已知可用版本，不盲目安装 latest。
• 改进兼容清单发布与访问方式，减少元数据不可用导致的安装问题。

桌面版重点修复

• 修复 Windows 插件安装完成后，命令强制退出可能触发 UV_HANDLE_CLOSING 原生断言的问题；现在会等待 Node 完成句柄清理后退出。
• 修复启动诊断早于 Profile 模块回退链接准备，可能把可用模块误判为缺失的问题。
• 改进插件快照的去重、无变化清理和启动预装批次处理，减少重复回退点。
• 改善隔离管理界面的滚动条，以及合并上游后的社区界面样式兼容。

同步官方 alpha.2～alpha.5 更新

会话与连接体验

• 连接异常现在有明确状态提示，并支持自动重试和立即重连。
• 会话标题区域可以查看活动的定时计划。
• 长会话导航支持预览并跳转尚未载入的分页轮次。
• 回答末尾展示 Token 用量与耗时，并可展开查看详细统计。
• 优化长会话的内存占用、流式渲染、代码高亮和实时消息处理。
• 改善菜单、滚动条、工具文件链接与差异统计。

模型、插件与子代理

• 插件列表按会话插件和全局插件分组，支持切换与搜索 Agent 预设。
• 自定义模型发现复用 Profile 请求头，模型目录支持搜索和筛选。
• 父 Agent 与可持续子 Agent 可以通过 send_message 双向交换后续消息。
• Python SDK、Headless、ACP 与自定义 Profile 默认提供 web_fetch。

图片与交互修复

• 修复会话运行中追加或排队发送图片时的回显与投递问题。
• 可持续子代理的后续消息支持携带图片。
• read_image 可以根据内容识别没有扩展名的图片附件。
• 修复 @ 菜单下钻目录时路径或目录导航路径丢失的问题。
• 命令菜单支持通过 Tab 补全当前高亮的斜杠命令。
• 修复后端暂时卡顿被误判为网络断开，以及窄窗口下定时计划列表越界的问题。
• 修复 Node.js 24.0～24.11.1 上的部分启动与热更新问题。

升级后的启动与会话标题修复

同步 alpha.5 的重点修复：从旧版本升级时，旧会话缓存可能导致应用启动失败，或会话列表标题丢失。

• 兼容读取相关旧版本会话缓存。
• 对缺少必要继承信息的分叉会话缓存，重新从会话记录构建。
• 对无法通过结构校验的缓存条目，先备份再跳过，避免单个坏缓存阻止启动。

这里处理的是派生缓存，不是删除原始会话记录。

预置插件更新

相较 v0.1.2-alpha.1.1：

• dshmarket：1.38.1 → 1.40.0
• @xmanrui/dsh-im：4.2.1 → 4.7.0

Better Sidebar、Pocket 与 Skill Picker 的预置版本保持不变。另增加两个仅供诊断演练使用的离线故障样本，不作为普通功能插件启用。

预置归档继续使用固定版本与 SHA-512 完整性校验。

升级与兼容性提醒

• 曾手动使用 SQLite Session 后端的用户请注意：上游已移除该可选会话持久化后端。原数据不会被删除，但需要先使用旧版本导出，不能假定新版会自动迁移。默认 JSON 会话不受此项移除影响。
• 插件开发者请关注上游会话 API 变化：Session.events 已由按需读取接口取代，并加强了 SessionSeq 与 SessionLogOffset 的类型区分。
• Web PTC Mode 默认不再向模型提供通用 workflow 工具。
• 如果升级后插件被隔离，请先查看诊断原因，选择兼容版本、修复、卸载或快照回退，不建议直接删除整个数据目录。

欢迎提交问题、建议和诊断报告。反馈时请尽量附上系统版本、安装包名称、操作步骤与客户端日志，并先移除其中的凭据和私人信息。

项目仓库：
https://github.com/flaqai/open-deepseek-harness-desktop

上游项目：
https://github.com/deepseek-ai/deepseek-harness

Open DeepSeek Harness Desktop v0.1.2-alpha.5

Open DeepSeek Harness Desktop is an independently maintained community desktop distribution by FLAQ AI, built on the open-source DeepSeek Harness. It is not an official DeepSeek product.

This release updates the core baseline to the official DeepSeek Harness 0.1.2-alpha.5, incorporating the cumulative updates from alpha.2 through alpha.5. It also introduces plugin snapshot rollback and custom application and tray icons, while strengthening plugin recovery and external tool installation safeguards.

This is an Alpha prerelease. Back up important configurations and conversations before upgrading. Plugin snapshots are not a substitute for a complete data backup.

Desktop Features and Enhancements

Plugin Snapshots: Another Way Back to a Working State

Before installing, updating, or uninstalling plugins, the client automatically saves the plugin deployment state. You can also create and manage snapshots manually.

• Preserve plugin dependency manifests, exact lockfiles, build approvals, and related quarantine state.
• Detect identical snapshots to avoid duplicate backups, retaining the 10 most recent distinct automatic states.
• Record the latest bootable state after the client completes startup successfully.
• Show the three most recent rollback points on the Diagnostics page by default, with an option to expand and manage the full list.
• Access snapshot recovery from the startup error page even when the main interface cannot load.

Recovery pauses Harness, creates a safety rollback point, restores dependencies at their locked versions, and runs health checks. Recovery is considered successful only when both the client and event dispatch are ready. If it fails, the client attempts to undo the recovery; if a safe state cannot be confirmed, recovery options remain available.

Recovery prioritizes the local cache for offline operation. If required cached packages are missing, an online retry requires explicit user consent.

Snapshots do not copy node_modules or roll back conversations, credentials, settings.yaml, user patches, or plugin application data. Missing local plugin source code must still be supplied by the user.

Custom Application and Tray Icons

Windows and macOS users can select images in General Settings to customize application and tray icons.

• Select, crop, and preview PNG or JPEG images.
• Preserve transparency and apply platform-appropriate rounded corners and padding.
• Set application and tray icons separately, or restore the defaults.
• Apply changes without restarting Harness, with preferences retained across launches.
• Store icons locally in the client without modifying the application package or losing them when switching configuration directories.

The interface reports which system locations each change affects. Pinned Windows taskbar shortcuts may need to be pinned again. On macOS, changes apply to the running application's Dock and menu bar icons, not the application bundle icon shown in Finder.

Stronger Diagnostics and Recovery

Building on the existing dependency safety checks, this release covers more cases where a plugin is installed but cannot actually load:

• Detect mismatches between scoped package names and Loader references.
• Identify missing internal dependencies in composite plugins and trace them to the responsible plugin.
• Improve diagnosis and quarantine of missing modules and invalid Loader entries, reducing recurring startup failures.
• Detect malformed settings.yaml files and offer a recovery action that backs up the original file before resetting settings.
• Add corresponding fault scenarios to the Diagnostics Lab to verify detection, attribution, recovery, and cleanup.

Resetting settings preserves a backup of the original file, but affected settings must be configured again. It is not presented as a lossless repair.

Verified Compatible Versions for External Tool Installation

Codex and Claude Code remain optional online installations under “External Tools.” This release strengthens version selection and verification:

• Use reviewed, exact Provider and runtime versions instead of assuming all related packages publish matching version numbers.
• Support signature-verified compatibility manifests.
• Verify the signing identity, content digest, validity period, and supported client versions.
• Fall back to known-working version pins included with the installer if network access or verification fails, rather than blindly installing latest.
• Improve compatibility manifest publishing and access to reduce installation failures caused by unavailable metadata.

Key Desktop Fixes

• Fixed a Windows issue where forcibly exiting a command after plugin installation could trigger the native UV_HANDLE_CLOSING assertion. Commands now allow Node to finish handle cleanup before exiting.
• Fixed startup diagnostics running before Profile module fallback links were prepared, which could incorrectly classify available modules as missing.
• Improved plugin snapshot deduplication, cleanup of unchanged states, and batched startup plugin provisioning to reduce duplicate rollback points.
• Improved scrollbars in quarantine management and community interface styling compatibility after the upstream merge.

Official alpha.2–alpha.5 Updates

Conversations and Connectivity

• Connection failures now have clear status indicators, automatic retries, and an immediate reconnect action.
• Active schedules can be viewed from the conversation header.
• Long-conversation navigation can preview and jump to paginated turns that have not yet loaded.
• Responses show token usage and elapsed time, with expandable detailed statistics.
• Reduced memory usage and improved streaming rendering, syntax highlighting, and live-message processing in long conversations.
• Improved menus, scrollbars, tool file links, and diff statistics.

Models, Plugins, and Subagents

• Plugin lists are grouped by conversation and global scope, with Agent Preset switching and search.
• Custom model discovery reuses Profile request headers, and the model catalog supports search and filtering.
• Parent Agents and continuable child Agents can exchange follow-up messages in both directions through send_message.
• Python SDK, Headless, ACP, and custom Profiles provide web_fetch by default.

Image and Interaction Fixes

• ...

v0.1.2-alpha.1.1

Open DSH Desktop v0.1.2-alpha.1.1

这是 v0.1.2-alpha.1 的桌面增强与修复版本，仍以官方 DeepSeek Harness dsh-v0.1.2-alpha.1 为核心基线。本版本没有合并官方 0.1.2-alpha.2 或 0.1.2-alpha.3，因此采用 alpha.1.1 标识，避免与上游版本混淆。如有问题，欢迎反馈！

主要增强

• 更安全的数据目录管理：首次导入官方配置或全新开始时，可使用客户端默认目录，也可选择空文件夹作为独立配置目录；完成设置后还能在通用设置中安全切换桌面独立目录、官方目录、其他现有 DSH 目录，或在空文件夹中创建新环境。切换不会复制、合并、覆盖或删除原目录数据。
• 首次设置加入手机访问引导：初始化流程可以继续完成局域网手机访问和 IM 连接相关配置。
• 隔离问题更容易发现和恢复：插件在安装后或重启时被隔离，会显示明确通知、责任插件和恢复入口；诊断中心能够清理失效的隔离卸载状态，并在演练恢复失败时保持安全关闭。
• 社区版本检查更加完整：识别 odsh-v*、旧版 dsh-v* 和普通 v* 标签；Windows 与 macOS 支持下载并校验匹配的安装程序，超时和不受支持的平台会给出明确反馈。
• Windows/Linux 标题栏与插件内容彻底隔离：Harness 页面和插件运行在标题栏下方的独立 WebContentsView 中，全屏或固定定位的插件内容不再覆盖窗口控制按钮。

重点修复

• 修复 Windows 插件安装或更新时，pnpm 因杀毒软件、索引器或残留进程短暂占用目录而出现 EPERM/rename 失败的问题；客户端会对可确认的临时重命名冲突进行有限重试。
• 修复问题插件卸载后仍残留隔离记录，导致重启后无法正常进入或无法重新安装的问题。
• 修复旧会话中空工具调用缺少 tool source 而导致历史会话无法加载的问题，并保留可恢复的会话内容。
• 修复社区 Release 检查不能正确识别最新发布、一直停留在检查中或错误选择预发布版本的问题。
• 强化插件诊断：对客户端模块缺失、依赖冲突和装载失败提供可执行的重新安装、重试或卸载建议，而不是只展示“已隔离”。

预置插件更新

• dshmarket：1.36.3 → 1.38.1
• @xmanrui/dsh-im：3.0.1 → 4.2.1
• dsh-better-sidebar：0.16.1 → 0.17.1
• dsh-pocket：1.14.5 → 2.10.0
• dsh-skill-picker 继续固定为 0.2.0
• dsh-font 1.1.0 仅保留为诊断演练插件，不会作为普通预置插件启用

所有归档继续使用固定版本与 SHA-512 完整性校验。用户主动卸载过的预置插件不会在升级或重启时被擅自装回。

升级说明

• 这是 Alpha 预发布版本，升级前建议备份重要配置和会话。
• 默认 JSON 会话、主题、背景、数据目录选择和插件卸载记录会继续保留。
• Codex 与 Claude Code 连接仍由用户在“外部工具”中联网安装，不随安装包预置。
• 如果插件启动后被隔离，请先查看隔离通知和“诊断”页面，再按建议重新安装、修复或卸载。

Open DSH Desktop v0.1.2-alpha.1.1

This is a desktop enhancement and bug-fix release based on v0.1.2-alpha.1, with the official DeepSeek Harness dsh-v0.1.2-alpha.1 remaining its core baseline. This release does not include the official 0.1.2-alpha.2 or 0.1.2-alpha.3 updates, so it uses the alpha.1.1 designation to avoid confusion with upstream versions. Feedback is always welcome!

Major Enhancements

• Safer data directory management: When importing an official configuration or starting fresh, you can use the client’s default directory or select an empty folder as an independent configuration directory. After setup, General Settings also lets you safely switch between the desktop client’s independent directory, the official directory, another existing DSH directory, or a new environment created in an empty folder. Switching directories does not copy, merge, overwrite, or delete data in the original directory.
• Mobile access guidance added to initial setup: The onboarding flow can now continue through LAN mobile access and IM connection setup.
• Easier detection and recovery of quarantined plugins: When a plugin is quarantined after installation or restart, the client displays a clear notification, identifies the responsible plugin, and provides recovery options. The Diagnostics Center can clean up invalid quarantine state left behind by plugin removal and remains safely closed if a diagnostics exercise cannot restore the environment.
• More complete community release checks: The client recognizes odsh-v*, legacy dsh-v*, and standard v* tags. Windows and macOS can download and verify the matching installer, while timeouts and unsupported platforms now receive clear feedback.
• Complete separation between the Windows/Linux title bar and plugin content: The Harness interface and plugins now run in a separate WebContentsView below the title bar. Full-screen or fixed-position plugin content can no longer cover the window controls.

Key Fixes

• Fixed Windows plugin installation and update failures caused by pnpm EPERM/rename errors when antivirus software, indexers, or leftover processes temporarily hold a directory open. The client now performs bounded retries for confirmed temporary rename conflicts.
• Fixed an issue where quarantine records could remain after removing a problematic plugin, preventing the client from starting normally or reinstalling the plugin after restart.
• Fixed older sessions failing to load when an empty tool call had no tool source, while preserving recoverable session content.
• Fixed community Release checks failing to recognize the latest release, remaining stuck in the checking state, or selecting the wrong prerelease version.
• Strengthened plugin diagnostics by providing actionable reinstall, retry, or uninstall recommendations for missing client modules, dependency conflicts, and loading failures instead of only displaying “Quarantined.”

Bundled Plugin Updates

• dshmarket: 1.36.3 → 1.38.1
• @xmanrui/dsh-im: 3.0.1 → 4.2.1
• dsh-better-sidebar: 0.16.1 → 0.17.1
• dsh-pocket: 1.14.5 → 2.10.0
• dsh-skill-picker remains pinned to 0.2.0
• dsh-font 1.1.0 is retained only as a diagnostics exercise plugin and is not enabled as a regular bundled plugin

All bundled archives continue to use pinned versions and SHA-512 integrity verification. Bundled plugins that a user has explicitly uninstalled will not be reinstalled automatically during an upgrade or restart.

Upgrade Notes

• This is an Alpha prerelease. Backing up important configurations and sessions before upgrading is recommended.
• JSON sessions, themes, backgrounds, data directory selections, and plugin removal records are preserved by default.
• Codex and Claude Code integrations must still be installed online by the user from “External Tools” and are not bundled with the installer.
• If a plugin is quarantined after startup, review the quarantine notification and the “Diagnostics” page before following the recommended reinstall, repair, or uninstall action.

v0.1.2-alpha.1

Open DeepSeek Harness Desktop v0.1.2-alpha.1

警告：此发布尚不稳定，已经收到很多用户的bug反馈，生产使用请找稳定版。开发者在此反思测试不足，欢迎各位的反馈

Open DeepSeek Harness Desktop 是由 FLAQ AI 独立维护的社区桌面发行版，基于开源的 DeepSeek Harness 构建，并非 DeepSeek 官方产品。

本次 Alpha 版本合并了官方 DeepSeek Harness 0.1.2-alpha.1，并在上一版 v0.1.1-rc.2 的基础上，新增诊断演练中心、实时插件发现、插件隔离保护和设置界面自定义，同时集中修复 Windows PATH、标题栏、配置文件打开和安装包启动检查等问题。

这是预发布版本。建议在升级前备份重要配置，并将遇到的问题和诊断报告反馈给我们。

官方 DeepSeek Harness 0.1.2-alpha.1 更新

本版本同步了上游 DeepSeek Harness 0.1.2-alpha.1 的主要能力。

会话界面

• 已完成回答默认折叠过程内容和 System Prompt。
• 会话正文宽度支持自适应和拖动调整。
• 支持展开查看每次回答的精确 Token 用量。
• 新增紧凑的回合导航。
• 支持调整会话字号，Markdown 表格随正文字号缩放。
• 流式生成代码块时持续显示语法高亮。
• 提问历史改为更易阅读的问答卡片，并显示取消或中断状态。
• 切换会话后保留尚未提交的提问卡片草稿。
• 会话运行期间输入新消息时，主按钮切换为“发送”，消息进入发送队列。

模型、插件与子代理

• 插件可以在模型设置页添加提供方登录配置。
• 支持第三方界面语言，并补充多语言文本。
• Agent 可以在授权范围内为子代理选择提供方、模型和推理力度。
• 启动子代理时可以指定提供方、模型、推理力度和最大输出长度。
• Claude Code 与 Codex 子代理支持配置模型。
• ACP 补齐标准会话控制、模型设置、MCP、权限和取消能力。
• Python SDK Runtime 新增 Windows x64 发行包。

图片与文件

• 图片发送后立即显示，压缩和上传在后台继续。
• 改进图片压缩速度、上传体积和超长截图清晰度。
• 上下文压缩会正确计算图片占用。
• 轨迹视图支持展示用户、助手和工具结果中的图片。
• 本地文件系统模式下，模型可以直接定位已经上传的图片。
• 输入框中的文件和会话引用在编辑相邻文字后仍保持有效。

性能与稳定性

• 优化页面启动和会话初始化，减少代码加载、数据传输及解析开销。
• 降低会话记录占用的磁盘空间。
• 修复 macOS、Linux 持久 PowerShell 启动过早、输出不完整的问题。
• 修复 Linux 持久 Bash 在管道读取时提前返回空结果的问题。
• 修复 Bash 派生大量子进程时造成的 macOS 宿主卡顿。
• 修复 Windows 目录选择器截断部分中文路径的问题。
• 修复 Profile 中 Agent Preset 目录在启动时丢失的问题。
• 为网关增加 WebSocket 心跳，减少空闲连接中断。
• Code Mode 更名为 PTC Mode，已有会话记录仍然兼容。
• 网络访问 Web 界面时使用一次性 Token 鉴权。
• 公网 WebFetch 默认启用，并带有 SSRF 防护。

官方完整更新记录：

https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.1

桌面版新增与改进

以下内容是相较 Open DeepSeek Harness Desktop v0.1.1-rc.2 的实际新增变化。

诊断演练中心，来点眼见为实的诊断测试！

上一版安装包中可能无响应的“安装诊断测试插件”入口，已经替换为正式的“诊断演练中心”。

诊断演练使用客户端内置的离线样本，在受控测试环境中执行：

注入故障 → 运行诊断 → 定位来源 → 修复或隔离 → 复检 → 清理

当前覆盖：

• Cordis、dsh-tools 等 Host 共享依赖出现物理重复实例。
• Host 依赖版本不兼容，无法安全统一。
• 插件已经消失，但 Bundle 或 Loader 配置仍然残留。
• 插件声明存在，但模块目录无法解析。
• cordis.patch.yml 损坏。
• Loader 条目或插件注册重复。
• 插件生命周期加载失败。
• pnpm 构建脚本被阻止以及 allowBuilds 授权检查。
• 修复过程中断后的恢复与残留清理。

界面会展示当前场景、轮次、执行阶段、通过状态和耗时，并允许导出演练报告。

插件隔离保护

进一步加强上一版的插件诊断能力：

• 启动时识别与当前客户端不兼容的插件。
• 无法安全统一 Host 依赖时，将问题插件隔离而不是继续加载。
• 检测客户端插件加载失败、缺失模块和残留 Loader。
• 进入客户端前提供恢复状态，避免问题插件持续拖垮启动流程。
• 插件被隔离后保留明确原因和恢复入口。

实时插件发现

“探索插件”不再使用写死的插件、Star 和安装状态，改为读取插件市场的真实目录。

• 支持热门推荐和按类别浏览。
• 每个分类展示排名靠前的插件。
• 推荐目录缓存 24 小时，避免每次打开都重新下载完整市场数据。
• 支持手动刷新，并在刷新失败时继续展示已经缓存的数据。
• 本机安装状态在每次打开时单独刷新。
• 显示已安装、可安装、需要重启、不可用等真实状态。
• 支持从推荐卡片立即安装，或进入完整插件市场查看。
• 本地插件安装方式也可以利用包信息和源码仓库检查联网更新。
• 插件市场内置版本更新至 1.36.3。

设置界面

• 左侧设置导航现在可以滚动，不再因为插件较多而裁掉后面的设置类型。
• 支持拖动调整设置类型顺序，并保存用户自己的排列。
• 优化拖动过程中的占位、滚动和动画反馈。
• 修复“打开配置文件”按钮无响应的问题。
• 修复部分文件和目录无法通过系统文件管理器打开的问题。
• 改善设置弹窗、初始化界面、图片预览等 Overlay 在有限窗口高度下的布局。

Windows 修复

• 修复 Windows 使用 Path、代码却只读取 PATH，导致系统命令路径被误判为空的问题。
• 内置 Node Runtime 保持 PATH 第一优先级。
• 保留原有 Path/PATH 键名，避免产生大小写重复项。
• 补齐 Windows 根目录、System32、Wbem 和 Windows PowerShell。
• 继续继承 Git、VS Code、Cursor、Zed 等用户工具路径。
• 对重复路径执行 Windows 大小写不敏感去重。
• 支持带空格和中文字符的安装目录。
• 修复 Better Sidebar 等全视口插件与 Windows 窗口按钮区域重叠的问题。
• 修复带一次性认证 Token 的 Harness 就绪地址无法通过安装包检查的问题。
• 桌面端启动内置 Harness 时不再额外打开系统浏览器。

其他修复

• 首次初始化中的 IM 机器人步骤现在会打开独立的“IM 机器人”设置页面。
• 修复升级或恢复预装插件时，无法重新使用客户端内置校验归档的问题。
• 改进插件市场安装、恢复和更新状态的匹配逻辑。
• 修复部分弹窗和覆盖层在小尺寸窗口中的溢出问题。

下载

请选择与系统和处理器架构对应的安装包。

Windows

• DeepSeek-Harness-windows-x64.exe

macOS

Apple Silicon：

• DeepSeek-Harness-macos-arm64.dmg
• DeepSeek-Harness-macos-arm64.zip

Intel：

• DeepSeek-Harness-macos-x64.dmg
• DeepSeek-Harness-macos-x64.zip

Linux

• Debian / Ubuntu：DeepSeek-Harness-linux-x64.deb
• Fedora / RHEL：DeepSeek-Harness-linux-x64.rpm

可以使用 Release 中的 SHA256SUMS 验证下载文件的完整性。

安装提示

Windows

如果旧版本仍在托盘运行，建议先通过托盘菜单选择“完整退出”，再运行升级安装包。

macOS

当前安装包尚未完成 Apple Developer ID 公证。如果首次运行被 macOS 阻止，请前往“系统设置 → 隐私与安全性”允许打开。

安装新版本时，如果 Finder 提示“保留两者、替换或取消”，请选择“替换”。

Linux

请选择与当前发行版匹配的 DEB 或 RPM 安装包。

反馈

如果遇到启动、插件加载、诊断演练、设置界面或安装升级问题，请提交 Issue，并尽量附上：

• 操作系统与版本；
• 安装包文件名；
• 问题出现前执行的操作；
• 客户端日志或诊断报告；
• 必要的界面截图。

项目仓库：

https://github.com/flaqai/open-deepseek-harness-desktop

上游项目：

https://github.com/deepseek-ai/deepseek-harness

Open DeepSeek Harness Desktop v0.1.2-alpha.1

Warning: This release is not yet stable and has received many bug reports from users. For production use, please use the stable version. The developers acknowledge that testing was insufficient and welcome your feedback.

Open DeepSeek Harness Desktop is an independently maintained community desktop distribution developed by FLAQ AI and built on the open-source DeepSeek Harness. It is not an official DeepSeek product.

This Alpha release integrates the official DeepSeek Harness 0.1.2-alpha.1 update. Compared with our previous v0.1.1-rc.2 release, it introduces the Diagnostics Lab, live plugin discovery, stronger plugin isolation, and customizable Settings navigation. It also includes focused fixes for Windows PATH handling, the custom title bar, opening configuration files, and packaged-runtime startup checks.

This is a pre-release build. We recommend backing up important configuration before upgrading and reporting any issues together with relevant logs or diagnostic reports.

Official DeepSeek Harness 0.1.2-alpha.1 Update

This release incorporates the major features from the upstream DeepSeek Harness 0.1.2-alpha.1 release.

Conversation Interface

• Process details and the System Prompt are now collapsed by default before each completed answer.
• Conversation content width can adapt automatically or be adjusted by dragging.
• Exact token usage can be expanded after each completed answer.
• Added compact turn navigation.
• Conversation font size can be adjusted, with Markdown tables scaling alongside the body text.
• Streaming code blocks retain syntax highlighting while responses are being generated.
• Question history is presented as readable question-and-answer cards, including cancelled and interrupted states.
• Unsubmitted question-card drafts are preserved when switching conversations.
• When text is entered during an active turn, the primary action changes to Send and the message is queued.

Models, Plugins, and Subagents

• Plugins can add provider sign-in controls to the Models settings page.
• Added support for third-party interface languages and expanded localization coverage.
• Agents can select a provider, model, and reasoning effort for subagents within the configured authorization scope.
• Subagents can be started with a specific provider, model, reasoning effort, and maximum output length.
• Claude Code and Codex subagents now support configurable models.
• ACP now includes standard session controls, model settings, MCP, permissions, and cancellation capabilities.
• The Python SDK Runtime is now available for Windows x64.

Images and Files

• Images appear immediately after being sent while compression and upload continue in the background.
• Improved image compression speed, upload size, and clarity for very tall screenshots.
• Image usage is now included in context-compaction accounting.
• Trajectory views can display images from users, assistants, and tool results.
• In local filesystem mode, models can directly locate uploaded image files.
• File and conversation references remain valid when adjacent composer text is edited.

Performance and Stability

• Optimized page startup and conversation initialization to reduce code loading, data transfer, and parsing overhead.
• Reduced the disk space consumed by conversation records.
• Fixed persistent PowerShell starting too early and returning incomplete output on macOS and Linux.
• Fixed persistent Bash returning empty output too early while reading from pipelines on Linux.
• Fixed macOS host stalls caused by Bash commands spawning large numbers of subprocesses.
• Fixed the Windows directory picker truncating paths containing certain Chinese characters.
• Fixed Profile-configured Agent Preset directories being lost during startup.
• Added WebSocket heartbeats to reduce idle connection interruptions.
• Code Mode has been renamed to PTC Mode while remaining compatible with existing conversation records.
• Web interfaces accessed over a network now use one-time token authentication.
• Public WebFetch is enabled by default with built-in SSRF protection.

Full official release notes:

https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-alpha.1

Desktop Additions and Improvements

The following changes are new compared with Open DeepSeek Harness Desktop v0.1.1-rc.2.

Diagnostics Lab: See the Diagnostics in Action!

The potentially unresponsive Install Diagnostic Test Plugin entry from the previous packaged release has been replaced with the full Diagnostics Lab.

The Diagnostics Lab uses bundled offline fixtures to exercise the diagnostic system inside a controlled test environment:

Inject failure → Run diagnostics → Identify the source → Repair or isolate → Verify again → Clean up

Current scenarios include:

• Physically duplicated Host-shared dependencies such as Cordis and dsh-tools.
• Host dependency versions that cannot be safely unified.
• Missing plugin packages with stale Bundle or Loader references.
• Declared plugins whose module directories can no longer be resolved.
• Corrupted cordis.patch.yml files.
• Dupli...

v0.1.1-rc.2

Open DeepSeek Harness Desktop 0.1.1-rc.2

Open DeepSeek Harness Desktop 是由 FLAQ AI 维护的社区独立桌面发行版，基于开源的 DeepSeek Harness 构建，并非 DeepSeek 官方产品。

本次候选版本同步了上游能力，并重点完善了桌面安装、独立运行环境、插件安全、配置导入与跨平台体验。
本次更新带来了“超级强化诊断”：专门收拾 pnpm 依赖混乱、Cordis 多实例冲突、幽灵插件和看不懂的 .prepare 报错，让插件问题从“玄学重装”变成可以定位、修复和隔离的明确流程。

本次更新

桌面客户端

• 提供 Windows、macOS 和 Linux 原生安装包。
• 安装包内置 Node.js、pnpm 与 Harness 运行时，无需用户自行配置开发环境；
• 支持托盘运行、快速重启、系统通知、日志入口和版本更新；
• 优化 Windows 安装与升级时的进程关闭检测；
• 改进 macOS 更新提示与应用生命周期管理。

独立配置环境

• 支持首次启动时选择创建新环境、导入官方配置或者共享官方目录；
• 导入官方配置时，聊天记录与插件配置表单都会复制，但是插件本体需要重新安装。我们提供了选项安装，导入插件前检查在线来源和恢复能力。支持从本地源码目录或 .tgz 文件安全恢复插件；
• 不选择共享目录时，客户端数据与官方 DSH CLI/Web 环境相互独立。

超级强化的诊断检查！

插件报错不再只留下一长串看不懂的堆栈。

我们针对最常见、也最棘手的 pnpm 与 Cordis 运行时问题，加入了一套启动前插件安全检查：

• 自动识别 pnpm Store 版本不一致、构建脚本被拦截、allowBuilds 缺失、锁文件和安装状态异常；
• 追踪插件的直接与间接依赖链，找出到底是哪个插件引入了冲突；
• 检测 @deepseek-ai/cordis、dsh-tools 等 Host 共享依赖是否被重复安装；
• 识别“版本看起来一样，实际上是两份物理实例”的隐蔽冲突；
• 处理 Cordis Service、Context、Symbol 身份不一致导致的工具注册失效、空工具调用和 .prepare 异常；
• 检查插件 Loader 残留、加载顺序、挂载失败以及已经卸载但仍在生效的幽灵插件；
• 能安全统一依赖时自动修复；无法安全修复时隔离问题插件，避免整个 Harness 被拖垮；
• 提供诊断报告、错误依赖链、修复结果、隔离原因和日志入口，不再只有一句“安装失败”。

简单来说：以前 pnpm 和 Cordis 报错像是在读密码；现在客户端会尽量把它翻译成“谁出了问题、为什么出问题、能不能自动修、下一步该怎么做”。

使用体验

• 新增初始化配置引导。
• 去掉预装的codex包，减小了包体积，用户可以在设置-外部工具中联网安装官方最新的对应依赖；
• mac顶部栏和Windows的工具栏图标添加了“快速重启”功能；
• 更新改为内置在“通用设置”中，而且可以在应用内获取最新release了；
• 通用设置中添加了设置dsh环境变量功能；
• 新增文本划选快捷操作与右键菜单；
• 优化浅色、暗色主题以及 Windows 自定义标题栏；
• 改进设置页面、加载页面和桌面宿主状态展示；
• 修复了超多的bug，感谢朋友们的信任与理解，有bug或者有想法，欢迎各位提出反馈，我们非常欢迎。

下载

请根据系统选择对应安装包：

• Windows x64：DeepSeek-Harness-windows-x64.exe
• macOS Apple Silicon：DeepSeek-Harness-macos-arm64.dmg
• macOS Intel：DeepSeek-Harness-macos-x64.dmg
• Linux Debian/Ubuntu：DeepSeek-Harness-linux-x64.deb
• Linux Fedora/RHEL：DeepSeek-Harness-linux-x64.rpm

macOS 同时提供 ZIP 版本。

下载后可使用 SHA256SUMS 校验文件完整性。

安装提示

macOS

当前版本尚未进行 Apple Developer ID 公证。首次启动时如果系统阻止运行，请在“系统设置 → 隐私与安全性”中允许打开。

Windows

升级安装时，如果旧版本仍在托盘运行，安装器会提示关闭相关进程。建议先从托盘菜单完整退出客户端再进行升级。

Linux

请选择与当前发行版匹配的 DEB 或 RPM 安装包。

已知问题

• 安装版中“安装诊断测试插件”入口可能仍然显示，但点击后不会执行测试插件安装。该问题不影响正式插件诊断和修复能力，将在后续版本移除或改造成安全的诊断演示功能。

项目说明

Open DeepSeek Harness Desktop 是社区独立维护的开源项目：

https://github.com/flaqai/open-deepseek-harness-desktop

上游项目：

https://github.com/deepseek-ai/deepseek-harness

Open DeepSeek Harness Desktop 0.1.1-rc.2

Open DeepSeek Harness Desktop is an independently maintained community desktop distribution developed by FLAQ AI and built on the open-source DeepSeek Harness project. It is not an official DeepSeek product.

This release candidate synchronizes with the latest upstream capabilities while significantly improving desktop installation, isolated runtime environments, plugin safety, configuration import, and the cross-platform experience.

It also introduces our Supercharged Diagnostics system, designed to tackle pnpm dependency issues, multiple Cordis runtime instances, ghost plugins, and cryptic .prepare errors. Plugin problems no longer have to be solved through trial-and-error reinstalls—they can now be identified, repaired, or safely isolated through a clear diagnostic process.

What’s New

Desktop Client

• Native installers are available for Windows, macOS, and Linux.
• Installers include Node.js, pnpm, and the Harness runtime, so users do not need to configure a development environment.
• Added system tray support, quick restart, native notifications, log access, and version updates.
• Improved process detection when installing or upgrading the Windows application.
• Improved update prompts and application lifecycle management on macOS.

Isolated Configuration Environments

• On first launch, users can create a fresh environment, import an official DSH configuration, or directly share an existing official configuration directory.
• When importing an official configuration, conversation history and plugin configuration forms are copied, but plugin packages must be installed again in the desktop client’s independent Profile.
• The client provides a plugin recovery selection flow that checks online package availability before installation.
• Plugins whose online sources are unavailable can be safely restored from a local source directory or .tgz archive.
• Unless the user explicitly chooses to share an existing directory, desktop client data remains independent from the official DSH CLI and Web environments.

Supercharged Diagnostics!

Plugin failures no longer leave users with nothing but an unreadable stack trace.

We added a pre-launch plugin safety system specifically for the most common—and most difficult—pnpm and Cordis runtime problems:

• Detects mismatched pnpm Store versions, blocked build scripts, missing allowBuilds entries, lockfile problems, and incomplete installation states.
• Traces direct and transitive plugin dependency chains to identify which plugin introduced a conflict.
• Detects duplicated Host-shared dependencies such as @deepseek-ai/cordis and @deepseek-ai/dsh-tools.
• Identifies hidden conflicts where package versions appear identical but resolve to separate physical installations.
• Handles tool registration failures, empty tool calls, and .prepare errors caused by mismatched Cordis Service, Context, or Symbol identities.
• Detects stale plugin Loader entries, incorrect loading order, mount failures, and “ghost plugins” that remain active after they appear to have been uninstalled.
• Automatically repairs dependencies when they can be safely unified.
• Isolates incompatible plugins when a safe repair is not possible, preventing one faulty plugin from breaking the entire Harness runtime.
• Provides diagnostic reports, conflicting dependency chains, repair results, isolation reasons, and direct log access instead of showing only “Installation failed.”

In short: pnpm and Cordis errors used to look like encrypted messages. The desktop client now tries to translate them into clear answers: which plugin failed, why it failed, whether it can be repaired automatically, and what the user should do next.

User Experience

• Added a first-run configuration guide.
• Removed the bundled Codex package to reduce installer size. Users can install the latest compatible official dependency online from Settings → External Tools.
• Added a Quick Restart action to the macOS menu bar and Windows system tray.
• Moved update controls into General Settings, including in-app Release discovery and downloading.
• Added an option in General Settings to register the bundled dsh command in the system PATH.
• Added text-selection shortcuts and a custom context menu.
• Improved light and dark themes, along with the Windows custom title bar.
• Improved the Settings interface, loading screen, and desktop host status presentation.
• Fixed many bugs. Thank you for your trust, patience, and understanding. If you encounter a problem or have an idea for the project, feedback is always welcome.

Downloads

Choose the installer that matches your operating system:

• Windows x64: DeepSeek-Harness-windows-x64.exe
• macOS Apple Silicon: DeepSeek-Harness-macos-arm64.dmg
• macOS Intel: DeepSeek-Harness-macos-x64.dmg
• Linux Debian/Ubuntu: DeepSeek-Harness-linux-x64.deb
• Linux Fedora/RHEL: DeepSeek-Harness-linux-x64.rpm

ZIP archives are also available for macOS.

After downloading, use SHA256SUMS to verify file integrity.

Installation Notes

macOS

This release has not been notarized with an Apple Developer ID. If macOS prevents the application from opening for the first time, go to System Settings → Privacy & Security and allow the application to open.

Windows

During an upgrade, the installer may ask you to close related processes if the previous version is still running in the system tray. We recommend fully quitting the client from its tray menu before starting the upgrade.

Linux

Choose the DEB or RPM package that matches your Linux distribution.

Known Issues

• The Install Diagnostic Test Plugin entry may still appear in packaged builds, but clicking it may not install the test plugin. This does not affect the production plugin diagnostics or repair system. The entry will be removed or replaced with a safe diagnostic demonstration in a future release.

Project Information

Open DeepSeek Harness Desktop is an independently maintained open-source community project:

https://github.com/flaqai/open-deepseek-harness-desktop

Upstream project:

https://github.com/deepseek-ai/deepseek-harness

open-deepseek-harness-desktop 0.1.0-rc.8

open-deepseek-harness-desktop 0.1.0-rc.8 · FLAQ Build 1

这是基于 DeepSeek Harness 0.1.0-rc.8 构建的 FLAQ Desktop 候选版本，重点完善桌面宿主体验、跨平台安装、插件管理和外部编码工具连接。

本版本为预发布版本，建议先用于测试和体验。

主要更新

桌面宿主能力

• 新增系统托盘，默认关闭窗口后继续在后台运行。
• 支持选择“隐藏到托盘”或“直接退出”。
• 新增 Harness 启动失败、恢复正常和重复失败的系统通知。
• 启动等待超过 15 秒后可直接打开 Harness 日志。
• macOS 安装版支持开机自启。
• 优化 macOS 托盘模板图标。
• 修复自动隐藏菜单栏下点击托盘后图标收起的问题。
• 退出应用时等待 Harness 子进程安全结束，减少后台进程残留。

版本更新

• 安装版可以检查新的 GitHub Release。
• 稳定版和预发布版按照各自版本通道检查更新。
• 更新提示只打开 GitHub Release 页面，不会自动下载或替换程序。
• 源码开发模式继续使用独立的源码更新方式。

初始化与配置

• 新增首次启动配置向导。
• 引导配置模型 API Key。
• 引导配置微信、飞书等 IM Bot。
• 支持中文和英文切换。
• 初始化步骤可以跳过，并在设置中继续完成。

插件与运行环境

• 内置 Node.js 和 pnpm，降低对系统环境变量的依赖。
• 预装常用社区插件。
• 新增客户端级插件兼容性诊断，自动隔离不合规依赖，安全无忧。
• 支持检测并处理共享 Host 依赖冲突。
• 改进插件安装、更新和卸载流程。
• 改进插件依赖残留和重复运行时实例的处理。

外部编码工具

• 新增外部编码工具连接中心。
• 改进 Codex 等外部工具的连接引导。
• 增加旧版 Agent 预设回退机制。
• 桌面安装包预装官方 Codex 运行支持。
• 修复 Windows 下 Codex 与插件安装命令解析问题。

外观与交互

• 新增“灵感拼贴”主题及配套聊天背景。
• 优化设置开关在明暗主题下的可辨识度。
• 修复 Electron 客户端复制按钮。
• Windows 和 Linux 使用自定义标题栏。
• macOS 保留原生窗口标题栏。

跨平台安装

本次 Release 提供：

• macOS Apple Silicon：DMG、ZIP
• macOS Intel：DMG、ZIP
• Windows x64：EXE
• SHA-256 校验文件

下载

macOS Apple Silicon

DeepSeek-Harness-macos-arm64.dmg
DeepSeek-Harness-macos-arm64.zip