乡村管理系统 DOCS
文档 常见问题

常见问题

把村干部最常问的问题集中在一页, 看完这页基本不用再到处搜。

1. 是免费的吗 / 后续会收费吗?

本系统永久免费, 没有激活码, 没有授权年限, 没有"基础版/旗舰版"区分。所有功能(党费、证明、扫码填写、大屏、备份)都在安装包里, 装完即用。

后续不会改成付费订阅。作者也不会通过软件推销保险、贷款、办公耗材。如果遇到自称"官方客服"要收激活费的, 都是骗子。

说明

软件只在本机运行, 不联网验证授权。把电脑断网也能正常使用, 这一点和那些 SaaS 系统不一样。

2. 数据安全吗 / 会不会上传到云?

所有数据存在主机本地的 SQLite 数据库文件里, 软件不向任何外网服务器发送数据, 不收集村民信息, 不做行为统计。

安全建议:

  1. 主机加开机密码这台电脑能开机的人就能开软件, 物理安全是第一道关。
  2. 首次登录改 admin 密码默认 admin/admin123 全网都知道, 必须改。
  3. 普通用户分角色不要全村干部都用 admin 账号, 在用户管理里给每人单建账号。
  4. 定期把备份拷到 U 盘系统每天会自动备份一份(保留最近 30 份), 这一步不用手动开、也没有开关能关掉; 你只需要定期把生成的备份文件下载到 U 盘或另一台电脑, 别只留在本机。

3. 需要联网吗?

不需要。安装后断网也能登录、填表、打印证明、看大屏。只有一种情况要联网: 同村其他干部要用浏览器连主机时, 大家得在同一个局域网(同一个 Wi-Fi 或同一个交换机), 不需要外网。

光在同一个局域网还不够

系统默认是"单机模式": 只认本机请求, 别的电脑就算在同一个 Wi-Fi 下也连不上, 跟防火墙、网线都没关系。要让其他电脑访问, 必须先到"系统设置"把"启用账号密码登录"打开(开启后监听地址才会从 127.0.0.1 切到 0.0.0.0), 固定端口是 8848。完整步骤见局域网部署

4. 支持多少人同时使用?

SQLite 在 WAL 模式下读写互不阻塞。实际经验(前提是已按上一条开启了账号密码登录):

同时在线人数体验
1 - 5 人流畅, 无感
6 - 15 人正常, 大批量导入时会短暂等待
16 - 30 人读没问题, 同时大量写入会排队
30 人以上不推荐, 这种规模建议用专业服务器数据库

5. 多大的村适合?

从 100 户到 5000 户都适合, 实际跑过 8000 多条村民记录的村, 列表翻页毫秒级。区分如下:

规模建议
100 - 500 户一台办公电脑当主机, 几个干部用浏览器连, 完全够用
500 - 2000 户主机用固态硬盘, 内存 8G 以上, 体验最好
2000 - 5000 户注意列表加筛选条件, 别一次拉全村, 详见第 14 条

6. 忘记 admin 密码怎么办?

本地系统没有"找回密码"短信/邮件, 但内置了一个本机应急逃生口, 不用联系作者、不用改数据库:

  1. 关闭本应用包含任务栏托盘里的后台进程都要退出。
  2. 找到数据目录常见位置是 D:\乡村管理系统\data, 找不到就参考第 7 条。
  3. 新建标记文件在数据目录顶层新建一个空文件, 命名为 RESET-ADMIN-PASSWORD(不加后缀, 或者新建文本文档后把 .txt 去掉)。
  4. 重新打开应用系统检测到这个文件后, 会把所有 admin 角色账号的密码统一重置为临时密码 reset123, 并删掉标记文件(不会重复触发)。
  5. 用你的管理员账号登录账号还是你原来那个用户名(新装系统默认是 admin), 密码填 reset123, 系统会强制要求立即修改新密码。

登录页的"忘记密码?"链接里也有这几步说明, 现场想不起流程时可以直接点开看。

安全提醒

这个逃生口只要能碰到数据目录的文件系统就能触发, 所以数据目录本身的电脑/账号权限要看好。触发后系统会写一条操作日志留痕, 事后能查到是谁在什么时候重置过。

7. 数据库文件在哪里?

默认路径是 D:\乡村管理系统\data\data.db(程序默认装在 D:\乡村管理系统\, 数据就在安装目录下的 data\ 子目录里); 如果电脑没有 D 盘, 安装时会自动回落到 C:\Program Files\乡村管理系统\, 数据路径相应变成 %APPDATA%\cn.village.admin\data\data.db(因为 Program Files 默认不可写)。也可在 系统设置 页面"数据目录"那一栏看到, 点旁边的"打开文件夹"会直接弹出资源管理器。

另外, 记录"上次打开的数据目录"的 storage.json 等配置文件始终放在 %APPDATA%\cn.village.admin\ 下, 不随安装位置变化。

核心文件是 data.db。还有 data.db-waldata.db-shm 是 SQLite 的临时文件, 备份时三个一起拷才完整, 或者关掉软件后只拷 data.db 也行。

