dsh-web-search-qwen

English | 中文

dsh-web-search-qwen 是专为 DeepSeek Harness (dsh) 设计的开源联网搜索插件。

它将 DeepSeek Harness 的 web_search 搜索引擎切换至阿里云百炼 / 通义千问 Token Plan（DashScope）提供的内置联网搜索能力，让您的 Agent 在进行实时信息检索时直接消耗 Token Plan 积分，免去 DeepSeek 官方按量计费调用的额外费用。

---

✨ 核心特性

• 🚀 无缝原生接入：直接注册为 DSH 底层的 WebSearchProvider（ID: qwen-token-plan），完全兼容系统自带的 web_search 交互卡片与界面。
• 💰 省心省钱：直接使用您购买的 Qwen Token Plan 积分配额进行联网检索，避免触发 DeepSeek 官方独立的 Messages 搜索按量扣费。
• ⚡ 高速响应：默认采用 qwen3.6-flash 配合 enable_search: true，兼具极速检索与高质量结构化结果总结。
• 🔒 安全密钥管理：原生支持 DSH 凭据层（~/.dsh/.credentials.yaml）与环境变量（QWEN_TOKEN_PLAN_CN_API_KEY / DASHSCOPE_API_KEY）。

---

📦 安装与使用

方式一：通过 DSH 插件命令安装

在您的 DSH Profile 目录下直接安装：

dsh plugin add dsh-web-search-qwen

方式二：在 Profile 补丁中配置 (cordis.patch.yml)

打开您的配置文件（如 ~/.dsh/profiles/web/cordis.patch.yml），添加如下配置：

# 1. 禁用默认的 DeepSeek 官方按量计费搜索
- id: web-search-deepseek
  disabled: true

# 2. 注入 Qwen Token Plan 搜索插件
- insert:
    - id: web-search-qwen
      name: 'dsh-web-search-qwen'
      config:
        apiKeyEnv: QWEN_TOKEN_PLAN_CN_API_KEY
        model: qwen3.6-flash

---

⚙️ 配置参数 (Configuration)

参数	默认值	说明
apiKeyEnv	QWEN_TOKEN_PLAN_CN_API_KEY	用于解析 API Key 的环境变量或 DSH 凭据名
apiKey	(空)	可选。直接填写的 API Key（推荐使用 apiKeyEnv 保持安全性）
baseURL	https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1	Token Plan 的 OpenAI 兼容接口地址
model	qwen3.6-flash	用于进行搜索提取与总结的模型（可选 qwen3.7-plus, qwen3.7-max 等）
systemPrompt	(默认提示词)	自定义的检索提示词

---

🔑 凭据配置

确保在环境变量或 ~/.dsh/.credentials.yaml 中包含您的 Token Plan API Key：

QWEN_TOKEN_PLAN_CN_API_KEY: sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx

---

📄 开源许可证

本项目基于 MIT License 开源。