maestro-flow 0.5.36 → 0.5.38

package/.agy/skills/scholar-citation-verify/references/common-errors.md

@@ -1,384 +1,384 @@
-# 常见引用错误模式
-
-本文档总结常见的引用错误类型、识别方法和修复建议。
-
-## 错误分类
-
-### 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 一致
-- [ ] 无重复引用
-- [ ] 格式统一(作者名、期刊名、页码)
-- [ ] 无虚假或严重错误的引用
-
-遵循这些最佳实践可以有效避免常见的引用错误,提高论文质量和可信度。
+# 常见引用错误模式
+
+本文档总结常见的引用错误类型、识别方法和修复建议。
+
+## 错误分类
+
+### 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 一致
+- [ ] 无重复引用
+- [ ] 格式统一(作者名、期刊名、页码)
+- [ ] 无虚假或严重错误的引用
+
+遵循这些最佳实践可以有效避免常见的引用错误,提高论文质量和可信度。