8. 怎么从旧 Excel 迁过来?

  1. 整理表头把 Excel 第一行整理成中文表头, 比如"姓名/身份证号/电话/户号"。
  2. 建模块在"模块管理"里新建模块(如"村民花名册"), 按 Excel 表头依次加字段, 字段类型选对(身份证选身份证号类型, 电话选电话号码类型)。
  3. 导入进入这个模块, 点右上角"导入", 选 Excel 文件, 系统自动匹配同名列, 不匹配的手动拖。
  4. 选策略第一次选"仅新增(首次导入)", 后面更新选"增量更新(同步刷新)"(具体几种策略怎么选见第 8.1 条)。
  5. 选匹配字段用身份证号判重最稳, 选身份证号作为匹配字段。

8.1 导入的四种策略(仅新增/跳过重复/增量更新/完全替换)该选哪个?

模块列表页点"导入"、选完 Excel 后会看到 4 个单选项, 按场景选:

策略行为什么时候用
仅新增(首次导入)不去重, 撞到"不允许重复"字段的行直接报错模块里还没有数据, 第一次导入
跳过重复(补录)按匹配字段查, 已存在的不动, 只 INSERT 新的手里有一批新增人员, 又怕不小心把老数据重复导进去
增量更新(同步刷新) · 推荐已存在的按匹配字段找到后局部覆盖(Excel 里没提供的字段保留旧值)日常同步更新, 比如每月拿到新一版低保名单
完全替换(慎用)已存在的整条覆盖, Excel 未提供的字段也会被清空确定这份 Excel 就是该记录的最新全量数据时才用

除"仅新增"外, 其余 3 种都要求模块里有至少一个开启了"不允许重复"的字段(比如身份证号)作为匹配字段用来判断"这一行对应哪条已有记录", 没有这样的字段时导入弹窗会提示先去"模块管理"给字段开启该约束。

9. 字段写错了能改类型吗?

能, 但有限制。在"模块管理"打开模块, 点字段右边的编辑, 可以改名字、改是否必填、改下拉选项。改类型有约束:

字段还没有录入过数据时不受限制

只要这个字段目前所有记录里都没填过值, 想换成哪种类型都行, 下面的表格只在已经有数据时才生效。

原类型能改成说明
任意类型(附件除外)文本 / 住址(逐级选择)万能兜底改法, 不校验格式
下拉单选下拉多选原来选的值自动变成多选里的一项, 安全
下拉多选下拉单选前提是没有记录同时选了多个值, 否则会先报错并说明有几条冲突, 得先把这些记录改成单个值
文本 / 住址数字 / 日期 / 身份证号 / 电话号码 / 下拉单选会先校验该字段现有的每一条值是否符合目标格式, 只要有一条不符合(比如含汉字改数字)就整体报错、不生效
派生字段(自动计算)、附件不能改派生字段是公式生成的、附件存的是文件路径, 改了会乱

拿不准就先在"全局回收站"留底, 或者手动备份一次再改。

10. 普通用户能看到的内容怎么控制?

在"角色权限"页, 对每个模块按 8 个动作勾选: 查看 / 新增 / 编辑 / 删除 / 导入 / 导出 / 打印 / 扫码填写, 比简单的只读/可写更细(内置的"党费缴纳"是特例,只有查看/新增-录入/管理 3 个动作)。普通用户登录后, 侧边栏只会出现他被勾上的模块, 没勾的连菜单都看不到。

例如村妇女主任只管"妇联台账", 就只勾这一个模块的查看/新增/编辑; 文书要看全村但不能删, 就把所有模块的查看/新增/编辑勾上, 删除和导入/导出按需留空。

11. 软件提示"不是受信任的发布者"

这是 Windows SmartScreen 的拦截, 不是病毒。处理:

  1. 点"更多信息"在蓝色提示框里点最下面那行小字。
  2. 点"仍要运行"展开后右下角会出现这个按钮, 点一下就能装。

装完一次后, 以后启动不会再提示。如果是企业管控的电脑, 联系 IT 把安装目录加白名单。

如果是 Defender 当病毒拦了, 处理方法见 故障排除 → 现象 12。

12. 软件打不开/打开闪退

按顺序排查:

  1. 看系统版本必须是 Windows 10 或 11 (x64), Win 7 不支持。
  2. 关杀毒重试360、火绒有时会拦 Tauri 应用, 把安装目录加白名单。
  3. 清缓存系统设置 里看的"数据目录"上一层, 删掉 WebView2 缓存子文件夹, 重启软件会自动重建。
  4. 看日志数据目录下有 logs 文件夹, 把最新的 .log 文件发给作者。

13. 提示"数据库被锁定"

常见原因有三个:

原因处理
用户在导入大文件等一两分钟自然解锁
外部工具(SQLite Browser)打开了 data.db关掉那个工具
主机休眠后唤醒卡住重启软件, 别让主机进睡眠

