From 06aee13f55a0e66accd051c9d5d73ded2c0808ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E8=88=AA=E5=AE=87?= <3364451258@qq.com> Date: Fri, 15 May 2026 07:42:35 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0CLAUDE.md=E4=BB=A5?= =?UTF-8?q?=E5=8C=B9=E9=85=8Dv2.6=20MVC=E6=9E=B6=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.7 --- CLAUDE.md | 63 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 38 insertions(+), 25 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 1e2a83c..ccfc81c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,51 +4,64 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 项目概述 -Path Editor 是一个 Windows 系统环境变量 PATH 编辑器，使用 C 语言和 IUP 图形库开发。通过读写注册表 `HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\Path` 来管理系统 PATH。 +Path Editor 是一个 Windows 系统环境变量（PATH）管理工具，使用 C 语言和 IUP 图形库开发。支持系统变量和用户变量的双视图编辑、智能路径检测、自动备份、JSON 导入导出等功能。 ## 构建与运行 ```bash -# 配置（需要 MinGW-w64 和 CMake 3.15+ 在 PATH 中） +# 配置（需要 MinGW-w64 和 CMake 在 PATH 中） cmake -B build -G "MinGW Makefiles" # 编译 cmake --build build -# 运行（必须以管理员身份） -bin/PathEditor.exe +# 打包 +build_installer.bat + +# 以管理员身份运行 +powershell -Command "Start-Process 'build\\PathEditor.exe' -Verb RunAs" ``` -编译器为 MinGW-w64 GCC。CMake 自动处理 `windres` 资源文件编译和 IUP DLL 复制。IUP 3.31 库已包含在 `libs/` 目录下，无需额外安装。 - -## 打包 - -使用 Inno Setup 6 生成安装包。先编译生成 exe，再用 Inno Setup 编译 `dist/installer.iss`。 +编译器为 MinGW-w64 GCC，C17 标准。IUP 3.31 和 Lua 5.5 库已包含在 `libs/` 目录下。CMake 在 POST_BUILD 阶段自动复制运行时 DLL 到输出目录。 ## 架构 +项目采用 **MVC 分层架构**： + ``` src/ - main.c 入口，构建 UI 布局（IupDialog + IupFlatList + 按钮） - callbacks.c 所有按钮回调 + 自定义输入对话框 - registry.c 注册表读写：load_path() / save_path() - utils.c 编码转换 + 管理员权限检测 + 斑马纹刷新 -include/ - globals.h 全局 Ihandle* 指针和注册表路径常量 - callbacks.h 回调函数声明 - registry.h 注册表操作声明 - utils.h 工具函数声明 +├── main.c # 入口：初始化日志/Lua/UI，创建 AppContext +├── core/ # Model — 业务逻辑，零 IUP 依赖 +│ ├── registry_service.c # Windows 注册表读写 +│ ├── path_manager.c # 路径增删移查与清理 +│ ├── app_context.c # 应用运行时状态（StringList sys/user） +│ ├── import_export.c # JSON/TXT 导入导出 +│ └── lua_config.c # Lua 配置热加载 +├── ui/ # View — IUP 界面构建 +│ ├── main_window.c # 主窗口布局（Tab、列表、按钮、状态栏） +│ ├── dialogs.c # 自定义输入对话框 +│ └── ui_utils.c # 斑马纹刷新等界面工具 +├── controller/ # Controller — 连接 UI 与 Model +│ └── callbacks.c # 所有按钮/搜索/拖拽/键盘回调 +└── utils/ # 纯工具层，无业务依赖 + ├── string_ext.c # StringList 动态字符串数组 + ├── os_env.c # 编码转换 + 管理员权限检测 + ├── safe_string.c # 安全字符串操作 + ├── logger.c # 日志系统 + └── error_code.h # 统一 ErrorCode 枚举 ``` -**数据流**: `load_path()`（注册表 → 列表） → 用户操作（按钮回调） → `save_path()`（列表 → 注册表 → `WM_SETTINGCHANGE` 广播） +**数据流**: `registry_service` 从注册表加载 → `AppContext` 持有 StringList → UI 展示 → 用户操作经 `callbacks` 调用 `path_manager` 修改 StringList → `registry_service` 写回注册表 → `WM_SETTINGCHANGE` 广播。 -**编码约定**: IUP 使用 UTF-8，Windows 注册表 API 使用 UTF-16 (wide char)。`utils.c` 提供 `wide_to_utf8()` 和 `utf8_to_wide()` 完成转换。 +**UI 控件寻址**：控件通过 `IupSetHandle("NAME", handle)` 注册名称，通过 `IupGetHandle("NAME")` 或 `IupGetDialogChild(dlg, "NAME")` 查找，不使用全局变量。AppContext 通过 `IupSetAttribute(dlg, "APP_CONTEXT", ctx)` 挂载到对话框上。 -**全局控件**: 所有 IUP 控件句柄（`dlg`, `list_path`, `lbl_status`, 各按钮）在 `main.c` 定义并通过 `globals.h` 声明为 `extern`，回调函数和工具函数直接访问它们。 +**Lua 配置**：`lua/config.lua` 定义所有 UI 文本和布局参数（按钮文字、颜色、尺寸等），通过 `lua_config_get_string("section", "key")` 读取，修改后无需重新编译。 ## 关键约束 -- 必须以管理员身份运行才能保存更改（`check_admin()` 通过尝试以 `KEY_WRITE` 打开注册表来检测） -- IUP 的 `UTF8MODE` 必须在 `IupOpen()` 之前通过 `putenv("IUP_UTF8MODE=YES")` 设置 -- `IupFlatList` 的数据操作（`APPEND` 等属性）必须在控件 Map 之后（`IupShowXY` 之后）才能生效 -- PATH 使用 `REG_EXPAND_SZ` 类型以支持 `%SystemRoot%` 等变量展开 +- IUP UTF8MODE 必须在 `IupOpen()` 之前通过 `putenv("IUP_UTF8MODE=YES")` 设置 +- `IupFlatList` 数据操作必须在 `IupShowXY`（控件 Map）之后才能生效 +- 管理员权限检测通过尝试以 KEY_WRITE 打开注册表键实现 +- 非管理员模式下所有修改按钮和保存按钮被禁用 +- PATH 注册表值使用 `REG_EXPAND_SZ` 类型，支持 `%SystemRoot%` 等变量展开 +- 拖拽支持在管理员模式下需要调用 `ChangeWindowMessageFilter` 绕过 UIPI