格式转换神器 · 交付包说明

本目录是基于两份需求文档（《需求.txt》《技术和难点.txt》）落地的可运行产品与商业化分析。

交付物一览

文件 / 目录	说明	是否能离线单用
格式转换神器.html	单文件离线转换工具：图片 / 数据 / 文本 / 标记 / 颜色 / 单位等纯前端互转，双击即用	✅ 纯浏览器，文件不离开本机
pdf-word/	核心产品：PDF ⇄ Word 互转，排版优先	✅ 调本机引擎，本地运行
需求.txt 技术和难点.txt	原始需求与技术拆解（14 章产品 + 7 章技术）	—
商业化优化排查.md	对照 12 章商业化框架的落地/优先级排查报告	—

核心产品：pdf-word/

把 PDF 和 Word 互转作为最高优先级，排版还原放第一位。

• Word → PDF：调用本机 MS Word 原生导出，排版零损失。
• PDF → Word：用 pdf2docx 做版面分析还原（表格 / 段落 / 图文混排保留）。
• 文件全程本地处理，不上传任何服务器。

两种用法（推荐第①种，零浏览器零端口）

① 拖拽法（最省心）

• 打开 pdf-word/ 文件夹
• 把 .pdf 或 .doc/.docx 直接拖到 convert.bat 上
• 自动转换，结果叫 原名_out.pdf / 原名_out.docx，放在源文件旁并弹出结果文件夹

② 网页法（仅在 start.bat 开的窗口里用）

• 双击 pdf-word/start.bat → 自动开浏览器到 http://127.0.0.1:8777/
• 在那个标签页里拖文件转换
• 不要从文件管理器双击 index.html，也不要在预览面板里用（会 Failed to fetch）

目录内容

• converter.py — 本地转换服务 + 商业化护栏（魔数校验 / 免费额度 / 大小限制 / 授权 / 缓存去重）
• index.html — 网页界面（历史记录 / 预估时间 / 升级提示 / 隐私透明）
• convert.bat + convert_cli.py — 拖拽式本地转换
• start.bat — 一键启动网页版
• make_license.py — 生成授权解锁无限额度 / 大文件（演示用）
• config.json — 运营可调的免费额度等参数
• _ctest.mjs — 端到端回归测试（9 项断言全通过）

首次使用

网页版首次需安装依赖（已装好，秒开）。拖拽版无需任何安装，直接拖文件即可。

商业化边界（诚实说明）

免费额度 / 大小限制 / 授权在本地版是「善意限制」，用户改配置即可绕过——这是本地产品的天然属性。 真实收入、支付订阅、API、企业版、风控、监控、SEO、数据埋点必须上云（账号 + 支付 + 服务端），本地版做不到。 config.json、/status、X-Warning、_ctest.mjs 等已留好接口，上云时可复用。

详见 商业化优化排查.md。