Moss PDF 阅读插件
v1.0.0 · 文档处理 · 官方
简介
Moss PDF 阅读插件 v1.0,AI 直接读取本地 PDF:
- read 提取全文或指定页文本,可限制字数、导出 txt
- info 页数、标题、作者、创建工具等元信息
- search 关键词搜索,返回页码 + 上下文摘要
- 本地处理,文件不上传;适合合同、报告、说明书阅读
仅支持有文字层的 PDF;纯扫描图片 PDF 无法提取文字(需 OCR)。
操作说明
| action | 功能 |
|---|---|
read | 读全文或指定页 |
info | 页数/标题/作者等 |
search | 关键词搜页码 |
pages 格式: 1 · 1-5 · 1,3,8 · 不填=全部
安装
- 解压到
D:\moss-plugins\文档处理\PDF阅读插件\ - 复制
python/到本目录 - 安装依赖:
python\python.exe -m pip install pypdf - 测试:
run.bat --action info --filepath D:\test\sample.pdf
| 文件 | 说明 |
|---|---|
pdf_plugin.py | 主程序 |
run.bat / run.sh | 启动脚本 |
PDF阅读插件.md | 用户文档 |
命令行
run.bat --action read --filepath D:\docs\报告.pdf
run.bat --action read --filepath D:\docs\报告.pdf --pages 1-5 --max_chars 8000
run.bat --action read --filepath D:\docs\报告.pdf --output D:\docs\报告.txt
run.bat --action info --filepath D:\docs\报告.pdf
run.bat --action search --filepath D:\docs\报告.pdf --query 销售额
注册技能 pdf_tool
名称: pdf_tool
描述: PDF阅读 v1.0:read/info/search。提取全文或指定页、查看页数标题作者、关键词搜索页码摘要。用户读PDF、搜PDF内容、看PDF信息时使用。需提供 filepath。
脚本: D:\moss-plugins\文档处理\PDF阅读插件\run.bat
参数 JSON:
{
"type": "object",
"properties": {
"action": {"type": "string", "enum": ["read", "info", "search"], "description": "操作类型"},
"filepath": {"type": "string", "description": "PDF文件路径,必填"},
"pages": {"type": "string", "description": "read页码 1或1-5或1,3,5"},
"max_chars": {"type": "string", "description": "read最多字符数"},
"output": {"type": "string", "description": "read导出txt路径"},
"query": {"type": "string", "description": "search关键词"},
"max_results": {"type": "string", "description": "search最多条数"},
"context_chars": {"type": "string", "description": "search摘要上下文长度"}
},
"required": ["action", "filepath"]
}
对话示例
| 场景 | 说法 |
|---|---|
| 读全文 | 读取 D:\docs\合同.pdf 的内容 |
| 读指定页 | 读 report.pdf 第 1-10 页 |
| 看信息 | 这份 PDF 多少页?标题是什么? |
| 搜索 | 在 contract.pdf 里搜「违约责任」 |
| 导出 | 把 manual.pdf 文字导出到 manual.txt |
常见错误
| 现象 | 处理 |
|---|---|
| 缺少 pypdf | pip install pypdf |
| 文件不存在 | 检查路径 |
| PDF 已加密 | 用无密码版或先解密 |
| 提取为空 | 扫描版无文字层 |
能力边界
| 支持 | 不支持 |
|---|---|
| 文字层 PDF | 扫描版 OCR |
| 按页读/搜 | 编辑合并 PDF |
| 元信息 | 复杂版式还原 |
配合:word_tool 写摘要 · file_convert 格式互转(规划中)
详见包内 PDF阅读插件.md。