Ayi914 / paperchecker

# 本地论文查阅修改助手
**简体中文** | English
鉴于OpenAI被爆出据说剽窃数学家的成果当作自己的成果发布，于是我紧急编写了这个demo，一个面向Linux的轻量论文辅助CLI Agent。输入问题后，模型可以调用本地工具和论文检索；
默认模型为 Qwen3-14B-AWQ，权重约 9.4 GB。Agent 输入预算默认为 4096 token；模型最大输出由 `.env` 的 `LOCAL_AGENT_MAX_TOKENS` 控制，`.env.example` 中默认是 2048 token。
输入预算和系统 prompt 可以在 `config/agent.yaml` 中修改，因此用途不局限于论文助手。该文件中的 `tool_output_max_chars: 4000` 是工具结果的字符截断上限，不是模型答案的 token 上限。调整参数时需要考虑显存容量。
支持 MCP 协议，可通过工具注册机制接入 MCP 服务。
面向显卡多的没事干并且还极度希望保护自己隐私的用户（
## 使用说明
1. 从 GitHub 页面复制仓库地址，克隆项目：
 [code] 
 也可以选择 **Code → Download ZIP**，解压后在项目目录打开终端。
2. 在项目目录运行安装命令：
 [code] 
3. 安装完成后运行：
 [code] 
 等待模型加载，看到 `>>>` 后输入问题并回车。例如：
 [code] 
以后只需运行 `bash scripts/start.sh`
## 用自己的论文
把文本型 PDF、Markdown 或 TXT 放入 `data/knowledge/`，然后建立索引：
 [code] 
第一次建索引会下载独立的检索模型，需要网络。示例问题：`根据本地论文总结 YOLOv1 的核心创新，列出来源。` 没有放入论文和建立索引时，回答来自模型本身；默认不启用联网搜索。扫描版 PDF 尚不支持 OCR。
## 常用操作
| 操作 | 输入或命令 |
| --- | --- |
| 查看对话命令 | `/help` |
| 开始新会话 | `/new` |
| 退出 | `/exit`、`/quit` 或 Ctrl+D |
| 单次提问 | `bash scripts/start.sh "总结注意力机制"` |
| 只输出答案 | `bash scripts/start.sh "问题" --quiet` |
| 不保存答案文件 | `bash scripts/start.sh "问题" --no-save` |
| 环境检查 | `bash scripts/doctor.sh` |
| 重新选择模型 | `bash scripts/setup.sh` |
每轮问题和答案默认保存在 `output/月/日/时间_微秒.md`。
当前默认会话上下文只保留在进程中，关闭 CLI 后不会恢复；Markdown 答案文件不会自动读回。需要跨窗口继续时，在 `config/agent.yaml` 将 `run.checkpoint_enabled` 改为 `true`，并始终使用同一会话 ID：
 [code] 
会话状态保存到 `data/checkpoints/langgraph.sqlite`。输入 `/new` 或不指定会话 ID 的新交互窗口会创建新会话。每次模型调用默认使用最近 4 轮并受 4096 token 输入预算限制。
## 遇到问题
先执行 `bash scripts/doctor.sh`。它检查环境、GPU 和模型配置，不会加载大模型或开始推理。
## 常见问题
- 没有 GPU：使用有 NVIDIA GPU 的 Linux 机器
- 模型目录不完整：运行 `bash scripts/setup.sh` 重新选择或继续下载。
- 下载失败：检查网络；可在有网络的机器下载完整模型目录后复制过来，再选择已有模型。
- 模型启动失败：查看终端指出的 `logs/cli-vllm-*.log`；确认显存没有被其他程序占用。
项目代码使用 MIT 许可证。