dsh-console-aio

中文 | English

dsh All-In-One 控制台（Windows GUI，PySide6 亚克力界面，支持深/浅主题）：SSH 隧道管理、本机 dsh 启停/安装/更新、健康监控，以及 17 个页面的 dsh 数据域管理（会话/Agent/Profile/插件/任务/用量/LLM/部署/日志/设置…）。

• 🚀 一键操作：本机 dsh 启停、SSH 隧道（启动/常驻/停止）、dsh 一键更新、全新环境一键安装
• 🖥️ 环境检查：git/node/npm/pnpm 版本与推荐基准，更新/安装/卸载引导
• 📡 健康监控：本机端口 + SSH 直查远端反向隧道，右栏一屏可见（可收起）
• 🗂️ 数据域管理：会话与工作区、Agent 模式、Profile、插件、任务看板、模型用量、LLM 配置、部署管理
• ⚡ 全局通用缓存：所有数据页面接入本地快照缓存与状态指示灯（绿/黄/红），进页秒开呈现，数据源变动按需刷新
• 🪟 系统托盘常驻：支持最小化至 Windows 系统托盘后台运行，鼠标悬停 Tooltip 实时状态监控，右键菜单一键启停 DSH 与隧道
• 🛡️ 全页内联确认：退役全部阻塞式弹窗，采用沉浸式内联确认条（ConfirmBanner），支持快捷键与操作说明
• 🔄 插件管理：官方 dsh plugin 安装/卸载、单个更新与「更新全部插件」批量升级（内联确认 + 流式日志）
• 🪵 日志管理：dsh web 输出实时 tail + 过滤 + 着色
• ⚙️ 设置页：全部配置标签页化，保存即热重载（弹窗收敛：极少模态框）
• 现代界面：PySide6 深色亚克力 + 现代列表/卡片组件 + 线程安全 + 一键打包分发

---

快速开始

方式一：安装包（推荐）

下载 dsh-console-aio-setup-0.8.0.exe（GitHub Releases），双击安装即可使用（无需 Python 环境）。 安装后可创建桌面快捷方式；卸载走系统控制面板。

方式二：双击（源码）

双击 启动dsh控制台.bat —— 它优先使用 conda base 的 pythonw 启动，找不到再回退 PATH。 源码方式需已安装 PySide6（pip install PySide6）；打包版无需任何 Python 环境。

方式三：命令行

python dsh-console-aio.py

💡 需要本机安装 Python 3（建议 Miniconda base，路径可改 启动dsh控制台.bat 顶部的 PYW）。

---

界面布局

顶部:  [🐳 DSH Console v0.8 ]   部署:[本机 ▾]        [搜索][立即刷新]
左导航            │ 中栏: 页面容器(17 页)                │ 右栏: 监控(可收起)
总览               │ 总览: 运行状态+数据速览+部署+隧道      │ 本机端口 ●●●●●
隧道               │ 插件: 列表|详情|配置 (三栏可拖拽)      │ 公网中转 反向隧道 ●●●
会话与工作区       │ ...                                 │
...               │                                     │
日志管理 / 设置    │                                     │
──────────────────┼──────────────────────────────────────┼─────────
底部: 控制台输出(日志实时滚动) / 全局状态栏

• ●=绿:健康/运行 ●=红:异常 * 切换顶部部署选择器 = 切换管理目标(远程只读)

---

一键安装 dsh（全新环境）

在 DSH 管理 页的「安装 dsh」卡填写 dsh 的 git 仓库地址（默认官方 deepseek-harness）与目标目录（可浏览选择，留空默认用户主目录/dsh），点「开始安装」即在页面内分步（step in place）执行：

1. 环境预检：检查 git / node / npm / pnpm 是否可用，缺失会明确提示先装什么
2. git clone：拉取 dsh 源码到目标目录
3. pnpm install：安装依赖
4. pnpm run build：构建
5. 完成后自动把目标目录写进 config.json 的 dash_repo（重启后生效）

进度条 + 流式日志显示在页内安装卡，安装过程中实时可见每步输出。适合在没有 dsh 的新机器 / 新用户上，从零一键搭好本机 dsh。

同页的「开发环境检查」卡内联展示 git / node / npm / pnpm 的版本与推荐基准，点「更新/安装/卸载」会先说明将执行什么，确认后才执行（环境检查/安装向导已退役模态弹窗，改为页面内分步）。

卸载 dsh

DSH 管理 页「卸载 dsh」卡提供两种模式，均先停 web、再删源码目录并清空 config：

• 保留数据卸载：只删源码（dash_repo）并清空 config.json 的 dash_repo；~/.dsh 数据（对话/会话/工作区/配置）保留
• 彻底卸载（含数据）：额外删除 ~/.dsh 数据目录——会清掉所有对话记录，二次确认后才执行

