dsh-web-ui 快速安装指南：任务看板、Git 图谱与皮肤中心一键部署
项目地址: https://gitcode.com/gh_mirrors/ds/dsh-web dsh-web-ui 安装指南：一套命令装齐 DSH Web UI 的任务看板、Git 图谱、移动端远程、SSH 连接与皮肤中心。本文覆盖 npm 一键安装与源码构建两条路径，并给出验证命令与故障排查清单，装完即可验收。
一分钟速览
聚合包一次挂载全部能力，无需逐个启用：
| 能力 | 一句话说明 |
|---|---|
| 任务看板 | 五列（待规划 / 待办 / 进行中 / 已完成 / 已失败）管理任务，支持真实会话执行与 cron 定时 |
| Git 图谱 | 分支泳道叠加提交历史，快速定位每次变更 |
| 右侧面板 | 文件树、多格式预览与 git 变更（SCM）管理 |
| 移动端远程 | 扫码配对后，用手机远程控制当前工作区 |
| SSH 远程连接 | Web 终端、SFTP 传输、端口转发与集群执行 |
| 鲸鱼娘宠物 | 常驻界面的互动宠物，动画随智能体状态切换 |
| 实时令牌统计 | 展示 TPS、token 用量与上下文占用 |
| 皮肤中心 | 内置 9 款皮肤，先试穿再应用 |
插件统一通过 dsh plugin 命令安装进 profile；dsh web 对应 web profile，后续所有命令都基于这个前提。
选对方式再动手
| 场景 | 推荐方式 | 前提条件 |
|---|---|---|
| 日常使用，装全功能 | npm 安装聚合包 @linxin666/dsh-web-ui-all | 已装 DSH 命令行工具，可正常启动 dsh web |
| 改代码、本地调试 | 源码构建后链接 profile | Node.js 22+、pnpm 11 |
| 只要皮肤，或只要单个插件 | 最小化安装对应包 | 无额外环境要求 |
版本建议显式指定：聚合包当前版本为 0.1.12。个别环境的 latest 解析会受 registry 缓存影响，带版本号最稳。
三步跑通
推荐方式只有三条命令。
① 安装聚合包
dsh plugin --profile web add @linxin666/dsh-web-ui-all@0.1.12
若首次安装提示 ERR_PNPM_IGNORED_BUILDS（pnpm 拦截依赖的构建脚本），按提示把 cloudflared / cpu-features / ssh2 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重跑即可，属正常现象。
② 重启 Web 服务
dsh web
成功标志：进程重新拉起，侧边栏出现全部插件入口。
③ 确认入口可用
打开侧边栏「任务看板」，看到五列任务面板即安装成功；「设置 > 插件配置」中可调整各插件开关与参数，修改即时生效。
其他安装路径
源码构建安装：开发调试路径
需要修改插件代码或做本地调试时走这条路：
git clone https://gitcode.com/gh_mirrors/ds/dsh-web
cd dsh-web
pnpm install
pnpm -r build
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-all
scripts/link-profile.mjs 会把仓库构建产物链接进 ~/.dsh/profiles/node_modules/@linxin666/，使子包全部走本地代码。随后重启 dsh web 即可。
最小化安装：只要皮肤或单个插件
只要皮肤：
dsh plugin --profile web add @linxin666/dsh-skins
皮肤中心 9 款皮肤均支持试穿：即时生效、退出完全还原，确认满意再一键应用。
只装某个功能插件，用对应包名即可：
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board
dsh plugin --profile web add @linxin666/dsh-ssh
dsh plugin --profile web add @linxin666/dsh-pet
其余插件把包名替换为 @linxin666/dsh-client-ui-git-graph、@linxin666/dsh-live-stats、@linxin666/dsh-remote-web-ui 等，规则相同。
自检与排查
验证：重启后执行
dsh --profile web --dump-config
输出中包含对应插件配置层，说明挂载成功；再看侧边栏入口，任务看板应呈现五列面板，Git 图谱可打开提交历史可视化。
排查清单
| 症状 | 原因 | 处理 |
|---|---|---|
| 侧边栏没有新入口 | 安装后未重启 | 重启 dsh web |
| 宿主已挂载但 UI 不显示 | npm 版本滞后或损坏 | 执行 node scripts/link-profile.mjs，让子包走仓库构建产物 |
| 版本解析异常 | latest 受 registry 缓存影响 | 安装时显式带版本号（如 @0.1.12），升级时替换为新版号 |
| 依赖构建被拒绝 | pnpm 拦截构建脚本 | 按提示将相关包加入 allowBuilds 后重装 |
清理与回退
移除聚合包并重启即可完全回退：
dsh plugin --profile web remove @linxin666/dsh-web-ui-all
dsh web
重启后侧边栏恢复原状，无残留入口。
插件规范与完整文档见 docs/plugins.md，按需查阅。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
