mirror of
https://github.com/LHY0125/PathEditor.git
synced 2026-07-01 03:25:54 +08:00
Compare commits
4 Commits
v5.0
...
06aee13f55
| Author | SHA1 | Date | |
|---|---|---|---|
| 06aee13f55 | |||
| 9d0797eafa | |||
| f69787a110 | |||
| a8f1bfeaab |
@@ -1,6 +1,7 @@
|
||||
/.trae/
|
||||
/.vscode/
|
||||
/build/
|
||||
/build*/
|
||||
|
||||
*.o
|
||||
*.obj
|
||||
|
||||
@@ -0,0 +1,67 @@
|
||||
# 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 导入导出等功能。
|
||||
|
||||
## 构建与运行
|
||||
|
||||
```bash
|
||||
# 配置(需要 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
|
||||
Reference in New Issue
Block a user