10 分钟启动 Web UI

最快的体验路径是运行官方 npm 包，打开本地 Web UI，配置模型，再选择一个工作区。

路径 A：直接运行 npm 包

npx @deepseek-ai/dsh web

浏览器打开：

http://127.0.0.1:3080

如端口被占用：

dsh web --port 3081

路径 B：从源码运行

源码开发要求 Node.js 22.19+ 或 24+、Git 2.26+；官方仓库固定 [email protected]。

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

启动器不会判断已有构建产物是否过期。修改源码后如果界面仍像旧版本，先重新运行 pnpm run build。

在 Web UI 完成首次设置

1. 打开「设置 → 模型」，保存 API Key；
2. 点击「选择工作区」，添加并选中一个项目目录；
3. 新建会话，发送一个只读任务：

请概括这个仓库的用途，并列出主要目录；不要修改任何文件。

工作区未选中前，输入框会保持不可用。这是产品状态，不是页面卡死。

本站独立运行记录

2026-08-14，本站在 macOS、Node.js 22.22.2、pnpm 11.7.0、DSH 0.1.0-rc.5 环境下完成本机验收：http://127.0.0.1:3080 返回 HTTP 200。

该记录只证明这台测试机器在该时间点可用，不代表其他系统、网络、模型或后续版本必然得到相同结果。

权限边界

新 Session 默认使用 workspace-write。它限制文件修改范围，但不等于读取、网络访问与进程可见性已经完全隔离。开始真实任务前，先确认工作区范围和审批选项。

当前 CLI 会主动拒绝 dsh web --host 0.0.0.0。不要绕过这一限制把没有认证层的 Web UI 暴露到公网。

停止服务

在启动终端按 Ctrl+C。CLI 会先执行资源释放；SIGINT 最终状态码为 130。