---
created: 2026-04-14
title: 文献库使用指南
tags: [文献, 论文]
category: 文献库
---

# 文献库使用指南

> **版本**：v1.1 | **创建**：2026-04-04 | **更新**：2026-04-05
> **维护者**：狗剩

---

## 📂 文件结构

```
文献库/
├── 文献索引数据库.json        # 主数据库（JSON格式，14条文献）
├── tools/
│   ├── 文献库管理器.py        # 主管理工具（CLI）
│   └── doi_resolver.py       # DOI解析工具（Crossref/DataCite API）
└── 使用指南.md               # 本文档
```

---

## 🚀 快速上手

> **运行前提**：需进入 `tools/` 目录，并使用 `--db` 参数指定数据库路径。
>
> **Windows PowerShell**：
> ```powershell
> $env:PYTHONIOENCODING="utf-8"
> cd "d:\TC_UP\2023card\projects\openclaw\教育AI研究\文献库\tools"
> ```

### 查看统计摘要

```bash
python 文献库管理器.py --stats --db "../文献索引数据库.json"
```

**输出示例**：

```
========================================================
  📚 教育AI研究文献库 — 统计摘要
========================================================
  总文献数：      14
  高可靠来源：    8  (57%)
  待验证：        6
  有效DOI：       7
  高质量(≥85)：   7

  技术分类：
    LLM                  6 篇
    自适应学习系统        3 篇
    ...
```

---

## 📋 常用命令

### 搜索文献

```bash
# 搜索关键词（标题/摘要/标签/备注全文匹配）
python 文献库管理器.py --search LLM --db "../文献索引数据库.json"
python 文献库管理器.py --search "自适应" --db "../文献索引数据库.json"
python 文献库管理器.py --search 哈佛 --db "../文献索引数据库.json"

# 显示详细信息
python 文献库管理器.py --search RCT --verbose --db "../文献索引数据库.json"
```

### 列出文献

```bash
# 列出全部
python 文献库管理器.py --list all --db "../文献索引数据库.json"

# 仅列出高可靠来源
python 文献库管理器.py --list verified --db "../文献索引数据库.json"

# 列出待验证文献
python 文献库管理器.py --list unverified --db "../文献索引数据库.json"

# 按年份筛选
python 文献库管理器.py --list 2025 --db "../文献索引数据库.json"
```

### 查看单条文献详情

```bash
python 文献库管理器.py --show 11 --db "../文献索引数据库.json"
```

### 验证DOI状态

```bash
python 文献库管理器.py --verify --db "../文献索引数据库.json"
```

**状态说明**：

- ✅ `DOI格式有效` — DOI格式正确，但仍需实际访问确认
- ⚠️ `DOI不完整（含XXX占位）` — 需补全实际期号
- ❌ `无DOI` — 政策文件/经典书籍等无DOI的文献

---

## 📤 导出引用列表

### 导出APA格式

```bash
python 文献库管理器.py --export apa --db "../文献索引数据库.json"

# 导出到文件
python 文献库管理器.py --export apa --output "../../outputs/参考文献-APA.md" --db "../文献索引数据库.json"

# 仅导出高可靠文献
python 文献库管理器.py --export apa --export-verified --db "../文献索引数据库.json"
```

### 支持的格式

| 参数 | 格式 | 说明 |
|------|------|------|
| `apa` | APA 7th | 国际学术通用格式 |
| `mla` | MLA 9th | 人文学科常用 |
| `chicago` | Chicago 17th | 历史/社科常用 |
| `gb` | GB/T 7714-2015 | 中国国家标准，投稿中文期刊时使用 |

---

## ➕ 添加新文献

### 方式1：通过DOI自动添加（推荐）

```bash
python 文献库管理器.py --add-doi "10.1038/s41598-025-00536-y" --db "../文献索引数据库.json"
```

自动从Crossref/DataCite获取元数据，填充标题、作者、期刊、年份等字段。

### 方式2：手动编辑JSON

直接编辑 `文献索引数据库.json`，在 `entries` 数组末尾添加新条目：

```json
{
  "entry_id": 15,
  "doi": "10.xxxx/xxxxx",
  "title": "文献标题",
  "authors": ["Last, First"],
  "journal": "期刊名称",
  "year": 2025,
  "keywords": ["关键词1", "关键词2"],
  "url": "https://doi.org/10.xxxx/xxxxx",
  "research_type": "系统综述",
  "education_level": "高等教育",
  "ai_technology": "LLM",
  "quality_score": 82,
  "reliability": "高",
  "added_date": "2026-04-05",
  "added_by": "狗剩",
  "notes": "备注信息",
  "tags": ["标签1"],
  "related_entries": []
}
```

添加后更新 `metadata.total_entries` 和 `metadata.last_entry_id`。

---

## 📊 文献库当前状态（2026-04-05）

| 指标 | 数值 |
|------|------|
| 总文献数 | 14 |
| 高可靠来源 | 8（57%） |
| 待验证 | 6 |
| 有效DOI | 7 |
| 高质量（≥85分） | 7 |
| 经典文献 | 2（Bloom 1984、Koedinger） |

### 待补全的DOI

| ID | 文献 | 问题 |
|----|------|------|
| 2 | Large language models in education… | `104XXX` 需替换 |
| 9 | Artificial intelligence-enabled adaptive… | `104XXX` 需替换 |
| 10 | Adaptive AI Agent Systems… | `ACCESS.2025.XXXXX` 需替换 |
| 11 | AI tutoring outperforms active learning… | `s41599-025-XXXXX` 需替换（哈佛RCT关键文献） |

---

## 🔍 DOI解析工具独立使用

```bash
# 解析单个DOI，生成APA引用
python doi_resolver.py "10.1038/s41598-025-00536-y" apa

# 批量解析（从文本文件读取DOI列表）
python doi_resolver.py --batch doi_list.txt
```

`doi_list.txt` 格式：每行一个DOI：

```
10.1038/s41598-025-00536-y
10.3389/frai.2025.1622292
10.48550/arXiv.2503.11733
```

---

## 🏷️ 字段规范说明

### `reliability`（可靠性）

| 值 | 含义 |
|----|------|
| `高` | 官方发布/已发表同行评审期刊/可验证DOI |
| `待验证` | DOI含占位符/引用待确认/数据需核实 |
| `中` | 预印本/行业报告（可信但非同行评审） |
| `低` | 媒体报道/二手引用 |

### `research_type`（研究类型）

`RCT随机对照实验` / `系统综述` / `元分析` / `纵向研究` / `实验研究` / `政策文件` / `行业报告`

### `quality_score`（质量评分，0-100）

- 90-100：顶级期刊，方法严谨，高引
- 80-89：主流期刊，合格来源
- 70-79：可参考，需注意局限
- <70：谨慎引用

---

## 🛠️ 维护建议

1. **每次引用新文献后**立即添加到数据库
2. **每月末**检查并补全含 `XXX` 占位的DOI
3. **季度**更新 `citation_count` 字段
4. **与项目真实性核查**联动：待验证文献在引用前必须核实