Merge branch 'feat/deepseek-search-api'

Author: qorzj

docs/configuration.md

@@ -45,6 +45,7 @@ Deep Code 使用 `settings.json` 设置文件进行持久化配置，支持两
 | `telemetryEnabled`   | boolean   | 是否启用匿名使用数据上报（默认 `true`）                              |
 | `notify`             | string    | 任务完成通知脚本的完整路径（如 Slack 通知脚本）                      |
 | `webSearchTool`      | string    | 自定义联网搜索脚本的完整路径                                         |
+| `deepseekSearchApiEnabled` | boolean | 是否使用 DeepSeek 官方网页搜索（默认 `false`） |
 | `mcpServers`         | object    | MCP 服务器配置（键为服务名，值为 McpServerConfig 对象）              |
 | `temperature`        | number    | 模型采样温度，范围 `0` 到 `2`                           |
 | `permissions`        | object    | 权限策略及 `addWorkingDirs` 额外工作目录配置（参见 [permission.md](./permission.md)） |
@@ -177,6 +178,12 @@ Deep Code 内置免费可用的 Web Search 工具。如果需要自定义搜索
 
 脚本接收一个搜索查询参数，输出 JSON 格式的结果供 AI 使用。
 
+#### `deepseekSearchApiEnabled` — 启用 DeepSeek 网页搜索 API
+
+Deep Code 支持最新的[DeepSeek官方网页搜索API](https://api-docs.deepseek.com/zh-cn/guides/search)。设置 `deepseekSearchApiEnabled: true`，且当前连接的 `BASE_URL` 为 `https://api.deepseek.com` 时启用。按照官方文档介绍（截止2026-10-30），网页搜索按请求次数计费，不按 token 或返回结果条数计费，网页搜索每 1,000 次成功请求	5元。
+
+`deepseekSearchApiEnabled` 默认值为 `false`。关闭开关或使用其他 API 地址时，保持原有搜索行为。
+
 #### `enabledSkills` — Skill 启用配置
 
 控制 skill 扫描时是否包含指定 skill。键是解析后的 skill 名称，值必须是布尔值：

docs/configuration_en.md

@@ -45,6 +45,7 @@ The following are all the top-level fields supported in `settings.json`, along w
 | `telemetryEnabled` | boolean | Enable anonymous usage reporting (default `true`)                           |
 | `notify`           | string  | Full path to a task-completion notification script (e.g., Slack notification script) |
 | `webSearchTool`    | string  | Full path to a custom web search script                                     |
+| `deepseekSearchApiEnabled` | boolean | Use DeepSeek official web search (default `false`) |
 | `mcpServers`       | object  | MCP server configurations (keys are service names, values are McpServerConfig objects) |
 | `temperature`      | number  | Sampling temperature for LLM, from `0` to `2`                 |
 | `permissions`      | object  | Permission policy and additional `addWorkingDirs` workspace roots (see [permission_en.md](./permission_en.md)) |
@@ -177,6 +178,12 @@ Deep Code has a built-in, free-to-use Web Search tool. If you need custom search
 
 The script receives a search query as an argument and outputs results in JSON format for the AI.
 
+#### `deepseekSearchApiEnabled` — Enable the DeepSeek Web Search API
+
+Deep Code supports the latest [DeepSeek official web search API](https://api-docs.deepseek.com/guides/search). Set `deepseekSearchApiEnabled: true` to enable it when the `BASE_URL` is `https://api.deepseek.com`. According to the official documentation as of October 30, 2026, web search is billed per request, rather than by tokens or the number of results returned, at $0.75 per 1,000 successful requests.
+
+`deepseekSearchApiEnabled` defaults to `false`. When disabled or using another API address, the existing search behavior applies.
+
 #### `enabledSkills` — Skill Enablement
 
 Controls whether skills are included during skill scanning. Keys are resolved skill names, and values must be booleans:

packages/cli/src/tests/exec-runner.test.ts

@@ -34,6 +34,7 @@ function createSettings(
     reasoningEffort: "high",
     debugLogEnabled: false,
     telemetryEnabled: false,
+    deepseekSearchApiEnabled: false,
     multimodal: "default",
     filesApiEnabled: false,
     filesApiTimeoutMs: 60_000,

packages/core/src/common/openai-client.ts

@@ -53,6 +53,7 @@ export function createOpenAIClient(
   telemetryEnabled: boolean;
   notify?: string;
   webSearchTool?: string;
+  deepseekSearchApiEnabled?: boolean;
   env: Record<string, string>;
   machineId?: string;
   plusApiKey?: string;
@@ -77,6 +78,7 @@ export function createOpenAIClient(
       telemetryEnabled: settings.telemetryEnabled,
       notify: settings.notify,
       webSearchTool: settings.webSearchTool,
+      deepseekSearchApiEnabled: settings.deepseekSearchApiEnabled,
       env: settings.env,
       machineId: getMachineId(),
       plusApiKey,
@@ -99,6 +101,7 @@ export function createOpenAIClient(
       telemetryEnabled: settings.telemetryEnabled,
       notify: settings.notify,
       webSearchTool: settings.webSearchTool,
+      deepseekSearchApiEnabled: settings.deepseekSearchApiEnabled,
       env: settings.env,
       machineId: getMachineId(),
       plusApiKey,
@@ -140,6 +143,7 @@ export function createOpenAIClient(
     telemetryEnabled: settings.telemetryEnabled,
     notify: settings.notify,
     webSearchTool: settings.webSearchTool,
+    deepseekSearchApiEnabled: settings.deepseekSearchApiEnabled,
     env: settings.env,
     machineId: getMachineId(),
     plusApiKey,

packages/core/src/common/tool-types.ts

@@ -19,6 +19,7 @@ export type OpenAIClientResult = {
   telemetryEnabled?: boolean;
   notify?: string;
   webSearchTool?: string;
+  deepseekSearchApiEnabled?: boolean;
   env?: Record<string, string>;
   machineId?: string;
   plusApiKey?: string;

packages/core/src/settings-diagnostics.ts

@@ -164,6 +164,7 @@ export function inspectSettings(options: {
       "telemetryEnabled",
       "notify",
       "webSearchTool",
+      "deepseekSearchApiEnabled",
       "multimodal",
       "filesApiEnabled",
       "filesApiTimeoutMs",

packages/core/src/settings.ts

@@ -103,6 +103,7 @@ export type DeepcodingSettings = {
   telemetryEnabled?: boolean;
   notify?: string;
   webSearchTool?: string;
+  deepseekSearchApiEnabled?: boolean;
   multimodal?: MultimodalMode;
   filesApiEnabled?: boolean;
   filesApiTimeoutMs?: number;
@@ -133,6 +134,7 @@ export type ResolvedDeepcodingSettings = {
   telemetryEnabled: boolean;
   notify?: string;
   webSearchTool?: string;
+  deepseekSearchApiEnabled: boolean;
   multimodal: MultimodalMode;
   filesApiEnabled: boolean;
   filesApiTimeoutMs: number;
@@ -862,6 +864,15 @@ export function resolveSettingsSources(
     ""
   );
 
+  const deepseekSearchApiEnabled = choose(
+    "deepseekSearchApiEnabled",
+    [
+      ["project.deepseekSearchApiEnabled", parseBoolean(projectSettings?.deepseekSearchApiEnabled)],
+      ["user.deepseekSearchApiEnabled", parseBoolean(userSettings?.deepseekSearchApiEnabled)],
+    ],
+    false
+  );
+
   const multimodal = choose(
     "multimodal",
     [
@@ -995,6 +1006,7 @@ export function resolveSettingsSources(
     telemetryEnabled,
     notify: notify || undefined,
     webSearchTool: webSearchTool || undefined,
+    deepseekSearchApiEnabled,
     multimodal,
     filesApiEnabled,
     filesApiTimeoutMs,