{"id":50733230,"url":"https://github.com/hpsummer/pdf-literature-manager","last_synced_at":"2026-06-10T11:00:39.168Z","repository":{"id":363705328,"uuid":"1264152276","full_name":"HPSummer/pdf-literature-manager","owner":"HPSummer","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-10T03:08:08.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T03:19:26.037Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HPSummer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-09T15:56:38.000Z","updated_at":"2026-06-10T03:06:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/HPSummer/pdf-literature-manager","commit_stats":null,"previous_names":["hpsummer/pdf-literature-manager"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/HPSummer/pdf-literature-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpdf-literature-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpdf-literature-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpdf-literature-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpdf-literature-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HPSummer","download_url":"https://codeload.github.com/HPSummer/pdf-literature-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HPSummer%2Fpdf-literature-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34149132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-10T11:00:22.535Z","updated_at":"2026-06-10T11:00:39.159Z","avatar_url":"https://github.com/HPSummer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PDF 文献管理器\n\nWindows 一键 PDF 文献管理工具，面向论文、硕士/博士学位论文和普通 PDF 的整理、引用、重命名与 Obsidian 知识库归档。\n\n## 功能\n\n- 自动扫描当前文件夹或指定文件夹中的 PDF\n- 识别期刊/会议论文、硕士论文、博士论文、普通 PDF 和待复核文件\n- 默认按 GB/T 7714 生成引用和安全文件名\n- 支持 IEEE、APA、MLA、Chicago、GB/T 7714\n- 生成 `references.bib`、`references.ris`、Markdown 引用列表和 CSV/JSON 索引\n- 生成 Obsidian 文献笔记，并可一键复制到 vault 的 `02_literature`\n- 支持 Obsidian 笔记模板和目标子目录配置，模板可使用 `zotero_key`、`citation_gbt`、`citation_ieee`、`school`、`place` 等变量\n- 支持 Zotero 等文献管理软件导入 BibTeX/RIS，并生成 Zotero 导入遗漏报告\n- 提供 Zotero 导出检查 / 待复核面板，可按 skipped、unknown、document、needs_review、缺 DOI、缺作者筛选并批量修正\n- 提供可选 AI 粗读 / 精读，支持 OpenAI-compatible API、可编辑模型名和 Base URL，API Key 仅从环境变量或本机临时输入读取\n- 优化 GUI 信息架构：扫描区、整理/复核/导入工具组、右侧当前记录详情和下一步建议\n- DOI/arXiv 与题名、作者、年份、期刊/出版社补全后自动通过，可直接重命名和导出，无需逐条复核\n- CLI 重命名计划同样使用 GB/T 7714 安全文件名，并限制长度以适配 Windows 路径\n- 支持批量复核、重复文献合并标记、重命名日志和撤销重命名\n- 增强中文学位论文元数据提取：题名、作者、导师、学校、地点、年份\n- 提供 GUI 和 CLI 两种使用方式\n\n## GUI 使用\n\n下载 Release 中的 `PDF文献管理器.zip`，解压后双击：\n\n```text\nPDF文献管理器.exe\n```\n\n推荐流程：\n\n1. 选择 PDF 文件夹。\n2. 点击“开始扫描”。\n3. 双击列表项复核题名、作者、年份、学校/期刊、硕博类型。\n4. 点击“导出索引 / 引用”。\n5. 需要重命名时先生成“重命名计划”，确认后再“应用重命名”。\n6. 需要批量修正时使用“批量复核”；重复条目使用“重复合并”生成合并标记。\n7. 使用“Zotero 检查”查看本次可导入数量和 skipped 条目，必要时批量标为 `paper` 或 `thesis` 后重新导出。\n8. 选中文献后点击“AI 阅读”，选择粗读/精读，按需修改模型、Base URL、环境变量名或临时 API Key。\n9. 使用“导入 Zotero”“导入 Obsidian”完成外部软件导入；若 Zotero 条目不完整，可打开待复核面板或 `zotero_import_report.md`。\n10. 重命名后可通过“撤销重命名”按日志恢复。\n\n## CLI 使用\n\n```powershell\n.\\pdf-manager-cli.exe \"D:\\PDFs\"\n.\\pdf-manager-cli.exe \"D:\\PDFs\" --style gbt7714 --no-network\n.\\pdf-manager-cli.exe \"D:\\PDFs\" --style ieee --recursive\n```\n\n## 输出文件\n\n扫描文件夹下会生成：\n\n```text\n_pdf_manager_output/\n```\n\n| 文件 | 作用 |\n|---|---|\n| `pdf_index.md` | Markdown PDF 总表 |\n| `pdf_index.csv` | 表格索引 |\n| `references_\u003cstyle\u003e.md` | 当前引用风格的引用列表 |\n| `references.bib` | BibTeX 文献库 |\n| `references.ris` | Zotero 兼容 RIS 导入文件 |\n| `zotero_import_report.md` | Zotero 实际导入数量与被跳过记录说明 |\n| `obsidian_notes/` | Obsidian 文献笔记 |\n| `ai_reading_notes/` | AI 粗读/精读 Markdown 笔记 |\n| `import_guide.md` | 第三方软件导入说明 |\n| `duplicates.md` | 重复文献分组与合并标记 |\n| `rename_log.jsonl` / `rename_log.md` | 重命名与撤销记录 |\n| `session.json` | GUI 可重新加载的扫描结果 |\n\nObsidian 模板变量包括：`citekey`、`bibtex_key`、`zotero_key`、`title`、`authors`、`year`、`venue`、`school`、`place`、`doi`、`arxiv_id`、`citation`、`citation_gbt`、`citation_ieee`、`type`、`thesis_type`、`advisor`、`date_added`。\n\nAI 阅读默认模型名为 `gpt-5.4`，可在窗口中改为任意 OpenAI-compatible 模型。API Key 不会写入配置、导出文件、日志或仓库；留空时读取环境变量 `OPENAI_API_KEY`，也可临时输入其他平台的 key。\n\n## 开发\n\n```powershell\npython -m venv .venv\n.\\.venv\\Scripts\\pip install -e \".[dev]\"\n.\\.venv\\Scripts\\pytest.exe .\\tests -v\n```\n\n构建 Windows exe：\n\n```powershell\n.\\build_exe.ps1\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhpsummer%2Fpdf-literature-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhpsummer%2Fpdf-literature-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhpsummer%2Fpdf-literature-manager/lists"}