前言¶
在 DeepSeek Harness（DSH）插件生態中，通過接口對接業務系統（如 EIP 系統）通常需要先明確接口定義、業務步驟與數據契約。現有文檔往往缺失或過時，逆向工程成本較高。dsh-web-recorder 提供了一種替代方案：它不依賴文檔，而是通過錄制真實的瀏覽器操作和網絡請求，生成可供大模型分析的時間線報告，從而推導出接口調用序列與數據格式。
核心能力¶
本插件專注於“旁觀與記錄”：
* 記錄真實瀏覽器操作（點擊、輸入、導航）和網絡請求（XHR/Fetch）。
* 生成 Markdown 摘要報告（report.md）和原始事件流（events.jsonl）。
* Attach 到已打開的瀏覽器窗口（如帶調試端口的 Playwright MCP 瀏覽器）。
* 啓動有頭瀏覽器進行錄製。
* 提供工具：recorder_start、recorder_stop、recorder_status。
安裝與前置¶
使用本插件需要滿足以下環境要求：
* DSH 宿主版本：@deepseek-ai/dsh ^0.2.0-rc.2
* Node.js >= 18
* pnpm >= 8
* Playwright MCP 是可選依賴，不是必需。
執行以下命令安裝插件：
dsh plugin --profile web add dsh-web-recorder@latest
安裝完成後，硬刷新瀏覽器即可在 DSH 會話工具列表中看到 recorder_* 工具。
工具說明¶
插件提供三個核心工具：
recorder_start(url?, waitSeconds?)：開始錄製。優先 attach 到已有瀏覽器窗口（如 CDP 端口的 Playwright MCP），否則啓動有頭瀏覽器。waitSeconds可用於跳過頁面初始化。事件實時寫入events.jsonl。recorder_stop()：停止錄製。生成report.md摘要報告。attach 模式只斷開連接，不關閉瀏覽器；自啓模式則關閉窗口。此操作爲冪等。recorder_status()：查詢錄製狀態，包括是否在錄製、事件分類計數、產物目錄、jobId等。
使用流程¶
本插件職責僅爲“記錄”，頁面操作由真人或自動化工具（如 playwright MCP、browser-use）驅動。
- 啓動錄製：調用
recorder_start。 - 執行流程：在受監控的瀏覽器窗口中完成業務操作（真人操作或自動化工具驅動）。
- 停止錄製：調用
recorder_stop，生成報告。 - 分析沉澱：模型讀取
report.md和events.jsonl，歸納業務流程、接口調用序列與數據契約，進而沉澱爲 skill 或接口文檔。
注意事項¶
- 錄製範圍：僅記錄插件 attach/啓動的瀏覽器窗口內的操作。
- 驅動分離：插件不直接操作頁面，只負責記錄。如果使用 Playwright MCP，需確保其瀏覽器啓動時帶
--remote-debugging-port，以便插件 attach。 - 文件輸出：停止錄製後會生成
report.md（摘要）和events.jsonl（原始事件流）。
結語¶
dsh-web-recorder 通過“操作留痕”的方式，將不可見的接口調用顯性化。對於缺乏文檔或需要快速驗證接口契約的場景，它是連接 DSH 智能體與真實 Web 業務的實用工具。
