RAFOLIE/dsh-desktop-windowos

Name: RAFOLIE/dsh-desktop-windowos
Author: RAFOLIE

Desktop桌面端 Native原生 ⭐ 22 MIT Clients & Launchers客户端与启动器 Dev Workflow开发与代码工作流 Productivity & Tasks效率与任务

DeepSeek Harness桌面外壳 —— 基于Tauri v2，托盘加原生网页聊天加任务完成通知提示，单便携可执行文件

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-desktop-windowos is a native Windows desktop client built exclusively for DeepSeek Harness (DSH). It is developed with Tauri v2, React 18, and TypeScript, and distributed as a single 4.5MB portable executable that requires no installation or unpacking. After you launch the app, it will automatically spin up the local DSH web service, embed the native DSH web chat interface inside its window, stay resident in the system tray, and send a system notification when any task is completed.

The recommended installation workflow is to first install DSH via npm or pnpm to any local folder, place the downloaded exe in the root of that same folder, then double click the exe to start. The app will automatically detect the nearby DSH executable and launch with zero additional configuration required. After the first successful launch, any existing “DeepSeek Harness Web” desktop shortcuts will automatically be migrated to work as login entries for this app, and after upgrading you will need to quit the old version from the system tray before opening the new one.

The project follows a three-stage release process, with the stable channel enabled by default, and supports automatic updates in-app. Users can switch to the pre-release channel to test out new bleeding-edge features if they want. To run the app, you must have Node.js version 22.19 or higher, or version 24 or newer installed on your system. If you do not have DSH installed locally, the first boot page supports one-click global automatic installation of DSH. Since the exe is unsigned, Windows SmartScreen may show a warning on your first run.

dsh-desktop-windowos 是专为 DeepSeek Harness (DSH) 打造的 Windows 桌面客户端，基于 Tauri v2、React 18 和 TypeScript 开发。打开应用后会自动拉起本地 DSH Web 服务，在窗口内嵌原生 DSH 网页聊天界面，程序常驻系统托盘，任务完成后会弹出系统通知。它以单个约 4.5MB 的免安装可执行文件分发，无需解压，双击即可运行。

推荐的使用方式是先通过 npm 或 pnpm 安装 DSH 到任意文件夹，再将 exe 文件放到同一文件夹根目录双击启动，应用会自动发现邻近的 DSH 可执行文件，实现零配置启动。首次启动后，原有「DeepSeek Harness Web」桌面快捷方式会自动迁移为登录入口，升级后需先从托盘退出旧版再重新打开。

应用遵循三段式发布流程，默认使用稳定更新通道，支持自动更新，用户也可切换到预发布通道体验测试版本。运行要求系统已安装 Node.js 22.19 以上或 24 及以上版本，若本地未安装 DSH，首次启动支持一键全局自动安装，exe未获得数字签名，首次运行可能触发 Windows SmartScreen 警告。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-desktop-windowos（RAFOLIE/dsh-desktop-windowos）
仓库：https://github.com/RAFOLIE/dsh-desktop-windowos
本站详情页：https://www.yhbd.top/plugins/rafolie-dsh-desktop-windowos/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 22 · 最近提交 2026-10-01 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

22 stars - an early-stage project星标 22，属于早期项目
Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端：安装会下载可执行文件，请核对发布者与校验和

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-desktop-plugin

把 RAFOLIE/dsh-desktop-windowos 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

28.9 KB · 缓存于 2026-10-01 22:09:57 · 28.9 KB

DSH Desktop (dsh-desktop-windowos)

中文 | En

DSH Desktop — native webchat in the shell window

中文

DeepSeek Harness(DSH)的 Windows 桌面壳,基于 Tauri v2 + React 18 + TypeScript。打开应用 → 自动拉起本机 DSH Web 服务 → 窗口内嵌原生 webchat(常驻壳) → 托盘常驻,任务完成弹系统通知。交付物是单个免安装裸 exe(约 4.5 MB)。

推荐用法:在任意文件夹执行 pnpm add @deepseek-ai/dsh(或 npm i @deepseek-ai/dsh),把 exe 放进同一文件夹的根目录双击即可——应用自动发现旁边的 node_modules\.bin\dsh.cmd,启动零下载、零配置、不询问。

