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
6.3 KiB
6.3 KiB
created, title, tags, category
| created | title | tags | category | ||
|---|---|---|---|---|---|
| 2026-04-14 | 文献库使用指南 |
|
文献库 |
文献库使用指南
版本: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:
$env:PYTHONIOENCODING="utf-8" cd "d:\TC_UP\2023card\projects\openclaw\教育AI研究\文献库\tools"
查看统计摘要
python 文献库管理器.py --stats --db "../文献索引数据库.json"
输出示例:
========================================================
📚 教育AI研究文献库 — 统计摘要
========================================================
总文献数: 14
高可靠来源: 8 (57%)
待验证: 6
有效DOI: 7
高质量(≥85): 7
技术分类:
LLM 6 篇
自适应学习系统 3 篇
...
📋 常用命令
搜索文献
# 搜索关键词(标题/摘要/标签/备注全文匹配)
python 文献库管理器.py --search LLM --db "../文献索引数据库.json"
python 文献库管理器.py --search "自适应" --db "../文献索引数据库.json"
python 文献库管理器.py --search 哈佛 --db "../文献索引数据库.json"
# 显示详细信息
python 文献库管理器.py --search RCT --verbose --db "../文献索引数据库.json"
列出文献
# 列出全部
python 文献库管理器.py --list all --db "../文献索引数据库.json"
# 仅列出高可靠来源
python 文献库管理器.py --list verified --db "../文献索引数据库.json"
# 列出待验证文献
python 文献库管理器.py --list unverified --db "../文献索引数据库.json"
# 按年份筛选
python 文献库管理器.py --list 2025 --db "../文献索引数据库.json"
查看单条文献详情
python 文献库管理器.py --show 11 --db "../文献索引数据库.json"
验证DOI状态
python 文献库管理器.py --verify --db "../文献索引数据库.json"
状态说明:
- ✅
DOI格式有效— DOI格式正确,但仍需实际访问确认 - ⚠️
DOI不完整(含XXX占位)— 需补全实际期号 - ❌
无DOI— 政策文件/经典书籍等无DOI的文献
📤 导出引用列表
导出APA格式
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自动添加(推荐)
python 文献库管理器.py --add-doi "10.1038/s41598-025-00536-y" --db "../文献索引数据库.json"
自动从Crossref/DataCite获取元数据,填充标题、作者、期刊、年份等字段。
方式2:手动编辑JSON
直接编辑 文献索引数据库.json,在 entries 数组末尾添加新条目:
{
"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解析工具独立使用
# 解析单个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:谨慎引用
🛠️ 维护建议
- 每次引用新文献后立即添加到数据库
- 每月末检查并补全含
XXX占位的DOI - 季度更新
citation_count字段 - 与项目真实性核查联动:待验证文献在引用前必须核实