dsh-web：DSH Web GUI 插件全家桶怎么装

原生 DeepSeek Harness Web 把对话交互与工具调用做完了，多任务并发调度、长程后台执行、移动端协同、工程化运维这几块留给了插件。dsh-web 补的就是这些位置：它通过官方 profile 机制挂载到已有的 dsh web 实例上，不改动官方源码。

dsh-web 是给 DeepSeek Harness Web GUI 加装插件全家桶的 TypeScript 项目，输入是已有的 dsh web 实例，输出任务看板、移动端远程、SSH 运维与用量统计等模块。

家族成员分成两类：功能插件负责能力，皮肤与桌面宠物属于样式资产，两者分离。既可以通过聚合包 @linxin666/dsh-web-all 一次装齐，也可以按需单装某一个插件。仓库默认分支是 dev，主要语言 TypeScript，采用 Apache-2.0 许可证，当前 8206 Star、556 Fork、开放 Issue 3 个。

它不做什么

从 v0.4.2 起，桌面端（Electron 应用及其打包 lane）已从本仓库移除，本仓库不再产出桌面安装包，桌面场景交给官方 DeepSeek Harness 桌面客户端承接。你要的是一个独立桌面应用，来这里找不到。

它也不自带宿主。所有插件包都声明了 dsh.engines.dsh 版本下限，宿主没升到对应版本就装不上或激活不了。v0.4.4 把下限提到了 >=0.2.0-rc.1。

移动端的实时流式推送有网络前提。Cloudflare quick tunnel（trycloudflare.com）和 Tailscale Serve 默认不透传 SSE，这两类环境下插件会自动降级为高频轮询，消息能收发，但新消息可能略有延迟。

用之前先准备好什么

• 一个可用的 DeepSeek Harness 宿主。dsh web 命令行实例与官方桌面客户端都可以用，但版本要先满足下限，仓库在 v0.4.4 的说明里写的是「请先升级 DSH 本体再安装或升级本版本」。
• 官方桌面客户端的 profile 是 desktop，该 profile 由应用内专管，外部 CLI 对它的修改有限制。走桌面客户端这条路时，安装动作要在客户端内部完成。
• 包管理器。仓库根目录有 pnpm-lock.yaml 与 pnpm-workspace.yaml，Issue 里出现过更新按钮提示找不到 pnpm 的情况，Windows 上尤其要注意。.gitmodules 与 satellites/ 目录说明皮肤中心、宠物、社区插件索引、预设中心是拆出去的卫星仓。
• 手机端远程访问需要一个能透传 SSE 的通道。仓库建议用 Cloudflare named tunnel 或自建 TCP 端口转发；用隧道时走配对通道，不建议为隧道域名配置 --trusted-host 参数。
• SSH 面板需要目标主机的密钥或密码，也可以导入本地 ~/.ssh/config 的主机列表。
• 仓库体积 894873 KB，克隆前留够磁盘空间。

主要功能

任务看板。按待规划、待办、进行中、已完成、已失败五列呈现。点卡片上的「执行」会调用真实 DSH 智能体会话运行任务，跑完状态自动回写看板；点卡片可跳回对应会话回溯完整交互轨迹。任务支持配置 cron 表达式做后端定时调度，关掉浏览器后宿主进程仍按计划执行并保存结果。可选的防休眠电源管理支持 Windows、macOS 与带 systemd-logind 的 Linux，允许显示器息屏但阻止整机睡眠，该设置默认关闭。开启会话复用后，若前一轮会话仍存活且空闲，宿主会复用该会话继续跑后续任务，并重新应用任务指定的权限与模型。

移动端远程控制。侧边栏底部的手机图标打开设备配对面板，手机扫码或复制链接配对后，手机浏览器直接载入官方 Web GUI 并激活触控交互层：轻触鲸鱼图标唤出侧边栏，左滑收起、右滑展开，长按会话项呼出操作菜单，输入框用 16px 字体防聚焦缩放。SSH 终端、任务看板、Git 图谱这类适合大屏的面板在手机端自动隐藏。同一配对通道也支持另一台 PC 浏览器接入完整的桌面版 Web GUI。远程通信走 /remote/api 路径并受配对门控保护，令牌单次使用且会超时失效，点「停止」可立即吊销所有已连接设备。

SSH 远程运维面板。侧边栏「SSH」入口，支持密钥与密码认证，可一键导入 ~/.ssh/config，配置保存在 ~/.dsh/dsh-ssh.json。面板提供基于 xterm.js 的 Web 终端、带进度提示的 SFTP 上传下载与远程目录浏览，以及端口转发隧道和集群批量命令。

用量统计与 Token 银行。提供每日 Token 消耗明细、多供应商余额查询、账单估算、套餐使用进度追踪。

Git 图谱与 Worktree 隔离。可视化分支与提交图谱，为会话自动创建专属 worktree 目录与分支，避免多 Agent 并行编码时互相覆盖。

会话归档管理。对全量会话做全文检索与多维筛选，支持批量归档、级联物理删除和自动清理策略。

模型能力声明。逐模型可视化声明 Vision 图片多模态与推理思考档位，并支持供应商快速启闭，避免第三方模型的配置失效。

创意工坊与皮肤宠物。站点 dsh-market.com 统一分发主题皮肤、桌面宠物、功能插件与社区 Agent 预设，按真实设备点赞热度排序，皮肤支持即时试穿预览。皮肤内置经典的 Blue Fantasy 蓝色幻想，其余资产在 Web GUI 的「创意工坊」设置卡里浏览下载。站点前端为纯静态构建，由 scripts/market-build 依据 skin.json、pet.json、community.json 生成，点赞等动态能力由 Cloudflare Workers 与 D1 提供，遵循单设备单票。

