用途:把手写笔记(手机/扫描仪导出的 PNG/JPG、平板导出的手写 PDF、历史手稿扫描件)转成可在文件系统中 grep 或 Markdown 阅读器全文检索的笔记库。不适用于印刷体书籍(可用 pdftotext)与纯图示/公式笔记。
主要能力:三步流水线——PaddleOCR 批量识别、LLM 润色纠错、生成含摘要与关键词索引的 Markdown;另可在人工标注对照集上打分(CER/WER、关键词召回、0-100 综合分)。
使用方式:命令包括 /ocr-notes install(检查安装依赖)、/ocr-notes <目录>(完整流水线)、/ocr-notes refine <raw_ocr.json>(仅润色)、/ocr-notes eval <测试集目录>(评估),中文命令 /手写笔记 <目录> 等价。依赖本地 Python 包 paddlepaddle、paddleocr、pymupdf、jieba(可选),安装:pip install -r ~/.config/opencode/skills/handwriting-ocr/requirements.txt。Python 3.13 需固定 paddlepaddle==3.2.2;GPU 加速可装 paddlepaddle-gpu==3.2.2。脚本:scripts/batch_ocr.py、scripts/dump_raw.py、scripts/evaluate.py。首次运行会自动下载约 100MB 模型。
限制:润色须保守,不确定处用 [?] 标注,不得凭空补写;页数多时需按页分块处理;若润色后分数低于原始 OCR,应加重“不要改写”约束。具体收费、平台支持等信息暂未提供。