# CiteChecker

**Repository Path**: Zen07/cite-checker

## Basic Information

- **Project Name**: CiteChecker
- **Description**: 一个专注于学术引用验证的开源工具，帮助研究者和作者快速准确地检查文献引用，提升科研工作的效率和质量。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/Zen07/cite-checker
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-02
- **Last Updated**: 2025-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: zen个人项目

## README

# FakeCitationDetector - 虚假引用检测工具

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
[![Gitee Release](https://gitee.com/Zen07/cite-checker/badge/star.svg?theme=dark)](https://gitee.com/your-username/FakeCitationDetector)

🔍 基于本地大模型（Ollama）的智能虚假引用检测工具，帮助学者和研究人员识别可疑的学术引用。

[English](README_EN.md) | 中文

## ✨ 特性

- 🤖 **AI驱动检测**: 基于Ollama本地大模型的智能分析
- 📚 **多格式支持**: 支持APA、MLA、Chicago、IEEE等主流引用格式
- 🔧 **灵活配置**: 可自定义检测阈值和模型参数
- 📊 **详细报告**: 生成包含可信度评分和详细分析的报告
- 🚀 **批量处理**: 支持大规模文件批量检测
- 🌐 **多语言**: 支持中英文引用检测
- 📈 **可视化**: 提供检测结果的图表展示
- 🔒 **隐私保护**: 完全本地化处理，保护数据隐私

## 🚀 快速开始

### 安装

```bash
# 克隆仓库
git clone https://gitee.com/your-username/FakeCitationDetector.git
cd FakeCitationDetector

# 安装依赖
pip install -r requirements.txt

# 或使用安装脚本
chmod +x scripts/install.sh
./scripts/install.sh
```

### 设置Ollama

```bash
# 安装Ollama (如果未安装)
curl -fsSL https://ollama.ai/install.sh | sh

# 启动Ollama服务
ollama serve

# 下载推荐模型
ollama pull llama2
```

### 基本使用

```python
from fake_citation_detector import FakeCitationDetector, OllamaClient

# 初始化检测器
client = OllamaClient()
detector = FakeCitationDetector(client)

# 检测单个引用
citation = "Smith, J. (2023). AI in Healthcare. Nature Medicine, 29, 123-130."
result = detector.detect(citation)

print(f"可信度评分: {result.credibility_score:.2f}")
print(f"是否可疑: {result.is_suspicious}")
```

### 命令行使用

```bash
# 检测单个引用
python -m fake_citation_detector.cli -c "Your citation here"

# 批量检测文件
python -m fake_citation_detector.cli -i citations.txt -o report.html

# 交互模式
python -m fake_citation_detector.cli --interactive
```

## 📖 文档

- [安装指南](docs/installation.md)
- [使用说明](docs/usage.md)
- [API文档](docs/api.md)
- [示例代码](docs/examples.md)

## 🔧 配置

项目支持多种配置选项：

```python
# config.py
DETECTION_CONFIG = {
    "ollama_url": "http://localhost:11434",
    "model_name": "llama2",
    "fake_threshold": 0.4,
    "suspicious_threshold": 0.6,
    "batch_size": 10
}
```

## 📊 支持的引用格式

- **APA**: Author, A. A. (Year). Title of work. *Journal Name*, Volume(Issue), pages.
- **MLA**: Author, First. "Title." *Journal Name*, vol. #, no. #, Year, pp. ##-##.
- **Chicago**: Author, First. "Title." *Journal Name* Volume, no. Issue (Year): pages.
- **IEEE**: F. Author, "Title," *Journal Name*, vol. #, no. #, pp. ##-##, Year.

## 🎯 检测维度

- ✅ 作者姓名合理性检查
- ✅ 期刊名称真实性验证
- ✅ 发表年份合理性分析
- ✅ 标题学术性评估
- ✅ 引用格式规范性检查
- ✅ DOI有效性验证
- ✅ 内容逻辑一致性分析

## 🌟 示例

更多示例请查看 [examples/](examples/) 目录：

- [基本用法示例](examples/basic_usage.py)
- [批量处理示例](examples/batch_processing.py)
- [Web界面示例](examples/web_interface.py)

## 🤝 贡献

欢迎贡献代码！请查看 [贡献指南](CONTRIBUTING.md) 了解详情。

### 开发设置

```bash
# 克隆开发分支
git clone -b develop https://gitee.com/your-username/FakeCitationDetector.git

# 安装开发依赖
pip install -r requirements-dev.txt

# 运行测试
python -m pytest tests/
```

## 📄 许可证

本项目基于 [MIT License](LICENSE) 开源。

## 🙏 致谢

- [Ollama](https://ollama.ai/) - 本地大模型运行时
- [Python](https://python.org/) - 编程语言
- 所有贡献者和用户

## 📞 联系

- 项目主页: https://gitee.com/your-username/FakeCitationDetector
- 问题反馈: https://gitee.com/your-username/FakeCitationDetector/issues
- 邮箱: your-email@example.com

## ⭐ 如果这个项目对你有帮助，请给个Star！

---

**免责声明**: 本工具仅供辅助参考，最终的引用真实性判断仍需人工核实。