当前位置：首页 > news >正文

我用 AI 做了一个PDF转Word神器：解决排版烦恼

news 2026/7/25 12:16:32

你有没有遇到过这种情况：

PDF 改不了
想改一页内容，结果重排半小时
表格一复制，全乱

我被这个问题折磨了很久。

所以我干了一件事：

自己做了一个 PDF 转 Word 的工具，然后把它上线了。

同时，我也把项目的 GitHub 仓库开源了。
我发现，有些技术用户其实不想用现成的服务，更愿意自己捣鼓代码，所以我把源码放在了GitHub上。

在线体验网站：
https://open.clipflow.top/
GitHub 开源仓库（需要自己部署和配置）：

https://github.com/lxy1234cn/PDFtoWordPublicVersion01/tree/YiPaySuccess

一、PDF 转 Word 的需求

如果你是学生 / 打工人，大概率遇到过：

PDF 没法编辑
想改几个字还得重做
表格、排版一塌糊涂

最离谱的是：

有时候你只是想改一页内容

结果要花 30 分钟重排版。所以还是有需求的。

二、ClipFlow 项目踩坑总结

（一） Python 调用 & IIS 部署

问题：本地能跑，部署到 IIS 服务器后 Python 无法执行或路径找不到
原因：
- Python.exe 路径写死在本地
- IIS 应用程序池权限不足

-解决方案：

用配置文件 (appsettings.json) 或环境变量指定 Python.exe 路径
确保应用池有执行权限

教训：部署环境和本地环境差异很大，路径硬编码容易出问题

(二) 支付系统 & 用户次数管理

问题：
- 在Notify 回调中粗心把流水号当 AccountId，存入数据库了，导致后面查不到使用次数
- 依赖注入生命周期冲突，导致服务取不到最新状态
解决方案：

修正 AccountId 与订单流水号的对应关系
在 Controller 内用 IServiceScopeFactory.CreateScope() 创建服务范围，确保生命周期正确

教训：支付闭环逻辑要严谨，尤其是异步和多服务调用

（三）文件大小限制 & Kestrel 配置

问题：大文件上传时失败
原因：ASP.NET Core 默认上传限制太小，小文件就直接进iis的缓存就欧克了，太大了服务器就不行。（其实这个问题，不是这个项目的，是我以前做图床和文件托管平台的时候，出现的。这里只是提一下）
解决方案：

修改 Kestrel 配置：options.Limits.MaxRequestBodySize = 104857600
修改 FormOptions：options.MultipartBodyLengthLimit = 104857600

教训：生产环境文件大小要提前规划

（四）异步处理 & 生命周期冲突

问题：
- 在 Controller 中调用异步服务出现 “对象为空” 和 “生命周期冲突” （居然犯了这种错误，之前我还专门写过生命周期冲突的相关博客文章，结果自己犯了☺）
原因：
-直接注入 Scoped 服务到 Singleton 或后台任务
解决方案：

使用 IServiceScopeFactory.CreateScope() 在后台任务中创建服务实例，使用 using 创建临时作用域

教训：异步任务和后台队列要注意服务生命周期

三、技术总结

后端

技术	用途	说明
ASP.NET Core 8	Web API 框架	提供控制器、路由、JWT 授权、文件上传接口
Entity Framework Core	数据访问	与 SQL Server 对接，实现账户、文件映射、充值记录 CRUD
SQL Server	数据库	存储账户、文件映射、充值记录、日志
IOptionsMonitor / Configuration	配置管理	管理 Python 路径、支付配置、速率限制等

身份认证与安全

技术	用途	说明
JWT (JSON Web Token)	用户认证	保护上传/下载接口，确保每个请求有用户身份
Authorization Attributes	权限控制	[Authorize] 控制 API 权限
Rate Limiting Middleware	频率控制	限制请求频率，保护接口安全

文件处理

技术	用途	说明
Python 3.12及相关的库：pdf2docx	PDF → Word 转换	使用自定义脚本 pdf_to_word.py 处理文件转换
ConcurrentQueue + SemaphoreSlim	队列处理	实现后台单任务队列，避免多用户同时处理冲突
IWebHostEnvironment	文件路径管理	管理上传目录 /uploads 和静态文件访问

支付与充值系统

技术	用途	说明
易支付（YiPay）	支付通道	接收用户支付，支持异步通知
TopUpService / Strategy 模式	充值管理	控制用户使用次数、减少重复逻辑
日志文件	调试与监控	logs/debug.log 记录支付和文件操作状态

开发工具与环境

技术	用途	说明
Visual Studio 2022 / VS Code	开发	后端开发、调试、迁移数据库
IIS / 云服务器	部署	托管 ASP.NET Core + Python 环境
Swagger	API 文档	方便测试上传、下载接口和 JWT 调用

扩展与中间件

技术	用途	说明
FileCleanupService / RateLimitCleanupService	后台服务	清理过期文件和过期速率限制记录
RequestDurationMiddleware	性能监控	记录每次请求耗时，便于优化

部署注意事项：

1. 需要手动创建 logs、uploads 文件夹，并在安全属性中为 IIS 用户设置控制权限；

同时还需要手动复制 pdf_to_word.py 文件到项目目录

配置文件中：

YiPayConfig 需要自己去找一个易支付平台对接
Jwt 自己生成一个不低于32位的key
PythonConfig 注意本地环境和服务器环境 python 解释器的位置
MailSendServiceConfig 需要自己去QQ邮箱申请 SMTP
1. 给应用池用户访问 Python 权限
  假设 Python 安装路径：

C:\Users\Administrator\AppData\Local\Programs\Python\Python312

在 PowerShell（以管理员身份）执行：

$pythonPath="C:\Users\Administrator\AppData\Local\Programs\Python\Python312"$acl=Get-Acl$pythonPath$permission="IIS AppPool\填应用程序池名称","ReadAndExecute","ContainerInherit,ObjectInherit","None","Allow"$rule=New-ObjectSystem.Security.AccessControl.FileSystemAccessRule$permission$acl.AddAccessRule($rule)Set-Acl$pythonPath$acl

这会给 IIS 应用池身份用户读取和执行 Python 的权限。

1. 给 uploads 文件夹权限
  假设 uploads 文件夹在：

C:\inetpub\PDFtoWord\uploads

同样用 PowerShell 给应用池写入权限：

$uploadsPath="C:\inetpub\PDFtoWord\uploads"$acl=Get-Acl$uploadsPath$permission="IIS AppPool\填应用程序池名称","Modify","ContainerInherit,ObjectInherit","None","Allow"$rule=New-ObjectSystem.Security.AccessControl.FileSystemAccessRule$permission$acl.AddAccessRule($rule)Set-Acl$uploadsPath$acl