Yuel25/dsh-desktop
A Windows desktop client for DeepSeek Harness.
安装Install
dsh plugin --profile web add github:Yuel25/dsh-desktop把 Yuel25/dsh-desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-desktop
面向 Windows 的 DeepSeek Harness 桌面客户端。
English · 中文
[!IMPORTANT] 本项目是社区开发的非官方桌面客户端，与 DeepSeek 官方无隶属、背书或合作关系。
功能
- 在无命令行窗口的情况下启动和管理
dsh web - 使用 Electron 窗口承载 DeepSeek Harness Web UI
- 自定义无边框标题栏、系统托盘和单实例运行（标题栏显示当前 profile），托盘菜单保持精简
- 可从系统托盘安全重启桌面应用及其启动的 DSH 服务
- 可在设置中选择黑色或白色标题栏，并自动保存选择
- 可在设置中切换 DSH profile（扫描
~/.dsh/profiles），切换时仅重启 DSH 服务 - 可为任意 profile 打开独立窗口，多个 profile 并行运行（各自使用独立端口）
- 内置设置窗口：外观与语言、开机自启（可隐藏到托盘）、DSH 端口、profile 管理
- 内置日志查看器与「复制诊断信息」（应用版本、dsh 版本、当前 profile 等）
- 启动时自动检查新版本，有新版本时托盘会出现下载入口并发系统通知
- DSH 服务或界面意外崩溃时自动恢复，并通过系统通知告知结果
- 检测已有的
127.0.0.1:3080服务，识别其 profile 后再连接；不一致时会提示 - 未安装 dsh 时显示安装引导页，可一键重试或打开文档
- 界面与通知支持中英双语，可在设置中跟随系统或手动切换
- 关闭窗口后驻留托盘，退出时清理本应用启动的 DSH 进程
- 记录 DSH 标准输出和错误日志（主实例与各 profile 窗口分文件记录）
- 生成 Windows NSIS 安装包
当前状态
目前应用依赖：
- Windows x64
- 在 Windows 中安装并加入
PATH的 DeepSeek Harnessdsh命令
应用尚未内置 DSH 运行时，而是启动 Windows 中现有的 DSH 安装。
快速开始
1. 在 Windows 中准备 DeepSeek Harness
npm install -g @deepseek-ai/dsh
dsh --version
如果需要社区 Web UI 插件，请先按插件自己的说明安装到 DSH 的 web profile。
2. 运行 dsh-desktop
从 GitHub Releases 下载 Windows 安装包，安装并启动。
如果 DSH 已经监听 127.0.0.1:3080，应用会识别其 profile 并连接现有实例（与所选 profile 不一致时会先询问）；否则应用会直接启动：
dsh --profile web --no-open
切换 profile
设置窗口的 Profile 区块会列出 ~/.dsh/profiles 下所有包含 cordis.yml 的子目录。选择后：
- 应用只重启自己管理的 DSH 进程，无需退出桌面应用；
- 选择会保存到用户数据目录的
settings.json，下次启动沿用； - 如果端口被外部启动的 DSH 占用，应用无法替它切换 profile，会提示并保持原选择。
列表中每个非当前 profile 旁的「新窗口」按钮会为它启动一个独立的 DSH 实例（自动分配空闲端口）并打开独立窗口；关闭该窗口即结束对应的 DSH 进程。每个实例的日志单独记录为 dsh.<profile>.stdout.log / dsh.<profile>.stderr.log。
设置与诊断
托盘菜单只保留高频操作（打开、浏览器打开、设置、重启、退出），其余选项都在设置窗口中。设置窗口包含：
- 外观：标题栏黑/白与语言切换，即时生效；
- 启动：开机自启动（可选自启动时隐藏到托盘、后台拉起 DSH）、DSH 端口（重启应用后生效）；
- Profile：切换主窗口 profile，或为其他 profile 打开新窗口；
- 日志：内置查看器（dsh 输出、错误、恢复日志及各 profile 窗口日志），也可一键打开日志文件夹；
- 诊断：一键复制应用版本、dsh 版本、当前 profile 等信息，方便反馈问题；
- 更新：手动检查新版本并打开发布页。启动时也会自动检查一次，有新版本时通过系统通知提醒。
本地开发
pnpm install
pnpm run dev
常用命令：
pnpm run typecheck # TypeScript 检查
pnpm run build # 生产构建
pnpm run check # 类型检查 + 生产构建
pnpm run dist # 生成 Windows NSIS 安装包
构建产物位于 release/，该目录不会提交到 Git。
运行机制
Electron 主进程负责窗口、托盘和 DSH 子进程生命周期。启动时会先检查 127.0.0.1:3080：
- 端口已存在且服务可用：通过监听进程的命令行识别其 profile，一致则连接现有 DSH，不取得该进程的所有权；不一致时提示用户选择。
- 端口不可用：在 Windows 中启动
dsh --profile <name> --no-open，并在应用退出时终止本应用启动的进程。 - 后端就绪后：窗口从本地加载页切换到 DSH Web UI。
日志保存在 Electron 的用户日志目录。可从托盘菜单选择“查看日志”。
安全说明
- DSH Web UI 默认只绑定
127.0.0.1。 - Electron renderer 禁止 Node.js 集成并启用上下文隔离。
- 应用自身的桥接 API（如开机自启设置）只暴露给本地加载页，DSH Web 页面无法调用。
- 外部链接交给系统默认浏览器打开。
- 应用不会在卸载时删除
~/.dsh或 DSH 会话数据。
如发现安全问题，请参阅 SECURITY.md。
路线图
- DSH 运行时诊断界面
- 设置界面与运行时诊断
- 自动更新和签名发布
- 完善安装、升级、卸载测试
贡献
请阅读 CONTRIBUTING.md。提交更改前请运行 pnpm run check。
许可证与品牌资产
项目代码使用 MIT License。DeepSeek Harness 官网图标不属于 MIT 许可范围，详情见 THIRD_PARTY_NOTICES.md。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
walkinglabs/learn-harness-engineering
Harness engineering beginner tutorial, from 0 to 1
-
YaoApp/yao
✨ All your agents and workspaces in one place, on every device you own. Track tasks on a board, accessible from desktop,…
-
Devin-AXIS/iPolloWork
Enterprise-grade, local-first Agent Workbench for people and agent teams. A unified multi-engine workspace for Codex Har…