> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AIsa Smart Search

> 融合网页与学术搜索，获得更广泛证据。

[在 GitHub 上查看 ->](https://github.com/AIsa-team/agent-skills/tree/main/smart-search)

**混合网页与学术搜索。** 当任务需要更广泛证据时，结合当前网页结果和学术来源。

## 安装

如果还没有安装 AIsa CLI，请先安装：

```bash theme={null}
npm install -g @aisa-one/cli
```

然后安装该技能：

```bash theme={null}
aisa skills install smart-search
```

## Agent 可以用它做什么？

<CardGroup cols={2}>
  <Card title="混合检索" icon="wand-magic-sparkles">
    同时搜索网页和学术来源。
  </Card>

  <Card title="更广覆盖" icon="layer-group">
    减少单一来源搜索带来的盲区。
  </Card>

  <Card title="研究摘要" icon="file-lines">
    跨来源类型总结发现。
  </Card>

  <Card title="证据比较" icon="scale-balanced">
    比较当前来源与学术证据。
  </Card>
</CardGroup>

## 设置

该技能需要 `AISA_API_KEY` 环境变量。作为 Claude 插件安装时，key 会通过插件的 `userConfig` 配置。

## 用法

用 `smart` 子命令运行搜索客户端：

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "<search query>" --count <max_results>
```

### 参数

| Argument         | Required | Default | Description  |
| ---------------- | -------- | ------- | ------------ |
| `--query` / `-q` | Yes      | —       | 搜索查询         |
| `--count` / `-c` | No       | 10      | 最大结果数（1–100） |

### 示例

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "impact of large language models on software engineering" --count 10
```

## 输出

脚本会打印来自网页和学术来源的混合结果集，包括标题、URL 和内容片段。

## 何时使用

当用户查询同时涉及通用知识和学术研究时使用该技能。例如新兴技术、具有实际应用的科学主题，或任何同时需要网页文章和论文的查询。

## 开始使用

1. 在 [aisa.one](https://aisa.one) 注册（新账户有 \$2 免费额度）。
2. 从控制台生成 API key。
3. 设置 key 并安装技能：
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install smart-search
   ```
4. 启动新的 Agent 会话，让运行时加载更新后的技能说明。

## 相关

<CardGroup cols={3}>
  <Card title="AIsa Scholar Search" icon="graduation-cap" href="/agent-skills/scholar-search">
    学术论文和学术来源搜索。
  </Card>

  <Card title="AIsa Web Search" icon="globe" href="/zh/agent-skills/web-search">
    当前网页来源搜索。
  </Card>

  <Card title="多源搜索" icon="magnifying-glass" href="/agent-skills/search">
    更广泛的搜索和答案工作流。
  </Card>
</CardGroup>