【AI台账助手】安装部署教程:一个 exe文件加两个文件夹,u盘拷走就能用,迎检资料好帮手

前面两篇文章写了AI台账助手的功能和使用示例：

台账助手：基层迎检资料秒级查到，上级下发的表格文档，一键批量生成报表上报

【上午发通知下午交】AI台账助手：花样翻新的表，让 AI 替你填

今天这篇写怎么部署这个系统，支持windows和linux系统。

给基层单位部署一套系统，最怕听到一句话：“在我电脑上是好的，拷过去就跑不起来了”。

缺运行环境、缺配置文件、缺依赖库——三样凑齐一样都跑不起来。这次更新的目标很简单：一个 exe 加两个文件夹，拷到哪台电脑都能直接用，包括最费劲的 AI 部分，也做成两套预设后台可一键切换。

因为是go语言编译的，因此支持windows、linux和mac平台，当配置文件不存在时，会自动创建默认配置。

1.部署包里装了什么

以前部署要在目标电脑上装 PHP 环境、放模板文件、改配置路径，少一步就报错。现在整个部署包只有三样东西：

主程序把后台管理页面、页面样式、默认配置模板、示例 Word 模板全部编译进了 exe 二进制文件——首次双击启动时自动生成一份配置文件，不需要写任何一行配置。

旁边两个文件夹是渲染 Word 模板用的 PHP 运行时和填充脚本，免安装、整目录拷，程序会自动找到它们。

拷到 U 盘、发微信传给别人、换一台新电脑，都是同一个动作：把这几个文件放过去，双击。

2.windows电脑三步部署，不用装任何环境

全程只有一个前置条件：目标电脑是 Windows（用 Linux 服务器的，看下一节宝塔部署）。启动后自动打开管理后台，上传 Excel、Word 或 PDF 台账就能入库检索、按模板批量生成报告。

如果要给整个办公室共用，不必每台电脑都装——在一台机器上把监听地址改成 :8090，同事在浏览器输入「这台机器的IP:8090」就能访问同一个后台。

3.Linux 服务器（宝塔面板）部署方法

机房或云服务器用 Linux + 宝塔面板的，同样不用装环境，先新建站点，输入域名或ip:

然后按五步走：

1. 上传源码：把 office_work二进制文件 和 php/ 文件夹上传到服务器站点目录下，给 office_work 加可执行权限。程序是静态编译的，不挑系统库版本；php/ 里是 Word 渲染脚本和依赖，整目录拷即可。旁边那个 winphp/ 是 Windows 专用的 PHP 运行时，Linux 上用不到，不用传。

2. PHP环境检查：宝塔服务器一般已装 PHP，程序会自动到 /www/server/php/ 下找版本最高的一个；也可以在宝塔面板设置默认php版本：

3. 补扩展：Word 渲染需要 zip、xml、mbstring 三个扩展，缺哪个就去宝塔「软件商店 → PHP → 安装扩展」补上。宝塔面板默认就有不需要单独安装。

4. nginx反代端口：config.yaml 里把监听地址改成 :8090，再到宝塔站点管理，反向代理添加。

5. 常驻运行：用宝塔「进程守护管理器」或 systemd 托管 exe，崩了自动拉起、开机自启。

AI 部分在 Linux 上与 Windows 完全一样，本机 Ollama 或云端 Key，见下一节。

4.AI 配置：本机还是云端，你说了算

系统最核心的能力是「AI 抽取」：从台账原文里自动抽出户主姓名、家庭人口、务工地点这些字段，再按 Word 模板批量生成报告。这步靠大模型完成，部署时只需要回答一个问题——用本机模型还是云端模型：

本机模型（Ollama + gemma4:12b）跑在自已电脑上，数据全程不出机，适合含个人信息、涉密敏感的台账；代价是速度慢一些，一台中等配置的电脑大约一分钟能出一户。各本机小模型在无N卡的电脑上，运行测试效果如下图：

云端模型（DeepSeek）约一秒一户，批量几百户很快跑完，但需要在设置页填 API Key，数据会上云。

两套参数各自保存，后台「系统设置」页单选切换，改完点一下「测试连接」就知道通没通。

有一点是刻意设计的：程序不会在一边挂掉时自动切到另一边——帮扶监测这类数据要不要出网，必须是人的决定，不能交给程序自作主张。

5.两个可能遇到的坎

扫描版 PDF 读不出字：纯图片扫描件需要旁边跑一个 OCR 识别容器（文本型 PDF 不受影响）。这属于可选件，普通 Word、Excel 台账完全用不到。如果是图片扫描件，可以共用原来我们的七合一镜像：七合一镜像发布，新增身份证照片自动处理，转为PDF文件直接打印

用云端模型报连接失败：先看 API Key 是否填对，再检查本机出口 IP 是否已加进服务商白名单——大多数「连不上」都是白名单没配。

至于日常使用：上传台账、建检索、配模板、批量出报告，全在浏览器里点点选选，不再展开。

部署这件事，从「装环境」变成「拷文件」，是这次更新最大的变化。

目前系统已用于基层乡村振兴、各村委的台账整理迎检等工作中，正在不断完善和进化，使用过程中如有什么问题请直接留言。