Easy Prompt — AI 智能 Prompt 增强器

两步 AI 意图识别 + 85 个专业场景 + 10 大用户画像，将你的简单描述自动扩写为大师级 Prompt。

✨ 核心功能

• 🧠 两步智能路由：先识别意图场景，再用对应专业 Prompt 生成
• 🔀 复合意图支持：一句话包含多个意图也能精准处理
• ⚡ 智能增强：自动判断增强选中文本 / 当前文件 / 剪贴板内容
• 📦 97 个场景：覆盖开发全流程 + 内容创作 + 产品 + 营销 + 设计 + 数据 + HR + 客服 + 创业 + 教育
• 🧑‍💼 10 大画像：软件工程师/内容创作者/产品经理/市场运营/设计师/数据分析师/HR/客服/创业者/学生教育
• 🕐 增强历史：查看历史记录，支持 before/after 对比、一键复制、删除
• 🌐 四端覆盖：VSCode 扩展 + IntelliJ 插件 + 浏览器扩展（Chrome/Firefox/Safari） + Web 在线版，全场景使用
• 🟣 PromptHub 精选库：独立 AI Prompt 精选库（zhiz.chat），发现/收藏/分享高质量 Prompt，含热门榜单、银河星图、7 大精选合集
• ✨ Smart Nudge：浏览器扩展在 AI 网站（ChatGPT/Claude/Gemini 等 22 站）输入暂停后自动弹出增强提醒，一键增强
• 🔑 多供应商兼容：OpenAI / Azure / Gemini / DeepSeek / Ollama
• 🎯 开箱即用：内置 AI 服务，零配置即可使用
• 🔒 安全加固：AES-256-CBC 加密内置凭证、2MB 响应限制、7 规则智能输入验证、竞态保护

✨ Key Features (English)

• 🧠 Two-step Smart Routing: detect intent/scene first, then generate a specialized professional prompt
• 🔀 Composite Intents: accurately handles multiple intents in a single sentence
• ⚡ Smart Enhance: automatically enhances selection / current file / clipboard
• 📦 97 Scenes: covers the full dev lifecycle + content + product + marketing + design + data + HR + support + startup + education
• 🧑‍💼 10 Personas: engineer / creator / PM / growth / designer / analyst / HR / support / founder / student-educator
• 🕐 History: before/after comparison, copy, delete
• 🌐 Multi-platform: VSCode extension + IntelliJ plugin + Browser extension (Chrome/Firefox/Safari) + Web
• 🟣 PromptHub Library: Standalone AI prompt library (zhiz.chat) — discover, bookmark & share quality prompts with trending charts, Galaxy star-map & 7 curated collections
• ✨ Smart Nudge: (Browser Extension) pops an enhancement reminder when you pause typing on AI sites (ChatGPT/Claude/Gemini, etc.)
• 🔑 Multi-provider: OpenAI / Azure / Gemini / DeepSeek / Ollama
• 🎯 Works out of the box: built-in AI service, zero config required
• 🔒 Hardened: AES-256-CBC encrypted defaults, 2MB response cap, 7-rule input validation, race-condition protection

📦 安装

浏览器扩展（v5.0 新增）

支持 Chrome、Firefox、Safari 三大平台：

# 方式 1：从各平台扩展商店安装（推荐）
# Chrome Web Store / Firefox Add-ons / Safari Extensions 搜索 "Easy Prompt"

# 方式 2：本地构建安装
cd browser && node build.js          # 构建所有平台（chrome/firefox/safari）
cd browser && node build.js chrome   # 仅构建 Chrome
# 输出：browser/dist/<target>/ (解压目录) + browser/dist/easy-prompt-<target>.zip

# Chrome 开发者模式加载：
# chrome://extensions → 开启「开发者模式」→ 加载已解压的扩展 → 选择 browser/dist/chrome/

Web 在线版（v4.0 新增）

无需安装，打开浏览器即可使用：

• 访问 Easy Prompt Web 在线使用
• 或将 web/ 目录部署到任意静态服务器
• 纯前端 SPA，零后端依赖，支持所有主流浏览器

