厌倦了上传敏感合同到云端？试试这个完全免费的本地注释工具，让你在浏览器中安全绘图、搜索和协作！
TL;DR

  1. 在浏览器中免费注释PDF，无需注册或上传文件，隐私安全。
  2. 支持绘图、搜索和移动端触控，性能卓越且符合WCAG AAA无障碍标准。
  3. 轻松本地运行或集成到项目中，是学生、开发者和隐私倡导者的理想选择。

序章：PDF的“云端”囚笼

1. PDF痛点大吐槽

导读：谁该看：所有曾被PDF工具的隐私条款和付费墙困扰过的用户。
我们都有过这样的经历：一份急需标注的合同、一篇重要的研究论文，或是一份包含个人信息的医疗报告。你打开某个在线PDF工具，它微笑着让你“注册账号”、“上传文档”、“升级会员”。那一刻，你的敏感数据就像寄出的明信片，在浩瀚的互联网服务器上裸奔。更别提那些动辄订阅、功能阉割的“免费”工具，简直让人抓狂。这种将用户数据作为筹码的商业模式，是时候被终结了。

  • 核心要点：

    • 常见云端PDF工具的隐私风险与高昂成本。
    • 用户对数据主权的迫切需求。
    • 开源、本地化处理方案的崛起背景。

2. LeedPDF闪亮登场

导读：谁该看：想快速了解这款工具亮点的读者。
就在这时，LeedPDF像一位低调的技术骑士，悄然登场。它是一个现代、开源的PDF注释工具，完全在你的浏览器中运行。没有服务器，没有账户，没有追踪。它将任何PDF文件变成一个可交互的画布，让你自由绘图、标注和协作，而你的文件从未离开过你的设备。这不仅是技术的胜利，更是对用户隐私的尊重。
LeedPDF Logo

  • 核心要点：

    • LeedPDF的核心价值：100%客户端处理，完全免费。
    • 技术栈亮点：基于SvelteKit、TypeScript和PDF.js，现代且高效。
    • 适用场景：从学生笔记到专业合同审阅，无所不包。

直觉：为何它与众不同

3. 隐私与性能的双杀

导读：谁该看：注重数据安全和效率的决策者。
为什么LeedPDF能如此“硬气”？答案在于其“隐私优先”的设计哲学。所有PDF渲染和注释操作都在你的设备上完成，这意味着你的文档永远不会经过第三方服务器。这种本地处理不仅带来了坚不可摧的安全性，还带来了极致的性能——没有网络延迟，加载速度飞快，高DPI屏幕上显示依然锐利。这就像把一个强大的PDF工作站装进了你的浏览器。

  • 核心要点：

    • 100%客户端处理，确保数据永不外泄。
    • 本地渲染带来的性能优势：即时加载、流畅缩放。
    • 与云端工具在响应速度上的天壤之别。

4. 五分钟上手指南

导读：谁该看：新手用户，想5分钟内开始使用。
别以为强大的工具一定复杂。LeedPDF的简洁设计会让你惊叹。只需访问 leed.my，整个世界就在你眼前。拖拽PDF文件到页面中央，或者点击文件夹图标选择文件。瞬间，PDF就加载完毕。顶部的工具栏一目了然：铅笔、高亮、文本、形状……就像你熟悉的物理文具盒。没有教程，没有引导，直觉就能驱动你开始标注。
LeedPDF in action - annotating a Y Combinator fundraising guide with highlights, comments, and drawings

  • 核心要点：

    • 访问 leed.my 即可开始，无需安装。
    • 拖拽上传与工具栏的直观设计。
    • 第一次绘图、添加文本的流畅体验。

实战：从标注到搜索

5. 基础注释的艺术

导读：谁该看：学生和初学者，需掌握核心功能。
让我们来点实际的。打开一份讲义，用铅笔工具在关键公式下划线，换上高亮笔标记重点段落。需要补充说明？点击文本工具，在空白处直接打字，字体和颜色都能调整。想快速批注？一个黄色的便签贴上去，写上“这里需要重点复习！”。所有操作都支持撤销和重做（Ctrl+Z/Y），就像在纸上一样自由，但比纸更灵活。

  • 核心要点：

    • 铅笔、高亮、文本和便签工具的使用技巧。
    • 利用快捷键提升效率（如1-9切换工具）。
    • 本地自动保存功能，让你无需担心丢失进度。

