xugulin/dsh-console

DSH 控制台 · DSH Console

绿色免安装的 DeepSeek Harness 桌面控制台 —— 解压即用，一个窗口管完启停、账单、插件与技能。

一款便携、零安装的 PySide6 DeepSeek Harness 桌面控制台 —— 解压、运行，在一个窗口中管理一切。

简体中文 · English

Python
PySide6
Platform
Portable
Themes
Chromium
macOS smoke

DSH 控制台 · 控制台页 / Dashboard

📸 截图 · Screenshots

|  |  |
|---|---|
| 模型与价格 | 插件与技能 |
| 模型与价格 · Models & pricing峰谷档位与切换倒计时、随峰谷实时切换的价目表峰谷档位、实时切换的价目表 | 插件与技能 · Plugins & skills安装 / 卸载 / 更新 / 启用停用、技能四个来源根安装、卸载、更新、启用/停用；四个技能来源根 |
| 设置 | 捐赠支持 |
| 设置 · Settings7 套亮 / 暗主题、插件摘要、关于7 套亮/暗主题、插件摘要、关于 | 捐赠支持 · Donate微信 / 支付宝收款码并排 + 感谢者名单微信/支付宝收款码并排 + 感谢者名单 |

截图摄于本机实跑，默认 1180×800 窗口；余额已打码。
截取自默认 1180×800 窗口下的真实运行。余额已打码。

🇨🇳 简体中文

平台与验证 · Platforms & verification

| 平台 | 状态 | 怎么验证的 |
|---|---|---|
| Linux | ✅ 完整支持（便携包） | 作者实机 + ./run.sh --self-test |
| Windows 10/11 | ✅ 完整支持（便携包） | 用户实机反馈 + 打包时校验启动脚本（CRLF/GBK/BOM/param 位置） |
| macOS | ✅ 可跑（从源码；暂未提供便携包） | GitHub Actions 免费 macOS runner：macos.yml —— 装 PySide6 6.11.2、离屏真起 Qt、7 套主题全部渲染、市场源设置对话框布局回归（压到 560×420 时控件不被压扁）、截图作为 artifact 上传。实测 7/7 通过 |

这个工作流特意只选不需要 harness、不需要网络的检查（CI 上没有 DSH 服务与 API key），
并上传截图：出问题时能直接看图，而不是只看一行报错。

这是什么

DSH 控制台是 DeepSeek Harness（本机 dsh-web 服务）的桌面控制中心。不用再来回切终端、敲 systemctl、开浏览器标签页、记一堆 npm 命令——一个原生窗口就能启停服务、盯住 token 花费、逛插件与技能市场、升级 harness。

基于什么搭的：项目建立在 DeepSeek Harness（@deepseek-ai/dsh）之上——控制台不重造
agent，只把它管起来；界面用 Python + PySide6（Qt 6） 写；页面里的内置浏览器基于 Chromium
（QtWebEngine），所以打开 harness 的 web 界面不需要目标机器上装任何浏览器。

发布形态是便携压缩包：免安装、不要管理员权限、不在你机器上留垃圾。

为什么值得一试

| | |
|---|---|
| 🟢 绿色无污染 | 解压就能跑。启动器把 HOME 关进包里，会话、配置、缓存、日志全都落在文件夹内，不往真实家目录写东西。实测跑完一遍 ~/.dsh、~/.npm 零改动。整个文件夹删掉，系统干干净净。 |
| 📦 零安装 | 便携包里自带 Python 3.14、PySide6、Node.js 和 harness 本体，目标机器不需要预装任何东西。 |
| 🔄 可以更新 | 控制台支持在线更新：只替换 app/ 和 tools/，旧代码自动备份成 app.bak-，绝不碰你的数据（home/）和运行时。harness 本体在专门的页面升级——选 latest / next / alpha 通道，一键升级并重启。 |
| 🚀 启动方便 | 双击启动器即可（.sh / .bat，另有静默 .vbs），还能一键装带图标的桌面快捷方式。四种前端从控制台直接拉起：内置浏览器、系统浏览器、TUI、PySide6 GUI。 |
| 🖥️ PySide6 原生 GUI | 是真窗口，不是终端套壳——7 套亮/暗主题，页面懒加载，冷启动约 95 ms。GUI 版把 harness 自己的 web UI 装进原生窗口，所以它永远不会落后于上游。 |
| 📊 账单消耗一目了然 | 账户余额、今日花费（¥ / $）、模型调用次数、总 tokens、缓存命中率、峰谷拆分、24 小时消费柱状图，以及按花费排序的会话明细。 |
| 🧩 插件与技能 | 管理已安装的插件和技能（安装 / 卸载 / 更新 / 启用停用 / 体检），并逛市场：npm 搜索 + 官方目录（3000+ 插件）、技能市场（100+）。 |
| 🖧 管理 harness 很方便 | 服务状态徽章、PID / 运行时长 / 内存 / 异常重启次数 / 端口 / 登录自启；内置与系统两份 harness 各自一个启动按钮；版本与升级通道；安装详情（路径 / bin / node / npm / registry）；Profile 与插件 bundle 顺序。 |
| 🧭 不止是仪表盘 | 本机信息（CPU / 内存 / 磁盘 / 网络）、journalctl 日志查看器、随峰谷实时切换的模型价目表，界面全中文。 |

