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 许可。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-ready-gui(itchenshi/dsh-ready-gui)
仓库:https://github.com/itchenshi/dsh-ready-gui
本站详情页:https://www.yhbd.top/plugins/itchenshi-dsh-ready-gui/
本站登记:类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-09-28 · 主语言 JavaScript · 未检测到 DSH 插件清单
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【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 更稳。
- 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):装上就有界面,不用碰命令行。
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 →
nexu-io/open-design
Devin-AXIS/iPolloWork
EthanYoQ/AI-Novel-Writer
ysr666/dsh-vision-router