14. 列表很慢/卡住怎么办?

  1. 加筛选不要默认拉全村, 在视图里加"所在小组=三组"这种筛选, 一次只看几百条。
  2. 保存为视图常用筛选保存成视图, 下次一键切换, 不用反复设置。
  3. 减少显示列不需要的列在列设置里隐藏, 列越多渲染越慢。
  4. 定期清理回收站"全局回收站"会自动 7 天清, 觉得慢也可以手动清空。

15. 怎么给作者反馈 BUG?

反馈时把这三样都带上, 作者能少回 5 次消息:

  1. 截图报错弹窗的完整截图, 别裁剪。
  2. 日志数据目录的 logs 文件夹里最新一个 .log
  3. 复现步骤"我点了什么 → 然后点了什么 → 出错"。

联系方式在关于页底部, 微信、邮箱、码云仓库 issue 三选一。

16. 支持苹果 Mac 吗 / 支持 Linux 吗?

当前只发布 Windows 10/11 x64 版本。技术上 Tauri 支持跨平台, 但适配 Mac/Linux 需要额外测试, 暂未发布。乡镇电脑 99% 是 Windows, 优先把这个平台做稳。

有 Mac 的用户想试用, 可以用虚拟机(Parallels、UTM)装一个 Windows 11 跑。

17. 数据怎么转给上级单位?

三种方式按场景挑:

上级要什么怎么导
Excel 表(报数)模块列表右上角"导出", 选 xlsx, 当前筛选条件下的数据全导
整个数据库(交接)"备份恢复"页点"立即备份", 然后对刚生成的那行点"下载", 存到电脑后再拷到 U 盘
纸质证明"证明开具"页生成 docx, 直接打印盖章

18. 能不能让村民自己查个人信息?(扫码查询)

当前版本支持扫码填写: 干部在模块里生成一个二维码/链接, 村民扫码后在手机上填一份新数据(比如人口普查表), 如果这个模块里有"图片/附件"类型的字段, 同一张表单里村民也能直接拍照上传材料(比如低保申请的附件), 不需要额外的"上传页"。

"村民扫码查自己已经录入过的档案"这个场景暂不支持, 涉及身份核验和隐私授权, 计划在后续版本里加, 实现前请村干部当面查询。

19. 党费档位标准从哪里来?

党费档位是本地可配置的, 不是写死的。在系统设置→"党费档位"里, 按上级党组织最新文件填月收入区间和对应的缴纳比例。比如:

月收入党费比例
3000 元及以下0.5%
3000 - 5000 元1%
5000 - 10000 元1.5%
10000 元以上2%

这里的数字仅作示例, 必须按本县/本省最新红头文件来填。"党费缴纳"页会按党员的月收入字段自动匹配档位并算出应缴金额。

20. 怎么调整左侧菜单的顺序? 使用指南去哪了?

1.5.3 版本起, 左侧菜单的顶级条目可以拖动改顺序。鼠标按住任何一项不动, 大约半秒后光标变成手掌, 这时拖到想要的位置松手即可。系统会记住你的偏好, 下次启动还是同一个顺序。

每个账号的菜单顺序独立保存, 你怎么排不会影响同一台主机上其他同事的视图。如果想恢复出厂顺序, 清浏览器/软件本地存储即可(或者再拖回去也行)。

同时"使用指南"从顶级菜单挪到了「系统管理 → 使用指南」, 普通用户也能展开「系统管理」看到它(里面其他管理项只对 admin 显示)。

21. 删除的记录还能找回吗?

能, 7 天内都能找回。删除不是物理删除, 而是进"全局回收站"。

  1. 打开全局回收站用 admin 登录, 左侧菜单底部点"全局回收站"; 普通用户没有这个菜单, 需要 admin 帮你还原。
  2. 找回选中要恢复的记录, 点"还原", 数据回到原模块。
  3. 彻底删"立即清空"会真删, 删完任何工具都救不回。
注意

回收站过期 7 天自动清空, 系统不会再次提醒。重要数据误删后要尽快还原, 别拖。如果担心被误清, 提前到"备份恢复"页做一次手动备份, 备份文件不受 7 天限制。

22. 能不能在系统里直接检查/一键更新到最新版本?

不能, 这是故意不做的。软件里没有"检查更新"按钮, 也不会自己联网、自己弹"发现新版本"的提示; 看到这种弹窗一定是假的, 立刻关掉。

  1. 去官网首页看更新日志对比你现在装的版本号(在 Windows"已安装的应用"里能看到), 不一样就说明有新版本。
  2. 下载新安装包官网"下载"页找到对应文件, 一般叫 乡村管理系统_X.X.X_x64-setup.exe
  3. 先手动备份一次"备份恢复"页点"立即备份", 下载到电脑再拷一份到 U 盘。
  4. 关掉当前系统, 双击新安装包覆盖安装安装路径保持默认, 一路"下一步"到底。

覆盖安装不会清空数据: 安装包只替换程序文件, 不碰数据目录下的 data.db。完整步骤和"升级会不会丢数据"的详细说明见系统升级