|
|
@@ -1,594 +0,0 @@
|
|
|
-# 诊断/UI/日志 三子系统 实现计划
|
|
|
-
|
|
|
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
-
|
|
|
-**Goal:** 实现操作日志落盘、诊断工具 Z 清晰度曲线扫描、CalibWindow UI 数据显示调整三个独立子系统。
|
|
|
-
|
|
|
-**Architecture:** 三个子系统互相独立，按"日志 → 诊断 → UI"顺序实现（日志先做，后续调试受益）。日志用一个静态 `FileLogger` + 在 `MainWindow.Log` 和各按钮 Click 入口埋点；诊断扩展独立工具 `WellSpacing`；UI 改 `CalibWindow`。
|
|
|
-
|
|
|
-**Tech Stack:** .NET 8 / WPF / C#。无单元测试框架——验证靠 `dotnet build` 编译 + 运行观察 + 真机。
|
|
|
-
|
|
|
-设计依据：`docs/superpowers/specs/2026-06-16-diagnostics-ui-logging-design.md`
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## 文件结构
|
|
|
-
|
|
|
-- 新建：`Logging/FileLogger.cs` —— 静态文件日志器（启动建文件、线程安全写入）
|
|
|
-- 修改：`AutoFocusTool.csproj` —— 加 `Logs\**`、`TestData\**` 到 Compile Remove 排除
|
|
|
-- 修改：`MainWindow.xaml.cs` —— `Log()` 加落盘；构造时初始化 FileLogger
|
|
|
-- 修改：`MainWindow.Motor.cs` / `MainWindow.Camera.cs` / `MainWindow.Scan.cs` / `MainWindow.Calib.cs` —— 各按钮 Click 埋 `FileLogger.Action`
|
|
|
-- 修改：`WellSpacing/WellSpacing.cs` + `WellSpacing.csproj` —— 加 zcurve 模式、输出改 TestData/、引入 Sharpness
|
|
|
-- 修改：`CalibWindow.xaml` / `CalibWindow.xaml.cs` —— 删底部 Border、SetCurrentInfo 显示更详细
|
|
|
-- 修改：`MainWindow.Calib.cs` —— OnStep 回调补齐字段传给 CalibWindow
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Task 1: FileLogger 静态日志器 + csproj 排除
|
|
|
-
|
|
|
-**Files:**
|
|
|
-- Create: `Logging/FileLogger.cs`
|
|
|
-- Modify: `AutoFocusTool.csproj`
|
|
|
-
|
|
|
-- [ ] **Step 1: 加 csproj 排除（Logs/TestData 不参与编译）**
|
|
|
-
|
|
|
-在 `AutoFocusTool.csproj` 中找到 `<Compile Remove="bin\**\*.cs" />` 这一行，在它之前插入两行：
|
|
|
-
|
|
|
-```xml
|
|
|
- <Compile Remove="Logs\**\*.cs" />
|
|
|
- <Compile Remove="TestData\**\*.cs" />
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 2: 创建 FileLogger**
|
|
|
-
|
|
|
-创建 `Logging/FileLogger.cs`：
|
|
|
-
|
|
|
-```csharp
|
|
|
-using System;
|
|
|
-using System.IO;
|
|
|
-
|
|
|
-namespace AutoFocusTool.Logging
|
|
|
-{
|
|
|
- /// <summary>
|
|
|
- /// 静态文件日志器：程序启动时按时间戳建一个文件，本次运行所有日志写入它。
|
|
|
- /// 线程安全（lock），每条 flush。格式：HH:mm:ss.fff [级别] [类别] 消息
|
|
|
- /// </summary>
|
|
|
- public static class FileLogger
|
|
|
- {
|
|
|
- private static readonly object _lock = new object();
|
|
|
- private static string _path;
|
|
|
-
|
|
|
- /// <summary>启动时调用一次：在 Logs/ 下建 yyyy-MM-dd_HHmmss.log。</summary>
|
|
|
- public static void Init()
|
|
|
- {
|
|
|
- lock (_lock)
|
|
|
- {
|
|
|
- if (_path != null) return;
|
|
|
- string dir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Logs");
|
|
|
- // 实际运行时希望日志落到项目根的 Logs/，但 BaseDirectory 是 bin 输出目录；
|
|
|
- // 用固定项目根更直观，便于查看。
|
|
|
- dir = @"C:\claudeFile\TL\AutoFocusTool\Logs";
|
|
|
- Directory.CreateDirectory(dir);
|
|
|
- _path = Path.Combine(dir, $"{DateTime.Now:yyyy-MM-dd_HHmmss}.log");
|
|
|
- Write("INFO", "APP", "==== 日志开始 ====");
|
|
|
- }
|
|
|
- }
|
|
|
-
|
|
|
- public static void Info(string category, string msg) => Write("INFO", category, msg);
|
|
|
- public static void Action(string category, string msg) => Write("ACTION", category, msg);
|
|
|
- public static void Data(string category, string msg) => Write("DATA", category, msg);
|
|
|
- public static void Warn(string category, string msg) => Write("WARN", category, msg);
|
|
|
- public static void Error(string category, string msg) => Write("ERROR", category, msg);
|
|
|
-
|
|
|
- private static void Write(string level, string category, string msg)
|
|
|
- {
|
|
|
- try
|
|
|
- {
|
|
|
- lock (_lock)
|
|
|
- {
|
|
|
- if (_path == null) return; // 未 Init 则静默丢弃
|
|
|
- string line = $"{DateTime.Now:HH:mm:ss.fff} [{level,-6}] [{category,-6}] {msg}";
|
|
|
- File.AppendAllText(_path, line + Environment.NewLine);
|
|
|
- }
|
|
|
- }
|
|
|
- catch { /* 日志失败不能影响主流程 */ }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 3: 编译验证**
|
|
|
-
|
|
|
-Run: `dotnet build AutoFocusTool.csproj -c Debug`
|
|
|
-Expected: 生成成功，0 错误。（FileLogger 暂未被调用。）
|
|
|
-
|
|
|
-- [ ] **Step 4: 提交**
|
|
|
-
|
|
|
-```bash
|
|
|
-git add Logging/FileLogger.cs AutoFocusTool.csproj
|
|
|
-git commit -m "feat(log): 新增FileLogger静态文件日志器 + csproj排除Logs/TestData
|
|
|
-
|
|
|
-Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>"
|
|
|
-```
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Task 2: MainWindow.Log 落盘 + 启动初始化
|
|
|
-
|
|
|
-**Files:**
|
|
|
-- Modify: `MainWindow.xaml.cs:35-54`（构造函数 + Log 方法）
|
|
|
-
|
|
|
-- [ ] **Step 1: 构造函数初始化 FileLogger**
|
|
|
-
|
|
|
-在 `MainWindow.xaml.cs` 找到构造函数：
|
|
|
-
|
|
|
-```csharp
|
|
|
- public MainWindow()
|
|
|
- {
|
|
|
- InitializeComponent();
|
|
|
- _scanner.Log = Log;
|
|
|
- Closing += (s, e) => Cleanup();
|
|
|
- Log("程序启动。先【扫描设备】，选舱室后【连接】。");
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-替换为（加 FileLogger.Init + using）：
|
|
|
-
|
|
|
-```csharp
|
|
|
- public MainWindow()
|
|
|
- {
|
|
|
- InitializeComponent();
|
|
|
- AutoFocusTool.Logging.FileLogger.Init();
|
|
|
- _scanner.Log = Log;
|
|
|
- Closing += (s, e) => { AutoFocusTool.Logging.FileLogger.Info("APP", "程序关闭"); Cleanup(); };
|
|
|
- Log("程序启动。先【扫描设备】，选舱室后【连接】。");
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 2: Log() 同时落盘**
|
|
|
-
|
|
|
-找到 `Log` 方法：
|
|
|
-
|
|
|
-```csharp
|
|
|
- private void Log(string msg)
|
|
|
- {
|
|
|
- void Append()
|
|
|
- {
|
|
|
- string line = $"{DateTime.Now:HH:mm:ss} {msg}\n";
|
|
|
- TxtLog.AppendText(line);
|
|
|
- TxtLog.ScrollToEnd();
|
|
|
- }
|
|
|
- if (Dispatcher.CheckAccess()) Append();
|
|
|
- else Dispatcher.BeginInvoke((Action)Append);
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-替换为（追加一行落盘；类别统一 INFO/RUN，因 Log 是通用信息）：
|
|
|
-
|
|
|
-```csharp
|
|
|
- private void Log(string msg)
|
|
|
- {
|
|
|
- AutoFocusTool.Logging.FileLogger.Info("RUN", msg);
|
|
|
- void Append()
|
|
|
- {
|
|
|
- string line = $"{DateTime.Now:HH:mm:ss} {msg}\n";
|
|
|
- TxtLog.AppendText(line);
|
|
|
- TxtLog.ScrollToEnd();
|
|
|
- }
|
|
|
- if (Dispatcher.CheckAccess()) Append();
|
|
|
- else Dispatcher.BeginInvoke((Action)Append);
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 2b: 新增 LogAction 辅助方法**
|
|
|
-
|
|
|
-在 `Log` 方法之后插入一个便捷方法（按钮埋点用，同时写界面+文件 ACTION 级）：
|
|
|
-
|
|
|
-```csharp
|
|
|
- /// <summary>记录界面操作（ACTION级落盘 + 界面日志）。</summary>
|
|
|
- private void LogAction(string msg)
|
|
|
- {
|
|
|
- AutoFocusTool.Logging.FileLogger.Action("UI", msg);
|
|
|
- void Append()
|
|
|
- {
|
|
|
- string line = $"{DateTime.Now:HH:mm:ss} ▶ {msg}\n";
|
|
|
- TxtLog.AppendText(line);
|
|
|
- TxtLog.ScrollToEnd();
|
|
|
- }
|
|
|
- if (Dispatcher.CheckAccess()) Append();
|
|
|
- else Dispatcher.BeginInvoke((Action)Append);
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 3: 编译验证**
|
|
|
-
|
|
|
-Run: `dotnet build AutoFocusTool.csproj -c Debug`
|
|
|
-Expected: 生成成功，0 错误。
|
|
|
-
|
|
|
-- [ ] **Step 4: 运行验证日志落盘**
|
|
|
-
|
|
|
-Run: `./bin/Debug/net8.0-windows/AutoFocusTool.exe`（启动后关闭），然后检查 `Logs/` 下生成了带时间戳的 .log 文件，内含"日志开始""程序启动"。
|
|
|
-
|
|
|
-- [ ] **Step 5: 提交**
|
|
|
-
|
|
|
-```bash
|
|
|
-git add MainWindow.xaml.cs
|
|
|
-git commit -m "feat(log): MainWindow.Log落盘 + 启动初始化 + LogAction埋点辅助
|
|
|
-
|
|
|
-Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>"
|
|
|
-```
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Task 3: 各按钮 Click 埋点
|
|
|
-
|
|
|
-**Files:**
|
|
|
-- Modify: `MainWindow.Motor.cs`、`MainWindow.Camera.cs`、`MainWindow.Scan.cs`、`MainWindow.Calib.cs`
|
|
|
-
|
|
|
-原则：在每个按钮 `Click` 处理函数体**第一行**加 `LogAction(...)`，写明操作名+关键输入参数。`MotorAction("Z正转 X步", ...)` 这类已带名字的，其内部已经走 `Log` 落盘了，但按钮入口仍加 `LogAction` 记录"用户点击"这个动作和参数。
|
|
|
-
|
|
|
-- [ ] **Step 1: MainWindow.Motor.cs 埋点**
|
|
|
-
|
|
|
-`BtnZUp_Click`：在 `int step = ...` 之后、`MotorAction(...)` 之前加：
|
|
|
-```csharp
|
|
|
- LogAction($"点击 Z正转, 步距={step}");
|
|
|
-```
|
|
|
-`BtnZDown_Click` 同理：
|
|
|
-```csharp
|
|
|
- LogAction($"点击 Z反转, 步距={step}");
|
|
|
-```
|
|
|
-`BtnZReset_Click` 改为带函数体：
|
|
|
-```csharp
|
|
|
- private void BtnZReset_Click(object sender, RoutedEventArgs e)
|
|
|
- {
|
|
|
- LogAction("点击 Z复位");
|
|
|
- MotorAction("Z复位", () => _motor.VerticalReset());
|
|
|
- }
|
|
|
-```
|
|
|
-`BtnZMoveTo_Click`：在 `int abs = ...` 之后加：
|
|
|
-```csharp
|
|
|
- LogAction($"点击 Z绝对移动, 目标={abs}");
|
|
|
-```
|
|
|
-`BtnHFwd_Click`：在 `int step = ...` 之后加：
|
|
|
-```csharp
|
|
|
- LogAction($"点击 水平正转, 步距={step}");
|
|
|
-```
|
|
|
-`BtnHBwd_Click`：在 `int step = ...` 之后加：
|
|
|
-```csharp
|
|
|
- LogAction($"点击 水平反转, 步距={step}");
|
|
|
-```
|
|
|
-`BtnHReset_Click` 改为带函数体：
|
|
|
-```csharp
|
|
|
- private void BtnHReset_Click(object sender, RoutedEventArgs e)
|
|
|
- {
|
|
|
- LogAction("点击 水平复位");
|
|
|
- MotorAction("水平复位", () => _motor.HorizontalReset());
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 2: MainWindow.Camera.cs 埋点**
|
|
|
-
|
|
|
-先 Read `MainWindow.Camera.cs` 确认按钮处理函数名（BtnLedOn/BtnLedOff/BtnGrab/TglLive/BtnSaveImg/BtnSetExp/BtnSetGain 等）。在每个 Click 函数体第一行加对应 `LogAction`，例如：
|
|
|
-```csharp
|
|
|
- // BtnLedOn_Click 第一行
|
|
|
- LogAction("点击 开光源");
|
|
|
- // BtnLedOff_Click
|
|
|
- LogAction("点击 关光源");
|
|
|
- // BtnGrab_Click
|
|
|
- LogAction("点击 抓一帧");
|
|
|
- // TglLive_Click
|
|
|
- LogAction($"点击 实时预览(切换)");
|
|
|
- // BtnSaveImg_Click
|
|
|
- LogAction("点击 存图");
|
|
|
- // BtnSetExp_Click (在读取曝光值后)
|
|
|
- LogAction($"点击 设置曝光={TxtExposure.Text}");
|
|
|
- // BtnSetGain_Click (在读取增益后)
|
|
|
- LogAction($"点击 设置增益 R={TxtGainR.Text} G={TxtGainG.Text} B={TxtGainB.Text}");
|
|
|
-```
|
|
|
-（按该文件实际函数名与变量调整文案；每个 Click 一行 LogAction。）
|
|
|
-
|
|
|
-- [ ] **Step 3: MainWindow.Scan.cs 埋点**
|
|
|
-
|
|
|
-Read `MainWindow.Scan.cs`，在 Z 扫描相关按钮（如 `BtnZScan_Click`、`BtnStop_Click`）函数体第一行加：
|
|
|
-```csharp
|
|
|
- // BtnZScan_Click (读取起点/层距/层数后)
|
|
|
- LogAction($"点击 Z扫描 起点={TxtScanStart.Text} 层距={TxtScanStep.Text} 层数={TxtScanCount.Text}");
|
|
|
- // BtnStop_Click
|
|
|
- LogAction("点击 停止扫描");
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 4: MainWindow.Calib.cs / xaml.cs 其余按钮埋点**
|
|
|
-
|
|
|
-- `BtnScan_Click`（MainWindow.xaml.cs）第一行：`LogAction("点击 扫描设备");`
|
|
|
-- `BtnConnect_Click` 第一行：`LogAction($"点击 连接 舱室索引={CmbHouse.SelectedIndex}");`
|
|
|
-- `BtnDisconnect_Click` 第一行：`LogAction("点击 断开");`
|
|
|
-- `BtnGoWell_Click`（Calib）第一行：`LogAction($"点击 转到well={CmbWell.SelectedIndex + 1}");`
|
|
|
-- `BtnWellAll_Click`：`LogAction("点击 全选well");`
|
|
|
-- `BtnWellNone_Click`：`LogAction("点击 全不选well");`
|
|
|
-- `BtnAutoInit_Click` 第一行：`LogAction("点击 一键全自动初始化");`（具体 wells 列表在收集后已有 Log，可不重复）
|
|
|
-
|
|
|
-- [ ] **Step 5: 编译验证**
|
|
|
-
|
|
|
-Run: `dotnet build AutoFocusTool.csproj -c Debug`
|
|
|
-Expected: 生成成功，0 错误。
|
|
|
-
|
|
|
-- [ ] **Step 6: 提交**
|
|
|
-
|
|
|
-```bash
|
|
|
-git add MainWindow.Motor.cs MainWindow.Camera.cs MainWindow.Scan.cs MainWindow.Calib.cs MainWindow.xaml.cs
|
|
|
-git commit -m "feat(log): 各界面按钮Click埋点记录操作+参数
|
|
|
-
|
|
|
-Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>"
|
|
|
-```
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Task 4: WellSpacing 加 zcurve 模式 + 输出改 TestData/
|
|
|
-
|
|
|
-**Files:**
|
|
|
-- Modify: `WellSpacing/WellSpacing.csproj`（引入 Sharpness.cs）
|
|
|
-- Modify: `WellSpacing/WellSpacing.cs`
|
|
|
-
|
|
|
-- [ ] **Step 1: csproj 引入 Sharpness**
|
|
|
-
|
|
|
-在 `WellSpacing/WellSpacing.csproj` 的 `<Compile Include="..\Imaging\WellDetector.cs" />` 之后加：
|
|
|
-```xml
|
|
|
- <Compile Include="..\Imaging\Sharpness.cs" />
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 2: 现有逐well模式输出目录改到 TestData/**
|
|
|
-
|
|
|
-在 `WellSpacing.cs` 找到：
|
|
|
-```csharp
|
|
|
- string outDir = $@"C:\claudeFile\TL\AutoFocusTool\calib_result\well_check_{stamp}";
|
|
|
-```
|
|
|
-替换为：
|
|
|
-```csharp
|
|
|
- string outDir = $@"C:\claudeFile\TL\AutoFocusTool\TestData\well_check_{stamp}";
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 3: 加 zcurve 子命令**
|
|
|
-
|
|
|
-在 `WellSpacing.cs` 的 `Main` 方法最开头（`Console.OutputEncoding = ...` 之后）插入分支派发：
|
|
|
-
|
|
|
-```csharp
|
|
|
- if (args.Length > 0 && args[0] == "zcurve")
|
|
|
- return ZCurve(args);
|
|
|
-```
|
|
|
-
|
|
|
-然后在类内（`Main` 方法之后）新增 `ZCurve` 方法：
|
|
|
-
|
|
|
-```csharp
|
|
|
- /// <summary>
|
|
|
- /// Z清晰度曲线扫描：移到指定well的EEPROM水平位置，从zLo到zHi逐层抓帧算清晰度，
|
|
|
- /// 同时记录灰度均值(验证亮度归一化是否带偏)，每层存图。
|
|
|
- /// 用法：WellSpacing.exe zcurve <COM> <相机idx> <well> [zLo=20000] [zHi=120000] [zStep=2000] [曝光=60]
|
|
|
- /// </summary>
|
|
|
- static int ZCurve(string[] a)
|
|
|
- {
|
|
|
- string port = a.Length > 1 ? a[1] : "COM11";
|
|
|
- int camIdx = a.Length > 2 && int.TryParse(a[2], out int ci) ? ci : 2;
|
|
|
- int well = a.Length > 3 && int.TryParse(a[3], out int wv) ? wv : 1;
|
|
|
- int zLo = a.Length > 4 && int.TryParse(a[4], out int v4) ? v4 : 20000;
|
|
|
- int zHi = a.Length > 5 && int.TryParse(a[5], out int v5) ? v5 : 120000;
|
|
|
- int zStep = a.Length > 6 && int.TryParse(a[6], out int v6) ? v6 : 2000;
|
|
|
- int exposure = a.Length > 7 && int.TryParse(a[7], out int v7) ? v7 : 60;
|
|
|
- int camW = 2592, camH = 1944;
|
|
|
- void L(string m) => Console.WriteLine($"{DateTime.Now:HH:mm:ss} {m}");
|
|
|
-
|
|
|
- string stamp = DateTime.Now.ToString("yyyyMMdd_HHmmss");
|
|
|
- string outDir = $@"C:\claudeFile\TL\AutoFocusTool\TestData\zcurve_w{well}_{stamp}";
|
|
|
- Directory.CreateDirectory(outDir);
|
|
|
- L($"==== Z清晰度曲线 well{well} {port} cam#{camIdx} Z[{zLo},{zHi}] step{zStep} 曝光{exposure} ====");
|
|
|
- L($"存图: {outDir}");
|
|
|
-
|
|
|
- var motor = new HouseMotor(port) { Log = null };
|
|
|
- if (!motor.Open()) { L($"✗ 打开 {port} 失败"); return 1; }
|
|
|
- motor.MotorDelayMs = 1500;
|
|
|
- int sn = motor.ShakeHands();
|
|
|
- L($"握手 houseSn={sn}");
|
|
|
- int hpos = motor.ReadWellHorizontalPos(well);
|
|
|
- if (hpos < 0) { L("✗ 读well水平位置失败"); motor.Close(); return 1; }
|
|
|
-
|
|
|
- var cam = new SerialCamera(camIdx, camW, camH, exposure);
|
|
|
- if (cam.Init() != 0) { L("✗ 相机初始化失败"); motor.Close(); return 2; }
|
|
|
- cam.SetOpMode(0); cam.SetExposure(exposure);
|
|
|
- motor.OpenLED(); Thread.Sleep(300);
|
|
|
- motor.HorizontalMoveTo(hpos, 1500);
|
|
|
- L($"已移到 well{well} 水平={hpos}");
|
|
|
-
|
|
|
- double bestScore = -1; int bestZ = zLo;
|
|
|
- try
|
|
|
- {
|
|
|
- for (int z = zLo; z <= zHi; z += zStep)
|
|
|
- {
|
|
|
- motor.VerticalMoveTo(z, 1500);
|
|
|
- Thread.Sleep(150);
|
|
|
- cam.GrabRgb(); Thread.Sleep(80); cam.GrabRgb();
|
|
|
- byte[] buf = cam.GetSourceBuffer();
|
|
|
-
|
|
|
- // 中央40% ROI
|
|
|
- int roiW = (int)(camW * 0.4), roiH = (int)(camH * 0.4);
|
|
|
- var roi = new System.Drawing.Rectangle((camW - roiW) / 2, (camH - roiH) / 2, roiW, roiH);
|
|
|
- double score = Sharpness.Compute(buf, camW, camH, roi);
|
|
|
- double mean = GrayMean(buf, camW, camH, roi);
|
|
|
- L($"z={z,6} 归一化分={score:F5} 亮度均值={mean:F1}");
|
|
|
- if (score > bestScore) { bestScore = score; bestZ = z; }
|
|
|
-
|
|
|
- ImageConverter.SaveBmp(buf, camW, camH,
|
|
|
- Path.Combine(outDir, $"z{z}_s{score:F4}.bmp"));
|
|
|
- }
|
|
|
- }
|
|
|
- finally { motor.CloseLED(); cam.Dispose(); motor.Close(); }
|
|
|
-
|
|
|
- L($"==== 峰值 z={bestZ} 分={bestScore:F5} 图在 {outDir} ====");
|
|
|
- return 0;
|
|
|
- }
|
|
|
-
|
|
|
- /// <summary>中央ROI灰度均值(BGR→灰度，行优先)。</summary>
|
|
|
- static double GrayMean(byte[] bgr, int W, int H, System.Drawing.Rectangle roi)
|
|
|
- {
|
|
|
- long sum = 0; int n = 0; int stride = W * 3;
|
|
|
- for (int y = roi.Y; y < roi.Y + roi.Height && y < H; y++)
|
|
|
- for (int x = roi.X; x < roi.X + roi.Width && x < W; x++)
|
|
|
- {
|
|
|
- int p = y * stride + x * 3;
|
|
|
- sum += (bgr[p] * 29 + bgr[p + 1] * 150 + bgr[p + 2] * 77) >> 8;
|
|
|
- n++;
|
|
|
- }
|
|
|
- return n > 0 ? (double)sum / n : 0;
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 4: 编译验证**
|
|
|
-
|
|
|
-Run: `cd WellSpacing && dotnet build WellSpacing.csproj -c Debug`
|
|
|
-Expected: 生成成功，0 错误。
|
|
|
-
|
|
|
-- [ ] **Step 5: 提交**
|
|
|
-
|
|
|
-```bash
|
|
|
-git add WellSpacing/WellSpacing.cs WellSpacing/WellSpacing.csproj
|
|
|
-git commit -m "feat(diag): WellSpacing加Z清晰度曲线模式(记录分数+亮度均值)+输出改TestData
|
|
|
-
|
|
|
-Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>"
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 6: 真机取证（用户执行，可选）**
|
|
|
-
|
|
|
-连 4 号舱跑：`WellSpacing.exe zcurve COM9 4 1 20000 120000 2000 60`
|
|
|
-观察输出：真实焦面 z 在哪、低 z 是否因亮度均值低而归一化分被抬高。这是后续决定是否改 Sharpness 的依据。
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Task 5: CalibWindow UI 调整（删底部冗余 + 预览参数更详细）
|
|
|
-
|
|
|
-**Files:**
|
|
|
-- Modify: `CalibWindow.xaml`（删底部 Border + Grid 行）
|
|
|
-- Modify: `CalibWindow.xaml.cs`（删对应控件引用，SetCurrentInfo 更详细）
|
|
|
-- Modify: `MainWindow.Calib.cs:145-151`（OnStep 回调传更详细参数）
|
|
|
-
|
|
|
-- [ ] **Step 1: 删 CalibWindow.xaml 底部区**
|
|
|
-
|
|
|
-将 `CalibWindow.xaml` 的 Grid 行定义（第 7-11 行）：
|
|
|
-```xml
|
|
|
- <Grid.RowDefinitions>
|
|
|
- <RowDefinition Height="Auto"/>
|
|
|
- <RowDefinition Height="*"/>
|
|
|
- <RowDefinition Height="120"/>
|
|
|
- </Grid.RowDefinitions>
|
|
|
-```
|
|
|
-改为（去掉第三行）：
|
|
|
-```xml
|
|
|
- <Grid.RowDefinitions>
|
|
|
- <RowDefinition Height="Auto"/>
|
|
|
- <RowDefinition Height="*"/>
|
|
|
- </Grid.RowDefinitions>
|
|
|
-```
|
|
|
-
|
|
|
-删除底部 Border 整块（第 28-34 行）：
|
|
|
-```xml
|
|
|
- <!-- 底部：仅当前参数/步骤文字(画面直接显示在上面对应well格内) -->
|
|
|
- <Border Grid.Row="2" Background="#252526" Padding="8" CornerRadius="4">
|
|
|
- <StackPanel VerticalAlignment="Center">
|
|
|
- <TextBlock x:Name="TxtCurParams" Text="当前: --" Foreground="White" FontSize="14"/>
|
|
|
- <TextBlock x:Name="TxtCurStep" Text="" Foreground="#DCDCAA" FontSize="13" Margin="0,4,0,0"/>
|
|
|
- </StackPanel>
|
|
|
- </Border>
|
|
|
-```
|
|
|
-（整段删除，无替代。）
|
|
|
-
|
|
|
-- [ ] **Step 2: 改 CalibWindow.xaml.cs 的 SetCurrentInfo**
|
|
|
-
|
|
|
-将现有 `SetCurrentInfo`（引用了已删除的 `TxtCurParams`/`TxtCurStep`）：
|
|
|
-```csharp
|
|
|
- public void SetCurrentInfo(string param, string step)
|
|
|
- {
|
|
|
- Dispatcher.Invoke(() =>
|
|
|
- {
|
|
|
- if (param != null) TxtCurParams.Text = param;
|
|
|
- if (step != null) TxtCurStep.Text = step;
|
|
|
- // 当前well格标题实时显示步骤+参数
|
|
|
- if (_activeWell >= 1 && _activeWell <= 16)
|
|
|
- {
|
|
|
- _cellCaps[_activeWell].Text = $"well {_activeWell} 标定中\n{step}\n{param}";
|
|
|
- _cellCaps[_activeWell].Foreground = Brushes.Yellow;
|
|
|
- }
|
|
|
- });
|
|
|
- }
|
|
|
-```
|
|
|
-替换为（去掉底部控件引用，well 格标题显示完整参数）：
|
|
|
-```csharp
|
|
|
- public void SetCurrentInfo(string param, string step)
|
|
|
- {
|
|
|
- Dispatcher.Invoke(() =>
|
|
|
- {
|
|
|
- if (_activeWell >= 1 && _activeWell <= 16)
|
|
|
- {
|
|
|
- _cellCaps[_activeWell].Text = $"well {_activeWell} 标定中\n{step}\n{param}";
|
|
|
- _cellCaps[_activeWell].Foreground = Brushes.Yellow;
|
|
|
- }
|
|
|
- });
|
|
|
- }
|
|
|
-```
|
|
|
-
|
|
|
-- [ ] **Step 3: OnStep 回调传更详细参数**
|
|
|
-
|
|
|
-在 `MainWindow.Calib.cs` 找到 OnStep 回调（145-151 行）：
|
|
|
-```csharp
|
|
|
- OnStep = (msg, circle, exp) =>
|
|
|
- {
|
|
|
- string param = circle != null && circle.Found
|
|
|
- ? $"圆心偏移 Y:{circle.OffsetYPct:F0}% X:{circle.OffsetXPct:F0}% 完整:{circle.Complete}"
|
|
|
- : "未检出well圆";
|
|
|
- win.SetCurrentInfo(param, msg);
|
|
|
- }
|
|
|
-```
|
|
|
-替换为（补 Z/水平/曝光等当前已知量；_lastZ/_lastH 是已有字段）：
|
|
|
-```csharp
|
|
|
- OnStep = (msg, circle, exp) =>
|
|
|
- {
|
|
|
- string circlePart = circle != null && circle.Found
|
|
|
- ? $"圆心偏移 Y:{circle.OffsetYPct:F0}% X:{circle.OffsetXPct:F0}% 完整:{circle.Complete}"
|
|
|
- : "未检出well圆";
|
|
|
- string expPart = exp != null ? $" 曝光信息:{exp}" : "";
|
|
|
- string param = $"Z:{_lastZ} 水平:{_lastH} {circlePart}{expPart}";
|
|
|
- win.SetCurrentInfo(param, msg);
|
|
|
- FileLogger.Data("CALIB", $"{msg} | {param}");
|
|
|
- }
|
|
|
-```
|
|
|
-注意：在 `MainWindow.Calib.cs` 顶部 using 区加 `using AutoFocusTool.Logging;`（若尚无）。
|
|
|
-（`exp` 是 `ExposureInfo` 类型，`$"{exp}"` 走其 ToString；若无意义可仅保留 circlePart。该回调天然把标定步骤数据落盘。）
|
|
|
-
|
|
|
-- [ ] **Step 4: 编译验证**
|
|
|
-
|
|
|
-Run: `dotnet build AutoFocusTool.csproj -c Debug`
|
|
|
-Expected: 生成成功，0 错误。
|
|
|
-
|
|
|
-- [ ] **Step 5: 运行验证**
|
|
|
-
|
|
|
-Run: `./bin/Debug/net8.0-windows/AutoFocusTool.exe`，连接后跑自动初始化，确认标定窗口底部不再有冗余文字区、well 格标题显示 Z/水平/曝光/偏移等详细参数。
|
|
|
-
|
|
|
-- [ ] **Step 6: 提交**
|
|
|
-
|
|
|
-```bash
|
|
|
-git add CalibWindow.xaml CalibWindow.xaml.cs MainWindow.Calib.cs
|
|
|
-git commit -m "feat(ui): 删CalibWindow底部冗余孔位数据 + well格预览显示详细参数
|
|
|
-
|
|
|
-Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>"
|
|
|
-```
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Self-Review（计划自检结果）
|
|
|
-
|
|
|
-- **Spec 覆盖**：
|
|
|
- - 子系统1（诊断+目录）→ Task 4（zcurve模式、输出TestData、记录亮度均值）+ Task 1（csproj排除TestData）。
|
|
|
- - 子系统2（UI）→ Task 5（删底部Border、预览参数详细）。
|
|
|
- - 子系统3（日志）→ Task 1（FileLogger）+ Task 2（Log落盘+Init+LogAction）+ Task 3（按钮埋点）。
|
|
|
- - 全覆盖，无遗漏。
|
|
|
-- **占位符**：无 TBD/TODO。Task 2/3 中按文件实际函数名调整文案的指引，均给了具体 LogAction 文本，非占位。
|
|
|
-- **类型/签名一致性**：`FileLogger.Init/Info/Action/Data/Warn/Error(category,msg)` 在 Task1 定义、Task2/3/5 一致调用；`LogAction(string)` Task2 定义、Task3 调用一致；`SetCurrentInfo(param, step)` 签名不变（Task5 只改内部实现），调用方 OnStep 一致。
|
|
|
-- **顺序**：日志(1-3)→诊断(4)→UI(5)，与 spec 实现顺序建议一致；各 Task 独立可编译可提交。
|
|
|
-- **范围**：未改 Sharpness 算法与对焦逻辑（Task4 仅诊断取证），与 spec 范围一致。
|
|
|
-
|
huangjie