桌面「DeepSeek Harness Web」快捷方式在应用 v1.6.52+ 首次启动后自动迁移为登录入口：点击时启动/唤起桌面应用，等待后端就绪并在默认浏览器完成登录。升级后请先从托盘退出旧版应用再重新打开一次；自定义网页地址保持原样。

更新通道(三段式发布)

应用按三段式节奏发布,releases/latest 即稳定通道:

开发期:每个迭代版本发为 GitHub 预发布(开发版)——自动更新不触碰(latest 天然排除),想尝鲜从 Releases 手动下载
稳定性检查:功能收敛后的检查版与修 bug 迭代仍走预发布
稳定版:仅当作者确认稳定使用后才转正(latest),桌面端自动更新开闸——已装用户下次启动即升级

桌面端自动更新支持稳定与预发布两个通道(更新中心可切换或关闭自动更新):稳定通道为默认,预发布通道供尝鲜与测试机验证。

功能

开箱即用:双击 exe 启动本机 DSH 并嵌入原生 webchat。已安装候选等待最多 120 秒，npx 最多 300 秒；通过只读包文件识别 --no-open，不会为参数检测启动 profile。
自绘标题栏:无边框窗口,Comfy 式胶囊控件(鲸鱼标+名字+箭头)整颗居中——点击打开环境管理面板(开启态蓝边高亮、箭头翻转);拖拽区/最小化/最大化/关闭自绘,Win 贴靠与边缘缩放原生保留
设置工作区:点击标题栏胶囊打开左右布局的设置页，包含常规、外观、环境、更新和日志；支持全局设置搜索、图标导航、键盘操作与窄窗口布局。聊天 iframe 常驻，切换设置页保留聊天状态。
外观定制:浅色 / 深色 / 跟随系统；DSH、海洋、森林、紫罗兰、琥珀、玫瑰六个预设。分别设置强调色、背景色、文字、前景卡片和顶部/侧栏边框色；自由选色、层次对比度、字体字号、手形光标和半透明侧栏。主题支持复制、粘贴、导入与重置；语言位于常规。
日志体系(ComfyUI 式):dsh.log 只记壳自身事件(启动/监护/更新;DSH web 输出不入日志,不再膨胀),[本地时间] [INFO/WARN/ERROR] 格式逐行着色,每次启动轮转历史文件;启动页「查看日志」实时看终端在跑什么;日志页带等级筛选/自动跟随/清空显示
诊断包:面板「更多 → 导出诊断信息」一键把环境配置+本次日志组装成 markdown——复制到剪贴板可直接粘贴给 AI 排障,无需翻目录查全局安装
托盘常驻:关闭窗口(X)只是隐藏到托盘,DSH 后台继续运行;双击托盘图标或右键 → Open DSH 随时唤回窗口;右键还有「重启 dsh web(后端)」「前后端重启」「检查前端更新」「环境信息」
故障自愈与可见性:DSH 崩溃的真实原因以 ERROR 写入日志并直接显示在启动页错误视图(摘要自动定位到 Error 行而非堆栈尾巴),附手动修复命令——再无静默崩溃循环;缺 profile 包时自动带冷却期旁路补装并重试;settings.yaml 被 Web UI 写坏(如 key:value 缺空格)时自动备份+修复+round-trip 校验后才落盘;启动链用绝对路径解析 dsh/pnpm,不受 GUI 环境 PATH 影响
DSH 监护自愈:DSH 意外退出(市场更新自重启/崩溃)时自动重拉并刷新界面,无需人工干预;连续快速崩溃自动熔断报错
自动更新带进度:更新时顶栏名字旁绿色圆环旋转 → 完成对勾 → 自动重启生效(无需手动重开;更新只在启动时发生,不打断对话);应用每次启动自检 GitHub 最新 Release,更新通道与自动更新开关见更新中心
更新中心:分别管理 DSH 内核和桌面壳。内核按完整 SemVer 比较运行版本与所选 npm 标签（latest / next / 高级 alpha），避免将较旧的 rc 版误报为更新；降级需要确认，复制命令不执行安装。仅对经过来源验证的应用托管全局 npm 安装提供一键更新，并核验重启后的进程、路径与版本；其他安装来源显示对应操作建议。桌面壳继续提供稳定 / 预发布通道、自动更新开关及完整性校验。
设置中心(环境面板第四标签):窗口置顶 / 开机自启(最小化待命) / 关闭按钮行为(隐藏到托盘[默认] 或直接退出) / 记住上次页签——全部以滑动开关呈现、点击即时生效并跨重启持久化;各子项说明收纳在功能名旁的「?」里,点击弹出气泡详读
主题模式:跟随系统 / 深色 / 浅色，桌面外壳即时切换；内嵌聊天的明暗模式重启后同步。
六种界面语言实时切换:设置 → 外观 → 语言(简体中文/繁體中文/English/日本語/한국어/Русский),整个壳界面与托盘菜单即时换语言、无需重启;默认「跟随系统」——启动时按 Windows 显示语言自动选择(简繁分流,未适配语言回退英文),也可手动指定;Rust 侧系统通知(更新流程/下载完成/任务完成)同步六语;新增语言只需一份字典(欢迎提 issue/PR)
缩放与下载:Ctrl +/-/0 与 Ctrl+滚轮缩放整个界面(焦点在内嵌页也生效);内嵌页面触发的下载(session log 导出等)统一落「下载」文件夹并弹系统通知
桌面快捷方式可配置：通过 profile 的 cordis.patch.yml 控制创建行为；本插件目前不提供 GUI 开关。见下方“快捷方式配置”。
插件包自动同步(带验真):应用启动时自动把已安装的 dsh-desktop-plugin 对齐到 npm 最新版(只升不降,带 pnpm 新发布冷却期旁路);安装后回读 node_modules 验证真实落地,pnpm 冷却期静默保留旧版不再虚报成功
图片拖放/粘贴:与浏览器一致——可拖入或粘贴 png/jpg/webp/gif 作为对话附件(DSH v1 支持的四种格式)
一键重启 DSH:托盘「重启 dsh web(后端)」只重启 DSH 服务(会话数据在 ~/.dsh 持久化);「前后端重启」连壳带后端全新拉起(无论后端是谁启动的都会清干净),新装插件随之加载,插件卡死 webchat 时一键满血——面板「更多」里也有同款
托盘图标固定任务栏:启动时自动写入 Windows 通知区域设置(IsPromoted),图标不再每次被收进任务栏角溢出
任务完成通知:会话从运行中转为空闲时弹 Windows 系统通知,带两个按钮——「打开窗口」(复现并聚焦窗口)和**「明白」**(收起通知);不点击则数秒后自动收起
外链统一接管:聊天/插件市场里的 http(s) 外链,左键点击与右键「在浏览器中打开」都会送达系统默认浏览器——包括 target=_blank 等在壳内会被 WebView2 吞掉激活的链接(替换误导性的 WebView2 默认菜单)
升级失败自动回滚:dsh 后端升级前自动保存当前版本号;升级后如果启动失败,错误界面提供「回滚之前版本」按钮一键恢复,回滚过程后台执行不卡界面
⚠️ 不同 DSH 版本间的会话历史:dsh 使用 fail-closed 会话格式保护——新版本写入的会话日志包含旧版本不认识的事件类型,旧版本会拒绝加载(防止数据损坏)。跨版本切换(升级/降级/源码↔npm)后历史对话可能暂时不可读,等升级到相同或更新版本即可恢复。会话数据不会丢失,只是暂时无法读取
附加模式:启动时若 3080 已有 DSH 在跑,直接连接不重复拉起;退出时也不会动别人(先于应用存在)的实例
干净退出:仅托盘右键 → 「退出(关闭 DSH)」才真正退出,自动 taskkill /T 杀掉自己拉起的整棵进程树,零孤儿进程
防重复实例:exe 被再次双击只会唤回已有窗口,不会开第二个
便携小巧:单文件、无安装器、无 DLL 依赖,数据/日志写在 %LOCALAPPDATA%\dsh-desktop\
本地优先启动,npm 全局为主推荐:按候选链自动启动 DSH——DSH_CMD 环境变量(失败自动降级,不再卡死)→ 自定义路径(启动页可填,永久记住)→ PATH 全局安装的 dsh web → 项目本地 node_modules\.bin\dsh.cmd(exe 同目录/工作目录/用户目录)→ 已确认过的 npx;全都找不到时启动页提供一键全局安装(应用直接执行 npm install -g @deepseek-ai/dsh,约 1-3 分钟,装完永久走最快路径、终端获得 dsh 命令)、npx 下载(备选)、手动填路径、重新检测、退出——不会静默下载任何东西

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 RAFOLIE/dsh-desktop-windowos 的 README.md。在 GitHub 查看原文 →