import live www.sillylaird.ca webrootHEADmain

1 files changed, 385 insertions, 0 deletions

diff --git a/.agents/skills/citation-verification/references/common-errors.md b/.agents/skills/citation-verification/references/common-errors.md
new file mode 100644
index 0000000..911bb8a
--- /dev/null
+++ b/.agents/skills/citation-verification/references/common-errors.md
@@ -0,0 +1,385 @@
+# 常见引用错误模式
+
+本文档总结常见的引用错误类型、识别方法和修复建议。
+
+## 错误分类
+
+### 1. 格式错误 (Format Errors)
+
+#### 1.1 缺少必填字段
+
+**错误示例:**
+```bibtex
+@article{smith2020,
+  title={Deep Learning for NLP},
+  year={2020}
+}
+```
+
+**问题:** 缺少 `author` 和 `journal` 字段
+
+**修复:**
+```bibtex
+@article{smith2020,
+  author={Smith, John and Doe, Jane},
+  title={Deep Learning for NLP},
+  journal={Nature},
+  year={2020}
+}
+```
+
+#### 1.2 年份格式错误
+
+**错误示例:**
+```bibtex
+year={20}          # 年份不完整
+year={2020-2021}   # 年份范围格式错误
+year={circa 2020}  # 包含非数字字符
+```
+
+**修复:**
+```bibtex
+year={2020}        # 使用四位数年份
+```
+
+#### 1.3 DOI 格式错误
+
+**错误示例:**
+```bibtex
+doi={doi:10.1038/nature12345}     # 包含 "doi:" 前缀
+doi={https://doi.org/10.1038/...} # 包含完整 URL
+doi={10.1038/nature12345.}        # 末尾有句号
+```
+
+**修复:**
+```bibtex
+doi={10.1038/nature12345}         # 只保留 DOI 本身
+```
+
+#### 1.4 作者名格式不一致
+
+**错误示例:**
+```bibtex
+author={John Smith and Jane Doe and Bob}  # 格式不一致
+author={Smith, J. and Doe, Jane}          # 格式混用
+```
+
+**修复:**
+```bibtex
+author={Smith, John and Doe, Jane and Brown, Bob}  # 统一格式
+# 或
+author={Smith, J. and Doe, J. and Brown, B.}       # 统一缩写
+```
+
+### 2. 信息错误 (Information Errors)
+
+#### 2.1 作者名拼写错误
+
+**错误示例:**
+```bibtex
+author={Vaswani, Ashish}  # 正确
+author={Vaswani, Asish}   # 拼写错误
+```
+
+**识别方法:**
+- API 验证时作者匹配度低
+- 通过 Google Scholar 搜索确认正确拼写
+
+**修复建议:**
+- 从可靠来源(Google Scholar, Semantic Scholar)获取 BibTeX
+- 仔细核对作者名拼写
+
+#### 2.2 标题错误
+
+**错误示例:**
+```bibtex
+title={Attention is All You Need}           # 正确
+title={Attention Is All You Need}           # 大小写错误
+title={Attention is all you need}           # 大小写错误
+title={Attention Mechanism for Transformers} # 标题完全错误
+```
+
+**识别方法:**
+- 标题匹配度低于阈值
+- API 返回的标题与 BibTeX 中的标题不一致
+
+**修复建议:**
+- 从原始论文或 DOI 获取准确标题
+- 保持原始大小写格式
+
+#### 2.3 年份错误
+
+**常见情况:**
+- 使用预印本年份而非正式发表年份
+- 使用会议年份而非论文集出版年份
+
+**错误示例:**
+```bibtex
+# 论文在 2017 年 arXiv 发布,2018 年 NIPS 正式发表
+year={2017}  # 使用了预印本年份
+year={2018}  # 正确:使用正式发表年份
+```
+
+**修复建议:**
+- 优先使用正式发表年份
+- 如果引用预印本,在 note 字段说明
+
+#### 2.4 期刊/会议名称错误
+
+**错误示例:**
+```bibtex
+booktitle={NeurIPS}                    # 缩写
+booktitle={Neural Information Processing Systems}  # 完整名称
+booktitle={Advances in Neural Information Processing Systems}  # 正确的完整名称
+```
+
+**修复建议:**
+- 使用官方全称或标准缩写
+- 保持整个文献列表的命名一致性
+
+### 3. 虚假引用 (Fake Citations)
+
+#### 3.1 完全虚构的论文
+
+**特征:**
+- 论文不存在于任何数据库
+- API 验证全部失败
+- 无法通过 Google Scholar 找到
+
+**识别方法:**
+```python
+# 所有 API 都返回 not_found
+if not crossref_found and not arxiv_found and not semantic_scholar_found:
+    return "可能是虚假引用"
+```
+
+**修复建议:**
+- 删除虚假引用
+- 如果确实需要引用,寻找真实的相关论文
+
+#### 3.2 信息严重错误的引用
+
+**特征:**
+- 论文存在,但信息完全不匹配
+- 作者、标题、年份都不对
+- 可能是复制粘贴错误
+
+**错误示例:**
+```bibtex
+@article{smith2020deep,
+  author={Smith, John},
+  title={Deep Learning for NLP},
+  journal={Nature},
+  year={2020}
+}
+```
+
+**实际论文:**
+- 作者: Brown, Tom et al.
+- 标题: Language Models are Few-Shot Learners
+- 期刊: NeurIPS
+- 年份: 2020
+
+**修复建议:**
+- 重新搜索正确的论文
+- 从可靠来源获取正确的 BibTeX
+
+#### 3.3 引用不存在的版本
+
+**错误示例:**
+```bibtex
+# 引用了不存在的期刊版本
+@article{vaswani2017attention,
+  author={Vaswani, Ashish and others},
+  title={Attention is All You Need},
+  journal={Nature Machine Intelligence},  # 错误:这篇论文没有期刊版本
+  year={2017}
+}
+```
+
+**正确引用:**
+```bibtex
+@inproceedings{vaswani2017attention,
+  author={Vaswani, Ashish and others},
+  title={Attention is All You Need},
+  booktitle={Advances in Neural Information Processing Systems},
+  year={2017}
+}
+```
+
+### 4. 一致性错误 (Consistency Errors)
+
+#### 4.1 LaTeX 引用与 BibTeX 不一致
+
+**错误示例:**
+
+LaTeX 文件中:
+```latex
+\cite{smith2020deep}
+```
+
+BibTeX 文件中:
+```bibtex
+@article{smith2020deeplearning,  # Key 不匹配
+  author={Smith, John},
+  title={Deep Learning for NLP},
+  year={2020}
+}
+```
+
+**识别方法:**
+```python
+def check_citation_consistency(tex_keys, bib_keys):
+    """检查引用一致性"""
+    tex_set = set(tex_keys)
+    bib_set = set(bib_keys)
+
+    # 未定义的引用
+    undefined = tex_set - bib_set
+
+    # 未使用的引用
+    unused = bib_set - tex_set
+
+    return {
+        'undefined': list(undefined),
+        'unused': list(unused)
+    }
+```
+
+**修复建议:**
+- 确保 LaTeX 中的 citation key 与 BibTeX 中的 ID 完全一致
+- 删除未使用的 BibTeX 条目
+- 补充缺失的 BibTeX 条目
+
+#### 4.2 引用格式不统一
+
+**错误示例:**
+```bibtex
+# 同一文献列表中格式混乱
+@article{paper1,
+  author={Smith, John and Doe, Jane},  # 全名
+  ...
+}
+
+@article{paper2,
+  author={Brown, T. and Lee, S.},      # 缩写
+  ...
+}
+
+@article{paper3,
+  author={John Wilson and Mary Johnson},  # First Last 格式
+  ...
+}
+```
+
+**修复建议:**
+- 统一作者名格式(全名或缩写)
+- 统一期刊/会议名称格式(全称或标准缩写)
+- 统一页码格式(1-10 或 1--10)
+
+#### 4.3 重复引用
+
+**错误示例:**
+```bibtex
+@article{vaswani2017,
+  author={Vaswani, Ashish and others},
+  title={Attention is All You Need},
+  booktitle={NeurIPS},
+  year={2017}
+}
+
+@inproceedings{vaswani2017attention,
+  author={Vaswani, A. and others},
+  title={Attention is All You Need},
+  booktitle={Advances in Neural Information Processing Systems},
+  year={2017}
+}
+```
+
+**问题:** 同一篇论文被引用两次,使用不同的 citation key
+
+**识别方法:**
+- 标题高度相似(相似度 > 0.9)
+- 作者重叠度高
+- 年份相同
+
+**修复建议:**
+- 保留更完整准确的条目
+- 删除重复条目
+- 更新 LaTeX 文件中的引用
+
+## 错误预防最佳实践
+
+### 1. 使用可靠来源
+
+✅ **推荐来源:**
+- Google Scholar - 获取 BibTeX
+- Semantic Scholar - 验证论文信息
+- 官方出版商网站 - 获取准确元数据
+- DOI 系统 - 最可靠的标识符
+
+❌ **避免:**
+- 手动输入 BibTeX
+- 从不可靠网站复制
+- 使用过时的引用管理工具
+
+### 2. 及时验证
+
+**验证时机:**
+- 添加引用后立即验证
+- 完成初稿后全面验证
+- 提交前最终验证
+
+**验证内容:**
+- 格式完整性
+- 信息准确性
+- 引用一致性
+
+### 3. 保持一致性
+
+**统一标准:**
+- 作者名格式统一(全名或缩写)
+- 期刊/会议名称统一(全称或标准缩写)
+- 页码格式统一
+- 大小写规则统一
+
+### 4. 使用工具辅助
+
+**推荐工具:**
+- BibTeX 格式检查器
+- LaTeX 编译器(检测未定义引用)
+- Citation verification scripts
+- 引用管理软件(Zotero, Mendeley)
+
+## 常见错误总结
+
+| 错误类型 | 严重程度 | 检测难度 | 修复难度 |
+|---------|---------|---------|---------|
+| 缺少必填字段 | 高 | 低 | 低 |
+| 年份格式错误 | 中 | 低 | 低 |
+| DOI 格式错误 | 中 | 低 | 低 |
+| 作者名拼写错误 | 高 | 中 | 中 |
+| 标题错误 | 高 | 中 | 中 |
+| 完全虚构论文 | 极高 | 高 | 高 |
+| 信息严重错误 | 极高 | 中 | 高 |
+| LaTeX-BibTeX 不一致 | 高 | 低 | 低 |
+| 格式不统一 | 低 | 低 | 中 |
+| 重复引用 | 中 | 中 | 中 |
+
+## 快速检查清单
+
+提交论文前,确保完成以下检查:
+
+- [ ] 所有 BibTeX 条目包含必填字段
+- [ ] 年份格式正确(四位数字)
+- [ ] DOI 格式正确(无前缀,无 URL)
+- [ ] 作者名格式统一
+- [ ] 标题大小写正确
+- [ ] 所有引用通过 API 验证
+- [ ] LaTeX 引用与 BibTeX 一致
+- [ ] 无重复引用
+- [ ] 格式统一(作者名、期刊名、页码)
+- [ ] 无虚假或严重错误的引用
+
+遵循这些最佳实践可以有效避免常见的引用错误,提高论文质量和可信度。
+