deepseek-web-query

# DeepSeek Web Query

## Overview

本技能用于将用户的查询请求转发到 DeepSeek 网页版，利用 DeepSeek 的联网搜索能力获取最新信息，同时减轻主模型的负担。

**技术栈**: 使用 Chrome DevTools MCP (通过 mcporter) 控制浏览器，替代原有的 Playwright 方案。

**故障恢复**: 如果 Chrome DevTools MCP 服务不可用，会自动尝试使用 chrome-devtools-mcp-manager 技能启动浏览器和 MCP 服务。

## When to Use

当用户有以下需求时触发此技能：

- **优先触发**：提问以 "ds:" 或 "ds：" 开头（例如："ds:什么是量子计算？"）
- "用 Deep Seek 查一下..."
- "联网搜索..."
- "查下最新的..."
- "搜索一下..."
- 需要查询最新的互联网信息（新闻、技术文档、产品信息等）
- 一般性知识查询，不需要复杂的多步推理
- 代码相关问题，需要最新的 API 文档或最佳实践
- 文本分析、翻译、总结等任务

## Workflow

### 步骤 0: 预处理查询（处理 ds: 前缀）

如果用户查询以 "ds:" 或 "ds：" 开头：
1. 移除前缀（"ds:" 或 "ds："）
2. 将剩余内容作为实际查询问题
3. 继续执行后续步骤

例如：
- 输入："ds:什么是量子计算？" → 实际查询："什么是量子计算？"
- 输入："ds：最新的Python版本是什么？" → 实际查询："最新的Python版本是什么？"

### 步骤 1: 检查并启动 Chrome DevTools MCP

在执行 MCP 操作前，先检查服务状态：

```bash
# 检查 MCP 服务状态
mcporter list
```

**如果服务不可用（连接错误或权限错误），执行自动恢复流程：**

#### 自动恢复流程

1. **检查内置 Chrome 浏览器状态**
   ```javascript
   browser({
     action: "status",
     profile: "openclaw"
   })
   ```

2. **如果浏览器未运行，启动它**
   ```javascript
   browser({
     action: "open",
     profile: "openclaw",
     url: "about:blank"
   })
   ```
   等待 2-3 秒让浏览器完全启动。

3. **验证 CDP 端点可用**
   ```powershell
   Invoke-WebRequest -Uri "http://localhost:18800/json/version" -Method GET
   ```

4. **重新配置 mcporter 的 MCP 服务器**
   ```bash
   # 移除旧的配置（如果存在）
   mcporter server remove chrome-devtools
   
   # 添加新的 MCP 服务器配置
   mcporter server add chrome-devtools \
     --command "npx" \
     --args "chrome-devtools-mcp@latest,--browserUrl,http://127.0.0.1:18800,--no-usage-statistics"
   ```

5. **验证 MCP 服务已恢复**
   ```bash
   mcporter list
   mcporter call chrome-devtools.list_pages
   ```

#### 完整自动恢复脚本示例

```javascript
// 步骤 1: 检查浏览器状态
const status = await browser({ action: "status", profile: "openclaw" });

// 步骤 2: 如果未运行，启动浏览器
if (!status.cdpReady) {
  await browser({ action: "open", profile: "openclaw", url: "about:blank" });
  await new Promise(r => setTimeout(r, 3000)); // 等待启动
}

// 步骤 3: 验证 CDP 端点
// (使用 exec 执行 PowerShell 命令)

// 步骤 4: 重新配置 mcporter
// (使用 exec 执行 mcporter 命令)

// 步骤 5: 验证 MCP 服务
// (使用 exec 执行 mcporter list)
```

### 步骤 2: 打开浏览器并检测登录状态

1. 使用 Chrome DevTools MCP 打开 DeepSeek：

```bash
# 创建新页面并导航到 DeepSeek
mcporter call chrome-devtools.new_page url: "https://chat.deepseek.com/"

# 或者导航到现有页面
mcporter call chrome-devtools.navigate_page type: "url" url: "https://chat.deepseek.com/"
```

2. 等待页面加载完成后，获取页面快照：

```bash
mcporter call chrome-devtools.take_snapshot
```

