hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
252 lines
6.3 KiB
Markdown
252 lines
6.3 KiB
Markdown
---
|
||
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. **与项目真实性核查**联动：待验证文献在引用前必须核实
|