docs: 诊断/UI/日志 三子系统实现计划

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/superpowers/plans/2026-06-16-diagnostics-ui-logging.md

@@ -0,0 +1,594 @@
+# 诊断/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 范围一致。
+