feat: add BOS single-field migration

AGENTS.md

@@ -40,8 +40,8 @@
 ### 启动与界面
 
 - `App.xaml`：应用资源、HandyControl 主题和 `MainViewModel` 资源注册；启动页是 `Views/HomeWindow.xaml`。
-- `App.xaml.cs`：Velopack 初始化、后台/手动更新、更新前后 `data/` 与 `pre/` 备份恢复、全局异常日志。
-- `Views/HomeWindow.xaml`：单窗口主界面，包含四个迁移 Tab、连接状态、SQL 编辑区和批量操作。
+- `App.xaml.cs`：Velopack 初始化、后台/手动更新、更新前后 `config.ini`、`data/` 与 `pre/` 备份恢复、全局异常日志。
+- `Views/HomeWindow.xaml`：单窗口主界面，包含五个迁移 Tab、连接状态、SQL 编辑区和批量操作。
 - `Views/HomeWindow.xaml.cs`：只处理窗口关闭和手动检查更新等窗口事件。
 - `Views/ConnectionDialog.*`：源库/目标库连接配置与测试。
 - `Views/ErrorDialog.*`：错误详情展示和复制。
@@ -49,7 +49,7 @@
 
 ### 状态与编排
 
-- `ViewModels/MainViewModel.cs`：主状态容器和命令编排；初始化四个 `TabServices`，管理数据库连接、单行/批量读写、SQL 编辑与断点续写。
+- `ViewModels/MainViewModel.cs`：主状态容器和命令编排；初始化五个 `TabServices`，管理数据库连接、单行/批量读写、SQL 编辑与断点续写。
 - `Models/TableRowModel.cs`：每个迁移对象的名称、所属 Tab、读写状态。
 - `Enums/`：Tab、状态、工作类型和输出扩展名枚举。
 
@@ -60,34 +60,41 @@
 - `Services/DbServices.cs`：Oracle SQL 的提取与执行核心：
   - `GetTableSql`：读取表 DDL、注释、主外键、唯一键和索引；
   - `GetTableBos`：读取 BOS 配置；
+  - `GetTableBosField`：按 `TABLE.COLUMN` 读取单个 BOS 字段配置，生成目标物理字段补充 SQL，并包含关联限定值/引用元数据；
   - `GetPrcSql` / `GetAllPrc`：读取存储过程或函数源码；
   - `GetTableData`：生成表数据 INSERT SQL；
-  - `ExecuteCreate`：按 `\n/` 分隔 SQL，在目标库逐条执行并检查 `USER_ERRORS`；
-  - `PreProcess`：在源库执行 `pre/` 下全部脚本。
+  - `ExecuteCreate`：按 `\n/` 分隔 SQL，在目标库逐条执行并检查 `USER_ERRORS`。
 - `Common/SqlSugarHelper.cs`：维护 `orig`（源库）和 `dest`（目标库）两个 SqlSugar 连接。
 - `Common/SysConfig.cs`：读取和写入运行目录下的 `config.ini`。
 - `Common/CommonHelper.cs`：运行目录、`data/`、`data/from/`、`pre/` 路径及文本读写。
 
 ## 真实数据流
 
-四个 Tab 的映射由 `MainViewModel` 构造函数定义：
+五个 Tab 的映射由 `MainViewModel` 构造函数定义：
 
 | Tab | 索引文件 | 内容文件 | 源库读取方法 |
 | --- | --- | --- | --- |
 | 表配置 | `data/from/table.txt` | `data/{对象名}_creat.txt` | `DbServices.GetTableSql` |
 | BOS 配置 | `data/from/bos.txt` | `data/{对象名}_bos.txt` | `DbServices.GetTableBos` |
+| BOS 字段配置 | `data/from/bos_field.txt` | `data/{表名}.{字段名}_bos_field.txt` | `DbServices.GetTableBosField` |
 | 存储过程 | `data/from/prc.txt` | `data/{对象名}_prc.txt` | `DbServices.GetPrcSql` |
 | 表数据 | `data/from/data.txt` | `data/{对象名}_data.txt` | `DbServices.GetTableData` |
 
 读取流程：索引项 -> 调用源库读取委托 -> 生成 SQL 文本 -> 保存到 `data/` -> 更新读取状态并显示内容。
 
+读取 BOS 配置前会检查源库当前用户下的辅助过程。整表读取使用 `HMIG_GET_TABLE_BOS_31`，单字段读取使用 `HMIG_GET_TABLE_BOS_FIELD_31`；若过程不存在，程序从运行目录的同名 `pre/*.prc` 脚本安装，检查 `USER_ERRORS` 和对象状态后再读取。单字段列表项必须采用 `TABLE.COLUMN` 格式。界面不提供手动“预处理”入口。
+
+单字段 SQL 写入目标库时，限定值组按名称、限定值按组和值判断，只补充缺失项；引用元数据按引用表名和字段 `DBNAME` 映射，目标引用字段不存在或不唯一时直接报错，不自动创建。
+
+单字段读取还会查询源库 `USER_TABLES`、`USER_TAB_COLUMNS`。源对象是物理表且源字段存在时，输出文件首先检查目标库物理表和字段：目标表不存在时报错，目标字段不存在时按源字段的数据类型、长度、精度和字符语义执行 `ALTER TABLE ... ADD`。源对象是视图或 BOS 计算字段时不生成物理字段 DDL。
+
 写入流程：索引项 -> 读取对应 `data/*_{后缀}.txt` -> `DbServices.ExecuteCreate` -> 在目标库执行 -> 更新写入状态。批量写入遇到第一条失败即停止，并在内存中记录断点；断点不会跨进程持久化。
 
 删除列表项会同时删除对应内容文件。调整顺序会立即覆盖索引文件。新增对象名会被转为小写，数据库读取时再按需要转大写。
 
 ## 配置和运行时文件
 
