# Felo Search Provider（本 fork 新增）

这是 `pi-web-access` 的私有 fork，唯一的改动是新增了一个 `felo` 搜索 provider，对接公司自建的 CloudsWay 搜索服务。完整方案见同目录下的 `DESIGN.md`。

## 改动清单

- 新建 `felo-search.ts`：实现 `isFeloSearchAvailable()` / `searchWithFeloSearch()`
- `gemini-search.ts`：`RESOLVED_SEARCH_PROVIDERS` 加入 `"felo"`，并在 dispatch / availability / `providerLabel()` 三处注册
- `index.ts`：`ProviderAvailability` 类型和 `getProviderAvailability()` 加入 `felo` 字段（供 curator 交互式 UI 识别可用性）
- 未改动官方的 auto 回退优先级链——`felo` 只有在显式指定 `provider` 时才会被使用

## 必需的环境变量

| 环境变量 | 说明 | 是否必填 |
|---|---|---|
| `CLOUDS_WAY_SEARCH_ENDPOINT` | 完整 URL，必须带 `/search/` 前缀，例如 `https://searchapi.cloudsway.net/search/<workspace-token>/smart` | 是 |
| `CLOUDS_WAY_SEARCH_KEY` | Bearer token | 是 |
| `CLOUDS_WAY_SEARCH_TIMEOUT_MS` | 请求超时（毫秒），未设置或非法值时默认 `30000` | 否 |

三者都只走环境变量，不支持写入 `~/.pi/web-search.json`（设计上的取舍，见 `DESIGN.md` 第 6.3 节）。

## 安装/启用步骤

见对话中的安装说明，或参照 `DESIGN.md` 第 12 节「实施步骤」。