PDF Viewer 插件 annotate 命令实战Claude 驱动的 PDF 协同批注工作流【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins在 Claude Cowork 中处理合同审阅、学术论文精读或报告核验时/pdf-viewer:annotate命令提供了一种逐节提议、实时确认、截图回查的协同批注模式Claude 先理解文档内容再向用户提议批注方案获批后通过interact批量施加高亮、备注、图章并回传页面截图双方在可视化查看器中往返迭代直至完成。读完本文你将掌握 annotate 命令的完整 7 步工作流、手动直执行模式、全部批注类型及其 JSON 载荷格式并能基于本仓库中的 命令定义、Skill 工具说明 与 连接器文档 直接落地这套交互式批注方案。annotate 在 PDF Viewer 插件中的定位PDF Viewer 插件围绕可视化查看 协同批注提供四个命令其分工在 插件 README 的命令表中定义命令功能/pdf-viewer:open在交互式查看器中打开 PDF/pdf-viewer:annotate逐段走查文档提议并施加标记与用户共同审阅/pdf-viewer:fill-form交互式填写 PDF 表单字段/pdf-viewer:sign在页面上放置签名或缩写initials图片其中 annotate 是协同批注的主命令它的核心产出是已批注的 PDF而不是纯文本摘要。插件 README 特别强调如果用户只是想总结或抽取文本不应使用本插件——Claude 原生 Read 工具直接读取 PDF 更快查看器的价值在于让用户看到文档并协作施加标记这一点同样写入 Skill 定义 的When to use与Out of Scope两节。工具链基础display_pdf、interact 与 viewUUIDannotate 命令的一切操作都建立在三个底层工具之上它们在 SKILL.md 中有完整定义display_pdf在交互式查看器中打开 PDF每个文档只调用一次。支持参数url本地路径或 HTTPS 地址、page初始页码可选默认 1、elicit_form_inputs为true时先提示用户填写表单再展示主要用于表单流程。调用后返回一个viewUUID所有后续interact调用都必须携带它。注意再次调用display_pdf会创建独立的查看器用新 UUID 发起的interact无法作用到用户正在查看的旧视图上。interactdisplay_pdf之后的所有后续动作都通过它完成。通过commands数组一次携带多条命令它们按顺序依次执行。get_text/get_screenshot前者从指定页范围抽取文本单次最多 20 页用于理解内容、决定批注对象后者把页面捕获为截图用于验证批注结果并展示给用户。display_pdf若检测到 PDF 含可填写表单还会返回formFields字段名、类型、页码、包围盒坐标这些坐标同样可用于签名定位。默认工作流AI 驱动的七步协同批注annotate 的默认路径是AI 驱动Claude 不直接动手而是提议 → 获批 → 施加 → 回查地逐段推进完整流程在 annotate.md 中定义为 7 步打开Open——调用display_pdf打开文档若查看器已打开则直接复用现有viewUUID避免创建第二个互相隔离的视图。理解Understand——通过interact→get_text读取前 20 页范围内的内容弄清文档讲了什么、关键条款在哪。提议Propose——向用户口述计划批注的内容例如我将在第 2 页高亮终止条款在旁边添加备注 Review 30-day window并在第 1 页盖上 DRAFT 图章可以吗施加Apply——用户批准后用interact一次性批量提交命令add_annotations施加批注get_screenshot抓取受影响页面。两条命令在同一commands数组中按序执行保证改完即截图。回查Review——把截图展示给用户征询修改意见。迭代Iterate——进入下一段落重复 25 步。收尾Finish——提醒用户可从查看器工具栏下载批注后的 PDF。这个流程的本质是小步快跑、肉眼可验每一批批注都以截图闭环用户在实时查看器中确认后再进入下一节从而避免大范围误标后返工。手动模式显式指令直接执行当用户给出明确指令高亮第 3 段在每一页盖 CONFIDENTIAL 图章时应跳过提议环节直接执行。手动模式只跳过提议一步截图确认不可省略——施加批注后仍须调用get_screenshot让用户看到实际效果。这是 annotate.md 明确规定的底线其目的与默认模式一致任何对文档的改动都必须可视化地回到用户眼前。支持的批注类型详解annotate 命令覆盖五类批注其中图片类签名、缩写、Logo由/pdf-viewer:sign命令专门承载文本标记则以highlight_text为优先。完整属性矩阵在 SKILL.md 的 Annotation Types 表 中给出类型关键属性用途highlightrects、color?、content?标记重要文本underlinerects、color?强调术语strikethroughrects、color?标记删除内容notex、y、content、color?便利贴式备注freetextx、y、content、fontSize?页面上的可见文本rectanglex、y、width、height、color?、fillColor?框选区域circlex、y、width、height、color?、fillColor?圈选区域linex1、y1、x2、y2、color?画线/箭头stampx、y、label、color?、rotation?APPROVED、DRAFT、CONFIDENTIAL 等图章imageimageUrl、x?、y?、width?、height?签名、缩写、Logo坐标体系是正确放置批注的前提所有批注都需要id唯一字符串、type、page从 1 起算的页码坐标为PDF 点1/72 英寸原点在左上角Y 轴向下增大美版 Letter 纸张为 612×792 pt。image批注的imageUrl接受本地文件路径或 HTTPS 链接不支持 data: URI宽高省略时自动从图片探测用户也可以直接把图片拖放到查看器上。施加批注的实际载荷示例以放置签名为例出自 sign.md{action: add_annotations, annotations: [ {id: sig1, type: image, page: 3, imageUrl: /path/to/signature.png, x: 400, y: 700, width: 150} ]}interact 动作速查批注、导航、抽取与表单interact承载的动作远不止add_annotations完整清单见 SKILL.md批注动作add_annotations施加标记、update_annotations修改既有标记需带id和type、remove_annotations按 id 数组删除、highlight_text按文本查询自动定位并高亮文本类批注优先于手工rects。导航动作navigate翻页、search搜索、find静默查找、search_navigate跳转到指定匹配项、zoom缩放范围 0.53.0。抽取动作get_text抽取页范围文本上限 20 页、get_screenshot页面截图。表单动作fill_form载荷为fields: [{name, value}, ...]。批注修改update_annotations与删除remove_annotations能力使回查-改稿闭环可行用户对截图不满意时Claude 可直接改坐标或删除重放无需重开文档。实战技巧让协同批注更高效annotate.md 的 Tips 一节给出了四条直接可用的操作准则文本批注优先用highlight_text而非手工rects——前者自动查找文本坐标省去手工计算包围盒既准又快。把相关批注合并到一次interact调用中——多命令在同一commands数组内顺序执行减少往返延迟。每批以get_screenshot收尾——让用户在看图后确认是 Review 环节的固定动作。每批提议控制在 35 条批注——小批量提议降低用户审阅负担迭代节奏更顺滑。从流程设计看这些技巧与小批量、可视化、可回查的整体思想一脉相承批量越大一次返工的成本越高没有截图批注效果就成了黑盒。与 open、fill-form、sign 的协同用法annotate 常与其他命令组合成完整工作流各命令文档提供了衔接指引open 先行文档打开后open.md 建议按文档类型给出下一步引导——合同/报告问要我高亮关键条款或添加审阅备注吗表单问要我帮你填写吗学术论文问要我走查并批注关键发现吗这正是进入 annotate 的入口。sign 接力合同审阅后需要签字时按 sign.md 的 6 步流程放置签名图片如需在每一页加缩写可在一次add_annotations调用中按页批量提交image批注。注意 sign 放置的只是视觉签名图片并非认证或加密的数字签名法律意义上的电子签名需使用专门服务。fill-form 联动真实 PDF 常含Text1、Field_7这类晦涩字段名fill-form.md 的做法是用get_screenshot查看每页实际渲染的标签来识别字段表单填完文本后签名区域可再交给/pdf-viewer:sign。运行环境与支持的文档来源PDF Viewer 插件不依赖任何远程连接器而是通过本地 MCP 服务器工作modelcontextprotocol/server-pdf经npx在用户机器上以 stdio 方式运行插件加载时自动启动无需 API Key 或认证详见 CONNECTORS.md。运行前提Node.js ≥ 18访问远程 PDFarXiv、bioRxiv 等需要联网。支持的文档来源包括本地文件工作目录下的路径、arXiv 的/abs/链接自动转换为 PDF 地址、以及任意直接的 HTTPS PDF 链接bioRxiv、Zenodo、OSF 等——务必使用 PDF 直链而非落地页。使用边界什么时候不要用 annotateannotate 不是万能的批注工具其明确边界在 SKILL.md 的 Out of Scope 与 README 中列出摘要/文本抽取——交给 Claude 原生 Read 工具更快且省去交互开销认证数字签名——本插件仅做图片盖印不具备法律效力PDF 创建——插件只作用于已有 PDF不生成新文档。把握可视化交互走 annotate、纯文本摄取走 Read的分界线是把这套工作流用在刀刃上的关键当目标是把一份文档看懂、标注、交付带批注版本时/pdf-viewer:annotate的提议-获批-截图闭环就是最稳妥的落地路径。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考