DeepSeek Harness 使用指南
本教程介绍如何通过 DeepSeek Harness 控制 ego (lite):在 Web UI 或无界面终端模式中开启 Full access,加载 ego-browser,并完成一次浏览器任务。
DeepSeek Harness 可以通过本地 Web UI 或一次性的无界面终端命令控制 ego (lite)。本指南以 Anthropic 的 X 主页为例,由 DeepSeek Harness 在 ego (lite) 的 Agent Space 中打开页面,读取前五条帖子,并返回整理后的结果。
上方是 Web UI 的完整操作过程。DeepSeek Harness 目前没有单独的原生桌面应用,也没有内置 TUI,因此本指南使用官方 Web UI 和 headless 配置。
开始前
请先安装 ego (lite)、完成初始设置,并确认电脑中已安装 Node.js,同时 DeepSeek Harness 已连接可用的模型。
- 下载并打开 DMG 安装包
- 按照指示,双击 ego (lite) 的 icon 进行安装
- 启动 ego (lite),完成初始设置
-
- 安装 Node.js
-
- 启动 DeepSeek Harness,并在 Settings > Models 中连接模型
ego (lite) 会将 ego-browser 安装到 ~/.agents/skills/。DeepSeek Harness 会扫描这个共享的用户 Skill 目录,也会读取当前项目中的 .agents/skills/。
安装 ego (lite) 后,请完全退出并重新启动 DeepSeek Harness,再继续下面的操作。这样 DeepSeek Harness 才能重新加载新安装的 Skill,并在 Web UI 中显示 /ego-browser 斜杠命令。仅新建会话可能无法重新加载 Skill。
选择 Web UI 或无界面终端模式
使用 Web UI 时,请在项目目录中打开终端并运行:
npx @deepseek-ai/dsh web
DeepSeek Harness 会在 http://127.0.0.1:3080 打开本地 Web UI。如果已经全局安装 dsh,也可以直接运行 dsh web。
使用终端时,请选择 headless 配置。它会执行一次任务、输出最终结果,然后退出。这里的“无界面”只表示 Harness 本身没有对话界面;任务执行期间,ego (lite) 仍会打开可见的浏览器窗口。
第 1 步:开启 Full access
Web UI
打开输入框下方的权限菜单,选择 Full access。阅读风险提示,勾选确认框,然后点击 Enable Full access。
Full access 对应 danger-full-access 预设:命令不再受 Harness 沙箱限制,审批提示也会关闭。请仅在您信任当前任务和工作区的情况下开启。
无界面终端模式
在运行任务的同一条命令中设置权限模式:
DSH_PERMISSION_MODE=danger-full-access dsh --profile headless \
"Use the ego-browser skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed."
环境变量会为本次运行启用 danger-full-access,并将审批策略设为 never。末尾引号中的内容是任务指令,不是额外的配置参数。
第 2 步:加载 ego-browser Skill
Web UI
在输入框中键入 /ego-browser,然后从候选列表中选择对应的 Skill。在 Skill 名称后继续输入或粘贴浏览器任务,再提交消息。
直接使用 /ego-browser 可以在任务开始前明确加载 Skill。DeepSeek Harness 也能根据任务意图选择允许由模型调用的 Skill,但录制演示时显式输入更容易确认调用过程。
无界面终端模式
第 1 步的终端命令已经明确要求使用 ego-browser Skill,因此无需再发送单独的斜杠命令。如需显式调用,也可以在引号中的任务开头加入 /ego-browser。
第 3 步:让 DeepSeek Harness 执行浏览器任务
Web UI
DeepSeek Harness 会加载 Skill、调用 ego-browser 命令行工具,并在单独的 ego (lite) Agent Space 中打开 Anthropic 的 X 主页。Agent 读取指定帖子并整理结果时,请保持 Web UI 运行。
无界面终端模式
终端会在不打开 Harness 对话界面的情况下执行相同的浏览器流程。录制时可以将终端放在一侧作为控制端,同时在另一侧展示 ego (lite) 中的实时浏览器操作。
第 4 步:完成任务
任务完成后,Web UI 会显示五条帖子的可见信息、对应链接和简要内容概括。使用无界面终端模式时,DeepSeek Harness 会在终端输出最终结果并退出。Anthropic 的 X 主页会继续保留在 ego (lite) 中。
常见问题
找不到 /ego-browser
请确认 ~/.agents/skills/ego-browser/SKILL.md 存在,然后从目标项目目录启动 DeepSeek Harness 并新建会话。DeepSeek Harness 也会扫描 <项目目录>/.agents/skills/ 中的项目 Skill。
执行任务时仍然要求审批
使用 Web UI 时,请在提交任务前确认当前会话显示为 Full access。使用终端时,请确认同一条命令中 DSH_PERMISSION_MODE=danger-full-access 位于 dsh 前面。
终端提示找不到 dsh
可以改用包运行器:
DSH_PERMISSION_MODE=danger-full-access npx @deepseek-ai/dsh --profile headless \
"Use the ego-browser skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed."
为什么本指南没有桌面端或 TUI?
DeepSeek Harness 目前官方提供的是本地 Web UI 和无界面 CLI 配置。Web UI 在本机运行,但需要通过浏览器打开,不属于原生桌面应用。TUI 需要另外安装社区插件,因此不在本指南范围内。
X 要求登录或验证账号
请在 ego (lite) 的 Agent Space 中完成登录或验证,然后重新执行任务。
相关文档
- 快速开始:安装 ego (lite) 并完成第一个浏览器任务
- Claude Code 浏览器自动化:通过 Claude Code 使用 ego-browser
- Codex 浏览器自动化:通过 Codex 桌面端或 TUI 使用 ego-browser
- OpenCode 浏览器自动化:通过 OpenCode 桌面端或 TUI 使用 ego-browser
- OpenClaw 浏览器自动化:通过 OpenClaw macOS 桌面端或 TUI 使用 ego-browser
- ego-browser:查看浏览器辅助命令及调用方式
- DeepSeek Harness 官网:查看产品介绍和快速开始
- DeepSeek Harness 仓库:查看源码和最新发布信息
- DeepSeek Harness 用户指南:配置 Web UI 和模型提供商
- DeepSeek Harness 权限预设:了解 Full access、沙箱模式和审批策略