zhu1090093659/dsh-web-ui · 上手攻略

  • 仓库：zhu1090093659/dsh-web-ui
  • 链接：https://github.com/zhu1090093659/dsh-web-ui
  • 分类：DeepSeek Harness 插件生态 · 效率工具
  • 作者：Tom
  • 更新：2026-08-16

是什么

dsh-web-ui 是给 DeepSeek Harness（以下简称 DSH）Web GUI 的一站式插件与皮肤全家桶，通过官方 profile 机制挂载，不改 DSH 源码。所有插件以 npm 包发布（@linxin666/ scope），可逐个安装也可一次性装齐。

仓库包含 11 个子包，核心能力如下：

能力 说明
梁神模式 面向 DeepSeek V4 Pro 的两阶段锚定 agent 预设，首轮 Minimal → 轨迹锚定后自动切 Code Mode（PTC），实测评分 98/99（均值 98.5）
任务看板 多列看板（待规划/待办/进行中/已完成/已失败）+ cron 定时真实执行，任务交给 DSH 智能体会话跑完自动回写状态
Git 图谱 分支选择器 + 提交历史泳道图，可切分支、翻历史
右侧面板 文件树 / 多标签预览（markdown/HTML/代码/diff/CSV/PDF/Office/图片）/ SCM 变更面板
移动端远程 扫码配对后手机进入独立移动端界面，SSE 实时同步（关闭标签页期间降级轮询）
SSH 运维面板 Web 终端 / SFTP 传输 / 端口转发 / 集群并发执行，支持密钥/密码认证
图像理解 给纯文本模型补视觉工具（describe_image），支持 OpenAI 兼容视觉端点（Qwen-VL/GLM-4V/GPT-4o/Ollama-vision）
鲸鱼娘宠物 常驻界面陪伴动画，跟随智能体状态换动画，支持互动喂食养成交互
实时吞吐 流式边流边更新输入/输出 token 估算，TPS 跟在步骤计数后面
皮肤中心 10 款皮肤，支持先试穿再应用（试穿即时生效、退出完全还原）

解决什么问题

DSH Web GUI 本身功能较基础：没有任务看板、没有 Git 可视化、没有移动端、没有 SSH 面板、没有多皮肤可选。dsh-web-ui 以插件形式把这些能力补齐，用户按需启用，不想要的关掉即可，无需 fork DSH 源码或等官方迭代。

梁神模式的价值在于：官方 Standard/PTC 预设只有 91/92 分，Minimal 能到 99/96 但只有两个工具。梁神模式把"首轮 Minimal 开局锚定"和"后续 Code Mode PTC 完整工具"两阶段串联起来，在不牺牲完整工具能力的前提下拿到 Minimal 的低敏感度分数。

快速安装

前提：已安装 DeepSeek Harness，dsh web 可正常启动。

方式一：npm 一键安装（推荐）

# 全家桶（全部插件+皮肤）
dsh plugin --profile web add @linxin666/dsh-web-ui-all

# 只要皮肤
dsh plugin --profile web add @linxin666/dsh-skins

# 单独安装某个插件
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，侧边栏出现全部插件入口即为生效。

方式二：仓库开发安装（仅供开发调试，需 Node.js >= 22 + pnpm）

git clone https://github.com/zhu1090093659/dsh-web-ui.git
cd dsh-web-ui
pnpm install && pnpm -r build

# 推荐：先 link 全部子包再注册聚合包
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-ui-all

# 重启 dsh web
dsh web

⚠️ pnpm 严格布局注意：profile 的 pnpm-workspace.yaml 需加 nodeLinker: hoisted（或 public-hoist-pattern: ['@linxin666/*']），否则子包无法找到。若出现 ERR_PNPM_IGNORED_BUILDS，把 cloudflared/cpu-features/ssh2 加入 allowBuilds 后重装。

卸载

dsh plugin --profile web remove @linxin666/dsh-web-ui-all
# 重启 dsh web

核心用法

梁神模式

在 DSH 新建会话的预设选择器里选「梁神模式」，首轮以 Minimal 预设开局（只暴露持久 bash 与 str_replace_editor），轨迹锚定后自动切换到 Code Mode（PTC），完整工具注册表随后恢复。原理详见 dsh-liangshen README。

