dsh-web-ui · DSH Web UI

中文 | English

CI 门禁：typecheck / test / scripts / docs / 聚合与画廊一致性；覆盖率与代码风格（Prettier / ESLint）门禁待接入 CI。

DeepSeek Harness（DSH）Web GUI 的插件与皮肤全家桶
梁神模式 · 任务看板 · Git 图谱 · 右侧面板 · 移动端远程 · SSH 运维 · 图像理解 · 鲸鱼娘宠物 · 实时吞吐 · 皮肤中心

[是什么](#是什么) · [功能插件](#功能插件) · [皮肤](#皮肤) · [快速开始](#快速开始) · [常见问题](#常见问题) · [已知限制](#已知限制) · [社区](#社区)

是什么

dsh-web-ui 是给 DeepSeek Harness（DSH）Web GUI 用的插件和皮肤集合：面向 DeepSeek V4 Pro 的「梁神模式」agent 预设，以及任务看板、Git 图谱、右侧面板、移动端远程、SSH 运维、图像理解、鲸鱼娘宠物、实时吞吐和皮肤中心。所有插件都走官方 profile 机制挂载到 dsh web，不改 DSH 源码；可以逐个安装，也可以用聚合包一次装齐。

功能插件

梁神模式

DeepSeek V4 Pro 对首轮工具目录很敏感。社区评测里，官方 Standard / PTC 预设只有 91 / 92 分，Minimal 能到 99 / 96，但 Minimal 只有两个工具。梁神模式把这两步拼起来：新建会话时在预设选择器里选「梁神模式」，首轮按 Minimal 开局（只暴露持久 bash 与 str_replace_editor，只放行你自己的消息），轨迹锚定后自动切到 Code Mode（PTC），完整工具注册表、workspace 指令和 skill 目录随后恢复。Windows 原生环境实测（DeepSeek V4 Pro）98 / 99，均值 98.5，不是抽卡，也不需要牺牲完整工具能力。

原理、稳定化控制与限制详见 dsh-liangshen README。

任务看板

侧边栏点「任务看板」进入。任务按五列摆开：待规划、待办、进行中、已完成、已失败。点卡片上的「执行」，任务交给真实的 DSH 智能体会话去跑，跑完状态自动回写；想复盘就跳回执行会话看完整过程。

任务也支持定时跑：详情里配 cron 表达式（比如每天 23:00 自动升级 DSH、每周一 09:00 生成周报），到点自己开工，不用人盯着。

多列看板	定时执行

Git 图谱

输入框上方有分支选择器，可以切分支、翻提交历史；Git 图谱把分支泳道和提交历史画出来，仓库再大也能顺着时间线找到变更。

右侧面板

项目会话打开时，聊天区右侧出现「预览」与「文件/变更」两块面板：

• 文件树：浏览工作目录，点文件名在预览面板打开，点整行展开文件夹，支持按文件名搜索；
• 预览：多标签预览 markdown、HTML、代码、diff、CSV、PDF、Office、图片与文本，可切换源码 / 预览、分屏编辑、保存；
• 变更（SCM）：真实的 git 变更面板，stage / unstage / discard；
• 面板宽度可拖，双击把手复位；折叠状态和宽度按项目记住；
• 10 款皮肤都适配右侧面板，换肤后面板跟着变。

鲸鱼娘宠物

一只常驻界面的鲸鱼娘，跟着智能体状态换动画：思考、等待、工作、庆祝。可以点她互动（摸头），喂小鱼干加亲密度，从幼鲸一路养到「深海羁绊」。名字能改，位置能拖，不想看就藏起来。

陪伴工作	互动面板

实时吞吐统计

会话状态行本来就有 token 用量，本插件补的是实时吞吐：响应边流边更新输入 / 输出 token 估算（~ 表示启发式估算），TPS 跟在步骤计数后面；provider 用量一到，估算自动换成真实值。

移动端远程

侧边栏底部的手机图标打开配对面板。扫码（或复制链接）配对后，手机进独立移动端界面，远程操作当前的 dsh web 工作区：看会话、开新会话、收发消息、切模型和思考强度、调权限预设，都和桌面端同步。配对令牌一次性、限时，「停止」随时吊销所有设备；二维码默认走局域网，开 cloudflared 公网隧道后手机在任何网络都能配对。

实时消息与隧道：移动端靠 SSE（Server-Sent Events）收实时消息。Cloudflare quick tunnel（trycloudflare.com）和 Tailscale Serve 不透传 SSE，普通 HTTP 正常、实时推送到不了；这种网络下插件自动降级轮询，收发消息正常，只是新消息可能晚几秒。要即时推送就用支持 SSE 的隧道（Cloudflare named tunnel、自定义 TCP 端口转发等）。

工作区列表	会话列表与新建会话
聊天（折叠的深度思考与工具调用）	模型与思考强度选择

远程连接

侧边栏「SSH」入口打开远程运维面板。主机支持密钥 / 密码认证，可从 ~/.ssh/config 一键导入；配置都在 ~/.dsh/dsh-ssh.json。对已配置主机可执行真实操作：

• Web 终端：xterm.js 远程终端，实时输出，窗口大小自适应；
• 文件传输：SFTP 上传 / 下载，有进度条，能浏览远程目录；
• 端口转发：本地隧道直连远程内网服务（数据库、API、管理后台），只监听 127.0.0.1；
• 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
• Agent 直连：Agent 和面板共用同一份主机配置，对话里说一句「连一下 xxx 看看状态」，智能体就去执行远程命令。

图像理解

给纯文本模型补上视觉：对话里提到图片（本地路径、http(s) URL、会话附件）时，describe_image 把图片发给配置好的 OpenAI 兼容视觉端点（Qwen-VL、GLM-4V、GPT-4o、本地 Ollama 都行）回答，进会话的只有返回的文本，图片本身不进会话记录。纯文本模型输入框没有图片入口，插件在输入框加了个图片按钮：选图后生成附件引用插进草稿，模型就能用 describe_image 分析；工具还支持 prompt 参数传自定义指令（OCR、UI 诊断、翻译），比默认描述准。端点、模型、密钥、默认指令在「设置 > 插件配置 > Image understanding」里配，即时生效。

设置中心

全部插件的开关和参数都在「设置」里，改了即时生效。设置侧边栏的一级菜单：通用设置、模式、插件、Agent 预设，加上 Web UI 插件组（归组 task-board / live-stats / remote-web-ui / describe-image）、皮肤中心、社区插件与宠物，打开即直接展开内容、无需再点折叠；插件配置页保留三个内置插件（Shell / Agent loop / Web search），各自独立开关与配置。

皮肤

皮肤中心有 10 款皮肤，都支持先试穿再应用：试穿即时生效、退出完全还原，满意再一键应用。

10 款皮肤一览（龙的传人 / 初音未来 · 电子歌姬 / 同花顺风格三款截图待补充）：

Windows XP（Luna）

还原 Luna 经典界面：蓝色渐变窗口条、绿色「开始」按钮、Bliss 蓝天桌面，全局直角风格。

Blue Fantasy 蓝色幻想

鲸鱼插画垫在半透明面板下面，靛蓝色调贯穿全局，暗色主题下更明显。

鲸吟（Whale Song）

深海鲸语女神主题：无文字纯氛围背景画（蓝发女神与鲸群居左、冰蓝星座网格与金色细线点缀、右侧大量留白）垫在半透明面板下面，冰蓝 / 浅青 / 深海军蓝 / 钴蓝冷色体系贯穿全局，暗色变体是深海夜航调。

·

夕港（Harbor）

黄昏港口主题：动漫少女港口背景（暮光蓝天空渐入日落橙）垫在半透明面板下面，深暮蓝底与日落橙主色贯穿全局，亮色是薄暮纱、暗色是深海夜航纱。

·

快速开始

系统要求

• 已安装 DeepSeek Harness，dsh web 可正常启动。
• npm 安装方式无额外要求；从仓库安装需要 Node.js >= 22 与 pnpm。

三步上手

1. 安装聚合包：dsh plugin --profile web add @linxin666/dsh-web-ui-all
2. 重启 dsh web，侧边栏出现全部插件入口
3. 打开「设置 > 插件配置」按需开关插件，或在皮肤中心试穿皮肤

从 npm 安装（推荐）

插件已发布到 npm（@linxin666 scope），一条命令装齐：

dsh plugin --profile web add @linxin666/dsh-web-ui-all

装完重启 dsh web，侧边栏就有全部插件入口。只要皮肤就装 @linxin666/dsh-skins。

装到了旧版本？ pnpm 11+ 的发布年龄门禁（minimumReleaseAge）会把新发布（约 10 天内）的版本静默隔离，导致按上面命令实际装到旧版（如 0.1.6 而非 0.1.10）。旧版皮肤中心缺少 "carrier 内建皮肤可解析入口" 的修复，应用皮肤后重启会以 ERR_MODULE_NOT_FOUND .../dsh-client-ui-skin-<id>/index.js 崩溃。解决办法：在 profile 的 pnpm-workspace.yaml 设置 minimumReleaseAge: 0（或把 @linxin666/* 加进 minimumReleaseAgeExclude），再执行 dsh plugin --profile web update @linxin666/dsh-web-ui-all 升级到最新版。详见 issue #71。

从 GitHub 仓库安装（开发调试）

插件包已在 npm 发布，仓库安装仅供开发调试（需要 Node.js >= 22 与 pnpm）：

# 1. 克隆仓库
git clone https://github.com/zhu1090093659/dsh-web-ui.git
cd dsh-web-ui

# 2. 安装依赖并构建
pnpm install
pnpm -r build

# 3. 把全家桶链接进 web profile（推荐，先链接全部子包再注册聚合包）
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-ui-all

# 4. 重启 dsh web，侧边栏即可看到全部插件入口
dsh web

只想用皮肤：第 3 步只执行 link-profile 后安装 packages/dsh-skins 即可。

注意：profile 目录不是 pnpm workspace，聚合包里的 workspace:* 依赖会回退拉取 npm 已发布版本； 若 npm 版本滞后或损坏会出现「宿主已挂载但 UI 不显示」，此时先用 node scripts/link-profile.mjs 让全部子包走仓库构建产物。

单独安装某个插件

不想装全家桶时，可单独安装任意插件（npm 已发布，直接用包名）：

dsh plugin --profile web add @linxin666/dsh-liangshen              # 梁神模式
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board   # 任务看板
dsh plugin --profile web add @linxin666/dsh-ssh                    # 远程连接（SSH）
dsh plugin --profile web add @linxin666/dsh-tool-describe-image    # 图像理解工具
dsh plugin --profile web add @linxin666/dsh-pet                    # 鲸鱼娘宠物

验证与卸载

装好重启 dsh web，侧边栏出现对应入口就是生效了；也可以用 dsh --profile web --dump-config 确认插件配置层已挂载。侧边栏没新入口，多半是装完没重启 dsh web。

卸载：dsh plugin --profile web remove @linxin666/dsh-web-ui-all，然后重启 dsh web。

技术细节见 docs/plugins.md。

安装排障

常见问题

已知限制

• 任务看板的定时调度在浏览器端：dsh web 标签页要保持打开，关闭期间错过的触发点跳过、不补跑，详见 dsh-task-board README。
• SSH 密码与 passphrase 口令以明文保存在 ~/.dsh/dsh-ssh.json（权限 0600）；断线重连可能重放非幂等命令，远程输出原样返回、不脱敏，安全模型见 dsh-ssh README。
• 移动端靠 SSE 实时推送：Cloudflare quick tunnel 和 Tailscale Serve 不透传 SSE，插件自动降级轮询，新消息可能晚几秒。
• 仓库安装需要 Node.js >= 22 与 pnpm，仅供开发调试；npm 安装不受影响。

社区

社区交流群在这里，和开发者、其他用户一起聊用法、报问题、提想法。QQ 扫码加入「DSH Web UI 交流群」：

也可以加 Discord 社区，或直接到 GitHub Issues 报 Bug / 提需求。

参与贡献

• 先读 CONTRIBUTING.md 再开 PR；用户可见变更请附截图或验证证据。
• 提交信息遵循 Conventional Commits（如 fix(task-board): 修复 xxx），代码、文档与提交信息全程禁止 emoji。
• 新插件与皮肤用脚手架生成：node scripts/dsh-plugin-new <name>、node scripts/dsh-skin-new。
• 提交前过门禁 pnpm typecheck && pnpm test && pnpm docs:check；完整开发流程见 docs/development.md。

许可证

本仓库以 Apache-2.0 授权。迁入第三方代码必须保留 LICENSE 与署名；活跃且有上游的第三方优先 fork 或依赖引用，不搬代码。

来源与版权

贡献者