LizzieYzy完全上手攻略：从入门到精通

核心功能解析 ⚙️

鹰眼分析：棋局质量评估利器

当需要全面评估棋谱质量时，可通过鹰眼分析功能实现多维度数据可视化。该功能对比AI推荐选点与实际落子的胜率差异、目差波动及计算量，自动识别失误手并生成动态图表。适用场景包括赛后复盘、教学分析及职业棋谱研究。分析结果以胜率曲线图、目差波动柱状图直观呈现，支持导出高清图片用于报告制作。

闪电分析：批量棋谱快速处理

面对大量棋谱需要快速分析时，⚡闪电分析功能采用Katago的analysis模式实现并行计算。用户可一次性导入多个SGF文件，系统自动生成胜率走向图与关键选点建议。该功能特别适合棋谱库管理、赛事数据分析等场景，分析速度较传统模式提升3-5倍，支持自定义分析深度参数。

双引擎模式：多AI协同分析方案

专业用户需要对比不同AI见解时，双引擎模式允许同时加载Katago与LeelaZero等两款引擎。系统分栏显示双方分析结果，自动标记观点分歧点并计算一致性指标。此功能适用于引擎对比测试、复杂局面深度研究，支持动态切换引擎参数实时观察影响。

技术架构揭秘 🔧

核心模块交互流程图

用户界面(Swing) ⟷ 控制器(Controller) ⟷ 引擎管理器(EngineManager)
                                          ↓
                      ┌──────────┬───────────┬──────────┐
                      ▼          ▼           ▼          ▼
                  Katago引擎   LeelaZero   ZenGTP    SAI引擎
                      ↑          ↑           ↑          ↑
                      └──────────┴───────────┴──────────┘
                                          ↓
                                      GTP协议层
                                          ↓
                                    棋盘数据模型(Board)

关键技术解析

• GTP协议（围棋文本协议，用于引擎通信）：作为界面与AI引擎的标准化通信桥梁，支持genmove（生成选点）、kata-analyze（深度分析）等指令，确保不同引擎间的兼容性。
• Swing框架：构建跨平台图形界面的基础，通过自定义BoardRenderer组件实现高分辨率棋盘渲染，支持4K显示器与系统缩放自适应。
• 多线程分析引擎：采用线程池管理技术，实现分析任务并行处理，核心类AnalysisEngine负责任务调度与结果整合，避免界面卡顿。

零基础部署指南 🚀

环境预检：系统兼容性检查

1. Java环境验证：打开终端执行以下命令检查Java版本（需Java 8+）

   java -version  # 预期结果：显示java version "1.8.0_xxx"或更高版本
   

   常见误区：64位系统需安装64位JDK，否则可能出现内存不足错误

2. Git工具就绪：验证Git是否安装

   git --version  # 预期结果：显示git version x.y.z
   

快速部署：5分钟安装流程

1. 获取项目代码：克隆仓库到本地

   git clone https://gitcode.com/gh_mirrors/li/lizzieyzy  # 克隆项目仓库
   

2. 引擎准备：

   • 下载Katago引擎文件（如katago-linux）
   • 创建engines目录并存放引擎文件
   • 确保引擎具有可执行权限（Linux/macOS需执行chmod +x katago-linux）

3. 启动程序：

   cd lizzieyzy  # 进入项目目录
   java -jar LizzieYzy.jar  # 启动主程序
   

验证测试：功能完整性检查

1. 基础功能测试：

   • 确认主界面棋盘显示正常
   • 点击"文件"→"新建对局"验证基本落子功能
   • 打开"设置"→"引擎配置"确认引擎路径正确

2. 高级功能验证：

   • 加载示例棋谱后点击"分析"→"闪电分析"
   • 检查胜率图是否正常生成
   • 启用双引擎模式验证多引擎协同工作

高级配置技巧 🎯

引擎参数优化方案

通过src/main/java/featurecat/lizzie/Config.java调整核心参数：

• 分析深度控制：修改minPlayoutsForNextMove（默认30）调整选点计算量
• 内存分配：在启动命令中添加-Xmx4G分配4GB内存（推荐值为系统内存的50%）
• 线程管理：设置analysisThreads参数匹配CPU核心数（通常为物理核心数的1.5倍）

性能调优公式：最优线程数 = CPU核心数 × 1.2 + 2（兼顾计算与IO等待）

快捷键效率提升表

功能	快捷键	使用场景
鹰眼分析	Ctrl+H	复盘时快速启动分析
闪电分析	Ctrl+Shift+F	批量处理棋谱
切换坐标系	Ctrl+Shift+C	教学演示不同坐标体系
复制棋谱	Ctrl+Shift+S	快速分享当前局面
Kata评估	大键盘"."	快速调用形势判断

缓存管理策略

• 启用Lizzie缓存：在"设置→高级"中勾选"启用分析缓存"，减少重复计算
• 定期清理：通过"工具→清除当前缓存"释放磁盘空间，建议每分析50局清理一次
• 缓存路径自定义：修改config.txt中cacheDir参数指定高速磁盘位置，提升IO效率

常见问题排查 🛠️

引擎启动失败解决方案

故障现象：程序启动后提示"引擎连接失败"

1. 路径检查：验证引擎路径是否包含中文或空格，建议使用纯英文路径
2. 权限验证：Linux/macOS用户执行ls -l engines/katago确认权限位是否有"x"
3. 依赖检查：Windows用户需安装Visual C++运行库（vcredist_x64.exe）
4. 配置修复：删除config.txt后重启程序，使用默认配置重新设置

界面显示异常处理

当出现棋盘错位或文字模糊时：

1. 缩放设置：在"显示→缩放比例"中调整至100%，禁用系统DPI缩放
2. 主题切换：尝试切换至"sabaki"主题（设置→外观→主题选择）
3. 字体重置：删除fontconfig.properties文件恢复默认字体配置

分析结果异常排查

若AI分析出现明显不合理选点：

1. 权重文件检查：确认Katago使用的权重文件（如kata1-b40c256-s11806166016-d2780375341.bin.gz）是否匹配当前规则
2. 参数重置：在"引擎设置"中点击"恢复默认参数"，特别检查maxVisits是否设置过低
3. 温度参数：将temperature调整至0.8-1.0之间，避免过度确定性导致的盲点

功能对比表

功能特性	LizzieYzy	同类工具A	同类工具B
多引擎支持	✅ 同时加载2个引擎	❌ 单引擎	✅ 最多3个（需插件）
批量分析速度	⚡ 30局/分钟	🔄 8局/分钟	⚡ 22局/分钟
可视化效果	📊 12种图表类型	📊 5种图表类型	📊 8种图表类型
自定义主题	✅ 5套内置+自定义	❌ 仅2套	✅ 3套内置
快捷键数量	⌨️ 32个	⌨️ 15个	⌨️ 24个
内存占用	🛡️ 约400MB	🛡️ 约600MB	🛡️ 约520MB
跨平台支持	✅ Windows/macOS/Linux	✅ Windows/macOS	❌ 仅Windows

通过以上全面解析，您已掌握LizzieYzy的核心功能与高级应用技巧。无论是围棋爱好者的日常复盘，还是专业教练的教学分析，这款工具都能提供强大支持。持续关注项目更新以获取更多AI协同分析功能。