Configuration

The web-search entry's config accepts:

Key	Default	Meaning
`provider`	`openai-responses`	Selected backend
`responsesApiKeyEnv`	`OPENAI_API_KEY`	Credential / env name for Responses search
`responsesBaseURL`	`https://api.openai.com/v1`	Responses API base URL
`responsesModel`	`gpt-4o`	Model that exposes `tools: [{ type: "web_search" }]`
`responsesMaxTokens`	`1024`	`max_output_tokens` for Responses search
`deepseekApiKeyEnv`	`DEEPSEEK_API_KEY`	Credential / env name for DeepSeek search
`deepseekBaseURL`	`https://api.deepseek.com/anthropic/v1`	DeepSeek Anthropic-compatible base URL
`deepseekModel`	`deepseek-v4-flash`	DeepSeek search model
`deepseekApiVersion`	`2023-06-01`	`anthropic-version` header
`deepseekMaxTokens`	`4096`	DeepSeek `max_tokens`
`deepseekMaxUses`	`5`	DeepSeek `web_search` `max_uses`

Provide keys through DSH credentials or the launching environment. Do not put real keys in Git, cordis.patch.yml, or this README.

Example entry in the profile's cordis.patch.yml:

- id: web-search
  config:
    provider: openai-responses
    responsesApiKeyEnv: OPENAI_API_KEY
    responsesBaseURL: https://api.openai.com/v1
    responsesModel: gpt-4o

Switching provider in the settings form saves immediately and applies to later web_search calls. A DSH restart is not required for that switch. The other fields are ordinary config: change them in cordis.patch.yml, and DSH re-applies the plugin.

On its first boot DSH 0.1.7+ imports a legacy settings.yaml web-search: section into this entry, provided 0.4.0 is already installed then. If that boot ran with 0.3.x, the selection stays in settings.yaml.imported; set provider on the entry above.

配置

web-search 条目的配置支持：

字段	默认值	含义
`provider`	`openai-responses`	当前 backend
`responsesApiKeyEnv`	`OPENAI_API_KEY`	Responses 搜索使用的凭据 / 环境变量名
`responsesBaseURL`	`https://api.openai.com/v1`	Responses API 根地址
`responsesModel`	`gpt-4o`	支持 `tools: [{ type: "web_search" }]` 的模型
`responsesMaxTokens`	`1024`	Responses 搜索的 `max_output_tokens`
`deepseekApiKeyEnv`	`DEEPSEEK_API_KEY`	DeepSeek 搜索使用的凭据 / 环境变量名
`deepseekBaseURL`	`https://api.deepseek.com/anthropic/v1`	DeepSeek Anthropic 兼容根地址
`deepseekModel`	`deepseek-v4-flash`	DeepSeek 搜索模型
`deepseekApiVersion`	`2023-06-01`	`anthropic-version` 请求头
`deepseekMaxTokens`	`4096`	DeepSeek `max_tokens`
`deepseekMaxUses`	`5`	DeepSeek `web_search` 的 `max_uses`

密钥只能放在 DSH credentials 或启动环境里，不要写入 Git、cordis.patch.yml 或本文。

profile cordis.patch.yml 条目示例：

- id: web-search
  config:
    provider: openai-responses
    responsesApiKeyEnv: OPENAI_API_KEY
    responsesBaseURL: https://api.openai.com/v1
    responsesModel: gpt-4o

在设置表单里切换 provider 会立刻保存，并作用于之后的 web_search，不必为了切换而重启 DSH。其余字段是普通配置：改 cordis.patch.yml，DSH 会重新应用插件。

DSH 0.1.7+ 首次启动时会把旧 settings.yaml 的 web-search: 段导入这个条目，前提是那时已装好 0.4.0。如果首次启动时装的还是 0.3.x，选择只留在 settings.yaml.imported 里，需要在上面的条目里手动设置 provider。

dsh-web-search

同名套件的其他儲存庫

安裝

說明文件

Configuration

配置