6. 高级绘图与协作

导读：谁该看：设计师或需复杂标注的用户。
对于需要更精确标注的场景，LeedPDF同样游刃有余。用矩形工具圈出图表中的异常数据，用箭头指向流程中的关键节点，甚至可以画个星星标记最重要的结论。最酷的是“智能橡皮擦”，它能精准擦除与它路径相交的任何元素，而不会误伤其他内容。在iPad上，Apple Pencil的压力感应让笔触粗细随力道变化，体验堪比专业绘图软件。

  • 核心要点：

    • 形状工具（矩形、箭头、星形）的应用场景。
    • 智能橡皮擦的精准擦除逻辑。
    • 触控笔（如Apple Pencil）的优化体验。

7. 全网PDF搜索利器

导读：谁该看：研究人员，需快速定位和发现文档。
这是LeedPDF的一个“杀手级”功能。它集成了Brave Search API，让你能直接在LeedPDF里搜索整个互联网上的PDF文件。输入关键词，它会智能过滤并返回纯PDF结果，支持分页浏览。看到想要的文档？直接点击，就会在LeedPDF中打开，无需跳转。这就像拥有了一个专为PDF打造的搜索引擎，找资料、查文献的效率瞬间翻倍。配置方法可以参考项目文档 docs/SEARCH_FEATURE.md。

  • 核心要点：

    • 使用Brave Search API进行全网PDF搜索。
    • 智能过滤和分页功能，提升搜索效率。
    • 从搜索结果直接在LeedPDF中打开文档。

8. 移动端无缝体验

导读：谁该看：平板/手机用户，需移动办公。
谁说专业工具只能在电脑上用？LeedPDF的移动端界面经过精心优化，在手机上也能流畅操作。双指缩放、单指拖动，一切都符合你的直觉。在平板上，它更是如鱼得水，配合触控笔，你可以舒舒服服地躺在沙发上审阅文档。由于所有处理都在本地，即使在没有网络的飞机上，你的工作也不会中断。

  • 核心要点：

    • 移动端触控手势的优化。
    • 平板与触控笔的完美结合。
    • 离线使用能力，随时随地保持生产力。

进阶：从用户到贡献者

9. 本地运行LeedPDF

导读：谁该看：开发者，想自定义或离线使用。
想更深入地掌控LeedPDF？把它跑在本地服务器上吧！这不仅能让你离线使用，还能为二次开发打下基础。过程非常简单，前提是你安装了Node.js 18+和pnpm。
必须出现的最小可运行示例：
打开你的终端，输入以下命令：

# 1. 克隆项目到本地
git clone https://github.com/rudi-q/leed_pdf_viewer.git
# 2. 进入项目目录
cd leed_pdf_viewer
# 3. 安装所有依赖
pnpm install
# 4. 构建项目并启动预览服务器
pnpm build && pnpm preview

输入：在终端逐行执行上述命令。
输出：终端会显示构建过程，最后出现类似 Local: http://localhost:4173/ 的提示。
预期结果：在浏览器中打开 http://localhost:4173，你会看到一个和在线版一模一样的LeedPDF界面，上传PDF即可使用，且完全不依赖互联网。

  • 核心要点：

    • 环境准备：Node.js和pnpm的安装。
    • 克隆、安装依赖、构建和预览的完整流程。
    • 验证本地服务是否成功启动。

是否需要代码示例/命令：是

10. 探索项目结构与贡献

导读：谁该看：贡献者，需参与代码改进。
跑起来之后，不妨看看它的“五脏六腑”。LeedPDF的代码结构清晰明了，遵循SvelteKit的最佳实践。src/lib/components/ 存放着所有Svelte组件，src/lib/stores/ 负责状态管理，而PDF和绘图的核心逻辑则在 src/lib/utils/ 中。项目已经配置好了ESLint和Prettier，保证代码风格统一。如果你想贡献代码，只需Fork仓库，创建新分支，提交后发起Pull Request即可。

  • 核心要点：

    • 项目核心目录结构解析。
    • 代码风格规范与开发工具配置。
    • 标准的开源贡献流程。

