【标签】学习工作
【学习工作赛道】PaperForge 论文工坊——配格式按章填内容，一键生成 Word 论文
【正文】 至少包含以下 4 个部分，可以增加额外的部分（比如自我介绍、经验总结、踩坑复盘等）
0. 先和大家打个招呼吧 
-
你是谁： 一名正面临期末周、要交一堆课程报告和论文的普通大学生。
-
你是怎么用 TRAE 把 Demo 做出来的： 项目的起因非常直接：本学期需要提交多篇课程论文，不同课程对格式要求各不相同，在调整Word格式的过程中耗费了大量时间——标题层级编号容易错乱、目录页码需要手动更新、参考文献格式需要逐条调整、中文斜体在Word中渲染效果不理想，这些重复性的机械劳动严重影响了写作效率。在一次调整格式到深夜之后，我产生了开发一款自动化论文排版工具的想法。
当时我正在使用TRAE，便尝试将这个模糊的想法描述给它："我希望开发一款论文排版工具，用户按章节填写内容、配置好格式参数后，能够直接生成符合规范要求的Word文档。"我原本预期需要自己完成大量编码工作，没想到TRAE立刻开始协助我逐步搭建项目。
整个开发过程的体验类似于与一位技术能力全面、沟通高效的伙伴协作。我只需要用自然语言描述需求，例如"左侧需要支持拖拽排序的章节目录树"、“内联格式采用简单的标记语法而非复杂的Markdown，使用B{粗体}、I{斜体}这类直观标记，方便打字时直接输入”、“生成Word时需要自动刷新目录域，避免用户手动按F9更新”、“窗口关闭时必须彻底终止后台进程，避免残留进程占用端口”，TRAE都能够准确理解需求，并直接产出可用的代码实现。
开发过程中有两个环节令我印象深刻：其一是WPS COM自动化功能的实现。我此前从未接触过Windows COM接口开发，原本预计需要花费数天时间查阅文档才能完成，但当我提出"需要自动调用WPS打开文档、刷新目录、重刷中文斜体后保存关闭"的需求后，TRAE直接输出了包含异常处理、WPS启动等待、超时判断在内的完整实现代码，首次运行即成功，大大超出了我的预期。
其二是Electron应用打包环节，过程中遇到了一系列典型问题：后端进程未彻底终止导致端口占用、浏览器缓存导致静态资源更新不生效、打包后app.asar文件被占用无法覆盖安装、覆盖安装后仍运行旧版本等。每次遇到问题，我只需要将错误现象或日志提供给TRAE，它就能够协助逐步定位原因，从配置缓存控制头、实现进程树强制清理逻辑，到编写NSIS自定义安装卸载脚本，所有问题都得到了妥善解决。如果依靠我个人查阅资料排查，这些问题每个都可能耗费一到两天时间。
整个项目利用课余时间断断续续开发了两三周。项目中约90%的代码由TRAE生成，我的主要工作是梳理产品需求、验证功能效果、反馈问题并提出调整方向。如果没有TRAE的协助，这个想法可能至今仍停留在构思阶段，很难在如此短的时间内落地为可实际使用的版本。
1. Demo 简介
-
是什么：一款运行于Windows平台的本地桌面论文排版工具，基于Electron打包，下载安装后即可直接使用，无需联网，无需额外配置运行环境。
-
面向谁：需要撰写课程论文、毕业论文、期刊论文的本科生与研究生，尤其是受Word格式调整困扰、希望将精力集中于内容创作而非格式排版的用户。
-
主要功能：
- 格式预设配置，一次调整整篇复用：通过格式配置面板，可以统一设置页面边距、正文中英文字体与字号行距、各级标题编号方式（支持"第X章"或阿拉伯数字多级编号）、页眉页脚内容与页码位置、目录显示层级、参考文献排版格式等所有常见格式参数。配置完成后可保存为个人预设，新建论文项目时直接选用，无需重复调整。
- **章节式块编辑，简单标记控制格式：**左侧为可拖拽排序的章节目录树，支持灵活调整论文结构；中间编辑区采用块式编辑，支持段落、表格、图片、公式等多种内容块。段落内通过简单标记即可控制格式：B{文字}表示粗体，I{文字}表示斜体，E{文字}表示着重号，x^{2}表示上标，H_{2}O表示下标，CIT{1}表示参考文献上标引用，也可通过工具栏按钮一键插入对应标记。支持LaTeX公式渲染，图表自动编号，交叉引用随编号变更自动更新。编辑区下方提供实时排版预览，所见即所得。
- **一键生成Word，自动处理目录与中文斜体：**内容编辑完成后，点击「生成Word」按钮，软件将自动调用本机安装的WPS，在后台完成文档打开、域刷新（确保目录页码准确）、中文斜体重绘（解决Word默认中文字体斜体渲染问题）、保存关闭等一系列操作，约30秒即可生成排版规范的docx文档。文件名自动附加时间戳，避免多次生成覆盖旧文件。参考文献管理支持直接粘贴知网格式文本自动解析、BibTeX导入、DOI拉取题录，自动按照GB/T 7714-2015标准排版。
所有项目数据均存储于用户本地计算机，无需注册登录，无需联网使用，论文内容不会上传至任何服务器。软件内置12章完整使用手册，新用户可以快速上手。
2. Demo 创作思路
-
灵感来源：项目直接来源于个人写论文时的真实痛点。期末季需要完成多篇课程论文，不同授课教师对格式要求各不相同，在Word格式调整上花费了大量非生产性时间，深刻感受到论文排版过程中机械重复劳动的低效与繁琐，由此萌生了开发一款自动化排版工具的想法。
-
想解决的问题：
-
论文写作过程中，大量时间消耗在无技术含量的格式调整机械劳动上，而非内容创作本身，据个人体验格式调整往往占据80%的论文写作时间
-
Word的样式系统、域代码、多级列表等功能对普通用户而言学习门槛较高，多数用户只会手动选中文字修改格式，易出现编号错乱、格式不一致等问题
-
中文斜体、着重号、参考文献上标等格式需要手动逐条设置，篇幅较长的论文操作繁琐且易遗漏
-
参考文献格式调整工作量大，不同学校、不同期刊要求各异，手动调整效率极低
每次撰写新论文都需要重新调整所有格式参数，已有配置无法复用，存在大量重复劳动
-
-
为什么做这个方向：目前市面上虽有不少写作工具，但普遍存在几个问题：部分云端工具存在论文内容泄密风险；部分工具功能过于复杂，引入了过多与论文写作无关的功能，学习成本较高；还有部分工具导出Word后格式仍存在问题，最终仍需手动调整。
我所希望打造的是一款轻量、本地、专注解决论文排版这一核心问题的工具：用户不需要学习新的复杂语法，不需要改变写作习惯，只需要按章节组织内容、配置一次格式参数，即可一键生成可直接提交的Word文档。同时这也是我个人真实需要使用的工具，项目完成后可以直接解决自己写论文的格式问题，并非为参赛而设计的概念性项目。
技术栈选择上，前端采用React + TypeScript + Vite + Tailwind CSS + shadcn/ui，保证界面简洁现代、交互流畅；后端采用Python + FastAPI，基于成熟的python-docx库处理Word文档生成；最外层通过Electron打包为Windows桌面应用，用户下载安装后开箱即用，无需自行配置Python或Node.js运行环境。
3. Demo 体验地址
-
github release地址：Release v1.3.6-demo提交 · wmlqq/PaperForgeWork
-
豆包云盘下载地址：PaperForgeWork-Setup-1.3.6.exe｜豆包 云盘
-
demo演示视频地址：幻想
瓣的抖音 - 抖音
4. TRAE 实践过程
-
用 TRAE 完成 Demo 开发的完整流程：整个项目从零到一完全在TRAE中完成，从项目初始化、前端界面开发、后端逻辑实现、问题调试到最终打包发布，全程采用对话式开发模式，开发过程中基本无需额外查阅技术文档。主要开发流程如下：
-
项目初始化阶段：项目启动时，我从TRAE solo CN中明确描述了整体技术方案与功能需求——开发一款本地运行的论文排版工具，开始时打算完成的是BS模式，在第一个demo搭建起来后注意到部署起来非常麻烦（因为COM不能安装到Linux上，因此服务器不能完成目录刷新），同时有些论文有需要保密的特性，因此改成了本地桌面应用开发。技术栈选用Electron + React + FastAPI，前端UI组件库使用shadcn/ui。TRAE直接协助搭建了完整的项目骨架，包括Vite前端配置、FastAPI后端入口、Electron主进程代码、前后端基础通信逻辑，项目初始版本可以直接运行看到界面效果，无需从零开始手动配置各类工程文件。
-
数据结构设计：我向TRAE描述了论文数据的组成结构：包含元数据、中英文摘要、多个层级章节、参考文献列表、致谢等部分；每个章节包含标题与若干内容块；内容块分为段落、表格、图片、公式等类型；格式配置涵盖页面设置、正文样式、各级标题样式、页眉页脚、目录、参考文献等分类。TRAE协助设计了完整的JSON数据结构，并实现了项目打开、保存、自动保存的相关逻辑。
-
编辑器功能开发：这是项目中工作量最大的模块。我描述了期望的交互效果：左侧为可拖拽排序的章节树，支持章节的新增、删除、重命名与顺序调整；中间为块式编辑区，支持不同类型内容块的切换；段落内通过简单标记语法解析格式，编辑过程中下方同步显示排版预览。TRAE逐步实现了以下核心功能：
-
基于正则表达式的内联文本解析器，将B{}、I{}、E{}、^{}、_{}、CIT{}等标记转换为对应样式渲染
-
块编辑器的新增、删除、排序、类型切换逻辑
-
章节树的拖拽排序与重命名功能
-
工具栏一键插入格式标记功能
-
编辑区与预览区同步渲染的实时预览功能
-
-
格式配置面板开发：我提出需要一个侧边配置面板，通过标签页分类展示不同类别的格式设置项，修改配置后可以实时预览效果，支持将配置保存为预设、支持预设的导出与JSON导入。TRAE生成了完整的配置面板组件，为不同类型的配置项匹配了对应的交互控件（字体下拉选择、行距滑块、边距输入框等），并实现了配置修改后的实时预览效果。
-
DOCX生成核心逻辑开发：这是项目最核心的部分，也是遇到问题最多的环节。最初基于python-docx生成的文档中，中文斜体无法正常显示，原因在于统一设置中文字体时会覆盖已设置的italic属性。我将生成的问题文档提供给TRAE后，它逐步排查定位问题：先是调整了CSS字体加载配置，随后修正了后端
_apply_fonts_to_all_runs函数中未保留italic属性的问题，最终提出了通过WPS COM接口在后台自动打开文档重刷斜体并刷新目录域的方案，一次性解决了中文斜体渲染和目录页码自动更新两个核心问题。 -
Electron打包与安装配置：这一环节遇到了一系列典型的Electron应用问题：开发过程中后端进程未彻底终止导致端口占用，应用二次启动失败；浏览器缓存导致前端静态资源更新后仍加载旧版本CSS；打包过程中app.asar文件被占用无法生成安装包；覆盖安装后应用仍运行旧版本后端进程。每次遇到问题，我将错误现象或日志提供给TRAE，它协助逐一解决：实现了统一的shutdown函数，窗口关闭时通过SIGKILL强制终止整个进程树，并增加端口占用检查逻辑；为FastAPI添加了no-cache中间件，禁止浏览器缓存静态资源；electron-builder配置中固定了appId与guid，确保覆盖安装时版本检测正常工作；编写了NSIS自定义安装卸载脚本，卸载前自动结束运行进程，卸载后清理APPDATA中的残留数据。
-
功能打磨与发布：后续逐步补充了内置使用手册、示例项目、参考文献BibTeX/DOI导入、文件名自动附加时间戳等功能，修复了各类使用中发现的小问题，最终通过electron-builder打包为NSIS安装版与便携版两个分发版本。
整个开发过程中，我的核心工作是梳理产品需求、用自然语言描述功能预期、验证功能效果、反馈问题并提出调整方向。如果完全依靠个人查阅资料独立开发，预估需要两到三个月时间才能完成当前版本，且涉及COM自动化、NSIS脚本等我此前完全没有接触过的技术领域，很可能会成为开发瓶颈。在TRAE的协助下，我可以将精力集中于产品逻辑本身，无需纠结于具体技术实现细节，最终利用两三周的课余时间即完成了可实际使用的版本。
-
-
开发关键步骤截图：
-
关键任务对话的 Session ID：3252823500259875:d2d13107ec749b94b561a9778e1ad1e7_6a3aa722774a965b7c37a120.6a3cda81369c0182378acd90.6a3cda81369c0182378acd8e:TRAE Work CN.0.1.30.no_sid.no_ppe.T(2026/6/25 15:36:33)3252823500259875:2b4bef7da35d1fd3c9fbaf3652e7d0eb_6a338c18cf5c2d39837e86e5.6a338c18cf5c2d39837e86e8.6a338c18cf5c2d39837e86e6:TRAE Work CN.0.1.30.no_sid.no_ppe.T(2026/6/18 14:11:36)3252823500259875:b0268ff2f2b153fccd844807f8244439_6a338c18cf5c2d39837e86e5.6a34c2b9d82636ec908a1bb8.6a34c2b9d82636ec908a1bb6:TRAE Work CN.0.1.30.no_sid.no_ppe.T(2026/6/19 12:16:58)
5. 对应的报名审核通过的帖子链接
【学习工作赛道】PaperForge 论文工坊——配格式按章填内容，一键生成 Word 论文 - TRAE AI 创造力大赛 / 【大赛报名专区】 - TRAE 官方中文社区