dsh-web-ui：DeepSeek Harness 可视化 Web 工作台（任务看板+Git 图谱）安装与使用指南

项目背景

DeepSeek Harness（简称 DSH，命令行工具叫 dsh）是 DeepSeek 官方开源的"一切皆插件"的 Agent 运行时，GitHub 星标已逼近 20 万。它和 Claude Code、Codex 这类"精装房"式产品不同：DSH 像"毛坯房"，本体极其精简，模型、工具、会话、沙箱、存储、循环甚至 UI 本身都是可替换插件——你装上什么插件，它就拥有什么能力。

官方默认提供的 dsh web 已经是一个跑在 http://127.0.0.1:3080 的本地 Web 界面：左侧对话历史、中间任务区、下方输入框。而 dsh-web-ui（zhu1090093659）是社区生态里星标最高（3400+）的一个可安装 Web Profile Bundle，它在官方 Web UI 基础上，额外加入了任务看板（Task Board）、Git 图谱（Git Graph）、远程访问能力和皮肤中心，把一个偏极客的命令行 Agent，升级成更接近现代 IDE 工作台的可视化体验。

它不是独立软件，而是 DSH 的一个"皮肤/扩展包"：必须先跑起来官方的 DeepSeek Harness，再把这个 profile 装上去。本文同时带你完成"DSH 本体 + dsh-web-ui 增强包"的完整部署。

核心特性

• 一切皆插件：DSH 的模型、工具、存储、Agent 循环全部是插件，dsh-web-ui 也是作为一个 Web Profile 插件挂载，装上即生效、卸载即还原。
• 任务看板：把多步 Agent 任务以看板形式可视化，跟踪每个任务的进度与状态。
• Git 图谱：在 Web 界面内嵌 Git 仓库提交图谱与工作区改动可视化，改了什么一目了然。
• Trajectory 全链路审计：每一次运行都有 append-only 会话日志，可按来源（系统提示 / 工具结果 / 子 Agent 调度）筛选，事后完整复盘模型"看到了什么"。
• 会话全操作：Resume（继续）、Fork（分叉新方向）、Search（检索历史工具调用）、Replay（重放事件流）。
• 本地优先、隐私安全：UI 只监听 127.0.0.1，项目文件、API Key、会话数据全部留在本机，不经过第三方服务器。
• Profile 隔离：可按项目或实验建立独立 Profile，插件组合与配置互不干扰。
• 远程访问扩展：增强包内置远程访问相关能力，配合手机端插件可从别处访问本机 Agent。

环境要求

• Node.js：≥ 22.19（强烈建议用 nvm 装 22 LTS）。
• npm：随 Node 安装；源码构建还需 pnpm。
• 操作系统：macOS / Linux（Windows 建议 WSL2，原生源码构建偶有坑）。
• DeepSeek API Key：在 platform.deepseek.com 申请。
• 内存：建议 8GB 以上。

详细部署步骤

第一步：安装 Node.js 22.19+

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc   # 或 source ~/.zshrc

# 安装并启用 Node 22
nvm install 22
nvm use 22
node -v    # 需输出 v22.19.0 或更高

第二步：快速启动 DSH 本体（推荐）

官方最省事的方式是用 npx 一键拉起，无需全局安装：

npx @deepseek-ai/dsh web

首次运行会自动下载依赖（约 1900 个包，国内网络约 2 分钟），完成后自动在 http://127.0.0.1:3080 启动 Web UI。也可以选择全局安装：

npm install -g @deepseek-ai/dsh
dsh --version    # 验证安装
dsh web          # 启动 Web UI

第三步：配置 API Key 与选择工作区

1. 浏览器打开 http://127.0.0.1:3080。
2. 首次会弹窗"添加一个 API Key 开始使用"，填入你的 DeepSeek API 密钥（sk-...），点"保存并继续"。也可以点左下角设置 → 模型里配置。
3. 关键：在界面中显式选择工作区（Workspace），即你希望 Agent 操作的项目目录。不要在错误的目录启动——这是新手最常踩的坑（"为什么我看不到我的文件"）。建议在家目录启动 dsh，再在 UI 里挑选目标项目。

第四步：安装 dsh-web-ui 增强包

DSH 的插件通过 dsh plugin 命令挂载（注意要指定 --profile web，因为 Web UI 跑在 web profile 下）：

# 为 web profile 安装 dsh-web-ui 增强包
dsh plugin --profile web add @zhu1090093659/dsh-web-ui

# 查看已安装插件
dsh plugin --profile web list

安装后重启 dsh web，界面即获得任务看板、Git 图谱等增强能力。也可在 DSH Web UI 内通过插件市场类插件可视化浏览、安装、更新社区插件。

第五步：从源码构建（进阶 / 插件开发者）

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

# 启用 pnpm（corepack 自带）
corepack enable
pnpm install

# 构建
pnpm run build

# 用已构建产物启动 Web UI
pnpm dsh web

注意：Windows 原生构建若报错，先执行 pnpm run clean，并理清 host/client 构建顺序；WSL2 下更顺。

第六步：自定义端口与配置检查

# 在 8080 端口启动
dsh web --port 8080

# 不启动、只打印合并后的配置树（排查配置问题时很有用）
dsh --dump-config

常见坑与解决办法

• 看不到项目文件：启动目录与目标工作区不一致，在 UI 里手动"选择工作区"指向你的项目目录。
• Node 版本过低报错：必须 22.19+，用 nvm 升级。
• npx 下载慢：切换国内 npm 镜像源后重试，或改用全局安装。
• 端口被占用：用 dsh web --port 其他端口。
• API 401/402：Key 错误或账户余额不足。
• 想从外网访问：DSH 默认只监听回环地址（安全限制），公网暴露需配合官方远程访问插件并做好鉴权，切勿裸奔。

使用方法示例

在中间大输入框直接用自然语言派活，右下角可切换模型（如 deepseek-v4-pro）与访问权限（如 Workspace Write）：

用 Python 写一个生成随机密码的函数，并解释每个参数的含义。
# DSH 会真的生成 random_password.py 文件、跑测试，并在 Trajectory 视图里记录全过程。

完成后打开某次会话的 Trajectory 标签，按来源筛选，即可看到系统提示、推理、工具调用与结果的完整链路；用 Fork 从某条消息分叉出新方向、Search 检索历史工具调用。

常见问题 FAQ

Q1：dsh-web-ui 是独立软件吗？
A：不是。它是 DeepSeek Harness 的一个 Web Profile 增强包，必须先跑通官方 dsh web 再挂载。

Q2：默认访问地址和端口？
A：http://127.0.0.1:3080，可通过 --port 改。

Q3：数据会上传到云端吗？
A：不会。Web UI 本地起服务，文件、Key、会话都留在本机。

Q4：和 Claude Code 有何区别？
A：Claude Code 是封闭成品；DSH 是可换内核的插件化底座，自由度更高但需要自己组装，目前仍是开发者预览阶段。

Q5：生产环境能用吗？
A：官方定位仍是 developer preview，API 可能有破坏性变更，生产落地建议观望并做好版本锁定。

跳转链接

• dsh-web-ui 插件仓库：https://github.com/zhu1090093659/dsh-web-ui
• DeepSeek Harness 本体：https://github.com/deepseek-ai/deepseek-harness
• 官方快速开始：https://dshai.org/quickstart
• DSH 插件目录：https://www.dshplugin.store/category/web-ui
• API Key 申请：https://platform.deepseek.com/api_keys