任务看板

  1. 侧边栏点「任务看板」进入
  2. 五列看板中点卡片「执行」，任务交给真实 DSH 智能体会话执行，状态自动回写
  3. 定时任务：详情里配 cron 表达式（如 0 23 * * * 每天 23:00）

⚠️ 定时调度在浏览器端完成，dsh web 标签页要保持打开；关闭期间错过的触发点按「错过即跳过」处理，不排队补跑。

SSH 运维

  1. 侧边栏「SSH」入口打开面板
  2. 配置主机（支持密钥/密码认证，可从 ~/.ssh/config 一键导入）
  3. 支持：Web 终端、文件传输（SFTP）、端口转发（127.0.0.1 监听）、集群并发执行、Agent 直连对话

⚠️ SSH 密码与 passphrase 以明文保存在 ~/.dsh/dsh-ssh.json（权限 0600），请确保本机安全。

图像理解

在「设置 > 插件配置 > Image understanding」配置视觉端点（URL、模型、密钥），对话里提到图片时 describe_image 自动调用。纯文本模型输入框无图片入口，插件在输入框加了图片按钮，选图后生成附件引用插进草稿。

皮肤中心

  1. 侧边栏「皮肤中心」进入
  2. 试穿：即时生效，退出完全还原
  3. 满意后点「应用」正式保存

典型适用场景

  1. DeepSeek V4 Pro 用户：用梁神模式拿更稳定的首轮轨迹评分
  2. 多项目并行管理：任务看板 + cron 定时执行，减少人工盯盘
  3. 需要 Git 可视化的代码审查：分支泳道图 + 提交历史，比纯 CLI 更直观
  4. 移动办公：手机扫码配对后随时查看/操作 DSH 工作区
  5. 远程服务器运维：SSH 面板 + Agent 直连，说一句话就让智能体执行远程命令
  6. 纯文本模型用户：describe_image 给 DeepSeek V4（纯文本）补视觉能力

坑与注意

  1. pnpm 严格布局报错：子包 Cannot find package '@linxin666/dsh-...' → 加 nodeLinker: hoisted
  2. 首次安装 ERR_PNPM_IGNORED_BUILDS：把 cloudflared/cpu-features/ssh2 加入 allowBuilds
  3. pnpm 11 门禁问题：新版本发布后约 10 天内可能装回旧版子包，导致皮肤中心 Apply 后启动崩溃（ERR_MODULE_NOT_FOUND），在 pnpm-workspace.yaml 的 minimumReleaseAgeExclude 中排除全部 @linxin666/*
  4. 装完侧边栏没入口：页面刷新不够，必须重启 dsh web 进程
  5. 定时任务不执行：dsh web 标签页关闭期间定时不触发，要保持标签页开着
  6. SSE 实时推送限制：Cloudflare quick tunnel 和 Tailscale Serve 不透传 SSE，会降级轮询
  7. SSH 明文凭证：~/.dsh/dsh-ssh.json 权限 0600，本机安全是前提

与同类对比

项目 dsh-web-ui dsh-TUI dsh-tianshu-tui
接入方式 Web GUI 插件（profile 机制） 终端 TUI 插件 终端 TUI 插件
核心能力 看板/Git/SSH/移动端/皮肤全家桶 Claude Code 风格全屏交互 TDD + 证据门工作流
依赖 DSH Web GUI DSH 终端 DSH 终端
皮肤/UI 10 款皮肤 + 右侧面板 无 无
移动端 ✅ 扫码配对 + SSE ❌ ❌

dsh-web-ui 面向 Web GUI 用户，补的是交互体验和生产工作流；dsh-TUI 和 dsh-tianshu-tui 面向终端用户，补的是 CLI 交互效率。路径不同，可以共存。

一句话推荐结论

DSH Web GUI 用户想要看板、Git 可视化、移动端、SSH 运维或换肤，dsh-web-ui 是目前最完整的一站式插件包；梁神模式对 V4 Pro 用户的首轮轨迹稳定性有实测收益，值得优先安装。

  • 原始 commit：https://github.com/zhu1090093659/dsh-web-ui/commits/main
  • 许可证：Apache-2.0