arxiv-pulse 0.5.0__py3-none-any.whl → 0.6.1__py3-none-any.whl

{arxiv_pulse-0.5.0.dist-info → arxiv_pulse-0.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arxiv-pulse
-Version: 0.5.0
+Version: 0.6.1
 Summary: An intelligent arXiv literature crawler and analyzer for physics research
 Author-email: Yang Li <lyang.1915@gmail.com>
 License-Expression: GPL-3.0-or-later
@@ -42,32 +42,27 @@ Dynamic: license-file
 
 # arXiv Pulse - 智能 arXiv 文献追踪系统
 
-![Version](https://img.shields.io/badge/version-0.5.0-blue)
+[![Version](https://img.shields.io/pypi/v/arxiv-pulse.svg)](https://pypi.org/project/arxiv-pulse/)
 ![Python](https://img.shields.io/badge/python-3.12%2B-green)
 ![License](https://img.shields.io/badge/license-GPL--3.0-orange)
 
 > 🌐 **语言说明**：本文档为中文版本。
 
-**arXiv Pulse** 是一个 Python 包，用于自动化爬取、总结和跟踪 arXiv 在凝聚态物理、密度泛函理论（DFT）、机器学习、力场和相关计算材料科学领域的最新研究论文。提供简化的命令行界面，通过 **8 个核心命令** 提供专业级的文献管理体验。
+**arXiv Pulse** 是一个 Python 包，用于自动化爬取、总结和跟踪 arXiv 在凝聚态物理、密度泛函理论（DFT）、机器学习、力场和相关计算材料科学领域的最新研究论文。提供简化的命令行界面，通过 **5 个核心命令** 提供专业级的文献管理体验。
 
 ## ✨ 核心功能
 
-- **📦 极简设计**：**8 个核心命令**覆盖完整文献管理流程
+- **📦 极简设计**：**5 个核心命令**覆盖完整文献管理流程
 - **🔍 智能搜索**：支持自然语言查询，AI 自动解析为学术关键词
-- **🔬 高级搜索**：多字段精细过滤（分类、作者、时间范围等）
-- **🔗 相似推荐**：基于分类重叠查找相似论文，拓展研究视野
-- **📋 搜索历史**：记录和重用成功搜索，提高检索效率
 - **🤖 AI 总结**：使用 OpenAI 兼容 API（如 DeepSeek、Paratera AI 等）生成简洁摘要和中文翻译
 - **💾 数据库存储**：SQLite 数据库存储完整论文元数据
 - **📊 智能报告**：自动同步最新论文后生成报告，确保数据时效性
 - **🔄 自动同步**：搜索和报告前自动更新数据库，保持数据最新
 - **💰 成本透明**：准确跟踪 API 使用费用，优化成本控制
 - **🎯 专注科研**：专为凝聚态物理、DFT、机器学习、力场等研究领域优化
-- **🎛️ 交互式配置**：引导式配置向导，支持 30+ 研究领域选择（v0.5.0）
-- **🧠 智能建议**：基于选择领域数量自动推荐优化配置（v0.5.0）
-- **🚩 个性化横幅**：根据研究领域显示定制化启动横幅（v0.5.0）
-- **🌐 通用 AI API**：支持所有 OpenAI 兼容服务（DeepSeek、Paratera AI 等）（v0.5.0）
-- **📅 工作日计算**：按工作日计算时间范围，排除周末（v0.5.0）
+- **🎛️ 交互式配置**：引导式配置向导，支持 30+ 研究领域选择
+- **🧠 智能建议**：基于选择领域数量自动推荐优化配置
+- **🌐 通用 AI API**：支持所有 OpenAI 兼容服务（DeepSeek、Paratera AI 等）
 
 ## 🚀 快速开始
 
@@ -93,10 +88,6 @@ pip install -e .
    pulse init .  # 自动创建目录并同步5年历史论文
    ```
 
-2. **交互式配置（推荐）**
-   ```bash
-   pulse init .  # 首次运行时会启动交互式配置向导
-   ```
    首次初始化时，配置向导将引导您完成：
    - 🔧 **AI API 配置**：设置 API 密钥、模型和 Base URL（支持所有 OpenAI 兼容服务）
    - 📊 **爬虫配置**：调整初始/每日最大论文数、回溯年数
@@ -123,16 +114,26 @@ pip install -e .
 
 ## 📋 核心命令参考
 
-### 8个核心命令
+### 全局选项
+
+所有命令都支持以下全局选项：
+
+- `-v, --verbose`：显示详细输出（包括调试信息）
+- `--version`：显示版本信息
+- `-h, --help`：显示命令帮助信息
+
+**日志级别控制**：
+- 默认输出级别为 `INFO`，隐藏调试信息
+- 使用 `--verbose` 选项显示所有调试信息
+- 通过环境变量 `LOG_LEVEL` 设置默认级别：`DEBUG`、`INFO`、`WARNING`、`ERROR`
+
+### 5个核心命令
 
 | 命令 | 说明 | 关键特性 |
 |------|------|----------|
 | **`pulse init`** | 初始化目录并自动同步历史论文 | ✅ 一键创建目录结构<br>✅ 自动同步5年历史论文<br>✅ 创建 `.env` 配置模板 |
 | **`pulse sync`** | 同步最新论文到数据库 | ✅ 专注于数据更新<br>✅ 可选择是否总结新论文<br>✅ 不自动生成报告 |
 | **`pulse search`** | 智能搜索论文（支持自然语言查询） | ✅ AI解析自然语言查询<br>✅ 自动前置同步确保数据最新<br>✅ 生成详细Markdown/CSV报告<br>✅ 包含中文翻译和PDF链接 |
-| **`pulse search-advanced`** | 高级搜索论文（支持多字段过滤） | ✅ AI解析自然语言查询<br>✅ 多字段精细过滤（分类、作者、时间等）<br>✅ 多种排序选项和匹配逻辑<br>✅ 生成详细报告 |
-| **`pulse similar`** | 查找与指定论文相似的论文 | ✅ 基于分类重叠计算相似度<br>✅ 可调节相似度阈值<br>✅ 发现相关研究方向<br>✅ 生成详细报告 |
-| **`pulse search-history`** | 显示搜索历史（按使用频率排序） | ✅ 查看最常用的搜索查询<br>✅ 统计使用频率和最后使用时间<br>✅ 快速重用成功搜索 |
 | **`pulse recent`** | 生成最近论文报告 | ✅ 先同步再报告，数据时效性强<br>✅ 自定义报告时间范围和论文数量<br>✅ 生成Markdown和CSV格式报告 |
 | **`pulse stat`** | 显示数据库统计信息 | ✅ 查看论文总数和总结率<br>✅ 分析论文分类和领域分布<br>✅ 查看时间分布和趋势 |
 
@@ -152,26 +153,34 @@ pulse init [目录路径] --years-back 5
 ```
 [工作目录]/
 ├── data/                    # 数据库存储目录
+│   └── important_papers.txt # 重要论文列表（在data目录内）
 ├── reports/                 # 报告输出目录  
-├── logs/                    # 日志目录
-├── .env                     # 环境配置文件模板
-└── important_papers.txt     # 重要论文列表
+└── .env                     # 环境配置文件（由.ENV.TEMPLATE生成）
 ```
 
 **设计理念**：一键完成所有初始化工作，无需额外步骤。
 
 #### `pulse sync` - 同步最新论文
-**功能**：仅同步最新论文到数据库，不生成报告。
+**功能**：同步最新论文到数据库，不生成报告。支持普通模式和强制模式。
 
 ```bash
+# 普通模式：只下载缺失的新论文，默认回溯1年
 pulse sync [目录路径] --years-back 1 --no-summarize
+
+# 强制模式：重新下载最近N年的所有论文，忽略重复检查，默认回溯5年
+pulse sync [目录路径] --force --years-back 5 --no-summarize
 ```
 
 **参数**：
-- `--years-back`：同步回溯的年数（默认：1年）
+- `--years-back`：同步回溯的年数（默认：强制模式5年，普通模式1年）
 - `--summarize/--no-summarize`：是否总结新论文（默认：否）
+- `--force`：强制同步：重新下载最近N年的所有论文，忽略重复检查，默认回溯5年
+
+**使用场景**：
+- **普通模式**：日常更新，只获取最新发布的论文
+- **强制模式**：初始化新数据库、修复数据缺失、更新配置后重新获取历史论文
 
-**设计理念**：专注于数据更新，让用户控制是否总结论文。
+**设计理念**：专注于数据更新，提供灵活的同步策略，让用户根据需求选择普通更新或完全重新同步。
 
 #### `pulse search` - 智能搜索论文
 **功能**：在数据库中搜索论文，支持自然语言查询和AI解析。
@@ -226,100 +235,28 @@ pulse stat [目录路径]
 
 **设计理念**：提供全面的数据库洞察，帮助用户了解文献分布和研究趋势。
 
-#### `pulse search-advanced` - 高级搜索论文
-**功能**：支持多字段精细过滤的高级搜索，满足复杂文献检索需求。
-
-```bash
-pulse search-advanced "查询内容" [目录路径] --categories 分类1 --categories 分类2 --date-from 2026-01-01 --summarized-only
-```
-
-**参数**：
-- `--categories, -c`：包含的分类（可多次使用）
-- `--exclude-categories, -ec`：排除的分类（可多次使用）
-- `--primary-category, -pc`：主要分类
-- `--authors, -a`：作者姓名（可多次使用）
-- `--author-match`：作者匹配方式（contains/exact/any，默认：contains）
-- `--date-from`：起始日期（格式：YYYY-MM-DD）
-- `--date-to`：结束日期（格式：YYYY-MM-DD）
-- `--days-back`：回溯天数（例如：30表示最近30天）
-- `--summarized-only/--no-summarized-only`：仅显示已总结的论文
-- `--downloaded-only/--no-downloaded-only`：仅显示已下载的论文
-- `--sort-by`：排序字段（published/relevance_score/title/updated/created_at，默认：published）
-- `--sort-order`：排序顺序（asc/desc，默认：desc）
-- `--match-all/--match-any`：匹配所有条件（AND逻辑）或任一条件（OR逻辑）
-
-**设计理念**：为科研工作者提供专业级的文献检索工具，支持复杂查询和精细过滤。
-
-#### `pulse similar` - 查找相似论文
-**功能**：基于分类重叠查找与指定论文相似的论文，帮助发现相关研究。
-
-```bash
-pulse similar [arXiv ID] [目录路径] --threshold 0.5 --limit 10
-```
-
-**参数**：
-- `--threshold`：相似度阈值（0.0-1.0，默认：0.5）
-- `--limit`：返回结果的最大数量（默认：10）
-- `--years-back`：搜索前同步回溯的年数（默认：0，不更新）
-
-**算法**：计算分类重叠相似度 = 共同分类数 / 总分类数，返回相似度≥阈值的论文。
-
-**设计理念**：帮助研究者拓展文献视野，发现相关研究方向，避免信息孤岛。
-
-#### `pulse search-history` - 显示搜索历史
-**功能**：显示最常用的搜索查询及其使用频率，便于快速重用成功搜索。
-
-```bash
-pulse search-history [目录路径] --limit 10
-```
-
-**参数**：
-- `--limit`：显示的搜索查询数量（默认：10）
-
-**显示信息**：
-1. **搜索查询**：查询内容
-2. **使用次数**：该查询的使用频率统计
-3. **最后使用**：最近一次使用该查询的时间
-4. **最后论文ID**：最近一次使用该查询找到的论文ID
-
-**设计理念**：提高搜索效率，通过历史记录快速重用成功搜索，避免重复构建复杂查询。
-
 ## ⚙️ 配置说明
 
 ### 环境变量（`.env` 文件）
 
-初始化目录时会自动创建 `.env` 模板文件，或首次运行 `pulse init .` 时通过交互式配置生成：
+初始化目录时会自动创建 `.env` 配置文件，或首次运行 `pulse init .` 时通过交互式配置生成。所有配置项均支持通过环境变量覆盖。
 
-```bash
-# AI API 配置 (支持所有 OpenAI 兼容服务，如 DeepSeek、Paratera AI、OpenAI 等)
-AI_API_KEY=your_api_key_here
-AI_MODEL=DeepSeek-V3.2-Thinking
-AI_BASE_URL=https://llmapi.paratera.com
-
-# 数据库配置
-DATABASE_URL=sqlite:///data/arxiv_papers.db
-
-# 爬虫配置
-MAX_RESULTS_INITIAL=100    # init命令每个查询的论文数
-MAX_RESULTS_DAILY=20       # sync命令每个查询的论文数
-
-# 搜索查询（分号分隔，允许查询中包含逗号）
-# 通过交互式配置选择研究领域后自动生成
-SEARCH_QUERIES=condensed matter physics AND cat:cond-mat.*; (ti:"density functional" OR abs:"density functional") AND (cat:physics.comp-ph OR cat:cond-mat.mtrl-sci OR cat:physics.chem-ph); (ti:"machine learning" OR abs:"machine learning") AND (cat:physics.comp-ph OR cat:cond-mat.mtrl-sci OR cat:physics.chem-ph); (ti:"force field" OR abs:"force field") AND (cat:physics.comp-ph OR cat:cond-mat.soft OR cat:physics.chem-ph); (ti:"first principles" OR abs:"first principles" OR ti:"ab initio" OR abs:"ab initio") AND (cat:physics.comp-ph OR cat:cond-mat.mtrl-sci); (ti:"molecular dynamics" OR abs:"molecular dynamics") AND (cat:physics.comp-ph OR cat:cond-mat.soft OR cat:physics.chem-ph); (ti:"quantum chemistry" OR abs:"quantum chemistry") AND (cat:physics.chem-ph OR cat:physics.comp-ph); cat:cond-mat.mtrl-sci AND (ti:"computational" OR abs:"computational" OR ti:"simulation" OR abs:"simulation")
-
-# 报告配置
-REPORT_DIR=reports
-SUMMARY_MAX_TOKENS=2000    # 总结和翻译的最大token数
-SUMMARY_SENTENCES_LIMIT=3
-TOKEN_PRICE_PER_MILLION=3.0
-REPORT_MAX_PAPERS=50
-
-# 同步配置
-YEARS_BACK=3               # 同步回溯的年数
-IMPORTANT_PAPERS_FILE=important_papers.txt
-```
+**主要配置类别：**
+
+1. **AI API 配置** - 支持所有 OpenAI 兼容服务（DeepSeek、Paratera AI、OpenAI 等）
+2. **数据库配置** - SQLite 数据库连接设置
+3. **爬虫配置** - 论文获取限制、排序方式、API 参数
+4. **搜索查询配置** - 分号分隔的研究领域查询列表
+5. **报告配置** - 报告生成、AI 总结、费用估算设置
+6. **同步配置** - 回溯年数、重要论文追踪
+7. **日志配置** - 输出级别、爬虫延迟
+
+**详细配置说明请参考 `arxiv_pulse/.ENV.TEMPLATE` 文件，其中包含完整的配置项列表、默认值和详细注释。**
 
-**注意**：从 v0.5.0 开始，所有 AI 相关配置统一使用 `AI_*` 前缀变量。旧的 `DEEPSEEK_*` 变量已不再支持。建议首次运行 `pulse init .` 时使用交互式配置向导完成所有设置。
+**使用建议：**
+- 首次使用建议运行 `pulse init .` 通过交互式配置向导自动生成优化配置
+- 如需手动配置，将 `.ENV.TEMPLATE` 复制为 `.env` 并根据需要修改
+- 交互式配置向导支持 30+ 个专业研究领域选择，并基于选择数量提供智能参数建议
 
 ### 研究领域
 
@@ -376,21 +313,21 @@ arxiv_pulse/                    # Python 包源码
 ├── output_manager.py          # 统一输出管理
 ├── report_generator.py        # 报告生成器
 ├── search_engine.py           # 增强搜索引擎
-└── summarizer.py              # 论文总结器
+├── summarizer.py              # 论文总结器
+└── .ENV.TEMPLATE              # 环境配置模板文件
 
-项目根目录/
+ 项目根目录/
 ├── pyproject.toml             # 包配置和依赖
 ├── README.md                  # 本文档
 ├── LICENSE                    # GPL-3.0 许可证
-
 └── .gitignore                 # Git 忽略文件
 
 工作目录（用户使用）/
-├── .env                       # 环境配置
+├── .env                       # 环境配置文件（由.ENV.TEMPLATE生成）
 ├── data/                      # 数据库存储
-├── reports/                   # 生成的报告
-├── logs/                      # 应用日志
-└── important_papers.txt       # 重要论文列表
+│   ├── arxiv_papers.db        # SQLite数据库文件
+│   └── important_papers.txt   # 重要论文列表
+└── reports/                   # 生成的报告目录
 ```
 
 ## 🗂️ 输出文件
@@ -404,9 +341,7 @@ arxiv_pulse/                    # Python 包源码
 - **最近论文报告**：`reports/recent_YYYYMMDD_HHMMSS.md` 和 `.csv` (通过 `pulse recent` 生成)
 - **报告内容**：论文详情、AI总结、中文翻译、相关度评级、费用统计、PDF链接
 
-### 日志
-- `logs/arxiv_pulse.log` - 主要应用日志
-- `logs/summarizer.log` - 总结器日志
+
 
 ## 🔧 高级使用
 
@@ -514,6 +449,8 @@ ls -la logs/
 tail -f logs/summarizer.log
 ```
 
+
+
 ## 📄 许可证
 
 本项目采用 GPL-3.0 许可证 - 详见 [LICENSE](LICENSE) 文件。

arxiv_pulse-0.6.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+arxiv_pulse/.ENV.TEMPLATE,sha256=-dG9dl1Cnb7Xjq30HZ7v4__ArtPewdjDtzgpJmBNjYE,5525
+arxiv_pulse/__init__.py,sha256=BBNwoE-pmiSqc3_X_Sr3Ao9bceygkhsDof1QuXCEfHs,608
+arxiv_pulse/__version__.py,sha256=q6GkywvRWb4klaJxfZzJnixMfPZhLCV4pKiL_QrBX_Q,961
+arxiv_pulse/arxiv_crawler.py,sha256=krUY_SCk2bFl9QidDbHt_qEMfO__KK_lDF_QekhDCSc,16623
+arxiv_pulse/cli.py,sha256=-XvHVOZAszLxwjxwMzmI84eIHaPR4IQ91oaWYnfJiDk,57158
+arxiv_pulse/config.py,sha256=Hcb6zcEjkO0y6QZ0AhqV2YAnKRnM3E6fNIyuGaXL0V0,2503
+arxiv_pulse/models.py,sha256=pvdd_bfDJcqenVNoCmdnU2049zucA0H8ERHqDa88MbI,10112
+arxiv_pulse/output_manager.py,sha256=WqYSGWX7cEzqPKCGCp6zevX99D7TYVcWJYTWL_za2XU,7139
+arxiv_pulse/report_generator.py,sha256=O6AmlHPeLI_0hyFo-5B0HpFP3P287ZfzGk4y_2mFziA,30333
+arxiv_pulse/search_engine.py,sha256=mEC63uOEawr3-I9zTscbbm2e_opaYkyf4-ihkFK5Who,16045
+arxiv_pulse/summarizer.py,sha256=60JgAR2bdwmc0V8lou8OVuEmZXWYbfbI-P4EbEdT5D0,12853
+arxiv_pulse-0.6.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+arxiv_pulse-0.6.1.dist-info/METADATA,sha256=mPJ3M01dKRsGBqHPql8ZCDqgJvqC7LJ28JKzF05wsV8,18493
+arxiv_pulse-0.6.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+arxiv_pulse-0.6.1.dist-info/entry_points.txt,sha256=ld4XAcWJDyHM1i5RKs0r22LdzhgFcNilNoU1dbf5r6E,46
+arxiv_pulse-0.6.1.dist-info/top_level.txt,sha256=CKAnBbV76S-15CP-m3rfia1VNSdZOocr5MhVxXzH-Vw,12
+arxiv_pulse-0.6.1.dist-info/RECORD,,

arxiv_pulse-0.5.0.dist-info/RECORD

@@ -1,17 +0,0 @@
-arxiv_pulse/.ENV.TEMPLATE,sha256=_MnlkK2RyVTSqQVqlKK2ngnCzTvzbydJ6RcVbsecpd4,2833
-arxiv_pulse/__init__.py,sha256=BBNwoE-pmiSqc3_X_Sr3Ao9bceygkhsDof1QuXCEfHs,608
-arxiv_pulse/__version__.py,sha256=AlKnb6hfRSNCL8vS1N77-D9fwh6hE_PiY_S_2uhM6lM,961
-arxiv_pulse/arxiv_crawler.py,sha256=KBRyrtjRjiGcdWifroHwO8QJ2a5YJ97pjflp7UaUzuM,14401
-arxiv_pulse/cli.py,sha256=ivrPQio8rS-m54uFUNoYejRGnOmEk9lUYrtZXEh7KAs,64449
-arxiv_pulse/config.py,sha256=3oCOE75FVc8i-aQNNYYrrJGzClkXX33DHXbaJN0Zb7o,2489
-arxiv_pulse/models.py,sha256=RhckE7dqU4OL27hcm94wdfpsFIKAMTJnKwz4-DSV8hI,9680
-arxiv_pulse/output_manager.py,sha256=__15l1ge5ok6oVvUCfxHiGPMrJkzQh1GltGk6DkLBHk,7341
-arxiv_pulse/report_generator.py,sha256=ZV-HPK1x3bEHvJcWYyivzExLq4-5iVpv2uBJMV8aQnw,31775
-arxiv_pulse/search_engine.py,sha256=F6V6kWgnGsOeIFtkyIRdLtj12MWfiYgpGnV9aalVUrc,13079
-arxiv_pulse/summarizer.py,sha256=dZgjSSl5phU8g-hOubtyVWIZ3mZilVuS7VbYdRWZocc,12867
-arxiv_pulse-0.5.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-arxiv_pulse-0.5.0.dist-info/METADATA,sha256=SNvMjBiJ36CpNZjo1lSxoi-u8GwRjqZl_8YBRy0Q-4Y,22126
-arxiv_pulse-0.5.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-arxiv_pulse-0.5.0.dist-info/entry_points.txt,sha256=ld4XAcWJDyHM1i5RKs0r22LdzhgFcNilNoU1dbf5r6E,46
-arxiv_pulse-0.5.0.dist-info/top_level.txt,sha256=CKAnBbV76S-15CP-m3rfia1VNSdZOocr5MhVxXzH-Vw,12
-arxiv_pulse-0.5.0.dist-info/RECORD,,