🟣 PromptHub — AI Prompt 精选库（v5.3 新增）

独立的 AI Prompt 精选库 Web 应用，帮助发现、收藏和分享高质量 Prompt：

• 访问 PromptHub 在线使用
• 精选库首页：分类筛选 + 难度/模型标签 + 瀑布流卡片布局
• 热门榜单：统计图表 + 排行榜 + 趋势分析
• Prompt 银河：Canvas 交互式星图可视化，全新方式浏览 Prompt
• 合集系统：7 个精选合集（开发者全套工具包 / 小红书运营 / AI 写作 / 数据分析等）
• 合集详情页：Hero 横幅 + 分类标签 + Prompt 列表 + 一键复制
• 收藏夹管理：收藏/取消收藏 + 搜索 + 排序
• 提交 Prompt：分享你的高质量 Prompt 到精选库
• 暗色/亮色主题：一键切换，oklch 色彩空间
• 技术栈：React 18 + TypeScript + Vite 6 + Tailwind CSS v4 + Framer Motion

VSCode

# 方式 1：从 VSCode Marketplace 安装（推荐）
# 搜索 "Easy Prompt" 或访问 Marketplace 页面直接安装

# 方式 2：本地打包安装
npx @vscode/vsce package --allow-missing-repository
code --install-extension easy-prompt-ai-5.3.2.vsix

# 方式 3：开发调试
code .  # 按 F5 启动调试

IntelliJ IDEA

# 方式 1：从 JetBrains Marketplace 安装（推荐）
# Settings → Plugins → Marketplace → 搜索 "Easy Prompt"

# 方式 2：本地构建安装（需要 JDK 17）
cd intellij && ./gradlew buildPlugin
# Settings → Plugins → ⚙️ → Install Plugin from Disk
# 选择 intellij/build/distributions/easy-prompt-intellij-5.3.2.zip

📦 Installation (English)

Browser Extension (v5.0+)

Supports Chrome, Firefox and Safari.

• Option 1 (recommended): install from the extension stores — search "Easy Prompt"
• Option 2: build locally:

cd browser && node build.js
cd browser && node build.js chrome

Web (v4.0+)

No installation required:

• Open https://prompt.zhiz.chat
• Or deploy the web/ folder to any static host (pure frontend SPA)

🟣 PromptHub — AI Prompt Library (v5.3+)

A standalone AI prompt curated library web app:

• Open https://zhiz.chat to browse
• Curated homepage: category filters + difficulty/model tags + masonry card layout
• Trending: charts + leaderboard + trend analysis
• Prompt Galaxy: Canvas interactive star-map for visual prompt exploration
• Collections: 7 curated collections (Dev Toolkit / Xiaohongshu / AI Writing / Data Analysis, etc.)
• Collection detail pages: Hero banner + tags + prompt list + one-click copy
• Favorites: bookmark / search / sort
• Submit prompts: share your quality prompts to the library
• Dark/light theme: one-click toggle, oklch color space
• Tech stack: React 18 + TypeScript + Vite 6 + Tailwind CSS v4 + Framer Motion

VSCode

• Option 1 (recommended): install from VSCode Marketplace — search "Easy Prompt"
• Option 2: package & install locally:

npx @vscode/vsce package --allow-missing-repository
code --install-extension easy-prompt-ai-5.3.2.vsix

IntelliJ IDEA

• Option 1 (recommended): Settings → Plugins → Marketplace → search "Easy Prompt"
• Option 2: build & install from disk:

cd intellij && ./gradlew buildPlugin

Then: Settings → Plugins → ⚙️ → Install Plugin from Disk → select intellij/build/distributions/easy-prompt-intellij-5.3.2.zip

⚙️ 配置

VSCode

打开 Settings（Cmd+,），搜索 Easy Prompt：

💡 开箱即用：安装后无需任何配置即可使用内置 AI 服务。如需使用自己的 API，可通过命令面板 Easy Prompt: 配置自定义 API 一键配置（支持测试验证）。

IntelliJ IDEA