-- `config.ini` 保存源库和目标库的 IP/服务名、用户名、密码。当前实现是明文读写，不要把注释或 UI 文案误当成加密能力。
+- `config.ini` 保存源库和目标库的 IP/服务名、用户名、密码。当前实现是明文读写，首次运行缺失时创建空配置；发布包不得携带本机配置。
 - 不要在日志、回答、补丁或测试输出中展示真实连接串和密码。
 - 修改或发布时不要用样例配置覆盖用户现有 `config.ini`。
 - `data/` 和 `pre/` 是用户可编辑、更新时需要保留的运行数据；不要无故清空、批量改名或删除。
@@ -113,11 +120,11 @@
 源库和目标库不是等价环境：
 
 - `Get*` 方法通常查询源库；`ExecuteCreate` 明确写目标库。
-- `PreProcess` 会在源库执行 `pre/` 下的 SQL/PLSQL，虽然名为预处理，但不是只读操作。
+- 首次读取整表或单字段 BOS 配置时可能在源库自动创建对应的 `HMIG_GET_TABLE_BOS_31` 或 `HMIG_GET_TABLE_BOS_FIELD_31`；这不是只读操作，源库账号需要相应的 `CREATE PROCEDURE` 权限。
 - 连接按钮会把界面中的连接信息写回 `config.ini`，并重建同时包含源库和目标库的 SqlSugarScope。
 - 界面的“断开”当前只更新连接状态，并未释放或关闭底层连接对象。
 
-除非用户明确要求并确认数据库、对象和影响范围，否则不要连接真实数据库、执行预处理、执行写入、清理数据或测试破坏性 SQL。需要验证数据库写入逻辑时优先使用代码审查、可控测试库或事务化的最小复现。真实目标库写入前必须提醒备份并确认权限。
+除非用户明确要求并确认数据库、对象和影响范围，否则不要连接真实数据库、触发 BOS 辅助过程安装、执行目标库写入、清理数据或测试破坏性 SQL。需要验证数据库写入逻辑时优先使用代码审查、可控测试库或事务化的最小复现。真实目标库写入前必须提醒备份并确认权限。
 
 ## 构建与验证
 
@@ -138,7 +145,7 @@ dotnet build .\henlo_migration_wpf10\henlo_migration_wpf10.csproj -c Debug --no-
 
 1. 所有 C#/XAML 修改至少执行一次主项目构建。
 2. 仅文档修改可不构建，但要重新读取文件检查 Markdown、路径和命令。
-3. XAML/绑定修改除构建外，应在 Windows 上启动应用，检查四个 Tab、连接弹窗、按钮可用性和错误弹窗；不要因此连接生产库。
+3. XAML/绑定修改除构建外，应在 Windows 上启动应用，检查五个 Tab、连接弹窗、按钮可用性和错误弹窗；不要因此连接生产库。
 4. SQL 生成/拆分修改需用不含真实数据的代表性 SQL 验证表 DDL、注释、约束、PL/SQL 和 INSERT。
 5. 更新逻辑修改需分别考虑普通 `dotnet run`（非 Velopack 安装）和 Velopack 安装态。
 
@@ -154,12 +161,11 @@ dotnet run --project .\henlo_migration_wpf10\henlo_migration_wpf10.csproj
 
 ## 版本与发布
 
-- 版本号只修改 `.csproj` 中的 `<Version>`，必须单调递增；显示版本来自程序集元数据。
-- 正式发布入口是 `henlo_migration_wpf10/pack.bat`。脚本会清理 `publish/`、执行 `dotnet publish -c Release --self-contained false -r win-x64`，再调用 `vpk pack --noInst` 输出到 `releases/`。
-- `pack.bat` 依赖本机 `dotnet`、`vpk` 和 Windows 批处理环境；不要把“构建通过”等同于“打包通过”。
-- 发布是显式任务。未经要求不要运行打包、删除发布目录、修改版本号或上传更新服务器。
-- 打包后核对便携 ZIP、full/delta nupkg、`RELEASES`/JSON 元数据以及实际版本号。上传服务器属于外部写操作，必须另行获得明确授权。
-- 若修改运行时必需文件，检查 `.csproj` 的 `CopyToOutputDirectory` 规则和 `App.xaml.cs` 的更新备份/恢复范围。
+- 仓库根目录的 `RELEASE.md` 是当前发版流程、产物、上传和自动更新风险的权威说明。凡任务涉及版本号、Release 构建、Velopack、打包、便携包、自动更新、服务器部署或上传，必须先完整读取 `RELEASE.md`，再执行或给出结论。
+- 正式版本的用户可见变更记录维护在仓库根目录 `CHANGELOG.md`，发版时必须新增对应版本条目。
+- 版本号只修改 `.csproj` 中的 `<Version>`，必须单调递增；正式发布入口是 `henlo_migration_wpf10/pack.bat`。
+- 发布是显式任务。未经要求不要运行打包、删除发布目录、修改版本号或上传更新服务器；构建通过不等于打包或自动更新验证通过。
+- 若代码、脚本和 `RELEASE.md` 不一致，以实际代码和 `pack.bat` 为准，并在同一任务中同步修正文档。
 
 ## 完成任务时的交付说明