在 C#/WPF 中构建便携式 PDF 编辑器（查看、批注…

当需要用 .NET 在 Windows 上实现一个无需安装、无账号、无遥测的单 EXE PDF 编辑器（渲染、批注、合并拆分、签名、搜索、打印）时，可参考此做法。

适用场景

解决思路

1. 获取预编译版本：用 PowerShell 下载最新发布包并解压运行——Invoke-WebRequest -Uri "https://github.com/SteveTheKiller/KillerPDF/releases/latest/download/KillerPDF.zip" -OutFile "KillerPDF.zip"; Expand-Archive -Path "KillerPDF.zip" -DestinationPath ".\KillerPDF"; .\KillerPDF\KillerPDF.exe，无需安装程序和管理员权限。
2. 从源码构建：需 Windows 10/11 x64、.NET 8 SDK（输出目标为 .NET Framework 4.8）、Git；执行 git clone https://github.com/SteveTheKiller/KillerPDF.git; cd KillerPDF; dotnet publish -c Release，产物在 bin/Release/net48/publish/，包含单文件 KillerPDF.exe（Costura 打包）和 GPL3 对应源码包 KillerPDF-<version>-src.zip。
3. 项目结构：App.xaml/App.xaml.cs（入口与主题）、MainWindow.xaml/.cs（主窗口、工具栏、页面画布）、PdfDocument.cs（PDFium 封装，加载/保存/渲染）、PageViewModel.cs（页面数据绑定与批注层）、AnnotationCanvas.cs（自定义画布用于绘制/批注）、SignatureManager.cs（签名保存/加载/放置）、MergeWindow、SplitWindow、SearchPanel、PrintHelper.cs（扁平化批注并打印）、Models/（Annotation、TextBoxAnnotation、DrawingAnnotation、HighlightAnnotation）、Resources/Icons。
4. 关键依赖（KillerPDF.csproj）：TargetFramework 设为 net48、UseWPF 为 true、OutputType 为 WinExe；PackageReference 包含 Docnet.Core 2.6.0（PDFium 渲染）、Costura.Fody 5.7.0 与 Fody 6.8.0（单 EXE 打包）。
5. 打开与渲染 PDF 页面：用 DocLib.Instance.GetDocReader(filePath, new PageDimensions(1080,1920)) 获取 IDocReader（支持密码重载），PageCount = GetPageCount()；渲染时用 GetPageReader(pageIndex) 取宽高与 BGRA 字节数组，写入 WriteableBitmap（Bgra32），调用 Freeze() 后返回；GetPageText 用 pageReader.GetText() 取文本；Dispose 时释放 reader 与 docLib。
6. 批注模型：定义抽象 Annotation 基类（Id、PageIndex、Bounds、Opacity，抽象方法 ToUIElement() 与 FlattenToPdfPage(PdfPage)）；TextBoxAnnotation 含 Text/FontFamily/FontSize/Color，ToUIElement 返回透明背景无边框的 TextBox 并用 Canvas.SetLeft/SetTop 定位；HighlightAnnotation 用半透明矩形（ARGB 中 Alpha 取 Opacity*128）实现高亮。
7. 自由手绘：自定义 AnnotationCanvas 继承 Canvas，维护 Polyline 与点列表；OnMouseLeftButtonDown 时创建 Polyline（圆角连接与端点）、CaptureMouse 并加点；OnMouseMove 在按住左键时持续加点；OnMouseLeftButtonUp 释放捕获并通过 AnnotationCommitted 事件提交 DrawingAnnotation。
8. 签名管理：SignatureManager 将签名 PNG 存放在 EXE 同目录的 Signatures/ 文件夹（便携、不写 AppData）；Save 用 PngBitmapEncoder 保存 RenderTargetBitmap；LoadAll 枚举 *.png 并 Freeze 后返回；PlaceSignature 返回 Image 元素（可设 Opacity 0.9）并用 Canvas.SetLeft/SetTop 定位。
9. 合并 PDF：MergePdfs 遍历输入路径，用 PdfReader.Open(path, PdfDocumentOpenMode.Import) 打开，逐页 output.AddPage(input.Pages[i])，最后 output.Save(outputPath)。
10. 拆分页面：SplitPages 打开输入文档，按传入的 pageIndices 逐页 AddPage 到新文档并保存。
11. 全文搜索：用 DocLib 获取 reader，逐页 GetText() 做不区分大小写匹配；再用 page.GetCharacters() 获取字符级包围盒，按匹配起止字符的 Box 计算高亮 Rect（Left/Top/Right-Left/Bottom-Top），循环查找所有出现位置。
12. 打印并扁平化批注：PrintDocument 用 PrintDialog 获取可打印区域，构建 FixedDocument/FixedPage，将每页 BitmapSource 以 Uniform 拉伸放入 Image；用 PrintQueue.CreateXpsDocumentWriter 写出。FlattenPage 用 DrawingVisual 先画 PDF 位图，再用 VisualBrush 把 AnnotationCanvas 叠加绘制，最后 RenderTargetBitmap 渲染并 Freeze。
13. 主窗口集成：OpenFile_Click 用 OpenFileDialog 打开并 ShowPage(0)；ShowPage 设置 PageImage.Source = _doc.RenderPage(index, dpi:150) 并清空 AnnotLayer.Children；DrawMode_Click 切换 IsDrawingMode 并设置 PenColor/PenThickness；AddTextBox_Click 创建 TextBoxAnnotation 并加入画布；PlaceSignature_Click 从列表取签名并放置；Save_Click 逐页扁平化后写出；Print_Click 对每页调用 FlattenPage 后 PrintDocument。
14. XAML 布局：DockPanel 顶部 ToolBar 放置 Open/Save/Merge/Split/Text/Draw/Highlight/Sign/Search/Print 按钮；ScrollViewer 内用 Grid 叠放 Image（PageImage，Stretch=Uniform）与 AnnotationCanvas（AnnotLayer，Background=Transparent，绑定 AnnotationCommitted 事件）。
15. 配置项：渲染 DPI 通过 RenderPage(dpi:) 参数；画笔默认值在 AnnotationCanvas.PenColor/.PenThickness；签名存储路径在 SignatureManager._sigDir（EXE 旁）；单 EXE 打包在 FodyWeavers.xml（Costura 配置）；目标框架在 KillerPDF.csproj 的 TargetFramework。不写注册表、不用 %APPDATA%，所有数据与 EXE 同目录。
16. 页面拖拽重排：ListBox 缩略图在 PreviewMouseMove 中按住左键时调用 DragDrop.DoDragDrop；Drop 时取源与目标 PageViewModel，用 Pages.Move(from, to) 调整顺序。
17. 颜色选择：点击颜色按钮弹出 ColorPickerDialog，确认后设置 AnnotLayer.PenColor。
18. 故障排查：DllNotFoundException: pdfium.dll 需用 dotnet publish（而非 build）让 Costura 打包原生库；空白页检查 pageIndex < PageCount 与 PageDimensions；大 PDF 内存高应按需渲染并及时 Dispose IPageReader；保存后批注丢失需对每页调用 FlattenPage；net48 SDK 缺失需装 .NET 8 SDK 交叉编译；签名找不到需保持 Signatures/ 与 EXE 同目录；WPF 设计器崩溃可忽略（Costura 与设计时不兼容），直接运行测试。
19. 许可证：KillerPDF 为 GPLv3，任何分支、修改或再分发（含商业换皮）必须以 GPLv3 发布并提供源码；构建流程会自动生成 KillerPDF-<version>-src.zip 以满足 GPL 合规。

适用边界 · 注意事项

• 需要跨平台（macOS/Linux）或非 Windows 环境时——该方案基于 WPF 与 .NET Framework 4.8，仅限 Windows。
• 需要商业闭源再分发时——项目为 GPLv3，衍生作品必须开源。
• 不想引入 PDFium 原生依赖或希望纯托管实现时——渲染依赖 Docnet.Core 的 pdfium.dll。