最快的体验路径是运行官方 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+;官方仓库固定 pnpm@11.7.0。
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 完成首次设置
- 打开「设置 → 模型」,保存 API Key;
- 点击「选择工作区」,添加并选中一个项目目录;
- 新建会话,发送一个只读任务:
请概括这个仓库的用途,并列出主要目录;不要修改任何文件。
工作区未选中前,输入框会保持不可用。这是产品状态,不是页面卡死。
本站独立运行记录
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。
证据与修订
一手来源
本页叙事经过压缩;命令、行为与风险边界以以下官方源码或文档为准。