deepseekplugins

DeepSeek Harness plugin

dsh-web-search-pool

多 key 多供应商（Tavily + Exa）搜索 provider，为 DeepSeek Harness 的 web capability seam（ctx.web）提供按限流负载均衡

Docs & Rendering
Jump to install

Source facts

Repository
DreamRift/dsh-web-search-pool
Latest update
Aug 18, 2026
Category
Docs & Rendering
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/DreamRift/dsh-web-search-pool
Plugin: dsh-web-search-pool
Author: DreamRift

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-web-search-pool

!Version !License: MIT !DSH Version: rc.7

DeepSeek Harness 的 多供应商搜索负载均衡插件。将多个 Tavily 和 Exa API keys 组织成智能池，自动按限流调度并故障切换。

✨ Features

  • 🔑 Multi-key Pool: 支持多个 Tavily + Exa keys，统一管理
  • ⚖️ Smart Load Balancing: 基于 RPM（每分钟的请求数）加权轮询调度
  • 🔄 Automatic Fallback: 429 rate limit、额度耗尽、网络错误时自动切换到下一个 key
  • 📊 Usage Dashboard: Settings 页卡片实时查看已用额度、总限额、刷新按钮
  • 🔒 Secure: API keys 通过 DSH credentials service 保存，不写入配置文件
  • 🎯 Exa Anonymous Free Tier: 内置免费匿名层（1 req/sec），有 key 走 REST 提配额
  • 🏗️ Native Bundle (rc.7): DeepSeek Harness 官方式原生 Bundle 集成

📦 Installation

# Build distribution package
npm pack

# Install to your profile
dsh plugin --profile web add ./dsh-web-search-pool-0.1.0-rc.7.tgz

Prerequisites

  • ✅ DeepSeek Harness 0.1.0-rc.7 or higher
  • 🔐 At least one search provider API key (Tavily / Exa)

⚙️ Configuration

After installation, configure via DSH Settings UI:

1. Open DeepSeek Harness → Settings → Plugins 2. Find "搜索 Key 池" card and expand it 3. Add your Tavily/Exa keys with: - Environment Variable Name (e.g., TAVILY_API_KEY_1) - Rate Limit (RPM): requests per minute - Remark: friendly name (optional) 4. Click Save - secrets are stored securely via credentials

> 🔐 All API keys are stored in DS H's credential system, never in plain-text configs.

🛠️ Usage

Once configured, the plugin automatically becomes your default web_search tool. No manual selection needed!

The provider will:

  • Select optimal key based on current quota and load
  • Switch providers (Tavily ↔ Exa) on failure
  • Respect rate limits and quotas across all keys
  • Return structured errors without exposing sensitive data

🧪 Testing

# Run test suite
npm run test

# Syntax check
node --check src/**/*.js scripts/*.mjs

# Pack integrity check
npm pack --dry-run

📄 Documentation

  • [Installation Guide](docs/挂载指南.md) - Quick setup for rc.7
  • [Upgrade & Rollback Guide](docs/升级与回滚指南.md) - Migrate from v0.2.x, troubleshooting
  • [Development History & Specs](docs/superpowers/) - Design decisions and specifications
  • [Architecture Overview](AI搜索Key池负载均衡 - 开发计划.md) - Technical architecture and trade-offs

🔧 Troubleshooting

IssueCauseSolution
No settings cardLegacy rc.6 slot registrationUpdate to use key: web-search-pool, restart DSH
Still using official searchBundle patch not loadedReinstall tarball, verify searchProvider: search-pool
Usage refresh failsInvalid credentials or quota exhaustedCheck credentials config, wait for quota recovery

See [Upgrade Guide](docs/升级与回滚指南.md#故障排查) for complete table.

🏗️ Architecture

See technical design docs:

  • [Bundle Contract Specification](docs/superpowers/specs/2026-08-18-native-bundle-rc7-design.md)
  • [Key Pool & Scheduler Logic](src/core/)
  • [RC7 Migration Report](v0.1.0-rc.7-升级实施计划.md)

🔐 Security

This plugin follows Zero Trust for credentials:

  • No hardcoded secrets or API keys
  • Keys only stored via DSH credentials service
  • Never logged or exposed in responses
  • Public anonymous mode available (Exa free tier)

📜 License

MIT License - see LICENSE file

🤝 Contributing

Issues and PRs welcome! Please follow existing patterns:

  • Core logic in src/core/ (DSH-independent)
  • Provider implementation in src/dsh/ (Host half)
  • Client UI in src/dsh/client.js (Web half)
  • Tests parallel production coverage (TDD)

See [Development Guidelines](docs/开发事故复盘与规范.md) for best practices.

---

Built for DeepSeek Harness community · Part of native ecosystem

Back to searchOpen GitHub repository

More related plugins

View category