博客

DeepSeek Harness Web UI 入门:localhost:3080 上手

快速回答

DeepSeek Harness(dsh)的 Web UI 是一个运行在 http://127.0.0.1:3080 的本地控制台。它不是一个「聊天窗口」,而是agent 运行时的前端:你给一个目标,agent 在工具里循环直到完成,UI 负责观察与干预。

启动方式:

bash
npx @deepseek-ai/dsh web

浏览器打开 http://127.0.0.1:3080。想让它真的干活,先把模型后端指到 TeamoRouter:

bash
export DEEPSEEK_API_KEY="sk-teamo-你的Key"
export DEEPSEEK_BASE_URL="https://api.teamorouter.com/v1"
export DEEPSEEK_DEFAULT_MODEL="deepseek-v4-pro-free"

下面按界面分块讲清楚每一块是什么、怎么用。

一、会话管理:多任务并行

左侧或顶部是会话列表,你能:

  • 新建会话:每个会话是独立的 agent 上下文,互不干扰。
  • 切换 / 重命名:按任务命名(「修支付 bug」「重构报表模块」),比按日期好找。
  • 并行跑多个:dsh 支持多会话并行,适合一个长 agent 循环在后台跑、另一个会话处理琐碎问答。

一个实用习惯:把「探索性」和「确定性」任务分开建会话。前者让 agent 自由发挥,后者锁死步骤,避免一个长会话里上下文被无关内容稀释。

二、模型选择:一个 key 切多家模型

模型选择器让你逐会话切换模型 ID。接 TeamoRouter 后,常见选择:

模型 ID 定位 免费额度
deepseek-v4-pro-free 旗舰 Pro,硬活 200 次/天
deepseek-v4-flash-free 便宜 Flash,轻活 200 次/天
deepseek-v4-pro 付费 Pro,无账号限流
deepseek-v4-flash 付费 Flash,无账号限流

轻活走 Flash、硬活切 Pro,是省额度又保质量的标准打法(详见《V4 Pro 还是 Flash》)。

三、工具面板:agent 的「手脚」

工具面板列出当前 agent 能调用的工具,这是 Harness 和普通聊天最本质的区别。典型工具包括:

  • bash:执行 shell 命令——agent 靠它读文件、跑测试、装依赖。
  • 文件读写:读写 / 编辑工作目录里的文件。
  • subagent:派生子代理并行处理子任务,再把结果收回来。
  • web_search / web_fetch:联网搜索和抓取页面。
  • ask_user_question:在关键时刻暂停、向用户提问。

理解这套工具,你就理解了 dsh 为什么能「改代码」而不是只会「聊代码」:模型每一次工具调用,都是一次真实的读写或命令执行。

四、目标管理(Goals):长任务拆解

dsh 把长任务建模成目标(Goals),支持:

  • 创建 / 编辑:把「做一个功能」拆成「写接口 → 写测试 → 跑通」。
  • 暂停 / 恢复:agent 跑偏时暂停,人工纠正后恢复。
  • 标记完成:显式闭环,便于回顾。

对于一次性小任务,直接一句话丢给 agent 就行;对于跨多步、需要跟踪的活,用 Goals 更稳。

五、一个完整的上手流程

  1. 配好环境变量(见上),启动 dsh。
  2. 新建会话,选 deepseek-v4-pro-free
  3. 给一个真实任务:
text
在当前目录下找到 package.json,把版本号改成 2.0.0,并在 README 里补一行 release note。
  1. 观察工具面板里 bash / 文件工具被依次调用,最后 agent 汇报结果。

这 30 秒跑通,你对「Harness 把模型变成工人」就有了体感。

常见疑问

Q:为什么打开 3080 是空白 / 连不上? 先确认 npx @deepseek-ai/dsh web 进程还活着(没退出、没报错)。dsh 的 SDK server 在 stdin 关闭时会退出,如果你用 nohup ... & 启动,注意给 stdin 挂一个不结束的输入。

Q:工具面板是空的 / agent 说没有工具? 工具来自插件预设(agent preset)。默认预设包含 bash + 文件读写 + glob/grep;如果被裁掉,检查启动配置是否加载了对应的工具包。

Q:Web UI 只能本地访问吗? 默认绑定 127.0.0.1,只有本机能开。别直接把它暴露到公网——它背后的 agent 能执行 shell 命令,裸奔非常危险。

Q:能改端口吗? 默认 3080。需要改时通过启动参数或配置指定,注意同步更新访问地址。

Q:UI 操作和底层 agent 是什么关系? UI 是观察和干预层。你看到的状态(目标、工具调用、会话)都对应底层 agent 运行时的真实事件流;停掉 UI 不会停掉正在跑的 agent 会话。

接上 TeamoRouter 的免费档,3080 这个控制台就能每天白嫖 200 次 V4 Pro。到 TeamoRouter 注册拿 Key 即可开始。

准备好接入了吗?登录控制台 · 购买额度 · 创建 API Key,三步即可开始。
DeepSeek Harness Web UI 入门:localhost:3080 上手 · TeamoRouter