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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

专题：导航与主 Frame 缺失

36. 页面正在导航与主 Frame 缺失：PAGE_NAVIGATING

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

37. dsb 客户端：Go 版本、多目标与后端服务管理

专题：可靠数据采集

38. 可靠的数据采集：上下文校验、UTF-8 留档与证据口径

专题：浏览器 profile 管理

39. 浏览器 profile：列表、克隆与选择

当前默认行为：高亮与截图关闭，元素索引照常生成；最后一个任务结束后保留浏览器和数据页。用法见首个任务，复用与显式关闭见浏览器与 profile。

按问题查阅

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

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

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

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

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

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

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

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

专题：导航与主 Frame 缺失 ​

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

专题：可靠数据采集 ​

专题：浏览器 profile 管理 ​

按问题查阅 ​