3. 根据快照内容检测登录状态：
   - **登录页面特征**：包含"手机号"、"验证码"、"登录"、"微信扫码登录"等文本
   - **已登录页面特征**：包含"发送消息"、"深度思考"、"新对话"等文本

**如果 MCP 调用失败，再次执行自动恢复流程，然后重试。**

### 步骤 3: 处理登录（如需要）

如果检测到未登录：

1. 截图展示登录页面给用户：

```bash
mcporter call chrome-devtools.take_screenshot
```

2. 提示用户："请先登录 DeepSeek（手机号+验证码或微信扫码）"
3. 等待用户完成登录
4. 用户登录完成后，重新检测状态（重复步骤 2）

### 步骤 4: 执行查询

1. **获取页面快照**，找到输入框和深度思考按钮的 uid：

```bash
mcporter call chrome-devtools.take_snapshot
```

2. **启用深度思考模式**（如果未启用）：
   - 在快照中查找包含"深度思考"文本的按钮
   - 如果按钮状态显示未启用，点击启用：

```bash
mcporter call chrome-devtools.click uid: "<深度思考按钮的uid>"
```

3. **点击输入框获取焦点**：

```bash
mcporter call chrome-devtools.click uid: "<输入框的uid>"
```

4. **输入用户问题**：

```bash
mcporter call chrome-devtools.type_text text: "用户查询问题"
```

5. **按 Enter 发送**：

```bash
mcporter call chrome-devtools.press_key key: "Enter"
```

6. **等待回答完成**：
   - 等待 "已思考" 或 "已深度思考" 文本出现
   - 或者等待停止按钮消失

```bash
mcporter call chrome-devtools.wait_for text: ["已思考", "已深度思考"] timeout: 60000
```

### 步骤 5: 提取结果

**使用 evaluate_script 提取 Markdown 内容**：

```bash
mcporter call chrome-devtools.evaluate_script function: '
() => {
    // 方法1: 尝试点击 copy 按钮后从页面提取
    const copyButtons = document.querySelectorAll("button[title*=\"复制\"], button[class*=\"copy\"], [class*=\"copy-button\"]");
    if (copyButtons.length > 0) {
        copyButtons[copyButtons.length - 1].click();
    }
    
    // 等待一下复制完成
    return new Promise(resolve => {
        setTimeout(() => {
            // 提取 Markdown 内容
            const markdownElements = document.querySelectorAll(".ds-markdown, [class*=\"markdown\"], [class*=\"message-content\"]");
            let result = "";
            markdownElements.forEach(el => {
                if (el.innerText && el.innerText.trim().length > 0) {
                    result += el.innerText + "\n\n";
                }
            });
            resolve(result.trim());
        }, 500);
    });
}
'
```

**备选方案**：如果上述方法失败，直接提取页面文本：

```bash
mcporter call chrome-devtools.evaluate_script function: '
() => {
    const messages = document.querySelectorAll(".ds-markdown, [class*=\"message-content\"], [class*=\"chat-message\"]");
    const lastMessage = messages[messages.length - 1];
    return lastMessage ? lastMessage.innerText : document.body.innerText;
}
'
```

### 步骤 6: 结果返回

**重要：直接返回提取的原始内容，不要进行 LLM 二次总结或加工。**

- 直接将提取的 Markdown 文本返回给用户
- **不添加额外的解释、总结或格式化**
- **不进行任何整理或编辑**
- 保持 DeepSeek 原始输出的完整性
- 避免不必要的 token 消耗

### 步骤 7: 保持浏览器

**重要**: 不要关闭浏览器页面！保持浏览器会话供后续查询复用。

如需关闭，使用：

```bash
mcporter call chrome-devtools.close_page pageId: <page_id>
```

## 故障恢复机制详解

### 常见错误及处理

#### 错误 1: "connect EPERM" 或管道连接错误

**症状**: 
```
connect EPERM \\.\pipe\mcporter-daemon-xxx
```

**处理**: 执行完整自动恢复流程（步骤 1）。

#### 错误 2: "CDP not ready"

**症状**: 浏览器状态显示 `cdpReady: false`

