Introduction

DSH’s plugin extension mechanism allows integrating various providers into the Web Runtime. For scenarios where the Codex Web Search interface is already prepared and you wish to use it within DSH via a plugin, the following introduces dsh-web-search-codex.

This plugin provides Codex Web Search capabilities for DeepSeek Harness (DSH), sending search requests to the configured /alpha/search compatible interface. Entries in the community plugin directory are merely plugin sources and are not equivalent to the official app store.

What is a Plugin

dsh-web-search-codex is a Web search provider plugin for DSH.

Its primary responsibilities are:

  • Register the codex search provider.
  • Send search requests to the configured /alpha/search compatible interface.
  • Support reusing OpenAI configuration or using an independent Key to fill in the complete interface address and API Key.

Repository URL:

https://github.com/Cora093/dsh-web-search-codex

Core Features

Below are several capabilities verified by the plugin.

  1. Register the codex search provider.

  2. Send search requests to the configured /alpha/search compatible interface.

  3. Support reusing OpenAI configuration to generate the /alpha/search interface address and use an existing API Key.

  4. Support using an independent Key to fill in the complete /alpha/search interface address and API Key.

  5. When the model is left empty, the search follows the current session model.

  6. Supports HTTP and HTTPS.

  7. Only sends the current search term and does not read or send conversation history.

  8. Rejects all HTTP redirects.

Installation and Enablement

First, confirm the version requirements: 0.1.2 requires DSH 0.1.2-rc.1 or higher 0.1.x versions, and is incompatible with DSH 0.1.1 and earlier versions.

Runtime environment requirements:

node >=22.19

Install the plugin:

dsh plugin --profile web add dsh-web-search-codex@latest --registry=https://registry.npmjs.org/

Start DSH:

dsh --profile web --port 3080

After completing the steps above, open:

Settings -> Plugins -> Plugin Configuration -> Codex Search Provider

Choose a configuration method:

  • Reuse OpenAI
  • Use Independent Key

Confirm the configuration and save.

Please note: After installing the plugin, the Web Runtime will use codex as the search provider, and default web search will be disabled.

Typical Usage

Reuse OpenAI Configuration

If the OpenAI provider is already configured in the model settings, you can select “OpenAI” in the plugin configuration.

After selection, the plugin will generate the /alpha/search interface address based on the existing baseURL and use the existing API Key. The key will not be copied.

The model is optional. When the model is left empty, the search follows the current session model.

Please confirm that the automatically generated interface address is available before saving.

Use Independent Key

If the interface and Key are maintained separately, you can select “Independent Key” in the plugin configuration.

After selection, you need to fill in:

The complete /alpha/search interface address
API Key

The interface address here must include /alpha/search. The plugin will not automatically rewrite the interface address.

The model can also be left empty. When left empty, the search follows the current session model.

Applicable Scenarios and Notes

This plugin is suitable for scenarios where you wish to direct the DSH Web Runtime’s search requests to a Codex /alpha/search compatible interface. It is recommended to pay special attention to the following points before using it.

  • /alpha/search is an internal alpha protocol of Codex and is not a stable public API.
  • The interface address must be a complete URL containing /alpha/search; the plugin will not automatically rewrite it.
  • Supports HTTP and HTTPS; an unencrypted connection warning will be displayed when using HTTP.
  • The plugin rejects all HTTP redirects to prevent the API Key from being sent to other addresses.
  • If a request fails, the plugin will not automatically fall back to the DeepSeek search provider.
  • The plugin does not limit model names and will not replace models that are not supported by the server.
  • The plugin only sends the current search term and does not read or send conversation history.
  • 0.1.2 requires DSH 0.1.2-rc.1 or higher 0.1.x versions and is incompatible with DSH 0.1.1 and earlier versions.
  • engines requires node >=22.19.
  • The license is MIT.
  • The plugin runs with the permissions of the current DSH process; you should check the source code, dependencies, and license before installation.

Conclusion

The value of dsh-web-search-codex lies in integrating Codex Web Search into DSH as a plugin. Once configured, the DSH Web Runtime will use codex as the search provider and send search requests to the /alpha/search compatible interface according to the configuration.

Directory Page:

https://www.skillhub.cn/plugins/Cora093/dsh-web-search-codex

GitHub:

https://github.com/Cora093/dsh-web-search-codex