itchenshi/dsh-ready-gui 预览 preview

itchenshi/dsh-ready-gui

DeepSeek Harness 桌面壳:内嵌 Web UI、引擎自动保持最新、预置 4 个插件、插件装坏能自愈。另有 Linux AppImage / zip 产物(CI 构建,未实机验证)。

Project Overview项目介绍

itchenshi/dsh-ready-gui is a cross-platform Electron desktop shell built specifically for DeepSeek Harness (DSH), wrapping the official @deepseek-ai/dsh CLI/web into a native window with system-tray behavior. It auto-downloads and self-updates the DSH engine from the npm registry on first launch (1–2 minutes with a progress page), binds only to localhost loopback, and stores all sessions, credentials, and profiles under DSH_HOME, defaulting to ~/.dsh. Installation happens via GitHub Releases installers for Windows/macOS/Linux, or via npm install && npm start from source using Node.js ≥ 23.

Four DSH-bound plugins are bundled inside the shell: dsh-model-surplus (model quota display), dsh-gui-last-session (resume last conversation), dsh-opencode-go-path (auto-add DeepSeek V4.1 model + inject session header to fix HTTP 400), and dsh-keys-setting (Enter/Shift+Enter/Ctrl+Enter bindings). Each lives in its own repository and can also be installed into other DSH hosts. A dedicated Settings window exposes engine update policy, per-plugin install/enable toggles, data-directory switching with migration prompts, close-to-tray behavior, and auto-resume of the last session; install/uninstall requires an engine restart, while enable/disable hot-reloads immediately.

The shell ships with a portable Node runtime so end users need no extra dependencies; packaged installers (133–194 MB) are produced only by GitHub Actions across three runners, while Gitee and GitCode mirrors host source tarballs (free-tier attachment limits block installers there). Both this project and the bundled engine are open-source and MIT-licensed, and AppImage artifacts can only be built on Linux/macOS or CI. First-run users should explicitly toggle their desired plugins under Settings → Third-party plugins and pick language/theme inside the Harness page itself.

itchenshi/dsh-ready-gui 是一个面向 DeepSeek Harness(DSH)的 Windows / macOS / Linux 桌面外壳,基于 Electron 打包,自动下载并管理 @deepseek-ai/dsh 引擎,启动时只监听本机回环地址,会话与设置存于 ~/.dsh。用户从 GitHub Releases 下载安装包,或用 npm install && npm start 从源码运行;首次启动约 1–2 分钟下载引擎。

壳内自带四个与 DSH 紧密绑定的内置插件——模型余量、会话续接、OpenCode Go 路由、按键设置——这些插件也作为独立仓库发布,可装到其它 DSH 宿主;设置窗口提供引擎更新、第三方插件勾选、数据目录切换、关窗行为等开关,启用/禁用即时生效,装卸则需重启引擎。典型用户是不想碰命令行的 DSH 用户。

打包产物自带便携 Node,终端用户无需额外运行时;Gitee / GitCode Release 仅提供源码包,安装包只在 GitHub Actions 三种 runner 产出。引擎本身仍是官方 MIT,本项目 MIT 许可。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
  • 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 github:itchenshi/dsh-ready-gui

把 itchenshi/dsh-ready-gui 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Ready GUI

DeepSeek Harness(DSH)的桌面壳(Windows / macOS / Linux):装上就有界面,不用碰命令行。

English 中文 license release stars platform GitHub Gitee GitCode

DSH 本体是一套开源 Agent 框架(@deepseek-ai/dsh),官方只给命令行和网页。这个壳把它装进一个 原生窗口:引擎它自己装、自己升级,数据在你自己手里,关掉就是托盘里的一个图标。

打开就能用

你想要 这里怎么做
不想敲命令 双击应用图标就完事。引擎由壳自己下载安装(首次 1–2 分钟,状态页有进度)
不想管升级 每次启动都自动检查,默认「问你要不要更新」;DSH Ready GUI 自己有新版也会通知你
不想配模型 首次启动会主动问你:设置窗口最上方一张卡片,点一次「一键开启」就装齐 —— 模型余量、会话续接、网关路由、按键设置
不想丢会话 重启后自动回到你上次那个对话(内置「会话续接」)
不想被人乱看 壳只监听本机回环地址;插件自己的 HTTP 路由都开了鉴权,裸 curl 拿不到你的用量和余额
想搬走数据 数据目录可切换(默认跟随系统 ~/.dsh),切换时问你要不要一起搬,会话记录跟着走

四个内置插件各自也是独立仓库(可以单独装到别的 DSH 宿主):

插件 一句话 仓库
模型余量 dsh-model-surplus 会话标题右侧显示当前模型的用量 / 账户余额 仓库
会话续接 dsh-gui-last-session 重启后回到上次那个对话 仓库
网关路由 dsh-gateway-models 声明 OpenCode Go / Command Code 的路由协议与地址,并自动补齐它们的模型 仓库
按键设置 dsh-keys-setting Enter / Shift+Enter / Ctrl+Enter 各自设成发送或换行 仓库

它们为什么内置、而不是从 npm 装? 原计划是发布到 npm,让插件更新不必等壳发版。但 npm 账号注册走不通(www.npmjs.com 返回 Cloudflare 托管挑战),包发不出去;而 profile 里登记一个 registry 上没有的包,会让插件直接从引擎的 bundle 列表里消失,并让这个 profile 里每一次安装 操作一起失败(都实测到了)。所以保持内置:装上 GUI 就有,勾选即在,不需要命令行。

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

← 上一个 Prev dsh-workbench-layout 下一个 Next dsh-cool-theme →