Plugin Env

Plugin Env - 插件环境管理器

通过「环境（Profile）」概念，把插件组合打包成可一键应用的配置模板，实现真正的「一次配置，处处复用」。

功能特性

• 📦 环境管理：将插件组合保存为命名环境
• 🔄 一键切换：快速切换不同开发场景的插件配置
• 📝 透明存储：所有配置为可读 JSON，可手动编辑
• 🚫 零依赖：仅使用 Python 标准库

命令参考

命令	功能
penv	显示当前环境状态
penv list	列出所有可用环境
penv use <名称>	应用指定环境（完全覆盖）
penv reset	重置当前项目配置

内置环境

环境名称	描述
coding	通用代码开发场景
plugin-dev	插件开发场景

工作原理

1. SessionStart Hook：会话启动时自动检测并显示当前环境状态
2. UserPromptSubmit Hook：拦截 penv 开头的命令并执行
3. Profile 配置：存储在 profiles/ 目录的 JSON 文件
4. 状态持久化：项目 .claude/.penv-state.json 记录应用状态

目录结构

plugin-env/
├── .claude-plugin/
│   └── plugin.json       # 插件元数据
├── hooks/
│   ├── hooks.json        # Hook 配置
│   └── session-start.sh  # SessionStart 入口脚本
├── scripts/              # 核心 Python 模块
│   ├── main.py
│   ├── state_manager.py
│   ├── profile_manager.py
│   ├── settings_writer.py
│   ├── interactive_menu.py
│   └── user_prompt_handler.py
└── profiles/             # 环境配置
    ├── coding.json
    └── plugin-dev.json

添加自定义环境

在 profiles/ 目录创建 JSON 文件：

{
  "name": "my-env",
  "description": "我的自定义环境",
  "enabledPlugins": {
    "plugin-name@source": true
  }
}

注意事项

• 切换环境后需要运行 /reload 才能生效
• 应用环境采用 Replace 模式，会完全覆盖 enabledPlugins 配置