**处理**: 
1. 停止现有浏览器：`browser({ action: "stop", profile: "openclaw" })`
2. 重新启动浏览器：`browser({ action: "open", profile: "openclaw", url: "about:blank" })`
3. 等待 3 秒后重试

#### 错误 3: MCP 服务器返回错误

**症状**: `mcporter call` 返回错误但连接正常

**处理**:
1. 检查页面是否存在：`mcporter call chrome-devtools.list_pages`
2. 如需要，重新导航到 DeepSeek
3. 重试操作

### 自动恢复的最佳实践

1. **最多尝试 2 次恢复**：如果连续 2 次恢复失败，向用户报告问题
2. **记录恢复操作**：在日志中记录每次恢复尝试
3. **保持用户知情**：如果恢复需要较长时间，告知用户正在处理
4. **优雅降级**：如果 MCP 完全不可用，建议使用替代方案（如 Tavily 搜索）

## Chrome DevTools MCP 工具参考

### 核心工具

| 工具 | 用途 |
|------|------|
| `new_page` | 创建新标签页并加载 URL |
| `navigate_page` | 导航到 URL 或前进/后退/刷新 |
| `take_snapshot` | 获取页面 a11y 树快照（用于查找元素 uid） |
| `take_screenshot` | 截图 |
| `click` | 点击元素 |
| `fill` | 填写输入框 |
| `type_text` | 输入文本 |
| `press_key` | 按键 |
| `evaluate_script` | 执行 JavaScript 并返回结果 |
| `wait_for` | 等待特定文本出现 |
| `list_pages` | 列出所有打开的页面 |
| `select_page` | 选择特定页面作为上下文 |

### DeepSeek 页面元素选择策略

**输入框**：
- 查找 placeholder 包含"发送消息"的 textarea
- 或查找 contenteditable="true" 的元素

**深度思考按钮**：
- 查找文本包含"深度思考"的按钮
- 检查按钮状态（aria-pressed 或 class）

**Copy 按钮**：
- 查找 title 包含"复制"或 class 包含"copy"的按钮
- 通常位于每条消息的右上角

**消息内容**：
- class 包含 "ds-markdown" 或 "message-content"

## Login Detection

通过页面快照检测登录状态：

**登录页面特征：**
- 包含文本："手机号"、"验证码"、"登录"、"微信扫码登录"
- 有手机号输入框和验证码输入框

**已登录页面特征：**
- 包含文本："发送消息"、"深度思考"、"新对话"
- 有消息输入框

## Result Extraction Methods

### 方法 1: Evaluate Script 提取（推荐）

优点：
- 获取 Markdown 格式文本，保留格式
- Token 消耗极低（~100 tokens）
- 速度快
- 用户可直接复制编辑

实现：
1. 使用 `evaluate_script` 执行 JavaScript
2. 查询 `.ds-markdown` 或 `[class*="message-content"]` 元素
3. 提取 `innerText` 返回

### 方法 2: 截图返回

优点：
- 原汁原味
- 包含图表、代码高亮等视觉效果

缺点：
- 无法复制文本
- 文件较大

### 方法 3: LLM 整理（传统方式）

优点：
- 可二次加工、个性化
- 可结合上下文

缺点：
- Token 消耗高（~2k+ tokens）
- 速度慢

## 完整查询流程示例（含故障恢复）

### ds: 前缀查询（推荐方式）

用户: "ds:什么是量子计算？"

1. 识别并移除 "ds:" 前缀，实际查询："什么是量子计算？"
2. **检查 MCP 服务状态**，如不可用执行自动恢复流程
3. 使用 Chrome DevTools MCP 导航到 chat.deepseek.com
4. 获取快照检测登录状态
5. 如果未登录，截图提示用户登录
6. 如果已登录：
   - 查找并点击深度思考按钮（如未启用）
   - 点击输入框获取焦点
   - 输入问题
   - 按 Enter 发送
7. 等待回答完成
8. 使用 evaluate_script 提取 Markdown 内容
9. 直接返回提取的原始文本
10. 保持页面打开

### 快速复用

用户: "ds：再详细说一下 asyncio 的事件循环"

1. 识别并移除 "ds：" 前缀
2. **检查 MCP 服务状态**，如不可用执行自动恢复流程
3. 复用已打开的页面（使用 `list_pages` 和 `select_page`）
4. 直接输入新问题并获取回答

