系统升级

本系统不联网, 升级靠手动下载新安装包覆盖安装, 数据不会动, 全程不到五分钟。

本系统不内置在线更新

很多软件都有"检查更新"按钮, 这个系统没有, 是故意不做的。原因只有一条: 数据安全。

村里管理的是村民身份证、低保金额、党员档案这类信息, 一旦软件能自动联网拉新版本, 就等于在每台电脑上开了一个对外的口子。这个口子哪天被人利用, 数据就出问题。所以从设计上, 这个系统就不连外网, 也不会偷偷下载任何东西。

代价就是升级要村干部自己动手, 但步骤很简单, 下面一步步说。

检查新版本

官网首页有一个"更新日志"区块, 按时间线列出每个版本发布了什么、什么时候发的, 每个版本条目旁边都带独立的下载链接。

把官网上最新的版本号, 和你电脑上当前安装的版本号(怎么看见下面"查看当前版本号"一节)对一下, 不一样就说明可以升级。

建议每个季度看一次, 没必要天天看。如果系统用着没毛病, 也不一定非升级。

下载新版本安装包

在官网"下载"页找到对应文件, 一般叫 乡村管理系统-Setup-vX.X.X.exe, 大小一百多兆。下载到本机的"下载"文件夹就行。

下载完, 右键文件 → 属性, 看看文件大小和官网写的对不对得上。对得上再装, 防止下到一半网断了。

升级前的备份

这一步不能省。虽然覆盖安装不会动数据, 但万一升级中途断电、新版本和你这台电脑不兼容, 有备份就能退回去。

1. 打开当前系统用 admin 登录。
2. 进入备份页左侧菜单点"备份恢复"。
3. 点"立即备份"按钮, 等进度条走完。
4. 导出到 U 盘找到刚生成的那一条, 点这一行的"下载"按钮存到电脑, 再拷贝一份到 U 盘。文件名建议改成 升级前-2026-06-20.db 这样便于识别。

运行新安装包

备份做完, 关掉正在运行的乡村管理系统(右下角任务栏图标, 右键点"退出系统")。然后:

1. 双击下载的安装包就是刚才那个 Setup-vX.X.X.exe。
2. Windows 提示"不是受信任的发布者"点"更多信息" → "仍要运行"。这是因为个人开发者没买代码签名证书, 不代表安装包有问题, 安装包本身经过校验。
3. 安装路径保持默认默认装在 D:\乡村管理系统\(D 盘不存在则回落 C:\Program Files\乡村管理系统\), 不要改! 改了会找不到原来的数据。一路点"下一步"到底。
4. 安装完成勾上"立即启动", 点"完成"。

新版本会自动启动。如果这次升级正好带了数据库结构变化, 第一次打开可能比平时慢几秒(见下面"升级后的 schema 自动迁移"一节), 属于正常现象。

覆盖安装数据是否会丢

不会。说清楚为什么不会丢:

这个系统把所有数据存在一个 SQLite 数据库文件里, 路径跟着安装目录走: 默认在 D:\乡村管理系统\data\data.db(没 D 盘则在 %APPDATA%\cn.village.admin\data\data.db)。安装包只替换程序文件(.exe、.dll 这些), 不碰 data 文件夹里的数据库; 另外像 storage.json 这种轻量配置仍然放在 %APPDATA%\cn.village.admin\ 下, 升级也不会动。

所以覆盖安装之后, 打开系统看到的还是原来那些村民、党员、低保户、待办、模板、用户、视图, 一条都不少。

包括这些也都在:

升级后的 schema 自动迁移

新版本如果给数据库加了新表或新字段(比如某个新功能要存东西), 第一次启动时会自动跑迁移脚本。表现就是启动界面(数据连接 → 权限校验 → 模块加载 → 缓存准备那条进度条)停留得比平时久一点, 数据量越大越明显。

迁移跑完自动进入系统, 不用额外操作。功能是新的就说明迁移成功了; 具体这次升级新增/修复了什么, 看官网首页"更新日志"区块对应版本的条目。

升级失败的回滚