执行前会逐条列出将删除的具体路径；源码/数据目录删除有防误删守卫（绝不删用户主目录）。

---

设置（config.json）

所有可调项集中在 config.json；也可点顶栏 【配置】 进入「设置」页（标签页：隧道与部署 / 监控与命名）， 保存后端口/命名/监控点即时热重载，无需重启。隧道 SSH 参数在下次启动隧道时生效。

• 场景模板一键填充（在家→中继隧道 / 实验室直连 / 本机反向）
• 测试 SSH 连接 在线验证免密连通
• 三处机器命名（本机/实验室/公网中转）与监测端口增删改，界面全部跟随

仓库自带一份 config.example.json（不含真实 IP 的模板）。首次使用请：

copy config.example.json config.json   # 然后编辑其中的 IP/仓库路径/端口

若没有 config.json，程序会使用内置默认值正常运行。

字段	说明	默认
ssh_server	公网中转服务器 IP/域名	YOUR_PUBLIC_IP
ssh_user	中转服务器隧道用户名	YOUR_USER
dash_repo	本机 dsh 仓库路径	<留空, 设置页里填>
dash_port	本机 dsh GUI 端口	3080
dash_cmd	本机 dsh 启动命令	["pnpm.cmd","dsh","web"]
dsh_version_pin	固定部署的 dsh 版本 tag（空=跟随默认分支）	空
local_ports	本机端口监控 [端口,名称,说明]	3080/8090/8022/8091/3090
remote_tunnels	远端反向隧道监控 [端口,名称,说明]	8090/8022/8091
local_name / lab_name / ssh_name	三处机器命名（界面跟随）	本机/实验室/公网中转
poll_seconds / remote_poll_seconds	本机轮询 / SSH 直查间隔(秒)	4 / 20
*_timeout	探测与更新超时	...

真实 IP / 用户名 / 仓库路径只保存在本地 config.json（已 gitignore），请勿把它们写进 README 或任何被提交的文件。

---

工作原理

典型拓扑（多机 + 公网中转）：

[实验室dsh 服务器(实验室)]          [Windows 本机]
  dsh GUI :3090               dsh GUI :3080
    |  反向隧道(常驻)               |  反向隧道(常驻)
    +-------------> 公网服务器 公网中转 <-------------+
                    8090->实验室dshGUI   8091->本机GUI
                    8022->实验室dshSSH
                        |
         在家/外部: 正向隧道访问

• 反向隧道在 公网服务器 上监听回环端口，默认仅绑定 127.0.0.1（安全）。
• 本机端口行反映本机监听状态；公网中转 反向隧道行通过 SSH 直查中转上的监听状态，才是"隧道是否配置成功"的真实指标。

隧道引擎

模块	作用	状态
core/tunnel_mgr.py	纯 Python 隧道管理器（forward/reverse, start/persist/stop）	✅
dsh-tunnel 卡片	在家正向隧道三连（8090/8022/8091）	✅ 纯 Python
connect-lab-dsh 卡片	实验室局域网直连 实验室dsh（本机 3090）	✅ 纯 Python
dsh-tunnel-reverse 卡片	本机 dsh -> 公网服务器 反向隧道（公网服务器:8091 -> 3080）	✅ 纯 Python
update-dsh 卡片	git 拉取 + pnpm 构建 + 重启（流式日志）	✅ 纯 Python

旧的 4 个 .ps1 已收进 legacy/ 目录，仅供历史参考，不再被界面调用。 连接参数（服务器 IP/用户名/端口）全部来自 config.json，无硬编码。

---

安全说明

• 中转服务器端口默认只绑回环，公网不可直达——除非你明确配置 GatewayPorts 并承担无鉴权 GUI 暴露公网的风险（=远程代码执行入口），否则请勿这样做。
• SSH 隧道需先配置好到中转/目标服务器的免密登录。
• 控制台不读取/不展示任何密钥明文；凭据只提示存在性。

---

数据域管理（17 页导航）

