3.4 KiB
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
项目概述
Path Editor 是一个 Windows 系统环境变量（PATH）管理工具，使用 C 语言和 IUP 图形库开发。支持系统变量和用户变量的双视图编辑、智能路径检测、自动备份、JSON 导入导出等功能。
构建与运行
# 配置（需要 MinGW-w64 和 CMake 在 PATH 中）
cmake -B build -G "MinGW Makefiles"
# 编译
cmake --build build
# 打包
build_installer.bat
# 以管理员身份运行
powershell -Command "Start-Process 'build\\PathEditor.exe' -Verb RunAs"
编译器为 MinGW-w64 GCC，C17 标准。IUP 3.31 和 Lua 5.5 库已包含在 libs/ 目录下。CMake 在 POST_BUILD 阶段自动复制运行时 DLL 到输出目录。
架构
项目采用 MVC 分层架构：
src/
├── 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 枚举
数据流: registry_service 从注册表加载 → AppContext 持有 StringList → UI 展示 → 用户操作经 callbacks 调用 path_manager 修改 StringList → registry_service 写回注册表 → WM_SETTINGCHANGE 广播。
UI 控件寻址：控件通过 IupSetHandle("NAME", handle) 注册名称，通过 IupGetHandle("NAME") 或 IupGetDialogChild(dlg, "NAME") 查找，不使用全局变量。AppContext 通过 IupSetAttribute(dlg, "APP_CONTEXT", ctx) 挂载到对话框上。
Lua 配置：lua/config.lua 定义所有 UI 文本和布局参数（按钮文字、颜色、尺寸等），通过 lua_config_get_string("section", "key") 读取，修改后无需重新编译。
关键约束
- IUP UTF8MODE 必须在
IupOpen()之前通过putenv("IUP_UTF8MODE=YES")设置 IupFlatList数据操作必须在IupShowXY（控件 Map）之后才能生效- 管理员权限检测通过尝试以 KEY_WRITE 打开注册表键实现
- 非管理员模式下所有修改按钮和保存按钮被禁用
- PATH 注册表值使用
REG_EXPAND_SZ类型，支持%SystemRoot%等变量展开 - 拖拽支持在管理员模式下需要调用
ChangeWindowMessageFilter绕过 UIPI