功能一览

| 页面 | 内容 |
|---|---|
| 控制台 | 服务状态与启停重启、强制修复端口占用（一键收拾抢端口的进程）、用内置 Chromium 浏览器打开界面 / 复制地址、启动前端、今日消费 + 余额 + 24 小时柱状图 |
| Harness | 版本与升级（latest / next / alpha）、安装详情、运行状态、Profile 与插件 bundle |
| 模型与价格 | 当前峰谷档位与切换倒计时、实时价目表、¥ / $ 切换、从官方 API 同步 |
| 账单 | 账户余额、会话花费汇总、按花费排序的会话明细 |
| 插件与技能 | 两张表：插件（安装 / 卸载 / 更新 / 批量检查）与技能（四个来源根、启用停用、查看正文、调用统计） |
| 插件 / 技能市场 | npm 搜索 + 官方目录、排名与筛选、滑到底自动加载、镜像 / 区域 / 加速设置 |
| 本机信息 | 系统、CPU、内存、磁盘、网络、DSH 占用 |
| 日志 | journalctl 查看器 |
| 设置 | 7 套主题、插件摘要、关于 |
| 捐赠支持 | 支持这个项目——微信 / 支付宝收款码与感谢者名单 |

快速开始

方式一 · 便携包（推荐，什么都不用装）

1. 到 Releases 下载对应平台的 zip：Linux 约 308 MB，Windows 约 353 MB。
2. 解压到任意位置（放 U 盘里也行）。
3. Linux 跑 ./Start-DSH-Console.sh；Windows 双击 Start-DSH-Console.exe
（原生启动器，不闪黑框；报错看不到就改用 Start-DSH-Console-Debug.exe）。
4. 可选：./Install-Desktop-Shortcut.sh / Create-Desktop-Shortcut.bat，装进启动器。

方式二 · 从源码跑

git clone https://github.com/xugulin/dsh-console.git
cd dsh-console
pip install -r requirements.txt      # 只需要 PySide6-Essentials >= 6.11.2
./run.sh                             # Linux
python main.py                       # Windows / 其他平台

需要 Python ≥ 3.14（会话文件用标准库 compression.zstd 解压）。QtWebEngine（PySide6-Addons）是可选项，只有"把 web UI 装进原生窗口"的 GUI 版才需要。

常见问题

会改我的系统吗？
便携包不会：HOME / DSH_HOME / USERPROFILE 都指向包内，配置和缓存都落在包里。源码运行只写一个文件：~/.config/dsh-console/config.json（记你选的主题）。

依赖 systemd 吗？
不依赖。便携模式下 harness 是控制台的子进程——pid 落在 run/web.pid，日志落在 run/web.log，所以没有 systemd 的机器也能用（同时能单独识别系统里那份 harness）。

停止服务会不会弄丢我的网页登录态？
不会。停止走 SIGTERM 并等它自己退；丢登录态的是 kill -9，控制台从不这么干。

端口被占了、harness 起不来也停不掉，怎么办？
点控制台页的 「强制修复端口占用」（琥珀色那个按钮）。它会：找出占着端口的进程 → 先 TERM 等 8 秒、不退再 KILL → 清掉 systemd 失败状态 → 重启 dsh-web.service → 顺手拉起显示器服务并清理无主 Xvfb，最后实测端口是否真空出来、把带 token 的地址交给你。典型场景是 harness 的文件被包管理器删了、进程却还在跑（dsh: 未找到命令，端口仍被占着）——systemctl 对那种进程完全无能为力，只有这个按钮收得回来。点之前会弹确认框，把"要杀谁"（PID、进程名、命令行）写清楚再动手。

