DBridge 1.3.1：说明书搬进软件里，每一步都能直接点过去

这一版（v1.3.1）没有新功能。

改的全是同一件事：让第一次用的人不用翻文档，也能自己走完一遍。

起因是上次一位客户的问题。他问：同步字段到底按哪个走？

我让他去看帮助，他回了一句：我就是在帮助里迷路的。

这句话把我们点醒了。原来的帮助是按功能分组的——数据库、任务组、日志、授权。
可人在卡住的时候，脑子里想的是「我要把数据搬过去」，不是「这属于哪个功能模块」。
按功能分组，等于要求他先知道自己遇到的问题叫什么。

所以这一版把说明书拆了，重做成按场景给的步骤，而且每一步后面直接挂一个能点的按钮。

一、操作指导：从「查文档」变成「跟着点」

现在打开帮助，第一屏不是目录，是四张卡：

• 第一次连接——从零到跑通一次同步
• 加表 / 换库——已经跑通了，现在要多同步几张表，或者把整组换到另一套库
• 同步出问题了——按现象找，不按模块找
• 换驱动 / 升级

点进任意一张，得到的是一条有编号的操作路径，不是一段说明文字。以「第一次连接」为例，它把整个过程拆成 5 步：

1. 建两个数据源——顺手说清：源库用只读账号就够，目标库的账号要能写。
   后面直接挂「去建数据源」按钮，点了就打开新建弹窗
2. 建任务组，勾上要同步的表——每勾一张表自动生成一条明细，不用一张张配
3. 先体检，别急着跑——红色的必须解决，能自动修的项直接有按钮
4. 手动跑一次——第一次是全量搬，大表会慢一些，属正常
5. 打开定时——设好频率，把开关拨开，之后全自动

每一步除了按钮，还有「卡住了看这里」的链接，比如第一步后面挂着「连不上库」「报权限不足」。
不用退回目录去找，卡在哪一步，就在那一步解决。

配套还有三件小事：

• 两分钟导览：第一次登录，界面会一步步高亮关键位置，跟着点一遍就知道东西在哪，随时可以跳过
• 空库不用先去帮助页：一个数据源都没有的时候，主区域直接给三步卡片——
  「① 建数据源 → ② 建任务组 → ③ 体检再同步」，配一个「新增数据源」按钮和一个「看操作说明」链接
• 就地解释：数据源库名、用户名、备份保留天数、表头状态等 8 处控件旁边加了小问号，
  点开就是这个字段的一句话说明，不用跳走

二、同步字段，以前能选两次

回到开头那个问题。同一个东西，界面上原来有两个地方能选：任务组里选一次「按哪个字段认变化」，
点进某张表还能再选一次。组里选 created_at、表里选 zz_sync_time，
到底按谁走，界面没说。

现在任务组是唯一入口：明细弹窗里那个选择器去掉了，换成一行的说明——
「变化识别方式由任务组统一指定：按 X」，后面一个「去任务组改」。在组里换字段，组内所有表一起跟着换。

这里补一句实情：换增量字段时，这张表的增量进度会被清掉，下次整表扫一遍。
不清的话，旧的进度是上一根字段的值，拿去对新字段比大小，会出现「日志写成功、实际 0 行」。
慢一次，但不会漏。

三、体检不再替你做保证

以前目标表缺列，体检只说「运行时会自动补建」。但账号没有改表权限时，它补不了，
要跑起来才报「列不存在」——白等一轮。

现在按实际权限分三种说法：

一句话原则：能自动做，就说我会自动做；做不了，当场说做不了。
不要让用户在报错里才知道。

四、打开就回到上次的任务组

以前点「同步任务」，左边一组组列着，右边一片空白，每次都要重新点一次。

现在会回到上次看的那一组，连同明细一起。第一次打开才是空的。
（这个记忆只存在浏览器本地，换浏览器会回到初始状态。）

五、其它

• 字段自动匹配更保守：名字像但类型装不下的列不再自动填，只给建议——少一次「配好了却写不进去」
• 目标列装不下时的一键加长只处理文本列，其它类型会明说「要人工判断」，不硬改
• 修了 Oracle 源 → PostgreSQL 目标的一处列名大小写问题
• 发版前测试 88 项全绿

下载与升级

• dbridge-client-v1.3.1-full.zip（约 117 MB，内置 Java 11，解压即用，适合内网/离线机器）
• dbridge-client-v1.3.1-lite.zip（约 60 MB，不含 Java，双击「环境检测.bat」自动补齐）

已安装的用户：解压到新目录 → 关旧程序 → 把旧目录的 data 整个复制过来 →
双击「启动.bat」。授权和任务配置都在 data 里，不会丢。
也可以在「关于」里点「检查更新」走一键升级。

Docker 用户一条命令（自动装最新版）：

bash <(curl -sL https://dbridge.zzzmxxkj.com/install.sh)

完整性校验：对照 SHA256SUMS-v1.3.1.txt。

sha256sum -c SHA256SUMS-v1.3.1.txt

下载地址：dbridge.zzzmxxkj.com ｜
GitHub：nmjugtzdw/dbridge