安装包需从官方网站下载,README 未提供命令行安装方式;手机通过互联网隧道连接需额外输入 6 位连接密码,Pinggy 备用通道约 60 分钟后失效;第三方插件可能导致启动异常,需用安全模式排查。
dsh-desktop
dataelementMIT活跃维护DeepSeek Harness 的桌面客户端,把 Agent 编排与运行环境搬到本地图形界面,方便在桌面上直接配置和驱动 DeepSeek 智能体。
DSHDesktop:DeepSeek Harness Desktop / DeepSeek Harness 桌面版
open -a "DSH Desktop" --args --safe-modeREADME 未说明显存或 GPU 要求;平台支持 macOS Apple Silicon、macOS Intel 与 Windows x64,不支持 Windows ARM64 和 Linux。
基于 DeepSeek Harness 的桌面 Agent 应用,开箱即用生成 Office 文档
DeepSeek Harness 的桌面客户端,把 Agent 编排与运行环境搬到本地图形界面,方便在桌面上直接配置和驱动 DeepSeek 智能体。
核心能力
- 优化主流模型提供方配置与首次接入
- 提供 Word 原生套版、Excel 案例工作簿与 PPT 可编辑模板
- 内置 16 套 PPT 模板、192 种版式并支持导入个人模板
- 安全模式屏蔽第三方插件并保留会话与配置
- 扫码配对后可在手机上继续会话
容易踩的坑
- v0.13.2DSH Desktop v0.13.2最新正式版2026-11-03 · 2026-11-03 12:48 UTC
本版本重点提升 Safe Mode 和启动稳定性,并改进故障报告、安装器及 Windows 环境下的兼容性。
- 故障报告:将待处理报告汇总为每次启动最多一个确认弹窗;用户同意后最多发送 5 份报告,避免重复打扰。
体验优化
- 故障诊断:相同诊断错误在 10 分钟内去重,减少重复捕获与报告。
- Office 集成:Office 运行时资源缺失或配置无效时,发出警告并停用 Office 功能,不再阻断 Harness 启动。
- 安装器:恢复安装完成后自动启动应用,同时避免强制提升安装器权限。
问题修复
- Safe Mode 与会话启动:确保 Safe Mode 配置包含可用的默认模型;缺少模型选择时回退到 DeepSeek 官方默认模型,避免会话控制器卡住。
- 凭据与会话持久化:遇到无效或旧版凭据键时跳过并警告;损坏的会话日志不再导致异常退出,并可隔离后继续列出其他会话。
- 锁文件恢复:自动清理超过 10 秒的陈旧凭据和 Profile 写入锁,避免异常退出后下次启动等待超时。
- Windows 沙箱与显卡回退:为安装目录授予 Chromium AppContainer 所需的读取权限;显卡回退时放宽 GPU 沙箱限制,同时保留 Renderer 沙箱,改善受限权限或驱动环境下的启动兼容性。
其他变更
- Harness 兼容性:更新会话控制器、凭据和会话持久化补丁,并补充对应回归测试,覆盖 Safe Mode、损坏数据容错、锁恢复和故障报告汇总。
This release improves Safe Mode and startup stability, and strengthens diagnostics, installer behavior, and compatibility on Windows.
- Error Reporting: Consolidate pending reports into at most one confirmation dialog per launch; user consent allows up to five reports to be sent, reducing repeated prompts.
Improvements
- Diagnostics: Deduplicate identical diagnostic errors for 10 minutes to reduce repeated captures and reports.
- Office Integration: Warn and disable Office features when runtime resources are missing or configuration is invalid, rather than blocking Harness startup.
- Installer: Restore automatic app launch after installation without forcing the installer to elevate privileges.
Bug Fixes
- Safe Mode & Session Startup: Ensure Safe Mode includes a usable default model and fall back to DeepSeek’s official default when model selection is unavailable, preventing the session controller from hanging.
- Credentials & Session Persistence: Skip and warn about invalid or legacy credential keys; corrupted session logs no longer cause failures and can be isolated so other sessions remain available.
- Stale Lock Recovery: Automatically remove credential and profile writer locks older than 10 seconds, preventing launch timeouts after an abnormal exit.
- Windows Sandbox & GPU Fallback: Grant Chromium AppContainer the required read access to the install directory. GPU fallback relaxes the GPU sandbox while preserving the Renderer sandbox, improving startup compatibility in restricted-permission or driver environments.
Chores
- Harness Compatibility: Update the session-controller, credentials, and session-persistence patches, with regression coverage for Safe Mode, corrupted data, stale-lock recovery, and aggregated error reporting.
- v0.13.1DSH Desktop v0.13.12026-11-02 · 2026-11-02 13:49 UTC
查看更新说明
本版本升级 Harness 与 Electron,新增原生侧边栏浏览器试用能力,并集中修复启动、导入、Windows 安装和界面体验问题。
- 侧边栏浏览器:新增基于租约管理的原生 WebView 浏览器试用能力,支持在桌面侧边栏中使用网页。
- 模型设置:自动识别发现模型的能力,并支持自定义模型;更新弹窗支持 Markdown 日志渲染。
- 公文模板:重建公文模板字体资源,降低字体合规风险,并调整模板处理逻辑以避免误删其他模板的表格。
体验优化
- 更新提示:更新条跟随 Desktop 浅色或深色主题,避免悬停时文字与背景对比不足。
- 启动界面:统一启动遮挡页动画位置,减少显示不一致。
- 工作台:将会话创建限制在工作台操作中,避免从其他入口误建会话。
- 版本发布:简化手动发布输入,并改进飞书评审反馈与更新说明生成流程。
问题修复
- 启动与迁移:忽略已被新文档替代的启动失败;遇到插件重复注册旧迁移预设时,自动停用冲突项;普通运行时依赖保留在共享依赖树中,避免迁移失败。
- 会话导入:导入后检查会话日志引用的附件对象;发现缺失时在导入进度中报告具体会话,避免问题被误报为模型传输故障。
- 文件预览:打开文件路径时正确处理并转发行号。
- Windows 安装与进程:改进安装失败提示和重试流程,修复低完整性目录安装及目录重命名问题;保留 Node 子进程 Promise 接口的原生行为。
- 窗口与权限:主窗口标题显示应用名;允许可信 Harness 来源申请麦克风权限,并对齐 macOS 权限与签名配置。
- 市场来源:应用经过 Desktop 外壳时保留可信来源信息。
- 更新弹窗:修复浅色主题下悬停文字难以辨认的问题。
其他变更
- 运行时与依赖:适配 Harness 0.2.2,并升级 Electron 至 44.7.0;同步更新相关兼容补丁和依赖。
- Windows 发布:改进安装器权限级别和错误处理,为内置 Python 与 Office Runtime 可执行文件签名,并并行运行 Windows 单元测试。
- 发布自动化:支持使用已有签名产物恢复发布;新增针对待补充反馈问题的自动关闭流程。
This release upgrades Harness and Electron, introduces a trial native sidebar browser, and addresses startup, import, Windows installation, and interface issues.
- Sidebar Browser: Adds a trial native WebView browser managed by leases, making web browsing available in the desktop sidebar.
- Model Settings: Infers capabilities for discovered models and supports custom models; update notes can now render Markdown.
- Government Documents: Rebuilds government-document font assets to reduce compliance risk and limits table handling to avoid deleting tables from unrelated templates.
Improvements
- Update Indicator: Follows the Desktop light or dark theme, keeping hover text legible against its background.
- Startup Screen: Aligns the boot-cover animation for a more consistent presentation.
- Workbenches: Restricts session creation to workbench actions, preventing sessions from being created through unrelated entry points.
- Release Workflow: Simplifies manual release inputs and improves Feishu review feedback and release-note generation.
Bug Fixes
- Startup & Migration: Ignores startup failures from superseded documents; automatically disables a migrated preset when a plugin registers the same preset; keeps ordinary runtime dependencies in the shared dependency tree to prevent migration failures.
- Session Import: Audits imported session logs for missing attachment objects and reports affected sessions in import progress instead of surfacing misleading model transport errors.
- File Preview: Preserves line numbers when opening file paths.
- Windows Installer & Processes: Improves installer failure messages and retries, fixes installation in low-integrity directories and directory rename failures, and preserves Node’s native child-process Promise behavior.
- Window & Permissions: Uses the application name in the main window title; allows microphone access from trusted Harness origins and aligns macOS permissions with upstream signing requirements.
- Market Origin: Preserves trusted origin information through the Desktop shell.
- Update Popup: Fixes hover text that was hard to read in the light theme.
Chores
- Runtime & Dependencies: Adapts to Harness 0.2.2 and upgrades Electron to 44.7.0, with corresponding compatibility patches and dependency updates.
- Windows Release: Improves installer execution level and error handling, signs bundled Python and Office Runtime executables, and parallelizes Windows unit tests.
- Release Automation: Supports publication recovery using existing signed artifacts and adds automatic closure for opted-in issues awaiting requested feedback.
- v0.13.0DSH Desktop v0.13.02026-10-28 · 2026-10-28 03:15 UTC
查看更新说明
本次版本重点完善启动故障恢复、应用回滚与工作台安装流程,并优化启动体验、稳定性和跨平台发布链路。
- 故障恢复与维修 Agent:提供由用户主动发起的启动维修流程,展示维修计划、错误详情和回滚位置;已知恢复操作与 Agent 维修分开呈现,成功修复后可返回正常导航。
- 应用回滚:新增独立的应用回滚页面与流程,支持在启动或更新故障后恢复到可用版本。
- 企业入口:新增企业网站入口,方便用户访问企业服务。
- 本地工作台安装:支持无 GitHub 身份的本地工作台身份、本地归档安装,以及由 Agent 通过插件管理器安装本地工作台。
体验优化
- 启动体验:启动页改用鲸鱼动画;启动遮罩覆盖页面内容出现前的空白帧,并支持自定义协议启动页的失败展示与恢复。Harness 页面准备与后端启动并行进行,页面重载时也会刷新启动注入内容。
- 安全模式与恢复页面:简化安全模式状态卡操作,改进错误详情、操作标签与维修入口提示,并为 Windows 恢复页面预留标题栏空间。
- 工作台:根据包清单区分重载与重启需求,本地安装后提示重启 Harness;优化制作引导和完成后的使用说明,并使长菜单可在窗口内滚动。
- 界面语言:菜单、“关于”和更新弹窗跟随 Desktop 语言设置;仅在用户未选择语言时回退到系统语言,并为 macOS 隐藏与退出菜单提供中英文标题。
- 安装器视觉:更新 macOS DMG 安装背景与布局。
问题修复
- 渲染进程恢复:限制渲染故障恢复次数,恢复导航失败时退回重启方案;保留诊断信息并处理旧导航退出,避免恢复页面切换被误判为渲染进程崩溃。
- 启动失败处理:修复插件加载失败时停留在 Harness 错误页、无错误详情时启动遮罩消失,以及客户端 Shell 检查导致可选工作台故障被放大的问题。
- GPU 与内存稳定性:完善 GPU 故障识别与有界恢复,明确呈现软件渲染恢复耗尽状态;处理内存耗尽故障,并恢复上游内存默认配置。
- 插件安装与依赖解析:修复通配符导出和无扩展名类型声明下的包解析问题;隔离每代安装暂存目录、补齐私有依赖,并从当前宿主解析缺失的 Harness peer。
- MCP 启动:限制连接及初始发现耗时,并在就绪前处理完启动通知同步。
- 工作台安装:统一经由插件管理器处理工作台生命周期与本地归档安装,并在切换插件时保留自定义补丁配置。
- 平台兼容性:修复 Windows 发布归档与 Unicode 路径处理、测试弹窗 fixture 编码,以及 macOS
node-ptyASAR 辅助程序映射的幂等性;补充 PingFang 字体变体到 CJK 字体回退的兼容处理。
其他变更
- Harness 与插件补丁:适配 Harness 0.2.1-rc.3,并同步更新相关插件补丁与客户端兼容调整。
- 更新与发布流程:支持手动查询更新和双语更新说明;发布前增加飞书审核门禁,并汇总已签名测试通知。网络超时后可继续 Apple 公证流程。
- 构建与 CI:优化跨平台构建准备和缓存复用,校验并流式处理 Windows 发布归档;将共享演示文稿准备移至 Ubuntu,并完善 macOS 原生辅助程序布局及 Windows/macOS 外部 Electron 启动验证。
- 依赖与文档:更新默认 dshmarket 版本,完善工作台开发指南、快速入门及稳定性、安装器和发布流程文档。
This release strengthens startup recovery, application rollback, and workbench installation while improving startup experience, stability, and cross-platform delivery.
- Recovery & Repair Agent: Adds a user-initiated startup repair flow with a clear repair plan, error details, and rollback placement. Known recovery actions remain separate from Agent repair, and successful repairs restore normal navigation.
- Application Rollback: Adds a dedicated rollback page and flow to recover a usable application version after startup or update failures.
- Enterprise Entries: Adds website entries for enterprise users.
- Local Workbench Installation: Supports local workbench identities without GitHub, installation from local archives, and Agent-initiated local installs through Plugin Manager.
Improvements
- Startup Experience: Refreshes the splash screen with a whale animation. The startup cover hides blank frames and supports recovery on custom-protocol startup failures. Harness page preparation now runs alongside backend startup, and boot injections refresh on page reload.
- Safe Mode & Recovery Pages: Simplifies Safe Mode status actions, clarifies error details and repair entry points, and reserves Windows caption space on recovery pages.
- Workbenches: Selects reload or restart requirements from package manifests and prompts for a Harness restart after local installs. Improves creation guidance and final usage instructions, and keeps long menus scrollable within the window.
- Localization: Localizes menus, About, and update dialogs to the Desktop language. The system language is used only when the user has not chosen one; macOS Hide and Quit menu titles are localized explicitly.
- Installer Design: Refreshes the macOS DMG background and layout.
Bug Fixes
- Renderer Recovery: Bounds renderer recovery attempts and falls back to restart when navigation recovery fails. Preserves diagnostics, drains stopped navigation before replacement loads, and avoids mistaking recovery navigation for a renderer crash.
- Startup Failures: Fixes plugin failures getting stuck on the Harness error page, startup covers disappearing when error details are unavailable, and optional workbench failures being escalated by shell audits.
- GPU & Memory Stability: Improves GPU failure classificatio
- v0.12.1DSH Desktop v0.12.12026-10-20 · 2026-10-20 13:41 UTC
查看更新说明
DSH Desktop v0.12.1 — 升级 Harness 并提升启动恢复与发布稳定性
更新内容
- Harness 运行时:升级至
0.2.1-rc.2,并同步更新相关宿主插件与兼容补丁,跟进上游运行时版本。 - 旧版工作流预设:启动时自动迁移旧格式预设,减少升级后预设无法继续使用时的手动处理。
- 工作台市场:市场条目改为分页展示,默认按星标数排序,浏览大量条目时更易找到受欢迎的工作台。
- 模型设置与启动恢复:模型服务地址异常时仍可进入应用,并在设置界面修改地址;Safe Mode 继承模型配置时会清理无效地址。
- PPT 工作区:统一解析工作区目录的实际路径,减少路径别名或软链接导致的目录定位不一致。
问题修复
- 启动配置恢复:DeepSeek 和第三方模型的地址问题不再阻止 Harness 启动,让用户可以通过设置界面修正配置;启动子进程时也会清理无效的
DEEPSEEK_BASE_URL环境变量。 - 插件加载诊断:改进宿主依赖回退与启动失败归因,避免将插件依赖缺失误报为插件本身不存在,并保留更明确的运行时错误信息。
- 打包运行时验证:打包后的 Harness 验证工具会显式结束进程并报告运行时错误;Windows 路径规范化也得到处理,便于发现和定位安装包中的运行问题。
- 文件预览错误:本地文件打开失败时向调用方传递原生错误,不再把失败隐藏为看似成功的结果。
性能与优化
- macOS 安装包:优化 DMG 压缩,并对公证后票据装订失败增加重试,降低临时服务问题导致发布失败的概率。
- Office 运行时体积:精简随包提供的 Python 依赖内容,并加强 Office 运行时打包检查,减少不必要的安装包负担并尽早发现缺失文件。
- Windows 签名与冒烟检查:避免对捆绑的 Office 运行时文件进行不适用的二进制签名;安装包重打包和最终签名步骤增加重试,冒烟脚本也能处理含空格的可执行文件路径并等待 GUI 程序启动。
- 发布与归档:改进版本索引追加逻辑,使归档版本历史能够保留;发布验证补充对打包依赖和资源的检查,并移除冗余的签名后冒烟任务。
- Harness 运行时:升级至
- v0.12.0DSH Desktop v0.12.02026-10-16 · 2026-10-16 10:58 UTC
查看更新说明
DSH Desktop v0.12.0 — 工作台体验升级,Office 模板工作流与桌面更新更完善
更新内容
- 工作台布局:新增默认与紧凑两种顶部布局,适配不同的窗口与侧栏空间;调整拖拽区域和标题可用宽度,并在工作台会话中隐藏不适用的 Word、Excel、PPT 快捷入口。
- 工作台市场与导航:改进市场卡片和侧栏交互,展示已安装工作台的来源,并识别旧版市场安装;整理重复卡片和已迁移的工作台标识,减少列表重复或安装项消失的情况。
- 工作台目录与更新:优先显示本地缓存目录,再在后台刷新市场数据;更新按版本判断,并仅针对检测到的风险请求确认。市场请求期间重试操作会保持忙碌状态,下载错误提供本地化提示。
- 工作台安装与故障恢复:市场替换前核实已安装来源,并在服务端执行替换确认;工作台加载失败时会指出出错项并提供恢复指引。不可卸载状态的原因也可通过键盘聚焦查看,已退役收藏项可以移除。
- 工作台顶部与会话交互:完善紧凑标题栏在普通侧栏分栏中的适配,并为展开的侧栏保留工作台拖拽空间;优化卡片在更新和错误状态下的尺寸稳定性。
- Office 文档与表格工作流:统一 PPT、Word、Excel 的模板选择、预览和案例体验;改进模板缩略图、打印预览和页面展示,Word 预览支持双页展开,Excel 示例以列表呈现并可预览成对页面。
- Office 案例与模板:增加会议纪要等精选案例,并提供多种文档、表格示例与配套模板;工作报告、写作案例和模板预览流程也经过整理。
- 个人 PPT 模板:改进模板导入、转换和复用流程,展示可复用样式与示例预览,并保留原始视图;导入预览可随页面生成逐步展示,进度反馈更清晰,完成后可先检查预览再继续。
- PPT 导入与资源管理:改进文本框继承、图表和图层布局、图片裁剪及媒体处理;对不支持的模板对象提供降级处理。模板上传采用流式处理并限制导入内存,导入过程中可取消任务并释放资源。
- 桌面通知:新增桌面原生通知与应用图标的桥接,并支持通知触发窗口聚焦。
- 安全模式配置:安全模式可继承普通 Profile 的模型配置,减少重复设置。
问题修复
- Windows 插件市场操作:修复打开添加插件界面或安装市场插件时弹出控制台窗口的问题;注册表查询和安装命令调整为避免经由
cmd.exe启动。 - Windows Office 文档处理:修复导入苹方字体 PPT 时的字体及字重解析;修复 Word 模板准备中的沙箱启动、空退出和超时问题,并修正中文 JSON 输出的 UTF-8 编码处理。
- Windows Office CLI:修复命令成功退出时被异常处理的问题,并调整无控制台环境下 Word 工作进程的启动方式。
- PPT 模板兼容性:改善导入模板的原生布局保留,以及文本框样式继承和图表布局处理。
- 工作台市场稳定性:延长市场目录请求等待时间,并改善已安装项导航、缓存目录展示和网络下载失败时的反馈。
- 桌面更新交互:区分后台更新通知与手动检查更新对话框;保留可操作的下载失败提示,并使手动检查遵循更新策略接口。
- 版本回退选择:调整更新与关于界面的交互,并限制可选的回退版本。
性能与优化
- Office 模板准备:为 Office 运行时下载和模板渲染产物增加构建缓存,并提取可在多平台构建间共享的模板与 PPT 运行时资源,减少重复下载和渲染。
- Office 转换可靠性:LibreOffice 模板准备遇到超时可重试;同时缩短发布流程中单次渲染的等待上限,避免偶发卡死长期阻塞构建。
- PPT 导入资源占用:拆分并优化模板转换、几何处理、媒体导入和预览流程,控制大文件导入时的内存使用。
- 发布流水线:减少重复执行的测试工作,并优化 DOCX、PPT 集成测试中的重复初始化和渲染;发布测试仍保留常规单测与核心契约校验。
- 签名与公证:调整 macOS 公证上传传输,并为 Apple 公证票据装订增加重试,以应对票据分发延迟。
- Office 字体发布验证:增加 Windows PPT 字体布局专项验证流程。
升级说明
- 工作台布局:工作台现支持默认与紧凑顶部布局;如需与原有界面保持一致,可在工作台布局设置中选择适合的模式。
- 市场工作台更新:对于已安装的旧版市场工作台,应用会识别其来源并按版本检查更新;替换现有安装时,可能需要根据检测到的风险确认操作。
说明
- 产品介绍:统一多语言 README 中的 Dataelem 产品标识,并补充中文介绍中的 DSH Client 名称。
- 工作台文档:更新中英文快速入门与开发指南,说明布局选择、首次使用检查及应用内 Agent 的重启要求。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。