支持哪些平台？
Linux 和 Windows，各一个 zip（harness 的原生模块是平台专属的）。

开发日志

设计取舍、实测数据和 100+ 条"踩过的坑" 都在 docs/DEVELOPMENT.md（约 1700 行）。
在动这套界面之前，值得先扫一遍。

联系与支持

- GitHub：@xugulin
- QQ：894597841
- 邮箱：894597841@163.com
- 如果这个项目帮你省了时间，欢迎请我喝杯咖啡 ☕ —— 应用里有捐赠支持页。

🇬🇧 English

⬆ 回到中文 / Back to Chinese

它是什么

DSH Console 是 DeepSeek Harness 的桌面控制中心 —— 后者是以 dsh-web 形式发布的本地 Web 服务。你不再需要在终端、systemctl、浏览器标签页和一堆 npm 命令之间来回切换，而是拥有一个原生窗口：启动 / 停止 / 重启服务、查看 token 消耗、浏览插件与技能市场，以及升级 harness —— 全部支持离线使用。

它基于什么构建： 该项目构建在 DeepSeek Harness（@deepseek-ai/dsh）之上 —— 它并不
重新实现 agent，而是管理它；UI 使用 Python + PySide6（Qt 6）；内置浏览器基于
Chromium（QtWebEngine），因此打开 harness Web UI 无需在目标机器上安装浏览器。

以便携 zip 形式发布：无需安装程序、无需管理员权限、不会在你的机器上留下任何残留。

你为什么喜欢它

| | |
|---|---|
| 🟢 绿色便携 | 解压即用。HOME 被重定向到包内部，因此会话、配置、缓存和日志都存放在该文件夹中 —— 不会写入你真实的 home 目录。已验证：~/.dsh 和 ~/.npm 保持原样。删除文件夹即可无痕清除。 |
| 📦 无需安装任何东西 | 便携版打包了 Python 3.14、PySide6、Node.js 以及 harness 本身。目标机器需要零前置依赖。 |
| 🔄 可更新 | 控制台可以在线自我更新：它只替换 app/ 和 tools/，将旧代码备份到 app.bak-，并且绝不触碰你的数据（home/）或运行时。harness 本身在专用页面升级 —— 选择 latest / next / alpha 渠道并重启即可。 |
| 🚀 一键启动 | 双击启动器（.sh / .bat，以及静默 .vbs），可选安装带图标的桌面快捷方式。四个前端可直接从控制台启动：内置浏览器、系统浏览器、TUI 和 PySide6 GUI。 |
| 🖥️ 原生 Qt GUI | 一个真正的 PySide6 窗口，而不是终端包装器 —— 7 种明暗主题、页面懒加载、约 95 毫秒冷启动。GUI 前端将 harness 自带的 Web UI 嵌入原生窗口，因此永远不会与上游脱节。 |
| 📊 账单一目了然 | 账户余额、今日支出（¥ / $）、模型调用次数、总 token 数、缓存命中率、高峰 / 低谷时段拆分、24 小时支出图表，以及按会话划分的费用表。 |
| 🧩 插件与技能 | 管理已安装的插件和技能（安装 / 卸载 / 更新 / 启用 / 禁用，并带健康检查），并浏览市场：npm 搜索加上官方目录（3000+ 插件），以及技能市场（100+）。 |
| 🖧 Harness，受管 | 服务状态徽章、PID / 运行时长 / 内存 / 重启次数 / 端口 / 自启动；两个 harness 来源（内置版与系统版），带有明确的启动按钮；版本与升级通道；安装详情（路径 / bin / node / npm / registry）；profile、bundle 顺序、patch 层。 |
| 🧭 不止是仪表盘 | 机器信息（CPU / 内存 / 磁盘 / 网络）、journalctl 日志查看器、随高峰/低谷时段实时切换的模型价格表，以及全程简体中文 UI。 |

功能

