@anspire-ai/ai-search-dsh-plugin
Anspire AI Search 的 DeepSeek Harness (dsh) 插件。
为 agent 提供全网搜索能力：网页 / 图片 / 视频检索 + 垂域结构化数据（天气、股票、汇率、油价、万年历等），作为回答实时性问题的依据。## 安装
两种方式任选其一：
方式一：npm（推荐，版本即发布 tag）
dsh plugin --profile <name> add @anspire-ai/ai-search-dsh-plugin方式二：GitHub（固定 commit，获取未发布的改动）
dsh plugin --profile <name> add github:Anspire-AI/ai-search-dsh#develop
# 或固定到具体提交：github:Anspire-AI/ai-search-dsh#<sha>> 两种方式的插件功能完全一致；npm 方式随 v* tag 自动发布，GitHub 方式可吃到 develop 分支的最新改动。 > 本插件为纯 JavaScript（无构建步骤），GitHub 安装无需在 pnpm-workspace.yaml 中放行构建。
从旧包名升级（曾以 anspire-ai-search-dsh-plugin 无 scope 名义安装过）：先 dsh plugin --profile <name> remove anspire-ai-search-dsh-plugin 再按上述方式安装；已保存的配置（settings.yaml）不受影响。
配置
方式一：UI 插件设置页（推荐）
启动 dsh 后打开 Settings → Plugins → anspire-ai-search，直接在页面配置：
| 配置项 | 说明 |
|---|---|
region | 服务区域（下拉二选一）：ai-search-cn（国内，默认）/ ai-search-global（海外） |
apiKey | Anspire API KEY，密钥框输入、自动脱敏；区域下方提供「获取 anspire-ai-search api-key」链接，点击即可前往申请 |
timeoutMs | 请求超时（毫秒），默认 30000 |
defaultTopK | 默认返回条数，默认 10 |
服务区域：国内与海外为独立服务，API KEY 不通用。区域与申请入口的对应关系见插件设置页内的链接。
修改即时生效（live），无需重启 dsh。配置持久化在 dsh 的 settings.yaml，由 dsh 统一管理。
> 卡片在「插件配置」tab 中，与终端/agent 循环/网页搜索并列。展开卡片即可编辑，支持「已覆盖」标记与恢复默认。API KEY 为密钥框输入（不回显）。
方式二：环境变量（兜底/CI 场景）
export ANSPIRE_API_KEY="你的 key" # 申请入口见插件设置页链接兼容的环境变量名：ANSPIRE_API_KEY > ANPSIRE_API_KEY > DSP_ANSPIRE_KEY（按此顺序取第一个非空）。
优先级：UI 设置页 > 环境变量。
进阶：patch 行覆盖（部署级默认值）
默认配置（index.js schema 默认值）：
{
region: 'ai-search-cn', // 服务区域，决定请求端点
timeoutMs: 30_000,
defaultTopK: 10,
}在 profile 為 cordis.patch.yml 中覆盖（按 id 定位本插件插入的行；config 是整体替换，需重述全部键）：
# profile 的 cordis.patch.yml（~/.dsh/profiles/<name>/cordis.patch.yml）
- id: anspire-ai-search
config:
region: 'ai-search-global'
timeoutMs: 20000
defaultTopK: 20提供的工具
anspire_search
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | ✅ | 搜索词，≤64 字符 |
topK | number | 返回条数 10/20/30/40/50，默认 10 | |
insite | string | 限定站点，逗号分隔，最多 20 个 | |
fromTime | string | 起始时间 2025-01-01 00:00:00 | |
toTime | string | 结束时间 | |
searchType | string | web（默认）/ image / video | |
regionMode | number | 0 国内（默认）/ 1 海外 / 2 混合 |
输出为编号列表文本：标题 / 摘要 / 链接 / 日期 / 相关度。垂类词（如「北京天气」）自动返回结构化垂域数据。
开发
git clone git@github.com:Anspire-AI/ai-search-dsh.git
cd anspire-ai-search/code # develop 分支即 bundle 根
node --test 'test/*.test.js' # 运行测试（Node ≥18，零依赖）发布（npm）
打 tag 自动发布（CI：测试 → 版本同步自 tag → pack 冒烟 → OIDC 发布）：
git tag v0.5.0 && git push origin v0.5.0前置（一次性）：npm org @anspire-ai 的 Trusted Publisher 已配置指向本仓库的 publish-npm.yml。
bundle 结构说明
cordis.patch.yml用- insert: [...]块向 entry 列表追加插件行。不要写成裸- id:行——那是「覆盖已存在 entry」语义，目标不存在时整条 patch 会被 loader 静默跳过（patch: entry not found），插件不加载。index.js不导出Config。cordis loader 要求Config["~standard"].validate（Standard Schema 接口），普通对象会 TypeError。配置直接经 patch 行的config键流入apply(ctx, config)，未提供时用内置默认值。
License
MIT