Anspire-AI/ai-search-dsh

@anspire-ai/ai-search-dsh-plugin

Anspire AI Search 的 DeepSeek Harness (dsh) 插件。

为 agent 提供全网搜索能力：网页 / 图片 / 视频检索 + 垂域结构化数据（天气、股票、汇率、油价、万年历等），作为回答实时性问题的依据。## 安装

两种方式任选其一：

方式一：npm（推荐，版本即发布 tag）

dsh plugin --profile  add @anspire-ai/ai-search-dsh-plugin

方式二：GitHub（固定 commit，获取未发布的改动）

dsh plugin --profile  add github:Anspire-AI/ai-search-dsh#develop
或固定到具体提交：github:Anspire-AI/ai-search-dsh#

两种方式的插件功能完全一致；npm 方式随 v tag 自动发布，GitHub 方式可吃到 develop 分支的最新改动。
本插件为纯 JavaScript（无构建步骤），GitHub 安装无需在 pnpm-workspace.yaml 中放行构建。

从旧包名升级（曾以 anspire-ai-search-dsh-plugin 无 scope 名义安装过）：先 dsh plugin --profile  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//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)，未提供时用内置默认值。

许可证

MIT