# Ai4Scholar Fulltext · 全文搜索

**从论文原文中，找到证据。** 面向 DeepSeek Harness 的全文片段检索插件，提供交互式 HTML 阅读工作台和离线 HTML / CSV 报告。

[English](README.md) · [AI4Scholar](https://ai4scholar.net/?src=dsh_fulltext)

## 安装

在 Harness 的「插件」页安装 `dsh-fulltext`，然后重启。命令行也可以执行：

```sh
dsh plugin add dsh-fulltext
```

原生页面和已认证的报告访问通道已在 Harness `0.2.2-rc.1` 验证；请使用支持这些能力的新版 Harness。当前工作台界面为中文。

## 设置密钥

以下三个入口共用同一份设置：

- **侧栏「全文搜索」→「设置」**。
- **插件 → 已安装 → dsh-fulltext**。
- **设置 → 全文搜索**。

可以独立保存 AI4Scholar API Key，也可以自动沿用已有 `AI4SCHOLAR_API_KEY`，不要求安装综合版插件。独立凭据 `FULLTEXT_API_KEY` 优先，移除后恢复使用已有 Key。设置页只修改独立 Key，不修改共享的 Ai4Scholar Key。密钥保存在 Harness 原生凭据服务中；同名环境变量也可使用。

在 [ai4scholar.net](https://ai4scholar.net/?src=dsh_fulltext) 获取 Key。

## 使用

打开侧栏「全文搜索」直接检索，或者在对话中发送：

```text
/fulltext 查找固态电池界面阻抗的实验方法，返回5个片段，整理主要发现，生成HTML和CSV报告
```

- 在 Semantic Scholar 已索引的标题、摘要和正文片段中查找方法、参数与论述，支持年份、学科、期刊和最低引用数条件。
- 可选信息补全会去重同篇论文的 ID，批量查询年份、期刊和可用的开放 PDF 链接。
- 同一份交互 HTML 可以在工作台、原生产物预览、独立窗口和离线文件中阅读；保留原文、来源类型、章节、片段详情、复制、筛选、排序和六种阅读主题。
- 「AI 整理」把已有报告的整理请求放入对话草稿，模型可补充有片段编号的总结和中文标题，原文与来源信息保留。不会自动发送或覆盖草稿。

覆盖范围以索引为准，结果可能来自标题、摘要或正文。这是片段检索；PDF 链接是单独的来源，不代表已经下载完整论文。

## 文件与费用

每次搜索保存 `report.html`、`report.csv` 和 `report.json`，目录为 `$DSH_HOME/fulltext/reports/<report-id>/`，默认位于 `~/.dsh/fulltext/reports/`。工作台显示最新 100 份报告；侧边栏可在确认后删除报告及这三个本地文件。HTML 的样式和脚本内嵌，无远程资源依赖；CSV 使用 UTF-8 BOM，并对可能被表格软件当作公式的文本做保护。

搜索和可选的信息补全由 AI4Scholar 接口计费，报告保留实际返回的扣费。关闭「补全」可只发出检索请求。重新打开、报告内筛选、更新和导出不会新增检索费用。模型总结、翻译的用量另计。

| 工具 | 用途 |
| --- | --- |
| `search_fulltext` | 检索并保存 HTML / CSV / JSON |
| `get_fulltext_report` | 读取已有报告，不重复检索 |
| `update_fulltext_report` | 补充总结 / 标题翻译并更新原文件 |

## 高级配置

```yaml
- id: fulltext
  config:
    defaultLimit: 10
    apiKeyEnv: FULLTEXT_API_KEY
```

另支持 `baseUrl`、`requestTimeoutMs` 和 `reportDirectory`。密钥放在凭据服务或环境变量中，不写入配置文件。预览和下载走宿主已认证、仅所有者可用的通道，HTML 在沙箱中运行。

## 开发与来源

```sh
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm pack --pack-destination /tmp
```

发布检查覆盖 Node 22 / 24 及当前发布的 Harness 页面契约。真实接口验证覆盖标题、摘要、正文片段、信息补全与扣费；模拟模型验证覆盖报告整理和原生产物交付。版本规则见 [RELEASING.md](RELEASING.md)。

报告设计来自 Ai4Scholar 原 `ai4s-fulltext` skill，保留阅读设计并补充离线资源、文本转义、字面关键词高亮和 CSV 单元格保护。MIT 许可证。
