DSH Web UI 全家桶源码解剖：一个「一切皆插件」的 Agent Web GUI 生态

研究：小八弟｜日期：2026-09-07 ｜素材：GitHub zhu1090093659/dsh-web-ui 源码快照 + npm registry + GitHub Releases 正文｜目的：开源插件生态全面研究（远程控制 / SSH / 升级机制 / 挂载架构）

DSH 生态@linxin666Apache-2.015+1 插件包扫码配对远程SSH 运维

一句话结论：dsh-web-ui 是 DeepSeek Harness（DSH）Web GUI 的开源插件与皮肤全家桶——15 个功能插件 + 皮肤中心 + 外部 better-sidebar 拼装，全部经官方 profile/cordis 行机制挂载、不改宿主源码。它把「扫码配对远程控制（手机 /m/ 移动端 + PC /remote/api 桌面通道）、SSH 运维面板、任务板 cron、梁神模式、桌宠、12 款皮肤」做成了可插拔 npm 包生态，其双半区架构、配对门控与「聚合包自动生成挂载清单」是 Agent 平台插件化最完整的落地样板。

一、基本档案

维度	内容
仓库	zhu1090093659/dsh-web-ui（GitHub 公开；monorepo + pnpm workspace）
npm scope	@linxin666（聚合包 dsh-web-ui-all；皮肤中心 dsh-client-ui-skin-center 等）
许可证	Apache-2.0 为主，部分包 BSD-3-Clause；皮肤 maid-atelier 单独 CC BY-NC-SA 4.0
定位	DSH（DeepSeek Harness）「一切皆开发、一切皆插件」理念在 Web GUI 上的落地：功能插件 + 皮肤资产目录 + Gallery 预览页
安装	`dsh plugin --profile web add @linxin666/dsh-web-ui-all@latest` → 重启 dsh web 即见全部插件入口；也可从仓库 link 安装开发调试
版本节奏	2026-08 中旬 0.2.x → 8/23 0.3.0 大版本 → 9/5 0.3.16（活跃度：近两周 8 个版本，含连续 bug 修复与功能迭代）
配套	右侧面板由外部插件 dsh-better-sidebar 接管；自带桌面安装包（mac/win，0.3.14 起 Electron 骨架）

二、插件包地图：15 功能 + 皮肤中心 + 外部拼装

包	许可	一句话职责
dsh-web-ui-all	Apache-2.0	聚合插件：一键装齐 + compat 桥接层 + 外部插件拼装清单
dsh-client-ui-web-ui-settings	Apache-2.0	Web UI 插件组设置页（全家桶开关与表单的家）
dsh-client-ui-plugin-manager	BSD-3-Clause	插件管理器：npm/git 安装、启停、冲突撤销、失败转修复会话
dsh-client-ui-community-plugins	BSD-3-Clause	设置页社区插件索引卡
dsh-client-ui-task-board	Apache-2.0	任务看板：五列 + 真实会话执行 + Host cron 定时
dsh-client-ui-git-graph	Apache-2.0	分支选择 + Git 提交图谱（host 侧真实 git 操作）
dsh-remote-web-ui	Apache-2.0	扫码配对手机 / PC 远程控制 + 全家桶一键自更新
dsh-ssh	Apache-2.0	远程 SSH 运维：主机管理 / Web 终端 / SFTP / 隧道 / 集群 + Agent 工具
dsh-tool-describe-image	Apache-2.0	纯文本模型借视觉模型看图（OpenAI 兼容端点）
dsh-chat-recovery	BSD-3-Clause	编辑上一条消息（fork 保历史）+ 受监督回合重试
dsh-liangshen	Apache-2.0	梁神模式 agent 预设（Minimal 锚定 → PTC 全工具两阶段）
dsh-pet	Apache-2.0	鲸鱼娘桌宠（状态动画 / Live2D / 亲密度）
dsh-client-ui-skill-explorer	BSD-3-Clause	技能中心：按来源浏览 / 启停 / 增删技能
dsh-desktop-launcher	Apache-2.0	桌面启动图标 + 一键关机
dsh-client-ui-aionui-panel	Apache-2.0	旧右侧面板（已停止支持、默认关闭，将被移除）
dsh-skins + skin-center	Apache-2.0	皮肤中心 v2：12 款皮肤 + Wallpaper Engine 壁纸库（纯资产目录）
外部 dsh-better-sidebar	—	右侧面板（聚合包集成默认启用，与官方 UI 同生态）

