mirror of https://github.com/lllin000/PaperForge.git synced 2026-07-22 06:50:53 +00:00

Research Assistant abab8df3f5 feat(phase-10): add consistency audit script

- Add scripts/consistency_audit.py with 4 automated checks
- Check 1: No old command names in active code/docs
- Check 2: No paperforge_lite references in Python code
- Check 3: No dead internal links in markdown
- Check 4: Command docs have required sections

Fix violations found by audit:
- Update paperforge/ocr_diagnostics.py error messages to use new commands
- Update pipeline/worker/literature_pipeline.py generated content to use /pf-deep
- Update scripts/welcome.py to recommend /pf-deep
- Update skills/literature-qa/prompt_deep_subagent.md title to /pf-deep
- Update skills/literature-qa/scripts/ld_deep.py docstrings to /pf-deep
- Fix dead links in docs/COMMANDS.md and command/*.md
- Update AGENTS.md migration section to reference MIGRATION-v1.2.md
- Update paperforge/cli.py module docstring to use current commands

2026-04-24 18:06:35 +08:00

2.9 KiB

Raw Blame History

/pf-status

Purpose

查看 PaperForge 当前安装与运行状态。

paperforge status 会检查：

安装完整性（Python 包、依赖）
配置文件（paperforge.json、.env）
路径连通性（exports、ocr、library-records、literature 目录）
Zotero 数据目录链接状态
Better BibTeX 导出文件状态

CLI Equivalent

paperforge status

如需使用 Python 直接调用（备选方式）：

python -m paperforge status --vault .

更简单的方式是直接使用 paperforge status（见上方）。

Prerequisites

无特殊前置条件。此命令用于诊断安装问题，即使在配置不完整时也会尽量输出可用信息。

Arguments

参数	必需	说明
`--vault <PATH>`	否	指定 Vault 根目录（默认当前目录）

Example

# 检查当前目录的 Vault 状态
paperforge status

# 检查指定 Vault 的状态
paperforge status --vault /path/to/vault

Output

典型输出示例：

PaperForge Lite v1.2
====================

[安装检查]
✓ Python 包: paperforge v1.2.0
✓ 依赖: requests, pymupdf, pillow

[配置检查]
✓ paperforge.json: 存在且有效
✓ .env: 存在
✓ PADDLEOCR_API_TOKEN: 已设置

[路径检查]
✓ exports: <system_dir>/PaperForge/exports/
✓ ocr: <system_dir>/PaperForge/ocr/
✓ library-records: <resources_dir>/<control_dir>/library-records/
✓ literature: <resources_dir>/<literature_dir>/
✓ Zotero: <system_dir>/Zotero/

[数据检查]
✓ library.json: 存在，包含 150 条文献
✓ library-records: 150 条记录
✓ 正式笔记: 150 篇

状态: 一切正常 ✅

Error Handling

配置缺失

表现：✗ paperforge.json: 未找到
解决：运行 paperforge doctor 或重新执行安装步骤

路径错误

表现：✗ Zotero: 目录不存在或不是有效链接
解决：创建 junction/symlink 到 Zotero 数据目录（见 AGENTS.md 安装指南）

依赖缺失

表现：✗ 依赖: requests 未安装
解决：pip install requests pymupdf pillow

API Key 未设置

表现：✗ PADDLEOCR_API_TOKEN: 未设置
解决：在 .env 文件中添加 API token

Platform Notes

OpenCode

/pf-status 是 CLI 命令，Agent 层不直接提供 /pf-status 聊天命令。

用户可以在终端运行 paperforge status 检查安装状态。 Agent 可以在对话中指导用户执行诊断，或通过 Bash tool 代为执行并解析输出。

Codex

Future：计划支持。预计通过 API 调用实现类似功能。

Claude Code

Future：计划支持。预计通过工具调用实现类似功能。

2.9 KiB Raw Blame History Unescape Escape