页面	功能
总览	运行状态卡 + 数据速览（会话/用量/任务板/插件）+ 部署列表 + 隧道速览
DSH 管理	本机 dsh 操控（启动/重启/停止）+ 完整更新 + 环境/安装 + 版本发布日志（GitHub Releases 中文更新日志）+ 部署指定版本（切换/固定/回退）
隧道	隧道卡片启停/常驻 + 本机 dsh 启停/更新
会话与工作区	分组/会话/详情三栏，归档/恢复/删除（二次确认）
Agent 模式	窄列表按名字选 + preset.yml 只读详情
Profile 管理	列出 / 复制 / 删除 profile
插件管理	列表/详情/cordis 合成配置三栏；官方 dsh plugin 命令安装/卸载/单个更新/批量更新全部；patch 层停用/启用（配置态与生效态徽章）
任务看板	ledger + scheduler 只读展示
模型用量	解压 session 聚合 token（按模型/天）+ 价格估算 + 明细卡
LLM 配置	默认模型切换、自定义 provider 浏览（密钥只提示环境变量名）
备份与凭据	~/.dsh 一键备份（排除凭据）、凭据存在性提示
SSH 密钥	生成/指纹/公钥查看（私钥内容绝不读取）
部署管理	多部署列表/详情/操作日志三栏：CRUD、连接测试、只读快照（在线徽章）
日志管理	dsh web 落盘输出 tail + 过滤 + 着色 + token 脱敏
设置	配置标签页化，保存即热重载；诊断报告（脱敏可外发）与配置导入导出
主题	明/暗变体一键切换 + 全部界面颜色实时可调（即时预览），可存/载主题文件、设启动默认
关于与更新	当前版本 / 检查更新 / 更新日志 / 一键自动更新（安装版直接下载安装包、退出并运行安装程序）

---

Roadmap（dsh 控制台进化路线）

• 配置外置到 config.json（IP/用户/端口/轮询）+ 配置热重载（保存即生效）
• 全部卡片 Python 化（core/tunnel_mgr.py + 纯 Python 更新）；旧 .ps1 收进 legacy/
• PySide6 现代界面：深色亚克力 + 现代列表/卡片组件 + 17 页导航（含实时主题定制）
• 明/暗主题：浅色整套变体 + 主题页一键切换（深色为默认, config 持久化）
• 一键安装 dsh + 环境检查（更新/安装/卸载引导；弹窗收敛：改 DSH 管理页页面内分步）
• 卸载 dsh（保留数据 / 彻底卸载含 ~/.dsh, 危险操作双确认 + 防误删守卫）
• 打包分发（PyInstaller + Inno Setup，GitHub Actions 自动发版）
• 会话与工作区管理：分组浏览 / 归档 / 恢复 / 删除（二次确认）
• Agent 模式管理：窄列表 + preset.yml 详情
• Profile 管理：列出 / 复制 / 删除
• dsh 插件管理：列表 / 安装 / 卸载 / 单个与批量更新 / patch 层启停（配置态+生效态徽章）
• 任务看板：ledger + scheduler 只读展示
• 模型用量统计：token 聚合（按模型/天）+ 价格估算 + 明细
• LLM 配置：默认模型切换 + provider 浏览
• 备份与凭据：~/.dsh 一键备份 / 凭据提示
• 部署管理：多部署只读总览 + 操作日志
• 日志管理：dsh web 输出 tail / 过滤 / 着色
• 设置页：配置标签页化 + 热重载（弹窗收敛第一步）
• 版本管理：当前版本 / 检查更新 / 更新日志 / 一键自动更新
• 多套拓扑配置切换
• 明/暗主题切换（主题页, 浅色整套变体, 深色为默认）
• 多主题预设切换（Mica 深色/纯色）+ 布局记忆
• 配置导出导入 + 诊断报告一键生成（设置页「诊断与配置」标签）
• 用量趋势图表（按模型堆叠, 设置在用量页）
• 全局命令面板 Ctrl+K（页面/部署/动作 搜索直达）
• 小白引导：首次使用向导 / 诊断助手 / 常见问题

License

MIT © 2025 JimyuAn

---

<a name="english"></a>

dsh-console-aio (English)

dsh All-In-One console (Windows GUI, PySide6 acrylic, dark/light themes): SSH tunnel management, local dsh start/stop/install/update, health monitoring, and a 17-page dsh data-domain console (sessions/agents/profiles/plugins/tasks/usage/LLM/deployments/logs/settings).

Features

• One-click control: local dsh GUI start/stop, SSH tunnels (start/persist/stop), one-click dsh update
• One-click dsh install: repo URL + target dir → env pre-check → clone → pnpm install → build → auto-write config
• Environment check: git/node/npm/pnpm versions vs. recommended baseline, with update / install / uninstall actions
• Two-layer health monitor: local ports + reverse tunnels queried via SSH (collapsible right panel)
• Data-domain console: sessions, agents, profiles, plugins, task board, model usage, LLM config, deployments
• Plugin manager: official dsh plugin install/uninstall, single or "update all" batch upgrades, patch-layer toggles
• Log viewer: live tail of dsh web output with filtering, coloring and token masking
• Settings page: all config as tabs, hot-reload on save (dialog-free by design)
• Modern PySide6 UI: dark acrylic, modern list/card components, thread-safe