是否需要代码示例/命令：是

11. 构建你的桌面应用

导读：谁该看：企业用户，需原生体验。
虽然Web版已经足够强大，但如果你需要一个更接近原生应用的体验，LeedPDF也提供了桌面版的构建方案，基于强大的Tauri框架。Tauri让你用Web技术构建轻量、安全的桌面应用。首先，你需要安装Rust环境。然后，只需几条命令，就能打包出属于你自己的LeedPDF桌面应用。

# 1. 安装Rust (如果尚未安装)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# 2. 在项目根目录下构建桌面应用
pnpm tauri build

构建完成后，你会在 src-tauri/target/release/bundle/ 目录下找到安装包。这为需要离线部署或集成到特定工作流的用户提供了极大便利。

  • 核心要点：

    • Tauri框架的优势：轻量、安全、跨平台。
    • 安装Rust环境并构建桌面应用的步骤。
    • 桌面版相比Web版的额外优势（如更好的系统集成）。

是否需要代码示例/命令：是

结论：拥抱开放与隐私的未来

12. 总结：不止于工具

导读：谁该看：所有读者，需回顾核心价值。
LeedPDF不仅仅是一个PDF注释工具，它更像是一种宣言：技术应当服务于人，而非控制人。它证明了在功能强大、体验流畅的同时，我们完全可以拥有隐私和自由。它将复杂的PDF.js、SvelteKit等技术优雅地封装，呈现出一个极其简单的界面，这正是工程艺术的体现。

  • 核心要点：

    • LeedPDF在隐私、免费和功能之间取得的完美平衡。
    • 背后活跃的开源社区和持续迭代的生命力。
    • 它所代表的“本地优先”软件设计哲学的未来趋势。

13. 社区：与你同行

导读：谁该看：热心用户，想反馈或贡献。
一个伟大的项目离不开一个伟大的社区。LeedPDF的GitHub讨论区非常活跃，无论你是想分享使用心得（Wall of Love），还是遇到问题求助（Q&A），亦或是为项目献计献策（Ideas），都受到欢迎。如果你觉得这个项目帮到了你，也可以通过 GitHub Sponsors 赞助开发者，让这份美好延续下去。

  • 核心要点：

    • 如何参与GitHub讨论，为项目贡献力量。
    • 通过赞助支持项目可持续发展的方式。
    • 社区驱动的项目生态对用户的价值。

14. 展望：无限画布的想象

导读：谁该看：长期用户，关注项目发展。
LeedPDF的“无限画布”不仅指其缩放和平移能力，也象征着其无限的可能性。未来，我们或许能看到更强大的协作功能、更丰富的注释类型，甚至是对其他文档格式的支持。Mac桌面版也已在计划之中。更重要的是，它为所有开发者提供了一个范本：如何构建一个既尊重用户隐私又功能强大的现代Web应用。

  • 核心要点：

    • LeedPDF未来的功能路线图（如Mac版、协作增强）。
    • 作为技术范本，对行业可能产生的积极影响。
    • 开源精神在推动技术进步中的核心作用。

