From 40ee97c0f8ed10d9758b5f2cccbb8110b9cd9561 Mon Sep 17 00:00:00 2001 From: Research Assistant Date: Tue, 28 Apr 2026 19:43:58 +0800 Subject: [PATCH] chore: bump to v1.4.3, update READMEs with multi-agent and plugin info --- README.md | 21 +++++++++++++-------- README.zh-CN.md | 21 +++++++++++++-------- paperforge/plugin/manifest.json | 2 +- paperforge/plugin/versions.json | 2 +- paperforge/setup_wizard.py | 2 +- pyproject.toml | 2 +- 6 files changed, 30 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 062819b0..be721b2e 100644 --- a/README.md +++ b/README.md @@ -96,6 +96,8 @@ PaperForge turns your Zotero library into an **AI-ready literature knowledge bas | **Progress bars** | tqdm with `--no-progress` flag for quiet mode | | **Zotero sync** | Better BibTeX auto-export, bidirectional | | **Obsidian Base** | Literature queue management via Base views | +| **Obsidian plugin** | Status panel + command palette integration | +| **Multi-agent** | OpenCode, Claude Code, Codex, Cursor, Copilot, Windsurf, Cline, Augment, Trae | | **Pre-commit gates** | ruff lint + format + consistency audit | | **Cross-platform** | Windows / macOS / Linux | @@ -126,7 +128,7 @@ paperforge setup The interactive wizard handles: agent platform selection, vault directory setup, Zotero data linking, PaddleOCR API key configuration. See [setup-guide.md](docs/setup-guide.md) for a step-by-step walkthrough. -> For AI agents reading this: use the headless mode — `paperforge setup --headless`. Full instructions in [docs/ai-agent-setup-guide.md](docs/ai-agent-setup-guide.md). +> For AI agents reading this: use the headless mode — `paperforge setup --headless --agent `. Supported agents: opencode, claude, codex, cursor, copilot, windsurf, cline, augment, trae. Full instructions in [docs/ai-agent-setup-guide.md](docs/ai-agent-setup-guide.md). ### Prerequisites @@ -154,18 +156,21 @@ The interactive wizard handles: agent platform selection, vault directory setup, | | `paperforge ocr --no-progress` | Quiet mode | | **Reading** | `paperforge deep-reading` | Show deep-reading queue | | **Maintenance** | `paperforge status` | System status | +| | `paperforge status --json` | JSON output for tooling | | | `paperforge update` | Auto-update | | | `paperforge --verbose` | DEBUG-level logging | -### Agent (via OpenCode) +### Agent (OpenCode / Claude Code / Codex / Cursor / Copilot) | Command | What it does | Required | |---------|-------------|----------| -| `/pf-deep ` | Full 3-pass deep reading | OCR complete | -| `/pf-paper ` | Quick summary | Formal note exists | -| `/pf-sync` | Sync Zotero | Installed | -| `/pf-ocr` | Run OCR | Installed | -| `/pf-status` | System status | Installed | +| `/pf-deep ` | Full 3-pass deep reading | OCR complete | +| `/pf-paper ` | Quick Q&A | Formal note exists | +| `/pf-sync` | Sync Zotero (OpenCode only) | Installed | +| `/pf-ocr` | Run OCR (OpenCode only) | Installed | +| `/pf-status` | System status (OpenCode only) | Installed | + +> Prefix: `/` for Claude Code / OpenCode / Copilot, `$` for Codex. CLI-only commands (sync, ocr, status) are available as OpenCode commands or via terminal. --- @@ -202,7 +207,7 @@ pip install --upgrade git+https://github.com/LLLin000/PaperForge.git ```json { - "version": "1.4.1", + "version": "1.4.3", "system_dir": "99_System", "resources_dir": "03_Resources", "literature_dir": "Literature", diff --git a/README.zh-CN.md b/README.zh-CN.md index 65d251f3..ddc07388 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -96,6 +96,8 @@ PaperForge 把你的 Zotero 文献库转化为**AI 可直接读取的知识库** | **进度指示** | tqdm 进度条 + `--no-progress` | | **Zotero 同步** | Better BibTeX 自动导出，双工同步 | | **Obsidian Base** | 文献队列管理，Base 视图集成 | +| **Obsidian 插件** | 状态面板 + 命令面板集成 | +| **多 Agent 平台** | OpenCode, Claude Code, Codex, Cursor, Copilot, Windsurf, Cline, Augment, Trae | | **pre-commit 栅栏** | ruff 检查 + 一致性审计 | | **多平台** | Windows / macOS / Linux | @@ -126,7 +128,7 @@ paperforge setup 安装向导引导你完成：Agent 平台选择、Vault 目录配置、Zotero 数据目录链接、PaddleOCR API Key 配置。详细步骤见 [setup-guide.md](docs/setup-guide.md)。 -> 如果你是 AI Agent 正在读这个：使用 headless 模式 — `paperforge setup --headless`。完整指引见 [docs/ai-agent-setup-guide-zh.md](docs/ai-agent-setup-guide-zh.md)。 +> 如果你是 AI Agent 正在读这个：使用 headless 模式 — `paperforge setup --headless --agent `。支持的 Agent：opencode, claude, codex, cursor, copilot, windsurf, cline, augment, trae。完整指引见 [docs/ai-agent-setup-guide-zh.md](docs/ai-agent-setup-guide-zh.md)。 ### 前置条件 @@ -154,18 +156,21 @@ paperforge setup | | `paperforge ocr --no-progress` | 静默模式 | | **精读** | `paperforge deep-reading` | 查看精读队列 | | **维护** | `paperforge status` | 系统状态 | +| | `paperforge status --json` | JSON 格式输出 | | | `paperforge update` | 自动更新 | | | `paperforge --verbose` | 全局 DEBUG 日志 | -### Agent 命令（OpenCode 中使用） +### Agent 命令（OpenCode / Claude Code / Codex / Cursor / Copilot） | 命令 | 用途 | 前置条件 | |------|------|---------| -| `/pf-deep ` | 完整三阶段精读 | OCR 完成 | -| `/pf-paper ` | 快速摘要 | 有正式笔记即可 | -| `/pf-sync` | 同步 Zotero | 安装完成 | -| `/pf-ocr` | 运行 OCR | 安装完成 | -| `/pf-status` | 系统状态 | 安装完成 | +| `/pf-deep ` | 完整三阶段精读 | OCR 完成 | +| `/pf-paper ` | 论文对话问答 | 有正式笔记即可 | +| `/pf-sync` | 同步 Zotero（仅 OpenCode） | 安装完成 | +| `/pf-ocr` | 运行 OCR（仅 OpenCode） | 安装完成 | +| `/pf-status` | 系统状态（仅 OpenCode） | 安装完成 | + +> 调用前缀：Claude Code / OpenCode / Copilot 使用 `/`，Codex 使用 `$`。sync/ocr/status 为 CLI 操作，纯终端命令。 --- @@ -202,7 +207,7 @@ pip install --upgrade git+https://github.com/LLLin000/PaperForge.git ```json { - "version": "1.4.1", + "version": "1.4.3", "system_dir": "99_System", "resources_dir": "03_Resources", "literature_dir": "Literature", diff --git a/paperforge/plugin/manifest.json b/paperforge/plugin/manifest.json index ff76aba6..1533818a 100644 --- a/paperforge/plugin/manifest.json +++ b/paperforge/plugin/manifest.json @@ -1,7 +1,7 @@ { "id": "paperforge", "name": "PaperForge", - "version": "1.4.2", + "version": "1.4.3", "minAppVersion": "1.0.0", "description": "PaperForge — Zotero + Obsidian literature pipeline. Sync, OCR, and deep-reading commands in your command palette.", "author": "PaperForge", diff --git a/paperforge/plugin/versions.json b/paperforge/plugin/versions.json index a232d585..5eadcb3e 100644 --- a/paperforge/plugin/versions.json +++ b/paperforge/plugin/versions.json @@ -1,3 +1,3 @@ { - "1.4.2": "1.0.0" + "1.4.3": "1.0.0" } \ No newline at end of file diff --git a/paperforge/setup_wizard.py b/paperforge/setup_wizard.py index 50e5b856..f6f29298 100644 --- a/paperforge/setup_wizard.py +++ b/paperforge/setup_wizard.py @@ -1991,7 +1991,7 @@ PADDLEOCR_MODEL=PaddleOCR-VL-1.5 except Exception: existing_config = {} existing_config.update({ - "version": existing_config.get("version", "1.4.2"), + "version": existing_config.get("version", "1.4.3"), "agent_platform": agent_config.get("name", "OpenCode"), "agent_key": agent_key, "skill_dir": skill_dir, diff --git a/pyproject.toml b/pyproject.toml index b4966933..023c8158 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "paperforge" -version = "1.4.2" +version = "1.4.3" description = "PaperForge — Obsidian + Zotero literature pipeline CLI" readme = "README.md" requires-python = ">=3.10"