前言¶
DSH 插件生态强调「一切皆插件」。dsh-pilot 是一个面向 DeepSeek Harness Web GUI 的插件，用于让 DSH agent 在聊天中通过 CDP 驱动本机 Edge 或 Chrome。
它面向浏览器操作任务：打开页面、读取结构化文本、按 snapshot ref 点击和输入、填写表单、上传文件，并在 Web GUI 中通过 cockpit 面板观察截图、URL、状态和操作日志。插件使用零运行时依赖，不需要 API key，可通过一条命令安装。
定位¶
项目信息¶
- 仓库：guo6x/dsh-pilot
- 类型：DeepSeek Harness 插件，安装到 web profile
- 许可证：MIT
- 浏览器：通过 CDP 使用本机 Edge 或 Chrome
- 依赖：零运行时依赖，不需要 API key
运行要求¶
- Node >= 22
- 本机已安装 Edge 或 Chrome
- 安装后需要重启 dsh web 进程，再刷新页面
核心能力¶
页面读取¶
插件可以从聊天中打开页面，并读取结构化文本，包括 title、URL、text、links，以及一个带编号的元素列表。
元素操作¶
点击和输入基于 snapshot ref 进行，而不是猜测 CSS selector。表单填写可按 label、aria-label、placeholder、name 或 id 解析人类可见字段。文件上传可指定 snapshot ref，用于定位文件输入框。
导航与辅助动作¶
支持 back、reload、wait、JS evaluation、screenshot 和 download 等工具。
pilot_wait接受 1-30000 ms 的等待时间。pilot_upload接受 1-10 个绝对路径文件。- 上传文件总大小上限为 100 MB。
- 下载上限为 20 MB。
可视化与会话隔离¶
Web GUI 中提供可拖动的 cockpit 面板，展示截图、URL、状态和操作日志。
默认情况下，面板跟随最近使用的会话；当多个会话存在时，也可以固定到另一个会话。每个 agent 会话使用独立的浏览器实例，便于并行会话互不干扰。
安装与启用¶
先安装插件，再重启宿主进程，最后检查安装结果。
- 从 GitHub 安装：
dsh plugin --profile web add github:guo6x/dsh-pilot
-
重启正在运行的
dsh web进程，然后刷新页面。仅刷新浏览器页面不能加载新的 host 代码。 -
在 web profile 中检查：
dsh plugin --profile web list dsh-pilot
- 如果你使用本地 checkout，也可以在仓库目录中执行：
dsh plugin --profile web add .
从 GitHub 安装会使用已提交的 lib/ 文件，不运行 build 脚本。
典型用法¶
只读检查¶
在新聊天中给出这样的任务：
Open
https://example.com, tell me what the page says, then verify that theLearn morelink is visible.
该任务只读取公开页面；完成后可以核对页面标题、文本和链接信息，cockpit 中也会显示截图、URL、状态和操作日志。
表单填写¶
对 staging 表单可以给出一个有边界的任务：
Open our staging application form, fill the contact fields, upload the approved resume, verify the entered values, and stop before final submission.
填写可按人类可见字段名解析，上传按 snapshot ref 定位文件输入框，并停在最终提交之前。
限制与注意¶
- 每个会话一个标签页；refs 固定在当前页面。
- 仅支持 headless，不提供 headed 模式。
- 安装后必须重启
dsh web进程；只刷新页面不能加载新的 host 代码。 - 插件以当前 dsh 进程权限运行；安装前应检查源码和 MIT 许可证。
- 不需要额外账号或 API key；文档说明数据不离开本机。
- 上传和下载有大小限制：上传总大小上限 100 MB，下载上限 20 MB。
链接¶
- GitHub：https://github.com/guo6x/dsh-pilot
- 社区目录页：本文已核实事实未提供具体 URL，因此不列出。