Quick Start

• Download dsh-console-aio-setup-0.8.0.exe from Releases (no Python needed), or run from source: python dsh-console-aio.py (requires Python 3 + pip install PySide6)

One-click dsh install

On the DSH Manage page, the "Install dsh" card takes a git repo URL (default: official deepseek-harness) and target directory (browse or leave blank for ~/dsh). Click Start Install to run the steps in-page (step in place) with a progress bar and streaming log:

1. Pre-check environment (git / node / npm / pnpm)
2. git clone → 3. pnpm install → 4. pnpm run build
3. Auto-write the target dir into config.json's dash_repo

Environment check

On the DSH Manage page, the "Development environment check" card shows git / node / npm / pnpm versions vs. a recommended baseline, each with Update / Install / Uninstall actions (confirm-before-run). The env check and install wizard are step-in-place cards on the page (the modal EnvDialog / InstallDialog windows are retired).

Uninstall dsh

On the DSH Manage page, the "Uninstall dsh" card stops the running web, deletes the source directory (dash_repo) and clears config.json's dash_repo, with two modes:

• Keep data: removes the source only; ~/.dsh (conversations/sessions/workspaces/config) is kept
• Full uninstall (with data): additionally deletes ~/.dsh — irreversible, requires a double confirmation

The exact paths to be deleted are listed before running; delete guards never touch the user home directory.

Configuration

All tunables live in config.json; the Config button opens the Settings page (tabs: tunnels & deployments / monitoring & naming). Saving hot-reloads ports, naming and monitor probes — no restart needed.

See the Chinese section above for the full field table.

Data-domain pages (17-page navigation)

Page	What it does
Overview	run-status card + data quick-look (sessions/usage/tasks/plugins) + deployments + tunnels
DSH manage	local dsh start/restart/stop + full update + env/install + release notes (GitHub Releases changelog viewer) + deploy a specific version (switch/pin/rollback)
Tunnels	tunnel card start/persist/stop + local dsh start/stop/update
Sessions & workspace	group/session/detail columns, archive/restore/delete (double confirm)
Agent presets	narrow name list + read-only preset.yml detail
Profiles	list / copy / delete profiles
Plugins	list/detail/composed-config columns; official dsh plugin install/uninstall/single-update/update-all; patch-layer enable/disable (config vs. effective badges)
Task board	ledger + scheduler read-only
Model usage	decompress sessions, aggregate tokens (by model/day) + cost estimate + daily trend chart
LLM config	switch default model, browse custom providers (API keys only hinted by env-var name)
Backup & credentials	one-click ~/.dsh backup (credentials excluded), credential presence hints
SSH keys	generate / fingerprints / public-key view (private keys are never read)
Deployments	multi-deployment list/detail/op-log columns: CRUD, connection test, read-only snapshots
Logs	live tail of dsh web output with filtering, coloring, token masking
Settings	config as tabs, hot-reload on save; masked diagnostics report & config import/export
Theme	toggle dark/light variant + edit every UI color live (instant preview), save/load theme files, set startup default
About & update	current version / check update / changelog / one-click auto-update (installed build downloads and launches the installer)

Auto release (GitHub Actions)

Pushing a v* tag triggers the CI workflow: PyInstaller onefile → Inno Setup installer (dsh-console-aio-setup-<version>.exe) → attach to a GitHub Release.

git tag v0.6.0
git push origin v0.6.0

(Update APP_VERSION in code, version.json, the installer.iss default version and RELEASE_NOTES before tagging.)

Security

• Relay ports bind loopback only by default; do not expose the unauthenticated GUI to public internet (remote-code-execution risk) unless you explicitly accept it.
• The console never reads or displays secret material; credentials are only hinted by presence.

Roadmap

• External config + hot-reload
• PySide6 modern UI (dark acrylic + modern list/card components + 17-page navigation)
• One-click dsh install + environment check
• Packaged distribution (PyInstaller + Inno Setup, GitHub Actions auto-release)
• Plugin manager (list / install / uninstall / single & batch update / patch-layer toggles with config & effective badges)
• Log viewer (tail / filter / colorize)
• Settings page (config as tabs + hot-reload)
• Overview redesign (run status + data quick-look + deployments + tunnels)
• Multiple topology profiles (tunnel plan snapshots + switch)
• Dark/light theme variant + live color editing + theme files
• Layout memory / runtime Mica-vs-solid switch (deliberately not done)
• Command palette (Ctrl+K) / config export-import / diagnostics report / usage charts
• Beginner onboarding (first-run wizard / diagnostics / FAQ)

License

MIT © 2025 JimyuAn