User Environment Manager
一个用于可视化管理 macOS 用户级 Zsh 环境变量的 VS Code 插件。目前支持：
- 管理交互式终端配置
~/.zshrc。
- 管理登录 Shell 配置
~/.zprofile。
- 管理所有 Zsh 进程都会读取的
~/.zshenv。
- 通过“其他”添加任意数量的自定义配置文件路径。
- 在侧边栏添加、修改和删除环境变量。
- 区分“纯文本”和“变量引用”两种值模式。
- 只读展示配置文件中已有的常见
export 变量。
- 保存前自动备份，并可恢复最新备份。
自定义配置文件
点击配置标签下方的“其他”，可以：
- 一次选择一个或多个已有配置文件。
- 设置一个尚未创建的新配置文件路径，第一次保存变量时自动创建文件。
- 在侧边栏横向切换任意数量的自定义配置文件。
- 使用“忘记路径”移除本地记录；该操作不会删除或修改原文件。
自定义路径保存在 VS Code 本机 globalState 中，不会写入项目仓库，也不会同步到远程开发主机。Webview 只持有注册后的目标标识，实际文件路径由扩展后端解析，未注册路径不能直接进入文件读写服务。
安全策略
插件不会执行或 source 用户的 Shell 配置。插件只维护如下受控区块，区块外脚本保持原样：
# >>> vscode-user-environment-manager >>>
export JAVA_HOME="/Library/Java/JavaVirtualMachines/example" # vscode-user-environment-manager:literal
export PATH="$JAVA_HOME/bin:$PATH" # vscode-user-environment-manager:reference
# <<< vscode-user-environment-manager <<<
修改已有文件前，原文件会备份到：
~/.vscode-user-environment-manager/backups/
写入完成后，插件会立即回读并校验磁盘内容。受控标记缺失、重复或顺序异常时，插件会停止修改。
本地运行
- 使用 VS Code 打开项目目录。
- 按
F5 启动 Extension Development Host。
- 在新窗口活动栏中打开“环境变量”。
- 添加变量并保存；新开终端后验证变量是否生效。
项目使用原生 JavaScript，无需安装运行时依赖。执行定向测试：
npm test
执行语法检查：
npm run check
当前范围
当前版本默认处理当前 macOS 用户的 ~/.zshrc、~/.zprofile 和 ~/.zshenv，也可以由用户明确选择其他有权限访问的配置文件。插件不修改系统级环境配置，也不管理通过 Finder 或 Dock 启动的图形应用环境变量。
点击保存后，目标文件会立即写入并回读校验，但环境变量不能反向注入已经运行的进程。新终端或新 Zsh 进程会读取最新配置；当前终端需要重新打开或手动执行对应的 source 命令，IDEA 和 VS Code 等已运行应用通常需要完全重启。
插件声明为本机 UI 扩展；即使 VS Code 正连接 Remote SSH、WSL 或 Dev Container，配置服务仍在本机 Extension Host 中运行，避免误改远端用户目录。