图表建议

  1. 表格：LeedPDF vs 主流PDF工具对比

    特性 LeedPDF (Web) Adobe Acrobat Foxit PDF Reader Smallpdf
    隐私 100%本地 云端同步 云端同步 云端处理
    价格 免费 订阅制 免费+付费 免费+付费
    开源 ✅ 是 ❌ 否 ❌ 否 ❌ 否
    平台 任何浏览器 桌面/移动 桌面/移动 Web
    无障碍 WCAG AAA WCAG AA 未知 未知
    关键结论：LeedPDF在隐私、免费和开源方面具有压倒性优势，且无障碍标准最高。
  2. Mermaid流程图：PDF搜索与注释流程

    graph TD
    A[用户输入关键词] --> B{Brave Search API};
    B --> C[返回PDF结果列表];
    C --> D[用户选择PDF];
    D --> E[LeedPDF本地加载];
    E --> F[用户开始注释];
    F --> G[自动保存到本地存储];

    关键结论：整个流程从发现到创作都在一个闭环内，高效且私密。

  3. 性能曲线图：LeedPDF vs 云端工具加载时间对比
    （示意图）

    • X轴：PDF文件大小
    • Y轴：加载时间
    • LeedPDF的曲线平缓上升，云端工具曲线陡峭。
      关键结论：随着文件增大，LeedPDF的本地加载优势愈发明显，几乎不受网络影响。
  4. 示意图：LeedPDF技术架构
    （示意图）

    • 用户界面
    • SvelteKit (应用框架)
    • PDF.js (PDF渲染引擎)
    • HTML5 Canvas (绘图引擎)
    • 浏览器
      关键结论：展示了LeedPDF如何利用现代Web技术栈，在浏览器内实现复杂功能。
  5. 对比图：移动端与桌面端功能矩阵
    （矩阵图）

    • 行：功能（绘图、搜索、文本、形状…）
    • 列：Web版、桌面版、移动端
    • 用✅和❌标记支持情况。
      关键结论：核心功能在所有平台保持一致，桌面版在性能和集成上略有优势。

常见问题解答 (FAQ)

Q：LeedPDF真的完全免费吗？有没有隐藏费用？
A： 是的，Web版完全免费，基于AGPL-3.0开源协议，没有任何隐藏费用或功能限制。桌面版和商业许可证是付费选项，面向需要原生体验或商业集成的用户。
Q：我的PDF数据真的不会离开我的电脑吗？
A： 绝对不会。LeedPDF的所有处理，包括PDF渲染、绘图、保存，都在你的浏览器本地完成。它不会向任何服务器发送你的文件内容。你可以断开网络后继续使用。
Q：我可以在没有互联网的情况下使用LeedPDF吗？
A： 可以。一旦你首次访问并加载了LeedPDF的网页，它就会被缓存在你的浏览器中。之后，即使断网，你也能打开它并加载之前已经打开过的PDF或本地新PDF进行注释。
Q：我想在我的商业项目中使用LeedPDF，可以吗？
A： 这取决于你的使用方式。如果你的项目本身也是开源的（遵循AGPL-3.0），那么可以。如果你想将LeedPDF集成到闭源的商业产品中，则需要购买商业许可证。详情可参考项目的Licensing部分。

SEO要素

  • Meta Title: LeedPDF: Free, Open-Source PDF Annotation Tool for Privacy
  • Meta Description: Annotate PDFs for free in your browser with LeedPDF. 100% private, no uploads required. Draw, search, and collaborate with this open-source tool.
  • 目标关键词: PDF注释工具, LeedPDF, 免费PDF编辑器, PDF annotation tool, 隐私优先

工程化 Checklist

- [ ] 环境检查：确认已安装 Node.js 18+ 和 pnpm。
- [ ] 代码获取：成功 `git clone` 项目仓库。
- [ ] 依赖安装：运行 `pnpm install` 无报错。
- [ ] 本地构建：`pnpm build` 命令成功执行。
- [ ] 预览测试：访问 `http://localhost:4173` 界面正常，可上传PDF。
- [ ] 功能验证：测试绘图、文本、保存等核心功能。
- [ ] 移动端测试：在Chrome DevTools的移动设备模式下测试触控操作。
- [ ] 隐私验证：通过开发者工具Network面板确认无PDF文件上传请求。

思考题与练习

  1. 思考题：LeedPDF选择了AGPL-3.0作为其Web版的许可证。请思考一下，为什么对于这样一个“客户端”工具，AGPL-3.0（一个针对网络服务的“强传染性”开源协议）依然是一个合适的选择？它对用户和社区分别意味着什么？
  2. 练习：尝试本地运行LeedPDF，并为其添加一个新的绘图工具，例如“波浪线”工具。你需要修改 src/lib/components/ 中的相关组件，并添加一个新的工具按钮。完成后，尝试提交一个Pull Request到官方仓库。