EricXu20266/dsh-gui
DeepSeek Harness (DHS) Electron GUI client — webui to gui, kernel untouched
安装Install
dsh plugin --profile web add github:EricXu20266/dsh-gui把 EricXu20266/dsh-gui 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-gui — DeepSeek Harness 桌面客户端
🌐 中文 | English
DHS (DeepSeek Harness) 的 Electron GUI 客户端：把 web ui 的使用方式封装为原生桌面 GUI。内核最大限度的保持 DHS。
DHS 官方以 web ui（浏览器）形态交付。dsh-gui 用 Electron 承载同一套 DHS 前端，把「浏览器里打开网页」变成「桌面应用」，同时保持 DHS 内核零改动。
下载
| 平台 | 安装包 | 说明 |
|---|---|---|
| Windows 10+（x64） | dsh-gui-v0.2.0.zip |
免安装包，解压后双击 dsh-gui.exe 启动 |
| macOS（Apple Silicon / arm64） | dsh-gui-0.2.0-arm64.dmg |
安装包，打开后拖入 Applications 启动 |
下载见 GitHub Releases。首次启动自动安装捆绑的 DHS 依赖（可选国内源加速），免手动配置环境。
系统要求
- Windows 10+（x64）：免安装包（zip），见上方下载
- macOS 14+（Apple Silicon / arm64）：dmg 安装包，见上方下载
- 源码运行：任何平台均可通过
pnpm install && pnpm dev从源码启动（见「快速开始」）
特性
- 原生桌面体验：独立窗口、系统托盘（X 最小化到托盘、托盘右键退出）、单实例锁、DeepSeek 蓝鲸鱼图标
- 动态端口：host 以
dsh web --port 0启动，解析就绪 URL 后加载窗口，避免 3080 端口冲突 - 首次安装向导：5 步流程（欢迎 → 下载源选择 → 下载进度 → 真实校验 → 完成），国内源/原生源/系统代理可选，全程进度真实显示
- 捆绑分发：打包版捆绑 Node + pnpm + DHS 源码 + 内置插件，首次启动自动装依赖，开箱即用
- 内置插件体系：捆绑 5 个插件（插件搜索 / Skill 管理 / MCP 管理 / 全局代理 / 关于），覆盖 DHS 的日常管理与扩展——详见下方章节
- 插件 agent 感知：每个内置插件向 host 注册
systemPromptsection，模型每轮会话都能感知已安装插件的能力说明，无需手动提示 - 全局代理：设置页图形化配置系统代理/手动代理，GUI 启动时注入环境变量，DHS 全链路（LLM 调用 / 内置搜索 / MCP 客户端）走代理
- 中英双语：界面语言跟随系统，可手动切换，并映射到 DHS 内核
locale.preference（内核 UI 跟随） - 安全基线：主窗口只允许本机 host origin 导航，外链走系统浏览器，危险权限默认拒绝，向导页启用 CSP
- 安装日志：安装全过程落盘
%APPDATA%/dsh-gui/install.log，失败可追溯 - 零内核改动：DHS 内核保持官方原样，GUI 只做壳
内置插件
dsh-gui 捆绑 5 个插件，除 dsh-about 外均为独立开源仓库，随打包版分发、首次安装自动注册到 DHS profile：
| 插件 | 仓库 | 功能 |
|---|---|---|
| dsh-discovery | EricXu20266/dsh-discovery | 社区插件搜索 + LLM 安全审计 |
| dsh-skillmanager | EricXu20266/dsh-skillmanager | Skill（技能）图形化管理 |
| dsh-mcpmanager | EricXu20266/dsh-mcpmanager | MCP server 图形化管理 |
| dsh-proxy | EricXu20266/dsh-proxy | 全局代理配置 |
| dsh-about | 内置（本仓库 plugins/） |
设置页「关于」显示版本信息 |
dsh-discovery — 插件搜索与 LLM 审计
定位是社区插件的发现与 LLM 审计工具：DHS 目前没有官方插件市场，第三方插件本质上是可执行代码，因此它刻意做成只读——只负责「发现 → 筛选」，安全审查交由 LLM 完成（一键生成审查 prompt，LLM 读源码查风险，通过则装、有风险则停）。
- 浏览：拉取 GitHub
dsh-plugin社区话题下的全部插件仓库（有界分页 + 超时降级） - 分类：7 类功能分类 + 其他（UI 增强 / 终端 / 工具 / 记忆 / 模型 / 通知 / 开发）
- 场景：5 个使用场景（写作 / 开发 / 模型接入 / 自动化 / 通知集成），自动去重限量推荐
- 搜索：38 词中英同义词表，中文关键词也能命中英文插件数据
- LLM 审计安装：一键生成审查 prompt 交给 LLM（读源码/查依赖/识别恶意行为），通过则
dsh plugin add安装、有风险则列出风险点停止；官方（deepseek-ai）标记、已安装标识、检查更新同样带安全审查（对比新旧差异，通过才 update）
完整的设计说明（安全模型、拉取规则、场景化筛选规则）见该仓库的 README。
dsh-skillmanager — Skill 管理
DHS 的技能体系没有中心化注册表——文件即注册：把 <name>/SKILL.md 放进扫描根，宿主自动发现并纳入模型可用目录（~/.dsh/skills、~/.agents/skills 等 5 个扫描根）。本插件以图形化方式呈现这套体系：技能列表、分组、启用/禁用（frontmatter 权限开关）、新建引导、LLM 审查。技能的创建与编辑由 host agent（LLM）执行，本插件负责「看得清、管得住」。
dsh-mcpmanager — MCP 管理
DHS 的 MCP 没有独立存储——一个 server = 一条 @deepseek-ai/dsh-mcp-client 插件实例，持久化在 ~/.dsh/profiles/web/cordis.patch.yml。本插件以表单化方式增删改 MCP server 配置（stdio / streamable-http 两种传输），保存后热重载生效（新会话工具列表立即可用，无需重启），并提供 LLM 验证引导。
dsh-proxy — 全局代理
DHS 网络栈全链路裸 fetch()，不读 Windows 系统代理；Node 24+ 支持 NODE_USE_ENV_PROXY 环境变量代理（bootstrap-only 安全设计，.env 禁止设置代理变量）。本插件在设置页「通用设置」图形化配置系统代理 / 手动代理，持久化到 ~/.dsh/settings.yaml，由 dsh-gui 启动时注入环境变量，让 LLM 调用 / 内置搜索 / MCP 客户端全链路走代理。
dsh-about — 关于
设置页「关于」tab（内置插件，随仓库打包、不独立发布），展示 dsh-gui / 内核 / 运行时（Electron + Node）/ 已装插件四层版本信息，方便核对版本与排查问题。
插件 agent 感知（systemPrompt section）
每个内置插件在 host 侧注册一段 systemPrompt section（plugin:<id>），随会话注入模型上下文。模型因此天然知道已安装哪些插件、各自能做什么——例如用户问「帮我看看有哪些插件」时，模型直接依据插件注册说明作答，无需额外文档。
架构
┌─────────────────────────────────────────────┐
│ Electron App（dsh-gui） │
│ main 进程 ──spawn──> DHS host 子进程 │
│ │ └─ apps/cli/bin.js │
│ │ --profile web │
│ │ --port 0 │
│ │ → 127.0.0.1:<p> │
│ BrowserWindow loadURL ←─────────────────────┘
└─────────────────────────────────────────────┘
- GUI 壳：Electron（窗口、托盘、进程管理、安装向导、单实例锁）
- DHS host：子进程方式运行官方
dsh（打包版用捆绑 Node 24，开发态用系统 Node），内核 100% 保持 - 通信：本地 HTTP + WebSocket（
127.0.0.1，端口由--port 0动态分配，避免 3080 冲突） - 配置：
~/.dsh（DHS 通用 home，web/gui 双模式共用）
⚠️ 已知边界：DHS 的 cordis loader 依赖 Node 内部 API（
node-addon-require-builtin）， 与 Electron 内置 Node 不兼容——因此 host 走子进程而非 in-process（详见 docs/ARCHITECT.md）。
快速开始（开发态）
# 依赖（workspace 包含 ../deepseek-harness）
pnpm install
# 构建 DHS（首次需要：host lib + client lib + web dist）
pnpm --filter @deepseek-ai/dsh-root run build
# 提交前自检（先格式化，再检查）
pnpm format
pnpm typecheck && pnpm check && pnpm test
# 启动
pnpm build && pnpm start
打包分发
Windows（本地打包）
一键脚本（推荐，输出全程 console）：
build-win-unpacked.bat
或手动（package.json 脚本）：
pnpm package:dir # 免安装包 → release/win-unpacked/
pnpm package # nsis 安装包 → release/dsh-gui-setup-*.exe
产物见 GitHub Releases。
macOS（源码构建）
dsh-gui 是 workspace 项目，内核依赖 deepseek-harness 必须放在 dsh-gui 同级目录（pnpm-workspace.yaml 的 ../deepseek-harness、图标源 apps/web/public/favicon.svg 都按此相对路径解析）：
# 目录布局：两个仓库同级
# ~/dev/dsh-gui
# ~/dev/deepseek-harness
git clone https://github.com/EricXu20266/dsh-gui.git
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd dsh-gui
pnpm install # 安装依赖（含 workspace 的 DHS 包）
pnpm --filter @deepseek-ai/dsh-root run build # 构建 DHS 内核（lib + web dist）
# 开发态运行（用系统 Node，无需捆绑运行时）
pnpm build && pnpm start
# 打包 macOS 应用（Apple Silicon，产物 release/*.dmg + *.zip）
node scripts/gen-icons.mjs # 生成 mac 图标（icon-512.png）
pnpm exec electron-builder --mac --arm64 --publish never
打包版需要捆绑 Node + pnpm 运行时（
resources/runtime/，该目录被 gitignore，需自行准备）：从 nodejs.org 下载 darwin-arm64 版 Node、从 npm registry 取 pnpm tarball，解压到对应目录即可。
打包版结构：resources/runtime（捆绑 Node + pnpm）、resources/dhs（DHS 源码种子，不含 node_modules）、resources/dsh-*（四个独立插件仓库 + 内置 dsh-about）。首次启动向导会把 DHS 源码复制到 %APPDATA%/dsh-gui/dhs（macOS 为 ~/Library/Application Support/dsh-gui/dhs）后再安装依赖，避免写入应用资源目录。
目录结构
dsh-gui/
├── electron/ # GUI 壳引擎（main/host/installer/proxy/paths/tray/preload/renderer）
├── plugins/ # 内置插件（dsh-about；其余 4 个为独立仓库）
├── mac-packing-resource/ # 4 个外置插件源码（mac CI 单仓库打包用）
├── platform/ # 平台适配（windows 打包 / macos 预留）
├── resources/ # 资源（图标、打包运行时：捆绑 Node + pnpm）
├── install/ # 安装器配置
├── scripts/ # 构建/打包脚本
├── tests/ # 单元测试（node:test + tsx）
├── tools/ # 辅助工具
└── docs/ # 文档体系（ARCHITECT/DEV-TRACKER/index...）
详细文档见 docs/index.md。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…