极少数情况, 比如新版本和你这台老电脑不兼容, 或者升级中途断电导致程序打不开, 需要退回旧版本。这里有一个很容易踩的坑, 务必先看完再动手: 数据库的结构变更(专业说法叫"schema 迁移")只能往前走, 不能倒退。新版本第一次启动时, 已经把数据库结构改成了新版本认识的样子; 如果只是把旧版安装包重新装一遍、但数据库还是新版本迁移过的那份, 旧版程序不认识这个新结构, 轻则打不开、报错, 重则把数据写坏, 没法修复。

正确的回滚顺序:

1. 先给当前状态留一条后路如果新版本还能打开, 立刻进"备份恢复"页点一次"立即备份", 把回滚前的现状存一份, 万一后来发现其实不用回滚, 还能拿回来。如果新版本已经打不开了, 直接用文件资源管理器手动复制一份当前的 data.db(路径见下面"覆盖安装数据是否会丢"一节), 改个名字比如 回滚前-2026-06-20.db 存好, 千万别删。
2. 找到升级前的数据库备份找到你在"升级前的备份"步骤里存的那份 升级前-YYYY-MM-DD.db(U 盘或另一台电脑上)。这一步是必须的——没有这份备份就先别急着装旧版本, 先想办法把它找回来; 没有对应旧版本的数据库, 装完旧版程序大概率打不开, 或者看到损坏、不完整的数据。
3. 卸载或覆盖装旧版程序从官网"更新日志"区块找到你之前用的那个版本号, 点它旁边的下载链接下载旧版安装包, 双击运行, 跟正常升级一样覆盖安装即可, 不需要先卸载。这一步只换程序文件, 不会自动处理数据库。
4. 关键一步: 用旧版备份换回数据库先退出刚装好的旧版程序(右下角任务栏图标, 右键"退出系统"), 进"备份恢复"页顶部"数据存储位置"那一行看清数据文件夹路径, 用文件资源管理器打开这个路径。把当前的 data.db 改名保留一份(不要直接删, 万一还得用), 再把第 2 步找到的 升级前-YYYY-MM-DD.db 复制进来并改名为 data.db, 然后重新打开旧版程序。
5. 确认数据打开系统, 随便点几个模块, 看看记录数、字段是不是旧版本认识的那个样子, 没有报错、没有缺字段。

查看当前版本号

系统里目前没有专门的"关于"页面显示版本号, 最直接的两个办法:

1. 看装机用的安装包文件名比如 乡村管理系统_1.6.0_x64-setup.exe, 中间那串数字就是版本号。下载文件夹里如果还留着安装包, 直接看文件名。
2. 在 Windows 里查已安装的应用按 Win 键搜"已安装的应用"(老版本 Windows 是"控制面板 → 程序和功能"), 找到"乡村管理系统"这一行, "版本"那一列显示的就是当前安装版本。

截图给技术支持的时候, 把第 2 种方法的截图发过去最清楚。

历史版本

官网首页"更新日志"区块本身就是按时间线列出的历史版本, 每条记录旁边都带独立的下载链接, 往下滚就能看到更早的版本。

如果需要的版本在更新日志列表里已经找不到了, 通过页面顶部的"反馈"入口说明情况。

团队多台电脑升级建议

村里如果用了局域网部署, 主机一台、其他电脑通过浏览器访问主机(详见局域网部署), 升级的顺序很重要:

1. 先升级主机主机是存数据的那台。先在主机上备份, 再装新版本, 启动确认数据正常。
2. 主机跑半天到一天观察有没有问题。期间其他电脑照常用浏览器访问主机, 不受影响。
3. 没问题再升级桌面客户端如果其他电脑也装了桌面客户端(而不只是浏览器访问), 一台一台装新版本, 不要全村同时升。

不建议团队所有人同时升级, 万一新版本有问题, 你连一个能用的旧版本都没了。

changelog 在哪里看

更新日志(changelog)就在官网首页的"更新日志"区块里, 也可以点导航栏的"更新日志"直接跳过去, 时间线形式, 从最新版本往下排:

每条更新前面有个小符号: + 代表新增功能, · 代表优化或修复。升级前花两分钟扫一眼当前版本到最新版本之间的条目, 心里有数, 升完了知道该试哪些新东西, 也知道哪些老问题应该已经修好了。