## 命令速查

### MCP 服务管理
```bash
# 检查 MCP 服务状态
mcporter list

# 添加 MCP 服务器配置
mcporter server add chrome-devtools \
  --command "npx" \
  --args "chrome-devtools-mcp@latest,--browserUrl,http://127.0.0.1:18800,--no-usage-statistics"

# 移除 MCP 服务器配置
mcporter server remove chrome-devtools
```

### 浏览器管理
```javascript
// 检查浏览器状态
browser({ action: "status", profile: "openclaw" })

// 启动浏览器
browser({ action: "open", profile: "openclaw", url: "about:blank" })

// 停止浏览器
browser({ action: "stop", profile: "openclaw" })
```

### CDP 验证
```powershell
# 测试 CDP 端点
Invoke-WebRequest -Uri "http://localhost:18800/json/version" -Method GET
```

### DeepSeek 查询
```bash
# 导航到 DeepSeek
mcporter call chrome-devtools.navigate_page type: "url" url: "https://chat.deepseek.com/"

# 获取页面快照
mcporter call chrome-devtools.take_snapshot

# 点击元素
mcporter call chrome-devtools.click uid: "<element_uid>"

# 输入文本
mcporter call chrome-devtools.type_text text: "查询内容"

# 按键
mcporter call chrome-devtools.press_key key: "Enter"

# 等待文本出现
mcporter call chrome-devtools.wait_for text: '["已思考", "已深度思考"]' timeout: 60000

# 执行 JavaScript 提取内容
mcporter call chrome-devtools.evaluate_script function: '
() => {
    const elements = document.querySelectorAll(".ds-markdown");
    let result = "";
    elements.forEach(el => {
        result += el.innerText + "\n\n";
    });
    return result.trim();
}
'

# 截图
mcporter call chrome-devtools.take_screenshot

# 列出所有页面
mcporter call chrome-devtools.list_pages

# 选择页面
mcporter call chrome-devtools.select_page pageId: 0
```

## Notes

- **ds: 前缀**：使用 "ds:" 或 "ds：" 前缀可以确保优先使用此技能进行查询
- **自动恢复**：MCP 服务故障时会自动尝试恢复，无需手动干预
- **首次使用需要登录 DeepSeek 账号**
- **浏览器页面会保持打开状态**，供后续查询使用
- **如需关闭页面**，使用 `close_page` 工具
- **查询结果取决于 DeepSeek 网页版的响应速度**，通常需要 10-30 秒
- **默认使用 evaluate_script 提取方案**，兼顾速度和质量
- **Chrome DevTools MCP 需要浏览器通过 `--remote-debugging-port` 启动**（内置 `openclaw` 配置文件已自动处理）
- **故障恢复最多尝试 2 次**，避免无限循环
- **如果 MCP 完全不可用**，建议向用户说明并提供替代方案（如 Tavily 搜索）

## 依赖技能

本技能依赖于以下技能的正常工作：
- **chrome-devtools-mcp-manager**: 用于管理 Chrome 浏览器和 MCP 服务的生命周期
- **browser tool**: OpenClaw 内置的浏览器控制工具
- **mcporter**: MCP 服务器管理 CLI 工具

## 故障排除

### MCP 服务持续不可用

如果自动恢复流程无法解决问题：

1. **检查 Node.js 环境**
   ```bash
   node --version
   npx --version
   ```

2. **检查 chrome-devtools-mcp 包**
   ```bash
   npm list -g chrome-devtools-mcp
   # 或
   npx chrome-devtools-mcp@latest --help
   ```

3. **检查端口占用**
   ```powershell
   Get-NetTCPConnection -LocalPort 18800
   ```

4. **手动重启**
   ```javascript
   browser({ action: "stop", profile: "openclaw" })
   // 等待 5 秒
   browser({ action: "open", profile: "openclaw", url: "about:blank" })
   ```

5. **联系用户**
   如果以上步骤都无法解决问题，向用户报告：
   - 当前状态
   - 已尝试的解决方案
   - 建议的替代方案（如 Tavily 搜索）