| 页面 | 作用 |
|---|---|
| 仪表盘 | 服务状态与控制（启动 / 停止 / 重启 / 在基于 Chromium 的内置浏览器中打开 UI / 复制地址）、前端启动器、今日支出 + 余额 + 24 小时图表 |
| Harness | 版本与升级（latest / next / alpha）、安装详情、运行状态、profile / 插件 bundle |
| 模型与定价 | 当前高峰 / 低谷时段及倒计时、实时价格表、¥ / $ 切换、从官方 API 同步 |
| 账单 | 账户余额、会话成本总计、按成本排序的逐会话明细 |
| 插件与技能 | 两张表：插件（安装 / 卸载 / 更新 / 批量更新检查）和技能（四个来源根目录、启用 / 禁用、预览、调用统计） |
| 插件 / 技能市场 | npm 搜索 + 官方目录、排名与筛选、无限滚动、镜像 / 区域 / 代理设置 |
| 机器信息 | 系统、CPU、内存、磁盘、网络、DSH 占用 |
| 日志 | journalctl 查看器 |
| 设置 | 7 种主题、插件摘要、关于 |
| 捐赠 | 支持本项目 — 微信 / 支付宝二维码及感谢名单 |

快速开始

方案 A — 便携版（推荐，无需安装任何东西）

1. 从 Releases 下载适用于你平台的 zip：Linux 约 308 MB，Windows 约 353 MB。
2. 解压到任意位置（U 盘也可以）。
3. 在 Linux 上运行 ./Start-DSH-Console.sh，或在 Windows 上双击 Start-DSH-Console.exe
（原生启动器，无控制台窗口；如需查看错误，请使用 Start-DSH-Console-Debug.exe）。
4. 可选：./Install-Desktop-Shortcut.sh / Create-Desktop-Shortcut.bat 将其添加到启动器。

方案 B — 从源码运行

git clone https://github.com/xugulin/dsh-console.git
cd dsh-console
pip install -r requirements.txt      # only PySide6-Essentials >= 6.11.2 is required
./run.sh                             # Linux
python main.py                       # Windows / anywhere else

需要 Python ≥ 3.14（会话文件使用标准库 compression.zstd 解压）。QtWebEngine（PySide6-Addons）为可选 — 仅在内嵌 Web UI 的 GUI 前端中需要。

常见问题

它会修改我的系统吗？
便携版：不会。HOME / DSH_HOME / USERPROFILE 都指向包内，因此配置和缓存都落在那里。从源码运行只会写入一个文件：~/.config/dsh-console/config.json（你的主题选择）。

它需要 systemd 吗？
不。在便携模式下，harness 是控制台的子进程——PID 写入 run/web.pid，日志写入 run/web.log，因此它可以在没有 systemd 的机器上运行（并单独检测系统范围的 harness）。

停止它会破坏我的浏览器登录吗？
不会。停止使用 SIGTERM 并等待干净退出——kill -9 才会丢失浏览器插件的 cookie，而控制台从不这样做。

某个进程占用了端口，harness 既无法启动也无法停止——现在怎么办？
按下 “强制修复端口冲突”（仪表盘上的琥珀色按钮）。它会找到占用端口的进程 → 发送 TERM 并等待 8 秒，然后 KILL → 清除 systemd 失败状态 → 重启 dsh-web.service → 恢复显示服务并清理孤立的 Xvfb 进程，然后验证端口确实已释放，并交给你带有令牌的 URL。典型情况是：包管理器删除了某个 harness 的文件，但进程仍在运行（dsh: command not found，端口仍被占用）：此时 systemctl 无能为力，而这是唯一能夺回它的按钮。它会先请求确认，并明确列出它即将结束的究竟是谁（PID、进程名、命令行）。

Windows 和 Linux？
两者都支持，作为单独的 zip 包（harness 中的原生模块是平台特定的）。

开发日志

设计权衡、实测基准以及 100 多个“我们实际踩过的坑” 都记录在
docs/DEVELOPMENT.md 中（中文，约 1700 行）。在更改 UI 之前值得略读一下。

联系方式

- GitHub: @xugulin
- QQ: 894597841
- 邮箱: 894597841@163.com
- 如果这个项目为你节省了时间，欢迎请我喝杯咖啡 ☕ —— 请参阅应用中的 捐赠 页面。

deepseek · deepseek-harness · dsh · console · pyside6 · qt6 · portable · green-software · no-install · zero-install · billing · token-usage · cost-tracking · plugin-manager · skills · npm · linux · windows · desktop-app · 控制台 · 便携版 · 绿色软件 · 免安装 · 解压即用 · 账单统计 · 插件市场