151 lines
11 KiB
Markdown
151 lines
11 KiB
Markdown
# 华晓AGV管理系统 源码与现场应用差异报告
|
||
|
||
> 生成日期：2026-08-19
|
||
> 比对方法：将「现场运行的二进制」与「CODE 源码重编译产物」用同一版本 ILSpy（ilspycmd 11.0.0.9375）、同一参数分别反编译为 C#，再逐类逐行 diff。两侧均带 PDB，局部变量名可还原，diff 结果即真实源码差异。
|
||
> 结论先行：**差异全部集中在主程序 exe 和 HxBusiness.dll，BllSql.dll 零差异**。所有差异均属于同一主题——「第三方交管（路权申请/归还）功能的完善」+「地标拖动调整坐标的小工具」+「日志增强」。
|
||
|
||
---
|
||
|
||
## 1. 比对对象与基线
|
||
|
||
| 项 | 现场（基准） | CODE 源码 |
|
||
|---|---|---|
|
||
| 华晓AGV管理系统.exe | 2023-09-18 编译，2,212,352 字节 | 快照 20230901，重编译 2,201,088 字节 |
|
||
| BllSql.dll | 2023-09-02 编译 | 同期 |
|
||
| HxBusiness.dll | 2023-09-15 编译 | 快照 20230901 |
|
||
| 其余 20 个第三方 DLL | 2015–2019 | **MD5 全部一致，无需处理** |
|
||
|
||
- 现场目录自带的 `华晓AGV管理系统.zip` 内是 2023-09-02 的旧 exe 备份，用它与源码重编译产物做了方法校准：仅 2 个文件 10 行差异（源码略新于 9/2 备份），证明比对方法可靠。
|
||
- 现场 exe 为 **Debug|x86 / .NET Framework 4.5.2** 构建，与 CODE 工程配置一致。
|
||
- 现场是用 **VS2022 (17.x)** 工具链构建的（Designer 生成代码版本号为 17.x，资源序列化格式与新工具链一致）。
|
||
|
||
## 2. 程序集级差异总览
|
||
|
||
| 程序集 | 差异 | 说明 |
|
||
|---|---|---|
|
||
| BllSql.dll | **无** | 反编译逐行一致，源码无需任何改动 |
|
||
| HxBusiness.dll | 2 处 | `ApiModel` 新增属性；`ByLeaved` 参数校验放宽 |
|
||
| 华晓AGV管理系统.exe | 新增 2 类 + 修改 4 文件 + 2 处生成器版本号 | 详见下文 |
|
||
|
||
## 3. HxBusiness.dll 差异明细
|
||
|
||
### 3.1 `Model\ApiModel.cs` — 新增属性
|
||
```csharp
|
||
public int AutoTime { get; set; } // 自动归还路权秒数，0=手动归还
|
||
```
|
||
与现场 `Config\ApiModel.json` 中新增的 `"AutoTime": 30` 对应。
|
||
|
||
### 3.2 `BusinessManage.cs` — `ByLeaved` 校验放宽
|
||
```csharp
|
||
// 旧（源码）：
|
||
if (string.IsNullOrEmpty(agvid) || string.IsNullOrEmpty(rfid))
|
||
// 新（现场）：
|
||
if (string.IsNullOrEmpty(agvid))
|
||
```
|
||
原因：交管自动/手动归还场景下 rfid 可能为空（TrafficCtrl 中 Agv_Land 可能返回 0），不应拒绝请求。
|
||
|
||
## 4. 华晓AGV管理系统.exe 差异明细
|
||
|
||
### 4.1 新增类 `A17168\TrafficModel.cs`
|
||
```csharp
|
||
public class TrafficModel
|
||
{
|
||
public string areaCode { get; set; } // 路口（交汇区）地标编号
|
||
public int agvId { get; set; } // 当前占用该路口的AGV，0=空闲
|
||
public DateTime InArea { get; set; } // 进入路口时间
|
||
}
|
||
```
|
||
|
||
### 4.2 新增类 `A17168\TrafficCtrl.cs` — 第三方交管自动归还监听线程
|
||
- `Listen()`：死循环（1s 周期）。当 `apiModel.AutoTime > 0` 且 `waitRfidList` 非空时，遍历 `Frm_A17168.autoLeavedDic`，对占用超过 `AutoTime` 秒的路口调用 `businessCtrl.ByLeaved(agvId, 当前地标, areaCode)` 自动归还路权，成功后清零 `leavedDic[agvId]` 与 `trafficModel.agvId`，写"放行日志X"（插件日志目录）。
|
||
- `Agv_Land(agvid)`：私有辅助，从 `Func.AgvInfo` 取该 AGV 当前地标。
|
||
- 异常写"异常日志"（插件日志），日志文案：`第三方交管监听线程异常！`。
|
||
|
||
### 4.3 `A17168\Frm_A17168.cs` — 3 处
|
||
1. 新增静态字段：
|
||
```csharp
|
||
public static int TraffAutoTimet = 0;
|
||
public static List<TrafficModel> autoLeavedDic = new List<TrafficModel>();
|
||
```
|
||
2. 构造函数中 `businessCtrl = new BusinessManage();` 之后新增初始化：按 `apiModel.waitRfidList` 逗号拆分，为每个路口建一个 `TrafficModel` 放入 `autoLeavedDic`，并读取 `TraffAutoTimet = apiModel.AutoTime`。
|
||
3. `Frm_A17168_Load` 中启动 `UPDateDBList.UpDateDb` 线程之后，新增启动交管监听线程：
|
||
```csharp
|
||
Thread thread2 = new Thread(TrafficCtrl.Listen);
|
||
thread2.IsBackground = true;
|
||
thread2.Start();
|
||
```
|
||
|
||
### 4.4 `A17168\Cls_A17168.cs` — 两个数据线程方法（AGV_Data 网口型 / AGV_Data2 S7-200型）同步修改
|
||
> 注：diff 中大量 `agvInfo→temp`、`num→location_temp` 为现场源码的**变量改名**（PDB 还原的真实命名），无语义影响，但为达成"反编译零差异"验收，回灌时同步改名。
|
||
|
||
真实语义差异（两个方法对称出现，编号 1x 为 AGV_Data，2x 为 AGV_Data2）：
|
||
1. **调试日志埋点**：读到地标后写 `"=========》（11/21）：" + 地标` 到"调试日志"；进入 waitRfid 分支写（12/22）；请求放行成功写（13/23）；进入 leavedRfid 分支写（14/24）；释放成功写（15/25）。
|
||
2. **放行前日志**：`地标 + "开始请求放行"` / `"开始请求释放"` 写入"放行日志{AgvID}"（插件日志）。
|
||
3. **放行成功后登记交管占用**（原来 `if (flag && WriteInfo(...)==0)` 拆为嵌套）：
|
||
```csharp
|
||
if (flag)
|
||
{
|
||
TrafficModel m = Frm_A17168.autoLeavedDic.Find(_ => _.areaCode.Equals(location_temp.ToString()));
|
||
if (m != null) { m.agvId = temp.Agv_ID; m.InArea = DateTime.Now; }
|
||
WriteTxt.SaveLog1(location_temp + "路口添加" + m?.areaCode + "(" + m.agvId + ")", "放行日志" + temp.Agv_ID, "插件日志");
|
||
if (WriteInfo/WriteVW(...) == 0) { /* 原放行逻辑 */ }
|
||
}
|
||
```
|
||
4. **归还接口第 3 参改变**：`ByLeaved(agvid, 当前地标, num3(上次放行地标))` → `ByLeaved(agvid, 当前地标, (当前地标-1))`（离开地标 = 进入地标+1 的约定）。
|
||
5. **归还成功后清除交管占用**：`autoLeavedDic` 中对应 `TrafficModel.agvId = 0`。
|
||
6. **报警处理异步化**：`Thread.Sleep(100); Warn_Deal(_Plc)(...)` 改为 `ThreadPool.QueueUserWorkItem(delegate { Thread.Sleep(100); Warn_Deal(_Plc)(temp, sWarn); });`，避免阻塞采集循环。
|
||
7. **仅 AGV_Data2**：地标变化时删除了 `Func.Change_Rec(...)` 调用；`Location_Log` 插入由同步 `bBllBase.ExecuteNonQuery(sql)` 改为 `UPDateDBList.sqlList.Add(item)` 异步批量入库。
|
||
8. 变量声明顺序/命名调整（`temp`、`location_temp`，`num2~num5` 重排）——纯改名，随语义项一并同步。
|
||
|
||
### 4.5 `Cls\Func.cs` — 新增"Ctrl+拖动地标改坐标"小工具
|
||
1. 新增静态字段：`moveFlag`、`xPos`、`yPos`。
|
||
2. `CreateLandMark`（路口地标创建分支）为 label 增挂 3 个事件：`MouseUp += label_UpClick; MouseDown += label_DownClick; MouseMove += label_MoveClick;`。
|
||
3. 新增 4 个私有静态方法：
|
||
- `label_DownClick`：按下记录起点，`moveFlag=true`；
|
||
- `label_MoveClick`：拖动时移动地标所在 Panel；
|
||
- `label_UpClick`：松开时若按住 Ctrl 且已登录管理员，弹窗确认后调用 `UpLocation`；
|
||
- `UpLocation(rfid,x,y)`：`UPDATE [LandMarkInfo] SET [Loc_X]=x,[Loc_Y]=y WHERE [Loc_ID]=rfid`。
|
||
|
||
### 4.6 `Cls\Path_Reset.cs` — 双击复位路口时手动归还路权
|
||
1. `label12_DoubleClick` 开头新增 `ClearOtherLand(array[1]);`。
|
||
2. 新增 `ClearOtherLand(int land)`：在 `autoLeavedDic` 中找到该路口且被占用（agvId≠0）的记录，调用 `businessCtrl.ByLeaved(agvId, land, areaCode)` 手动归还，成功后清零，写"手动释放/路口已手动归还"日志（插件日志）。
|
||
3. 文件头新增 `using AGVSystem.A17168;`。
|
||
|
||
### 4.7 生成器版本号（纯装饰，为达成零差异同步）
|
||
- `Properties\Resources.Designer.cs`：`StronglyTypedResourceBuilder` 版本 `16.0.0.0` → `17.0.0.0`
|
||
- `Properties\Settings.Designer.cs`：`SettingsSingleFileGenerator` 版本 `16.10.0.0` → `17.6.0.0`
|
||
|
||
## 5. 配置文件差异（不随 bin 替换，仅记录）
|
||
|
||
| 文件 | 差异 | 处理 |
|
||
|---|---|---|
|
||
| `Config\ApiModel.json` | 现场版（2024-03-04）`waitRfidList`/`leavedRfidList` 由 9 个路口扩到 25 个，新增 `"AutoTime": 30`（行尾带 `//` 注释，Json.NET 可解析） | **现场为准，替换 bin 时严禁覆盖**；建议将 CODE bin 内该文件同步为现场版便于本机调试 |
|
||
| `华晓AGV管理系统.exe.config`、`info.ini`、`agvinfo.ini`、`item.ini` | 无差异 | 不动 |
|
||
| `Nancy.Hosting.Self.dll` | 现场没有此文件；现场代码已不使用 NancyHost 自宿主（`BusinessManage` 中相关代码已注释） | 替换包中**不要**包含此 DLL |
|
||
|
||
## 6. 与整合无关的说明（查漏补缺结论）
|
||
|
||
1. 用户提供的 dnSpy 反编译 CODE（`反编译CODE\` 目录）与本报告的 ILSpy 反编译结果核对一致，未发现 dnSpy 导出遗漏的类型；其中 `SqlHelperParameterCache`、`E_State`、`RequestLeavedModel`、`SendModel`、`Channel`、`Location_Log` 等"多出来的文件"只是 dnSpy 按类拆分所致，源码中都存在。
|
||
2. CODE 中的 `Creat_Task.cs`、`Cls\Func - 副本 (2).cs` 未被 csproj 编译，现场 exe 中也无对应类型，保持现状即可。
|
||
3. 源码快照（20230901）略新于现场 zip 备份中 9/2 的 exe：多了"AGV经过地标"地标日志、`order by id`、部分路口数组扩容——即源码基线本身没有丢内容，缺的只是 9/2–9/18 的增量。
|
||
|
||
## 7. 回灌与验收
|
||
|
||
- 回灌范围：4.1–4.7 全部 + 3.1–3.2，共 10 个源文件（新增 2 个、修改 8 个，含 csproj 注册与 2 个 Designer 版本号）。
|
||
- 验收标准：重编译后，用同一 ilspycmd 反编译新 exe / HxBusiness.dll / BllSql.dll，与现场反编译结果 **逐行零差异**（反编译器自动生成的 csproj 除外，其差异仅为本机路径）。
|
||
- 替换清单（复制到现场目录）：`华晓AGV管理系统.exe`、`华晓AGV管理系统.pdb`、`HxBusiness.dll`、`HxBusiness.pdb`（BllSql 无差异可不换）。
|
||
- 回滚：替换前备份现场原文件；现场目录自带 9/2 的 zip 备份可作最后手段。
|
||
|
||
### 验收结果（2026-08-19 已完成）
|
||
|
||
| 程序集 | 反编译比对结果 |
|
||
|---|---|
|
||
| 华晓AGV管理系统.exe | **53 个类型全部逐行一致**（`TrafficCtrl.Listen` 连 IL 字节长度都已对齐） |
|
||
| HxBusiness.dll | **全部逐行一致** |
|
||
| BllSql.dll | **全部逐行一致**（源码未改动，重编译即一致） |
|
||
|
||
细节备注：
|
||
1. 现场源码风格已在回灌中还原——`continue` 不带大括号（带括号会多一个 `nop` 字节改变 IL 标签号）、`TrafficCtrl` 的 foreach 采用两个独立守卫 `if`、`Frm_A17168` 初始化直接对 `Split(',')` 结果 foreach（不引入中间变量）。
|
||
2. `Func.label_UpClick` 现场 IL 采用"正向 if 包裹 + return"结构（297 字节），回灌版为等价的"取反守卫 return"结构（293 字节），两者反编译 C# 完全一致、行为完全一致，仅方法内部 IL 编排不同，不影响验收。
|
||
3. 之前 diff 中大量 `agvInfo→temp`、`num→location_temp` 的"改名"是反编译命名假象：现场代码因 lambda 闭包捕获把真实变量名保留进了元数据，回灌 lambda 后两侧命名自动对齐，非真实源码差异。
|