Settings → Tools → Easy Prompt（支持一键「测试并保存」）

📖 详细配置指南: 查看 API_CONFIG.md 了解各 API 提供商的配置示例（OpenAI / Azure / Gemini / DeepSeek / Ollama）

⚙️ Configuration (English)

VSCode

Open Settings (Cmd+,) and search for Easy Prompt.

💡 Works out of the box: leave everything empty to use the built-in service. To use your own API, run the Command Palette action Easy Prompt: 配置自定义 API (includes connection test).

IntelliJ IDEA

Settings → Tools → Easy Prompt (one-click “Test & Save”).

📖 Detailed guide: see API_CONFIG.md for provider examples (OpenAI / Azure / Gemini / DeepSeek / Ollama).

🎯 使用方式

快捷键（9 个命令 · 7 个快捷键）

使用流程

1. 在编辑器中写下你的需求（可以很简单、很混乱）
2. 选中文本，按 Ctrl+Alt+I（智能增强）或 Ctrl+Alt+P（增强选中）
3. 等待 AI 两步处理：
   • 🔍 Step 1：意图识别（~1-2 秒）
   • ✍️ Step 2：专业 Prompt 生成（~3-5 秒）
4. 选中文本被自动替换为专业级 Prompt
5. 将生成的 Prompt 发给 Copilot / ChatGPT 获得高质量回答

🎯 Usage (English)

Shortcuts (9 commands · 7 keybindings)

Workflow

1. Write your request in the editor (it can be short and messy).
2. Select the text and press Ctrl+Alt+I (Smart Enhance) or Ctrl+Alt+P (Enhance Selection).
3. Wait for the two-step pipeline:
   • 🔍 Step 1: intent/scene recognition (~1–2s)
   • ✍️ Step 2: professional prompt generation (~3–5s)
4. Your selected text will be replaced with the enhanced prompt.
5. Send the generated prompt to Copilot / ChatGPT for a much better answer.

📋 97 个场景

💡 痛点示例：Before → After

🏗️ 项目结构

easy-prompt/
├── core/                    # 共享核心逻辑（CommonJS，平台无关）
│   ├── index.js             # 统一导出
│   ├── scenes.js            # 97 个场景定义（含痛点和示例）
│   ├── router.js            # 意图识别路由器 + Prompt 构建
│   ├── composer.js          # 两步路由编排器（smartRoute）
│   ├── api.js               # API 调用层（curl subprocess + 重试 + 安全限制）
│   └── defaults.js          # 内置默认配置（AES-256-CBC 加密）
├── extension.js             # VSCode 扩展入口（9 命令注册 + 核心逻辑）
├── welcomeView.js           # Welcome 引导页（Webview）
├── package.json             # VSCode 扩展清单（9 命令 + 7 快捷键）
├── intellij/                # IntelliJ IDEA 插件（Kotlin）
│   ├── build.gradle.kts     # Gradle 构建配置
│   └── src/main/kotlin/com/easyprompt/
│       ├── actions/         # 8 个 Action（智能增强/增强选中/输入/场景/指定/教程/菜单/历史）
│       ├── core/            # 路由 + API + 场景 + 内置默认配置
│       ├── settings/        # 配置管理（测试并保存）
│       └── ui/              # Welcome 对话框 + 状态栏 Widget + 启动检测
├── web/                     # Web 在线版（v4.0 新增）
│   ├── index.html           # 主页面（SPA 入口）
│   ├── style.css            # 样式（暗色主题 + 响应式）
│   ├── app.js               # 应用逻辑（路由 + 场景 + API 调用）
│   └── scenes.json          # 97 场景数据（由 core 生成）
├── browser/                 # 浏览器扩展（v5.0 新增，Chrome/Firefox/Safari MV3）
│   ├── manifest.*.json      # 三平台 manifest（chrome/firefox/safari）
│   ├── build.js             # 构建脚本（自动打包 + zip）
│   ├── popup/               # Popup 面板（输入/增强/场景/历史）
│   ├── options/             # 设置页（API 配置 + 测试连接）
│   ├── background/          # Service Worker（上下文菜单 + 快捷键）
│   ├── content/             # Content Script（浮动增强按钮）
│   ├── shared/              # 共享模块（Storage/API/Router/Scenes/Defaults/Icons）
│   └── scenes.json          # 97 场景数据
├── web-hub/                 # 🟣 PromptHub 独立 Web 应用（v5.3 新增）
│   ├── package.json         # 独立依赖（React + TypeScript + Vite + Tailwind CSS v4）
│   ├── vite.config.ts       # Vite 构建配置（代码分割策略）
│   └── src/                 # React SPA 源码
│       ├── app/components/  # UI 组件（Navbar/PromptCard/Drawer 等）
│       ├── app/pages/       # 路由页面（Home/Trending/Galaxy/Collections/Profile 等）
│       ├── app/hooks/       # 自定义 Hooks（usePromptStore 等）
│       └── app/data/        # 数据层（prompts/collections/constants）
├── README.md
├── CHANGELOG.md
└── .github/
    └── copilot-instructions.md

