<!-- Source: https://deepseek-browser-use.io.nexus/guide -->

# deepseek-browser-use：从入门到源码

本章对应当前 deepseek-browser-use 工程，所有浏览器控制操作通过 `POST /playwright/command`。新读者从 01 开始；已经接入的读者可直接查 13 的命令清单。文中源码路径相对于浏览器项目根目录。

## 第一阶段：从零运行一个任务

按顺序阅读，完成环境准备、第一次调用并理解统一协议。

- [01. deepseek-browser-use：概念与学习路线](<https://deepseek-browser-use.io.nexus/01>)
- [02. 安装、启动与健康检查](<https://deepseek-browser-use.io.nexus/02>)
- [03. 第一个任务：打开页面、读取结果与关闭](<https://deepseek-browser-use.io.nexus/03>)
- [03-1. 客户端：dsb 命令行与结构化留档](<https://deepseek-browser-use.io.nexus/03_client>)
- [04. 统一命令接口与人机协作](<https://deepseek-browser-use.io.nexus/04>)

## 第二阶段：让智能体可靠完成任务

理解共享登录态与页面状态，再学习模型接入、表单验证、留档、批量和运维。

- [05. 浏览器、profile 与登录态](<https://deepseek-browser-use.io.nexus/05>)
- [06. 窗口尺寸与页面视口](<https://deepseek-browser-use.io.nexus/06>)
- [07. 接入智能体：观察、执行与验证](<https://deepseek-browser-use.io.nexus/07>)
- [08. 表单与多层弹窗排障：防止重复提交](<https://deepseek-browser-use.io.nexus/08>)
- [09. 调用追踪、页面留档与文件上传](<https://deepseek-browser-use.io.nexus/09>)
- [10. 站点配方、技能与异步作业](<https://deepseek-browser-use.io.nexus/10>)
- [11. Windows OCR：本地图片与页面文字识别](<https://deepseek-browser-use.io.nexus/11>)
- [12. 配置项与运维自省](<https://deepseek-browser-use.io.nexus/12>)

## 第三阶段：查命令、理解核心原理

从命令速查进入执行链、前端 DOM、Java 模型和正文抽取。

这部分包含当前源码：DOM 构建脚本、Java 元素树与 Frame 模型、HTTP 执行链，以及可独立编译的网页正文与大模型结构化示例。07 补充状态评估、任务记忆和模型决策适配代码。

- [13. 命令清单](<https://deepseek-browser-use.io.nexus/13>)
- [命令可靠性：诊断、业务断言与稳定定位](<https://deepseek-browser-use.io.nexus/40>)
- [14. 源码教程：从 HTTP 请求到命令执行](<https://deepseek-browser-use.io.nexus/14>)
- [15. DOM 原理：前端如何生成可交互快照](<https://deepseek-browser-use.io.nexus/15>)
- [16. DOM 原理：Java 模型与跨 Frame 索引](<https://deepseek-browser-use.io.nexus/16>)
- [17. 正文提取与上层结构化处理](<https://deepseek-browser-use.io.nexus/17>)

## 第四阶段：按功能深入源码

每篇结合注册参数、服务方法、返回结果与边界条件，覆盖当前全部注册命令。

每条命令后附可展开的注册代码与实际服务方法；点击、定位、批量和配方另附公共辅助实现。代码来自当前工程，类内片段需要结合原类字段和辅助方法阅读。

- [18. 源码教程：生命周期、导航与页签](<https://deepseek-browser-use.io.nexus/18>)
- [19. 源码教程：DOM、页面状态与元素读取](<https://deepseek-browser-use.io.nexus/19>)
- [20. 源码教程：点击、输入、键盘与鼠标](<https://deepseek-browser-use.io.nexus/20>)
- [21. 源码教程：等待条件与 JavaScript 执行](<https://deepseek-browser-use.io.nexus/21>)
- [22. 源码教程：文件上传、截图、PDF 与 OCR](<https://deepseek-browser-use.io.nexus/22>)
- [23. 源码教程：Cookie、存储与页面设置](<https://deepseek-browser-use.io.nexus/23>)
- [24. 源码教程：网络记录、请求拦截与控制台](<https://deepseek-browser-use.io.nexus/24>)
- [25. 源码教程：原生对话框、DOM 弹窗与人机协作](<https://deepseek-browser-use.io.nexus/25>)
- [26. 源码教程：批量、配方、后台作业与维护](<https://deepseek-browser-use.io.nexus/26>)
- [27. 源码教程：Chrome 走 CDP 与 CDP 客户端](<https://deepseek-browser-use.io.nexus/27>)
- [28. 请求响应关联与线程约束](<https://deepseek-browser-use.io.nexus/28>)

## 第五阶段：从零开发 DeepSeek Harness 插件

先按 29–32 四篇开发教程完成入口、基础工具、核心能力和安装验收，再将 33–35 作为使用与维护手册查阅。

- [29. DeepSeek Harness 插件开发入门：从入口到第一个工具](<https://deepseek-browser-use.io.nexus/29>)
- [30. 开发 dsh-plugin-deepseek-browser-use：HTTP 客户端与基础工具](<https://deepseek-browser-use.io.nexus/30>)
- [31. 开发 dsh-plugin-deepseek-browser-use：会话、作业、文件与图片](<https://deepseek-browser-use.io.nexus/31>)
- [32. 构建并安装到 DeepSeek Harness](<https://deepseek-browser-use.io.nexus/32>)

## 第六阶段：原生插件使用与维护

- [33. 原生浏览器插件：安装、配置与使用](<https://deepseek-browser-use.io.nexus/33>)
- [34. 原生浏览器插件：源码、生命周期与测试](<https://deepseek-browser-use.io.nexus/34>)
- [35. 后端自动管理：安装依赖、更新、编译与启动](<https://deepseek-browser-use.io.nexus/35>)

## 专题：导航与主 Frame 缺失

- [36. 页面正在导航与主 Frame 缺失：PAGE_NAVIGATING](<https://deepseek-browser-use.io.nexus/36>)

## 专题：客户端与后端服务管理

- [37. dsb 客户端：Go 版本、多目标与后端服务管理](<https://deepseek-browser-use.io.nexus/37>)

## 专题：可靠数据采集

- [38. 可靠的数据采集：上下文校验、UTF-8 留档与证据口径](<https://deepseek-browser-use.io.nexus/38>)

## 专题：浏览器 profile 管理

- [39. 浏览器 profile：列表、克隆与选择](<https://deepseek-browser-use.io.nexus/39>)

当前默认行为：高亮与截图关闭，元素索引照常生成；最后一个任务结束后保留浏览器和数据页。用法见 [首个任务](<https://deepseek-browser-use.io.nexus/03>)，复用与显式关闭见 [浏览器与 profile](<https://deepseek-browser-use.io.nexus/05>)。

## 按问题查阅

| 遇到的问题 | 阅读位置 |
| --- | --- |
| 服务启动不了或端口不通 | [安装](<https://deepseek-browser-use.io.nexus/02>)、[配置](<https://deepseek-browser-use.io.nexus/12>) |
| 客户端装哪个、怎么用、服务在别的机器上 | [Go 客户端](<https://deepseek-browser-use.io.nexus/37>) |
| 参数、输出投影和 UTF-8 留档 | [客户端](<https://deepseek-browser-use.io.nexus/03_client>)、[可靠采集](<https://deepseek-browser-use.io.nexus/38>) |
| 浏览器引擎不对或登录态变化 | [浏览器与 profile](<https://deepseek-browser-use.io.nexus/05>) |
| 列出 profile、克隆 Chrome 用户资料或选择命名目录 | [profile 列表、克隆与选择](<https://deepseek-browser-use.io.nexus/39>) |
| 本机 Chrome 是怎么被驱动的、调试端口 | [Chrome 走 CDP](<https://deepseek-browser-use.io.nexus/27>) |
| 元素找不到、索引失效或 iframe | [页面状态](<https://deepseek-browser-use.io.nexus/19>)、[Java DOM](<https://deepseek-browser-use.io.nexus/16>) |
| 点击成功但提交结果不明 | [防重复提交](<https://deepseek-browser-use.io.nexus/08>)、[弹窗与人工协助](<https://deepseek-browser-use.io.nexus/25>) |
| 相同 URL 的响应串错或 requestId 查不到正文 | [请求响应关联](<https://deepseek-browser-use.io.nexus/28>)、[网络记录](<https://deepseek-browser-use.io.nexus/24>) |
| 需要读取正文或结构化数据 | [正文提取](<https://deepseek-browser-use.io.nexus/17>) |
| 要读页面上的表格（数字别配错列） | [正文提取](<https://deepseek-browser-use.io.nexus/17>) |
| 从零开发 Harness 插件 | [插件入门](<https://deepseek-browser-use.io.nexus/29>)、[基础功能](<https://deepseek-browser-use.io.nexus/30>)、[核心功能](<https://deepseek-browser-use.io.nexus/31>) |
| 把自己开发的插件安装到 Harness | [构建与安装](<https://deepseek-browser-use.io.nexus/32>) |
| 新增命令或修改底层实现 | [执行链](<https://deepseek-browser-use.io.nexus/14>)、[功能源码教程](<https://deepseek-browser-use.io.nexus/18>) |
| 只读命令报主 frame 为 null、或控制台一直在登录页跳转 | [导航与主 Frame 缺失](<https://deepseek-browser-use.io.nexus/36>) |