三、架构三机制：插件化怎么落地

3.1 行挂载：cordis.patch.yml + 聚合清单自动生成

每个包带 cordis.patch.yml 声明插件行；装入 profile 后由 DSH loader 展开挂载。
聚合包不手写 patch：aggregate.yml 声明 patchFrom（子包清单）+ deps + rows（外部插件），由 scripts/aggregate.mjs 生成 17 行 web-ui-* 命名空间 patch（与独立安装共存不撞 id）。
挂载顺序有讲究：设置组先声明子槽、remote-web-ui 先于 pet 装好配对门控再让桌宠发首请求——避免启动期撞 SDK 围栏。

3.2 双半区：一个包 = host 逻辑 + browser bundle

host 半区跑在 dsh web 进程内（路由 / 服务 / 引擎 / 令牌）；browser 半区编译为 lib/client.js，由 web server 经 /plugins/@scope/<pkg>/client.js 伺服并扫入插件名册。
浏览器侧靠 slots 注入 UI（侧边栏 footer 座位、设置页 plugin.item 槽）；纯逻辑部分单测可跑（无 cordis 依赖）。

3.3 皮肤资产目录化

皮肤中心 v2：一款皮肤 = 纯资产目录（skin.json + 样式 + 贴图 + 可选特效），由皮肤中心唯一加载器即时加载——新增皮肤只落目录、不发布 npm；插件负责逻辑、皮肤负责外观，与官方解耦、升级零牵连。

四、移动端远程与桌面配对：一枚令牌、两种界面

入口：侧边栏底部「手机图标」（插件自绘 SVG，非共享图标库），旁边是下载/更新按钮（静默探测 npm 新版本、亮圆点提示）。
配对：面板（仅本机 loopback 可开）铸一次性限时令牌 → 二维码（默认局域网 IPv4，多网卡可选；可配 publicBaseUrl 或一键 cloudflared 公网隧道）→ 手机或 PC 扫码绑定。
手机 /m/：落地独立移动端界面（插件自含、非桌面缩放、可 PWA），RPC 走 /m/api 代理（方法白名单——settings / credentials / host-action 手机永不可达），SSE 实时流（不支持 SSE 的隧道自动降级轮询）。
PC /remote/api：同一链接桌面形态配对后，完整 Web GUI 经门控 /remote 通道在另一台电脑运行（围栏代发 /api、/sidebar、/git、/pet 与事件/终端/SSH WebSocket）；未配对只看到全页阻断与指引、拿不到数据。
安全边界：SDK 特权方法（原生对话框 / settings / credentials / 工作区选择）对远程设备不可达；控制端点（配对 / 更新 / 插件管理 / SSH）仅 loopback；「停止」一键吊销全部设备。
一键更新：检测到全家桶新版本时更新按钮亮圆点，面板内确认即在本 profile 执行 pnpm update --latest 并提示重启；pnpm 11 的发布年龄门禁可能静默装旧版——升级后复核版本，必要时关掉 minimumReleaseAge。

五、SSH 运维面板：连接池 + Web 终端 + Agent 直连

