docs: update README for v1.4 — add structured logging, tqdm, retry, pre-commit; fix chart type count 14->19; update docs links

This commit is contained in:
Research Assistant 2026-04-27 19:17:35 +08:00
parent 2edb5b65cc
commit c2a29a27d9

View file

@ -39,11 +39,15 @@ python setup_wizard.py --vault /path/to/your/vault
- **交互式安装向导** — 步骤引导,自动检测,安全验证
- **`/pf-deep`** — 深度精读Keshav 三阶段阅读法)
- **自动 OCR 提取** — PaddleOCR-VL API 提取全文和图表
- **图表类型智能识别**20 种图表类型自动检测
- **图表质量审查指南** — 14 种图表类型的专业审查清单
- **图表类型智能识别**19 种图表类型自动检测
- **图表质量审查指南** — 19 种图表类型的专业审查清单
- **Zotero 双向同步** — Better BibTeX 自动导出
- **文献队列管理** — Obsidian Base 集成
- **自动更新**`python literature_pipeline.py --vault . update`
- **结构化日志**`--verbose`/`-v` 全局参数stderr 诊断输出,不影响管道 stdout
- **进度指示**`tqdm` 进度条 + `--no-progress` 全局参数
- **自动重试** — tenacity 指数退避OCR 上传/轮询自动恢复
- **代码质量栅栏** — pre-commit hooks + ruff 检查 + 重复代码检测
- **自动更新**`paperforge update`
## 安装要求
@ -69,7 +73,7 @@ your-vault/
│ └── literature-qa/
│ ├── scripts/ld_deep.py
│ ├── prompt_deep_subagent.md
└── chart-reading/ # 14 种图表阅读指南
└── chart-reading/ # 19 种图表阅读指南
├── .env # API Key 配置
├── paperforge.json # 版本配置
└── AGENTS.md # 安装后指南
@ -79,6 +83,9 @@ your-vault/
- [安装指南](docs/INSTALLATION.md) — 详细安装步骤
- [安装后指南](AGENTS.md) — 第一次使用必看
- [变更日志](CHANGELOG.md) — v1.0~v1.4 版本历史
- [贡献指南](CONTRIBUTING.md) — 开发环境搭建与代码约定
- [v1.4 迁移说明](docs/MIGRATION-v1.4.md) — 从 v1.3 升级到 v1.4
- [设置向导](setup_wizard.py) — 交互式配置工具
## 核心命令
@ -87,8 +94,9 @@ your-vault/
# PaperForge CLI在终端中直接运行
paperforge status # 查看状态
paperforge sync # 同步 Zotero 文献并生成正式笔记
paperforge ocr # 运行 PDF OCR
paperforge deep-reading # 查看精读队列
paperforge ocr # 运行 PDF OCR支持 --verbose, --no-progress
paperforge deep-reading # 查看精读队列(支持 --verbose
paperforge --verbose ... # 全局 --verbose/-v 启用 DEBUG 日志
# Agent 命令(在 OpenCode 中使用)
/pf-deep <zotero_key> # 完整三阶段精读(需要 AI 理解论文)