Share_Li/share

Host 121.196.200.148
    HostName 121.196.200.148
    Port 2222
    User git
    IdentityFile C:\Users\Klein\.ssh\id_rsa_kylin_Klein

在将 `ku2d-hmi` 转化为 Qt 工程的过程中，第一步“环境搭建与 CMake 改造”决定了后续开发的底层逻辑。其核心目标是：**在保留原有业务逻辑编译能力的基础上，引入 Qt 的构建套件。**

以下是该阶段的大方向实施步骤：

---

### 1. 开发环境基准对齐

在进行代码改动前，必须确保编译器与 Qt 库的版本兼容。

* **编译器确认**：根据 Qt 版本选择合适的 C++ 标准（Qt 6 建议使用 C++17 或更高）。
* **Qt 插件安装**：安装 Qt 本身及其对应的构建工具（如 Ninja 或 Make）。
* **IDE 准备**：配置 VS Code (配合 CMake 插件) 或 Qt Creator，使其能够正确识别项目的 `CMakeLists.txt`。

---

### 2. 核心逻辑的“库化”分离

为了不破坏原有的业务逻辑，需在构建层面将“计算逻辑”与“界面展示”解耦。

* **创建 Core 静态库**：修改 `src/CMakeLists.txt`，将 `protocol`, `business`, `infra`, `transport` 等非 UI 目录打包成一个名为 `ku2d_core` 的静态库。
* **清理依赖关系**：确保 `ku2d_core` 仅依赖 Protobuf、YAML-CPP 等基础库，而不依赖任何 Qt 组件。

---

### 3. 根目录 CMake 配置“Qt 化”

在顶级 `CMakeLists.txt` 中注入 Qt 的生命周期管理逻辑。



* **声明 Qt 依赖**：使用 `find_package` 指令显式引入 `Qt6` 的 `Core`, `Widgets`, `Gui` 模块。
* **开启自动处理机制**：
* `set(CMAKE_AUTOMOC ON)`：处理 Qt 信号槽宏。
* `set(CMAKE_AUTOUIC ON)`：处理 `.ui` 界面文件。
* `set(CMAKE_AUTORCC ON)`：处理图标等资源文件。



---

### 4. 创建 Qt 专用可执行程序目标

在 `src/app` 或新建的 UI 目录中，定义新的构建目标。

* **定义可执行文件**：创建一个新的编译目标（如 `ku2d-gui`），将其源文件指向新的 Qt `main.cpp` 和 UI 类。
* **执行目标链接**：将该目标与 `ku2d_core` 库以及 `Qt6::Widgets` 等库进行链接（Target Link Libraries）。

---

### 5. 入口函数重定向

将程序的控制权从原有的 C++ 循环移交给 Qt 事件循环。

* **主入口切换**：废弃原有的 `src/main.cpp` 启动逻辑，编写符合 Qt 规范的 `QApplication` 启动代码。
* **后台线程初始化**：在 Qt 启动前，确保原有的后端 `Coordinator` 能在非主线程中正确初始化。

---

### 6. 环境冒烟测试

验证构建系统是否闭环。

* **编译验证**：尝试执行 CMake Configure 和 Build，确保没有因库冲突导致的链接错误。
* **空窗运行**：启动程序，若能成功弹出一个空白的 `QMainWindow` 且后台日志正常滚动，则表示第一步环境搭建完成。


