Phase 0-2: Schema cleanup, typed relations, event-driven automation
- 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
This commit is contained in:
hehaiguang1123
@@ -0,0 +1,251 @@
|
||||
---
|
||||
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. **与项目真实性核查**联动：待验证文献在引用前必须核实
|
||||
Reference in New Issue
Block a user