📚 文档

• PromptHub — AI Prompt 精选库 — 在线浏览、收藏和分享高质量 Prompt
• Easy Prompt Web 在线版 — 无需安装，浏览器直接使用
• API_CONFIG.md — 各 API 提供商详细配置指南（OpenAI / Azure / Gemini / DeepSeek / Ollama）
• FAQ.md — 常见问题与故障排查
• CHANGELOG.md — 版本更新日志
• RELEASE_CHECKLIST.md — 发布前检查清单
• CLAUDE.md — Claude Code 项目规范

❓ 故障排查

常见问题

Q: 提示 "请先配置 API Key"？ A: Easy Prompt 开箱即用，无需配置。如需自定义 API，通过 Easy Prompt: 配置自定义 API 命令配置（支持一键测试验证）。

Q: 提示 "未找到 curl 命令"？（VSCode 端） A:

• Windows: 确保 Windows 10+ 自带的 curl 在 PATH 中
• macOS/Linux: 系统自带，检查 PATH 环境变量

Q: API 调用超时？ A: 检查网络连接、Base URL 配置、API Key 是否有效。系统内置自动重试机制（最多 4 次，指数退避）。

Q: AI 识别的场景不对？ A: 使用「指定场景增强」功能（Ctrl+Alt+M）手动选择场景

Q: IntelliJ 构建失败？ A: 确保安装了 JDK 17：brew install openjdk@17，然后 JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home ./gradlew buildPlugin

更多问题请查看 FAQ.md

🛡️ 安全特性

• 内置凭证加密：AES-256-CBC + 多层混淆（分散存储 + 打乱索引 + charCode 构造）
• 响应体限制：2MB 最大响应大小，防止 OOM
• 输入长度限制：最大 10000 字符
• curl 进程安全：超时 + 10 秒强制 Kill Timer
• 竞态保护：文档替换前验证选区偏移量 + 文档切换检查
• Base URL 规范化：自动去除尾部斜杠，智能拼接 /chat/completions 路径

🔧 开发与测试

运行核心功能测试

node test.js

VSCode 插件开发

code .  # 在项目根目录按 F5 启动调试

# 语法检查
node --check extension.js && node --check welcomeView.js && node --check core/index.js

# 打包
npx @vscode/vsce package --allow-missing-repository

IntelliJ 插件开发

cd intellij

# 编译验证（需 JDK 17）
JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home ./gradlew compileKotlin

# 构建插件
JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home ./gradlew buildPlugin

# 启动调试 IDE
JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home ./gradlew runIde

浏览器扩展开发

cd browser

# 构建所有平台
node build.js

# 仅构建指定平台
node build.js chrome
node build.js firefox
node build.js safari

# 输出目录：browser/dist/<target>/ + browser/dist/easy-prompt-<target>.zip

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/AmazingFeature
3. 提交更改：git commit -m 'Add some AmazingFeature'
4. 推送分支：git push origin feature/AmazingFeature
5. 提交 Pull Request

📄 License

MIT