基于 DeepSeek Harness,增强主流模型适配、Word / Excel / PPT 模板、启动异常恢复与工作台,提供开箱即用的桌面体验。
下载安装
请前往官方网站下载 DSH Desktop。
DSH Desktop 会自动检查更新。新版本会先进行灰度测试,确认稳定后再向所有用户全量推送。
加入社区
DSH Desktop 带来了什么
DeepSeek Harness 提供 Agent Runtime、Web UI 和基础模型接入能力。DSH Desktop 复用这些基础,重点增强以下体验:
- 主流模型适配:优化模型提供方配置与首次接入,补充模型搜索、图片输入及推理能力配置,并改善第三方模型兼容性。
- Office 三件套模板:提供 Word 原生套版、Excel 案例工作簿及 PPT 可编辑模板,结合业务技能生成 DOCX、XLSX、PPTX;桌面端随附 Python 和 Office 处理依赖。
- 启动异常与插件故障恢复:结合启动和前端诊断定位问题,提供引导恢复、安全模式及修复 Agent 入口,尽量保留用户会话与配置。
- 工作台:集中浏览、安装和打开工作台应用,支持市场安装与本地导入,并复用 Harness 会话交互。
- Agent Preset 迁移:通过
.dshpreset包导入导出自定义 Preset,安装前检查冲突并提示信任风险。 - 手机连接:扫码配对后,通过局域网或可选公网隧道在手机上继续会话。
- 原生桌面体验:自动管理 Harness 启停,集成系统目录选择、原生菜单与窗口;应用升级保留用户数据,并提供自动更新检查。
Office 三件套
提供 Word、Excel、PPT 三种制作模式。选择模板并提供材料,即可让 Agent 按模板制作可继续编辑的文件。
- Word:沿用原生模板的版式与样式,适合通知、纪要、报告等文档,输出 DOCX。
- Excel:基于案例工作簿整理数据、制作分析与图表,输出 XLSX。
- PPT:内置 16 套模板、192 种版式,输出可编辑 PPTX,也支持导入个人模板。内置模板预览使用英文,生成内容支持中文和英文;预览语言不决定输出语言。
桌面端随附 Python 和 Office 处理依赖,无需另行安装这些运行环境。PPT 模板模式的自动提示词仅在当前会话启用该模式时生效。
工作台
工作台把面向具体业务的操作界面与 Agent 会话结合起来,让常用任务不再只有聊天入口。
你可以在工作台市场浏览、收藏和安装应用,也可以导入本地开发的工作台。打开后,在业务界面中操作,并结合关联的 Agent 会话完成任务;安装或更新后,按界面提示重启即可加载。移除工作台不会删除已有会话和项目文件。
手机连接
从 Harness 菜单选择“连接手机…”,再扫描配对二维码。
- WiFi 下扫码即可连接。
- 互联网隧道需要再输入电脑上显示的 6 位连接密码。默认是 5 分钟、只存在内存里的临时密码;只有在「连接手机」窗口勾选同意后,才会在本机生成长效密码。
Harness 本身始终运行在随机的 127.0.0.1 端口。手机访问由独立的配对 Bridge 提供。Cloudflare Quick Tunnel 是常态长连接路径;免费 Pinggy 是 Cloudflare 不可用时(如中国大陆)的备用通道,大约 60 分钟后失效。桌面端断开连接后,手机会话随即失效。
Cloudflare 启动失败时会尝试 Pinggy。若已显示 Cloudflare 配对链接,但手机无法打开,可点击“扫码打不开?换一条线路”切换到 Pinggy。
安全模式与故障恢复
如果第三方插件导致启动或页面渲染异常,DSH Desktop 会结合 Runtime 与前端证据定位相关插件,并打开引导式恢复界面。
从 Harness 菜单选择“以安全模式重启…”,可暂时屏蔽第三方插件,同时保留 Agent、会话、模型配置和工作区。你可以在管理界面停用问题插件,再重启正常模式验证;停用不会删除插件和用户数据,之后可以重新启用。
恢复页面会检查插件是否有兼容更新;有可用版本时,可升级对应插件,安全模式还支持批量升级。需要帮助时,鼠标悬停“微信群”即可显示二维码,点击 Discord 则会打开社区链接。
当正常界面无法进入时,也可以通过 --safe-mode 启动。例如 macOS:
open -a "DSH Desktop" --args --safe-mode
本地数据与安全边界
- 会话与配置保存在本机用户数据目录,应用升级不会覆盖这些数据。
- 内置侧栏浏览器与应用权限隔离;普通外链交由系统浏览器打开。
- 手机通过扫码配对连接;互联网连接还需要输入电脑上显示的连接密码。
- Agent 的文件与命令操作受权限控制,请谨慎批准敏感操作,并只安装可信插件。
平台支持
| 平台 | 分发形式 | 状态 |
|---|---|---|
| macOS Apple Silicon | 已签名并通过公证的 DMG/ZIP | 支持 |
| macOS Intel | 已签名并通过公证的 DMG/ZIP | 支持 |
| Windows x64 | 已完成代码签名的 NSIS 安装包 | 支持 |
| Windows ARM64 | — | 当前不支持 |
| Linux | — | 当前不支持 |
Harness 包含目标平台原生依赖,因此每一种正式安装包都在对应操作系统与架构上构建。
开发与架构
欢迎参与贡献。工程说明已拆分为独立文档:
- 开发指南 — 本地环境、验证、补丁维护与原生平台打包
- 运行架构 — 启动流程、持久化数据、安全边界、故障恢复、手机连接与更新
- 发布手册 — 签名与正式发布控制
- Preset 包格式 — 可移植 Agent Preset 契约
提交修改前请运行 npm test、npm run typecheck 和 npm run build,并实际操作受影响的应用流程。请勿在 Issue、日志、截图或测试数据中提交真实 API Key。
友情链接
dsh-market 是 DeepSeek Harness 社区插件市场,可在 Harness 界面中浏览和搜索插件、查看截图、安装或更新包、启停插件以及切换主题。
许可证
DSH Desktop 采用 MIT License 开源。
DeepSeek Harness 及其依赖仍遵循各自的上游许可证与商标规则。DSH Desktop 是独立的社区桌面应用。
了解企业版
企业版由 BISHENG 桌面客户端与 BISHENG 企业平台服务端组成。客户端基于 DSH Desktop,员工通过企业账号结合本地文件使用获准的模型、知识、工具和技能;服务端集中配置资源与权限,管理积分和用量。企业版的 BISHENG 客户端与服务端均已开源,可通过下方仓库获取源码。
企业管理平台开源仓库 · 企业版客户端仓库 · 企业版介绍