{
    // ==================== [ 核心功能与安全 ] ====================
    // 文件自动保存 - 延迟后自动保存
    "files.autoSave": "afterDelay",
    // 自动检测文件编码
    "files.autoGuessEncoding": true,
    // 保存时删除行尾空格
    "files.trimTrailingWhitespace": true,
    // 文件末尾插入最终换行符
    "files.insertFinalNewline": true,
    // 删除文件末尾多余换行符
    "files.trimFinalNewlines": true,
    // ==================== [ 代码格式化与缩进 (强制 4 空格) ] ====================
    // 强制使用空格进行缩进
    "editor.insertSpaces": true,
    // 强制设置缩进宽度为 4 个空格
    "editor.tabSize": 4,
    // 禁用自动检测，以确保 4 个空格的全局设置覆盖所有文件 (从 true 修正为 false，以确保强制执行)
    "editor.detectIndentation": true,
    // 启用保存时自动格式化
    "editor.formatOnSave": true,
    // ==================== [ 编辑器可视化与人体工学优化 ] ====================
    // **字体系列：** 整合新设置，并保留中文字体后备
    "editor.fontFamily": "JetBrains Mono",
    // 字体大小 (统一为 18)
    "editor.fontSize": 16,
    // 行高 (来自新设置，提升可读性)
    "editor.lineHeight": 26,
    // 字间距 (来自新设置，缓解视觉疲劳)
    "editor.letterSpacing": 0.7,
    // 启用字体连字 (来自笔记本设置)
    "editor.fontLigatures": true,
    // 显示空格/制表符边界：设置为 all 以便查看 4 个点表示一个制表符
    "editor.renderWhitespace": "all",
    // 启用缩进引导线（即制表位上的竖线）
    "editor.guides.indentation": true,
    // 行状光标更容易定位 (来自新设置)
    "editor.cursorStyle": "line",
    // 平滑闪烁，减少视觉疲劳 (来自新设置)
    "editor.cursorBlinking": "smooth",
    // 平滑滚动 (来自新设置)
    "editor.smoothScrolling": true,
    // 高亮活动括号对 (来自新设置)
    "editor.guides.bracketPairs": "active",
    // 显示标尺线
    "editor.rulers": [
        100,
        120
    ],
    // 禁用自动换行
    "editor.wordWrap": "off",
    // 启用 Tab 补全
    "editor.tabCompletion": "on",
    // 启用内联建议
    "editor.inlineSuggest.enabled": true,
    // ==================== [ 工作台与界面 ] ====================
    // 禁用预览模式 (来自笔记本设置)
    "workbench.editor.enablePreview": true,
    // 快速打开时禁用预览
    "workbench.editor.enablePreviewFromQuickOpen": false,
    // 始终显示缩略图滑块 (来自笔记本设置)
    "editor.minimap.showSlider": "always",
    // 只显示单个标签页
    "workbench.editor.showTabs": "multiple",
    // 隐藏空编辑器提示
    "workbench.editor.empty.hint": "hidden",
    // 颜色主题：默认采用新设置的 Monokai，如果喜欢 Dracular 请自行修改
    "workbench.colorTheme": "Monokai",
    // 启动时不打开编辑器
    "workbench.startupEditor": "none",
    // 文件图标主题
    "workbench.iconTheme": "vs-seti",
    // 文件树缩进
    "workbench.tree.indent": 24,
    // 文件树渲染缩进引导线
    "workbench.tree.renderIndentGuides": "always",
    // ==================== [ 终端配置 ] ====================
    // 终端字体系列 (来自新设置)
    "terminal.integrated.fontFamily": "Consolas",
    // 终端字体大小 (统一为 16)
    "terminal.integrated.fontSize": 16,
    // 终端行高 (来自新设置)
    "terminal.integrated.lineHeight": 1.4,
    // 终端平滑滚动 (来自笔记本设置)
    "terminal.integrated.smoothScrolling": true,
    // 终端光标样式
    "terminal.integrated.cursorStyle": "line",
    // 选择时自动复制 (来自笔记本设置)
    "terminal.integrated.copyOnSelection": true,
    // 右键粘贴 (来自笔记本设置)
    "terminal.integrated.rightClickBehavior": "paste",
    // 终端配置文件（保留 Windows 特定配置）
    "terminal.integrated.profiles.windows": {
        "PowerShell": {
            "source": "PowerShell",
            "icon": "terminal-powershell"
        },
        "Command Prompt": {
            "path": [
                "${env:windir}\\Sysnative\\cmd.exe",
                "${env:windir}\\System32\\cmd.exe"
            ],
            "args": [],
            "icon": "terminal-cmd"
        },
        "Git Bash": {
            "source": "Git Bash"
        },
        // 保留 PowerShell 7 路径，但建议使用 'source'
        "PowerShell 7 (pwsh)": {
            "path": "D:\\Software\\PowerShell\\7\\pwsh.exe",
            "args": []
        }
    },
    // ==================== [ 扩展与 AI 助手 ] ====================
    // Copilot 启用状态 (保留笔记本设置)
    "github.copilot.enable": {
        "*": true,
        "plaintext": false,
        "markdown": true,
        "scminput": false,
        "c": true,
        "cpp": true
    },
    "github.copilot.chat.codesearch.enabled": true,
    "github.copilot.nextEditSuggestions.enabled": true,
    // DeepSeek 语言设置 (保留，但密钥和 URL 已移除)
    "deepseek.lang": "cn",
    // Emmet 启用 Tab 展开 (保留)
    "emmet.triggerExpansionOnTab": true,
    // ==================== [ 性能与杂项优化 ] ====================
    // 文件资源管理器不确认删除/拖放
    "explorer.confirmDelete": false,
    "explorer.confirmDragAndDrop": false,
    "explorer.confirmPasteNative": false,
    // Git 自动拉取
    "git.autofetch": true,
    // ==================== [ 语言特定设置 ] ====================
    "[json]": {
        "editor.defaultFormatter": "vscode.json-language-features",
        "editor.formatOnSave": true
    },
    "[jsonc]": {
        "editor.defaultFormatter": "vscode.json-language-features",
        "editor.formatOnSave": true
    },
    "[javascript]": {
        "editor.defaultFormatter": "vscode.typescript-language-features",
        "editor.formatOnSave": true,
        "editor.codeActionsOnSave": {
            "source.organizeImports": "explicit"
        }
    },
    "[typescript]": {
        "editor.defaultFormatter": "vscode.typescript-language-features",
        "editor.formatOnSave": true,
        "editor.codeActionsOnSave": {
            "source.organizeImports": "explicit"
        }
    },
    "[html]": {
        "editor.defaultFormatter": "vscode.html-language-features",
        "editor.formatOnSave": true
    },
    "[css]": {
        "editor.defaultFormatter": "vscode.css-language-features",
        "editor.formatOnSave": true
    },
    "[markdown]": {
        "editor.defaultFormatter": "yzhang.markdown-all-in-one",
        "editor.formatOnSave": false
    },
    "markdown-preview-enhanced.previewTheme": "github-light.css",
    "geminicodeassist.project": "peta-tea-jrc5w",
    "chat.tools.terminal.autoApprove": {
        "git add": true,
        "/^Get-Command ninja -ErrorAction SilentlyContinue \\| Format-List; Get-Command cl -ErrorAction SilentlyContinue \\| Format-List; Get-Command nvcc -ErrorAction SilentlyContinue \\| Format-List$/": {
            "approve": true,
            "matchCommandLine": true
        },
        "docker build": true
    },
    "[cpp]": {
        "files.encoding": "utf8bom"
    },
    "[c]": {
        "files.encoding": "utf8bom"
    },
    "[h]": {
        "files.encoding": "utf8bom"
    },
    "terminal.integrated.shellArgs.windows": [
        "/k",
        "chcp 65001"
    ],
    "powershell.promptToUpdatePowerShell": false,
    "jdk.telemetry.enabled": true,
    "gitlens.ai.model": "vscode",
    "gitlens.ai.vscode.model": "copilot:gpt-5-mini",
    "security.workspace.trust.untrustedFiles": "open",
    "remote.SSH.remotePlatform": {
        "aliyun-dev-host": "linux",
        "home-dev-server": "linux"
    },
    "Lingma.aI Chat.commandAllowlistInAgentMode": "",
    "http.proxy": "http://127.0.0.1:7897",
    "makefile.configureOnOpen": true,
    "cmake.showOptionsMovedNotification": false,
    "cmake.pinnedCommands": [
        "workbench.action.tasks.configureTaskRunner",
        "workbench.action.tasks.runTask"
    ],
    "terminal.integrated.enableMultiLinePasteWarning": "auto",
    "cmake.configureOnOpen": false,
    "git.confirmSync": false,
    "python.analysis.typeCheckingMode": "standard",
    "diffEditor.codeLens": true,
    "gopls": {},
    "workbench.settings.applyToAllProfiles": [],
    "chat.agent.maxRequests": 100,
    "go.testTags": "integration",
    "editor.codeActionsOnSave": {},
    "roo-cline.allowedCommands": [
        "git log",
        "git diff",
        "git show"
    ],
    "roo-cline.deniedCommands": [],
    "http.systemCertificatesNode": true,
    "geminicodeassist.inlineSuggestions.enableAuto": false,
    "Lingma.aI Chat.webToolsInAsk/AgentMode": "Ask every time",
    "workbench.secondarySideBar.showLabels": false,
    "git.openRepositoryInParentFolders": "never",
    "markdown-preview-enhanced.codeBlockTheme": "vue.css",
    "window.customTitleBarVisibility": "windowed",
    "chatgpt.localeOverride": "zh-CN",
    "chatgpt.runCodexInWindowsSubsystemForLinux": false,
    "chat.viewSessions.orientation": "stacked",
}