主机管理：GUI 增删改查 / 分组 / 测试；配置集中 ~/.dsh/dsh-ssh.json（版本化、原子写、0600）；支持密钥 / 密码 / ssh-agent（Windows 可走 Pageant）/ passphrase 密钥 / 多级 ProxyJump 跳板；可从 ~/.ssh/config 一键导入（已有别名跳过）。
引擎：ssh2 持久连接池（空闲 30 分钟断开、断线重连 ≤3 次）；exec 带超时与 2MB 截断；xterm.js Web 终端；SFTP 上传（目录递归）/ 下载（逐文件）带进度；本地端口转发只监听 127.0.0.1；集群执行（并发 8，按别名/环境/标签过滤）。
Agent 直连：ssh_list / ssh_exec / ssh_upload / ssh_download / ssh_tunnel / ssh_cluster 六工具，GUI 与 Agent 共享同一份主机配置——对话里一句「连一下 xxx 看状态」即可执行远程命令。
安全设计：/api/dsh-ssh/* 仅 loopback + 同源校验；改连接字段即断旧连接防凭据复用；上传下载不经 bash 沙箱（宿主权限直读写）；exec 输出不脱敏（env 可能带回远端密钥——使用需知）。

六、版本演进速览（0.2.x → 0.3.16 主线）

版本	日期	要点
0.2.4 / 0.2.5	8/20-21	rc.8 SDK cohort 适配；远程配对扩展 PC Web GUI（/remote/api）；未配对拦截页；设备名单持久化；桌面启动器插件登场；11+33 项修复合集
0.3.0-0.3.6	8/23-27	大版本 0.3：功能集扩充与稳定化（皮肤/宠物/任务板/远程多线并进）
0.3.9-0.3.10	8/30-31	SDK alpha.2 cohort；手机端 401/零宽列修复；better-sidebar 重新内置；俄语语言包（15 命名空间全覆盖）
0.3.11-0.3.12	9/1-2	启动自愈隔离故障插件行；聚合 shell 裸行挂载容错；聚合客户端 bundle 挂载 shell 包裹子插件；远程更新角标；会话归档插件；SDK alpha.4
0.3.13	9/3	命名隧道模式（配对手机重启不掉线）；快速隧道改经 dsh-market 子域名中继；隧道域名收敛
0.3.14	9/3	Electron 桌面应用骨架（内置运行时）；better-sidebar 0.18.0；SDK cohort 迁移
0.3.15	9/5	移除内置 dsh-perf；remote 回环代理双向拆除 / 动态信任主机表限容 / 隧道 token 配对修复；bundle 降级路由引用计数单例；桌面安装向导
0.3.16	9/5	修复 0.3.15 聚合包回归：子插件挂载门控误读启动载荷线协议（曾致全家桶设置界面整体消失）——恢复 0.3.14 挂载语义

观察：8/23 起近两周 8 个版本中，「插件加载 / 聚合 bundle 挂载 / 启动自愈」是最高频修复主题（0.3.11/0.3.12/0.3.15/0.3.16 连续四版）——聚合化插件架构能力强的同时，其启动期挂载协议也在快速打磨；升级建议直取最新（勿停在 0.3.15）。

七、对 Agent 平台插件化的启示

#	启示	要点
①	能力独立成包可插拔	看板/图谱/远程/SSH/桌宠各为 npm 包，profile 机制热挂载——平台内核保持最小，能力面持续外扩
②	双半区是 Web 插件标准形制	host 逻辑 + lib/client.js 浏览器 bundle + slots 注入，一套代码两个半区，UI 与安全边界同源声明
③	聚合清单自动生成	aggregate.yml → 生成器产出 17 行 patch——组合安装无需手写挂载配置，避免人工维护漂移
④	配对门控替代简单鉴权	一次性令牌 + 设备 cookie + 方法白名单 + 仅 loopback 控制面——远程通道的访问控制做成插件自有的围栏，而非依赖 SDK 信任名单
⑤	皮肤纯资产目录化	外观与逻辑彻底解耦、升级零牵连——降低社区贡献门槛
⑥	自更新闭环	UI 内一键 pnpm update + 版本复核防门禁误装——插件系统的运维闭环值得借鉴

八、数据来源

GitHub 仓库 zhu1090093659/dsh-web-ui：根 README / 各包 README.zh / aggregate.yml / cordis.patch.yml / docs/release-notes（v0.2.1–v0.2.5）
npm registry：@linxin666/* 各包 version / time、@deepseek-ai/dsh dist-tags（2026-09-07）
GitHub Releases API：v0.3.8–v0.3.16 发布正文
公开演示素材：仓库 docs/screenshots 与 docs/images