安装与最短示例

走官方桌面客户端是最短路径，仓库给出的步骤只有三步。第一步，打开客户端进入「设置」中的「插件」页面，或点左侧导航栏的插件入口；第二步，在插件管理界面的安装输入框里输入包名 @linxin666/dsh-web-all（或 @linxin666/dsh-web-all@latest），点击安装；第三步，安装完成后重启客户端，任务看板、主题皮肤、远程控制等能力即可使用。

给已有的命令行环境安装时，仓库在快速上手章节说明可以通过 npm 或 GitHub 仓库地址一行命令安装，但 README 节选里没有给出这条命令的完整写法，这一步骤需要回到仓库正文核对。仓库地址是 https://github.com/zhu1090093659/dsh-web。卫星仓（皮肤中心、宠物、社区插件索引、预设中心）各自独立发版，聚合包按 semver 消费它们。

关键参数

• dsh.engines.dsh：家族全部包与插件脚手架声明的宿主版本下限。v0.4.4 起为 >=0.2.0-rc.1；v0.4.3 时期为 >=0.1.7-rc.2。低于下限时安装或升级会失败。
• cron 表达式：写在任务详情里，决定后台调度节奏，例如每日 23:00 自动检查升级 DSH。
• IANA 时区字段：v0.4.4 给任务看板排期规则新增的可选字段。旧规则缺少该字段时按宿主时区执行。
• /goal 开关：任务的该开关只在关闭时落盘，字段缺省即视为开启。
• ~/.dsh：官方桌面客户端与 dsh web 共用的数据目录；SSH 配置落在 ~/.dsh/dsh-ssh.json，桌面客户端的 profile 名为 desktop。
• 防休眠电源管理：默认关闭，需要在设置里手动打开。

结果在哪里看

功能入口都在 Web GUI 的侧边栏：任务看板、SSH、底部手机图标对应移动端配对面板，Git 图谱对应仓库视图。用量统计与创意工坊在设置区，创意工坊以设置卡形式呈现线上清单，皮肤与宠物下载到 DSH 主目录后在对应设置页选用，社区预设下载后进「设置 → Agent 预设」用于新建会话。

任务执行的历史轨迹在对应会话里回溯，看板卡片可以直接跳过去。远程端的状态用「停止」按钮控制，点下去即吊销所有已连接设备。工坊侧的数据在 dsh-market.com 上看，点赞热度按设备计。

实际使用中的坑

第一条是全家桶装完 UI 不显示。有用户反馈在 DSH 0.1.0-rc.6 下安装后侧边栏、统计、宠物全部缺失，另有报告说除皮肤中心外其余插件已 Mounted/Enabled、客户端模块也加载成功但就是不渲染。两条在仓库里都标记为已解决。宿主版本与插件版本的匹配关系是这类问题的常见来源。

第二条是发布包缺构建产物。有报告说 @linxin666/[email protected] 的 npm 包缺少构建 chunk，导致 dsh web 启动时插件树加载直接崩溃，报 ERR_MODULE_NOT_FOUND。该问题已解决。

第三条是 0.4.0 的升级路径。从 0.3.24 或更早版本升级时，包管理器会保留锁文件里已解析到的 0.3.24，而那个构建仍注入 0.1.7-rc.1 宿主已退役的 settingsScope 服务，结果皮肤中心、宠物与社区插件的浏览器半区一直等它，永不激活。v0.4.1 把三个卫星依赖的下限提到 ^0.3.25 修复了这条，全新安装不受影响。仓库在 v0.4.1 的说明里明确建议从 0.3.24 或更早版本升级的用户升到该版本。

第四条是更新按钮找不到 pnpm。有 Windows 11 用户在 deepseek-harness-desktop 上点更新时收到该提示，问题已解决。

横向对照

下表两个对比项都是仓库给定的同功能档位项目，各自只做同一件事的一部分。

桌面端这条路本项目已经让出去了。0.4.2 起本仓库不再产出桌面安装包，要把 DSH 跑在独立桌面应用里，得去用官方桌面客户端或 dsh-desktop 这类方案。只想要余额与单会话成本读数，装一整套插件反而是负担，dsh-balance-meter 这种单一功能插件更对症。dsh-web 的价值集中在任务调度、远程访问与运维面板这几块成套能力上，缺了这些需求就没必要引入它。

合规与授权边界

这个项目包含 SSH 终端、SFTP 传输、端口转发隧道、集群批量命令与跨设备远程控制，都属于对目标主机和会话的访问能力。这些功能只能用于你自己拥有的资产，或者已经获得明确授权的目标；对第三方服务器执行登录、传文件、批量下发命令，可能违反对方服务条款，也可能触及法律风险。

移动端远程控制把 Web GUI 暴露到配对通道上，隧道配置要守住配对门控，仓库明确不建议为隧道域名配置 --trusted-host，那会绕过设备验证。不用时应点「停止」吊销已连接设备。

适合谁

适合已经在用 DeepSeek Harness、并且把它当作长期工作台的人：需要定时跑后台 AI 任务、想在手机上接着看会话、要在一台机器上管多台 Linux 服务器、在意 Token 花销、或者想让界面换个样子的人，都能在同一套插件里找到对应模块。

只偶尔用一下 DSH、不需要后台调度与远程访问的人不适合装全家桶，聚合包会把用不到的插件一起带进来。想要独立桌面应用的人应当直接去用官方桌面客户端。宿主版本停在 0.2.0-rc.1 以下且暂时不打算升级的人，也先别装。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 10.0 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。