All notable changes to the Easy Prompt project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- 新增：Zhiz OAuth 全链路能力 — 后端补齐 Zhiz OAuth、密码设置邮件与 link-status/finish/status 能力；Web-Hub 增加 auth completion、密码设置完成与 continuation flow，覆盖“登录 / 绑定 / 设密 / 回流”关键链路。
- 新增：Zhiz Skill 真实拉取能力 — Browser / Web / Backend / Core 打通真实 skill fetch，Skill Panel 不再停留在静态占位，支持多端统一展示 Zhiz Skills。
- 新增：多端 Zhiz 登录入口 — VS Code、IntelliJ、Browser Options 与 Web / PromptHub 补齐 Zhiz 登录 / 绑定入口，降低跨端账号联动成本。
- 变更：OAuth 上游与运行时环境区分 — Zhiz 授权页、token / skill upstream 与 SSO / Web / Backend 公网地址继续按 development / production 分流，避免本地调试与生产部署串环境。
- 变更：Skill 编辑前置绑定校验 — Web / Browser 在进入 Skill 编辑前先检查 Zhiz link-status，并提供续绑引导；PromptHub Profile 补齐绑定卡片与后续跳转。
- 变更：发布链路与发布门禁 — 引入 env-aware release gate、backend deploy env guard、各端 published 脚本与文档同步，降低发版漏项与运行态 env 漂移风险。
- 修复：后端运行稳定性 — 补齐 AiRequestLog 关键字段、保留错误链路诊断信息，并增强生产环境
core/scenes.js多路径探测，提升后端可观测性与兼容性。 - 修复：生产部署环境歧义 — Backend 发布脚本显式使用 PM2 production reload，避免线上继续沿用 development 环境默认值。
本版本正式引入 Easy Prompt 统一后端服务（api.zhiz.chat），完成 Phase 1 ~ Phase 4 共约 80 项任务，为全端客户端提供集中式 AI 增强代理、认证、PromptHub 数据层和内容管理能力。
- 新增：统一后端服务 — 基于 Express 5 + TypeScript + Prisma + PostgreSQL 16 + Redis 的全栈后端，部署在
api.zhiz.chat（PM2 cluster × 2） - 新增：AI 代理网关 —
POST /api/v1/ai/enhance统一增强接口，支持 4 种 API 协议（openai / openai-responses / claude / gemini），路由超时 30s、生成超时 90s - 新增：认证系统 — 邮箱注册/登录 + JWT Access/Refresh Token + SSO 授权码交换，支持匿名和认证两种访问模式
- 新增：多维黑名单 — IP / 用户 / 指纹三维度封禁检查，Redis 缓存 + CRUD 管理接口
- 新增：滑动窗口限流 — Redis ZSET 实现，BAN_LADDER 阶梯升级封禁策略
- 新增：Provider 管理 — API Key 加密存储（AES-256-CBC）、多 Provider CRUD、权重轮询选择
- 新增：PromptHub 数据层（Phase 3） — Prompt CRUD + PostgreSQL 全文检索（tsvector + pg_trgm）+ 用户交互（点赞/收藏/复制）+ Collection 管理 + 成就系统
- 新增：Trending 与内容管理（Phase 4） — 热门排行算法（时间衰减加权评分）+ 每日精选 + 分类趋势 + Admin 内容审核流程
- 新增：请求分析与审计（Phase 2） — AI 增强专用日志 + 管理员操作审计日志 + Pino 日志轮转（app / audit / ai-request 三通道）
- 新增：定时任务 — Cron 定时刷新 Trending 缓存、清理过期 Token、Featured 精选刷新
- 新增：全端 SSO 登录入口 — VS Code welcomeView + IntelliJ ToolWindow + Welcome Screen 均新增 zhiz.chat 登录 CTA
- 新增：全端 backendMode 配置 — VS Code / IntelliJ / Browser / Web 新增
auto/backend-only/local-only三模式开关
- 修复：AI 增强 504 超时 — 后端 ai-gateway 路由超时上限 30s、生成超时下限 90s，Provider 默认超时从 30s 提升至 90s
- 修复：Web 端后端超时对齐 —
web/app.js后端请求超时从 30s 对齐到 90s，与 Browser 端一致
- Prisma Schema：18 个数据模型（users / prompts / collections / ai_providers / ai_request_logs / blacklist_rules 等）
- 数据库迁移：PostgreSQL 16 + Docker 容器，Prisma migrate deploy
- Redis：Docker 容器，用于限流/黑名单缓存/SSO code/Trending 缓存
- Nginx：宝塔面板管理，HTTPS + 反向代理 + SSE 支持 + Gzip
- PM2：cluster × 2 实例，graceful reload 零停机部署
- 测试：55 项通过（20 单元 + 35 集成），
tsc --noEmit0 errors
| Method | Path | Auth |
|---|---|---|
| POST | /api/v1/auth/register | — |
| POST | /api/v1/auth/login | — |
| POST | /api/v1/auth/refresh | — |
| GET | /api/v1/auth/me | required |
| POST | /api/v1/auth/sso/authorize | required |
| POST | /api/v1/auth/sso/token | — |
| POST | /api/v1/ai/enhance | optional |
| GET | /api/v1/meta/categories | — |
| GET | /api/v1/meta/models | — |
| GET/POST/PUT/DELETE | /api/v1/prompts | varies |
| GET | /api/v1/collections | — |
| GET | /api/v1/trending/* | — |
| GET/POST/DELETE | /api/v1/admin/blacklist | admin |
| GET/POST/PUT/DELETE | /api/v1/admin/providers | admin |
| GET | /health | — |
本版本正式以 Fast / Deep 双模式 作为对外发布主题：两种模式保持同模型、同接口，只在第二步生成的输出深度上区分；Fast 更精炼，Deep 更完整。
- 发布：Fast / Deep 双模式 — 全端统一说明，保持现有模型配置与 API 协议不变
- 语义统一：同模型、同接口 —
fast/deep不新增公共 API、不自动切换模型、不修改请求路径或协议 - 结果差异：只体现在第二步输出深度 — Fast 更精炼直接，Deep 更完整充分
- Browser 稳定性优先 — 浏览器扩展中的 Fast / Deep 不改变请求形状，降低真实浏览器环境中的跨域与超时回归风险
本版本主要完成 5.3.5 发版对齐，修正多端界面、安装文档与测试脚本中的过期版本/文案，确保当前发布物与实际产品状态一致。
- 同步：全端版本号升级至 5.3.5 — VSCode / IntelliJ / Browser / Web 的版本显示与安装引用统一更新
- 修正：内置默认模型说明 — VSCode 配置项中“留空使用内置默认模型”明确为
gpt-5.4 - 修正：当前场景数量展示 — Welcome 页、Web 在线版、README、IntelliJ Marketplace 描述统一为 97 个场景
- 修正：发布文档与校验脚本中的过期版本引用 — README、RELEASE_CHECKLIST、
test-full.js等同步更新
用户使用 openai-responses 模式时，上游服务偶发返回 "Upstream request failed" 导致无法增强 Prompt。本版本在全部 4 端同步修复此问题。
- 新增：自动回退机制 —
openai-responses模式遇到 "Upstream request failed" 后，自动回退到标准/chat/completions端点重试，用户无感知 - 新增：
shouldTryResponsesFallback— 检测当前是否满足回退条件（仅openai-responses模式 + 特定错误） - 新增：
stripApiEndpoint— 从 Base URL 中剥离/responses、/chat/completions、/messages等路径后缀 - 新增：友好错误提示 — "Upstream request failed" 映射为中文友好消息「上游模型服务暂时不可用」
- 修复：
isRetryableError增加 "upstream request failed" 模式 — 纳入可重试错误列表 - 修复：core/api.js 致命 Bug —
shouldTryResponsesFallback和stripApiEndpoint在callApi中被调用但从未定义（ReferenceError），本版本补全定义
- VSCode 扩展 (core/api.js)：补全缺失函数定义 + isRetryableError 模式
- IntelliJ 插件 (ApiClient.kt)：新增回退逻辑 +
callApiOnce接受configOverride参数 - 浏览器扩展 (browser/shared/api.js)：已在 5.3.3 中修复（本次参考实现）
- Web 在线版 (web/app.js)：完整同步回退逻辑 + 友好错误映射
全端新增多 API 模式支持，现可直连 OpenAI / Claude / Gemini 等不同格式的 API 服务商，无需通过中转。
- 新增：4 种 API 模式 — OpenAI Chat Completions / OpenAI Responses API / Claude API / Google Gemini API，覆盖主流 AI 供应商
- 新增：API Mode 选择器 — 设置页新增 API 模式下拉菜单，切换模式自动填充对应默认路径
- 新增：Host + Path 分离 — 原 Base URL 拆分为 API Host 和 API Path，配置更清晰灵活
- 新增：自动查询模型列表 — 设置页新增"获取模型列表"按钮，一键从 API 服务商拉取可用模型
- 新增：自动模式检测 — 未设置模式时，根据 API 路径自动推断（
/responses→ Responses API、/v1/messages→ Claude、/v1beta→ Gemini） - 新增：向后兼容 — 旧版
baseUrl配置自动拆分为apiHost+apiPath，无需手动迁移
- VSCode 扩展：设置面板完整重写，新增 Mode / Host / Path / Fetch Models UI
- IntelliJ 插件：Settings 页重写为 Mode / Host / Path 布局，新增 Fetch Models 按钮
- 浏览器扩展：Options 页新增 Mode 下拉 + Host/Path 分离 + Fetch Models 按钮
- Web 在线版：设置面板新增 Mode 下拉 + Host/Path 分离 + Fetch Models 按钮
- 重构：
callApiOnce()4 模式分支 — 每种模式独立构建 URL、Headers、请求体、响应解析 - 重构：
fetchModels()多模式支持 — OpenAI/Responses 查/v1/models，Claude 查/v1/models（x-api-key认证），Gemini 查/v1beta/models?key= - 重构：Endpoint 自动补全 — 用户仅配置
/v1时，自动追加/chat/completions、/responses、/messages等完整路径 - 安全：Gemini URL 编码 — 全端统一对
model和apiKey进行 URL 编码（encodeURIComponent/URLEncoder.encode），防止特殊字符导致 URL 异常
- 修复：浏览器扩展 Gemini URL 缺少
encodeURIComponent—callApiOnce()和fetchModels()中 model/apiKey 未编码 - 修复：Web 端 Gemini URL 缺少
encodeURIComponent— 同上 - 修复：IntelliJ Gemini URL 缺少
URLEncoder.encode—callApiOnce()/testApiConfig()/fetchModels()三处 - 修复：IntelliJ
fetchModels()正则无法匹配/v1beta— 导致 Gemini 模式 host 提取失败、路径翻倍 404，改为显式indexOf匹配 - 修复：IntelliJ
testApiConfig()缺少 endpoint 自动补全 — 非 Gemini 模式测试 URL 与实际调用 URL 不一致，导致测试误报失败 - 修复：IntelliJ 错误响应直接显示原始 JSON — 改为解析
error.message字段，用户可读性更好 - 修复：Web 端
handleTestApi()内置配置 fallback 产生双路径 — 改用new URL().origin提取 host - 修复：IntelliJ
callApiOnce()非 Gemini 模式缺少 endpoint 自动补全 — 添加与其他三端一致的路径检查逻辑
- 新增：历史搜索 — 支持按场景名、用户输入、扩写内容全文检索
- 新增：按日期分组 — 历史记录按“今天/昨天/具体日期”分组展示，信息定位更高效
- 新增：单开折叠详情 — 同一时刻仅允许展开一个历史卡片，避免列表信息过载
- 新增：双内容展示 — 卡片同时展示“用户输入”与“扩写结果”摘要，展开可查看完整扩写
- 优化：防误触操作模型 — 取消点击卡片主体即跳转，改为显式动作按钮（应用/复制/删除/展开）
- 优化：卡片层级与动效 — 历史卡片 hover 与边条过渡重构，过渡更平滑、更克制
- 优化：面板切换观感 — 浏览器端切面动效与时序微调，减少体感割裂
- 审查：Chrome / Firefox / Safari 构建一致性 — 同步校验三端构建产物结构与关键资源一致，确保跨浏览器行为对齐
web-hub（PromptHub）端深度性能优化，所有视觉 UI、动效、视效保持不变。
- 优化：canvas-confetti 动态导入 — 将
canvas-confetti（10.68KB）从主 bundle 拆分为独立 chunk，仅在成就解锁时按需加载，减少首屏 JS 体积 - 优化：首屏渐进式加载 — Home 页 Prompt 卡片由一次性渲染 50+ 张改为首批 12 张 + IntersectionObserver 滚动增量加载，大幅减少首屏 DOM 节点数
- 优化：Store 通知批处理 —
usePromptStore的notifyListeners使用queueMicrotask合并同一事件循环内的多次通知为单次全局渲染，避免级联 re-render - 优化：分类计数预计算 — 导出
CATEGORY_COUNTS预计算映射，Sidebar 和 CommandPalette 使用 O(1) 查表替代 16 次.filter()全量扫描
- 优化：AuroraOrbs 合成层优化 — 移除 3 处冗余
willChange: 'transform, filter'，CSSanimation已自动提升至合成层，节省约 4MB GPU 显存
Easy Prompt 生态新成员：PromptHub（https://zhiz.chat），一个独立的 AI Prompt 精选库 Web 应用，帮助用户发现、收藏和分享高质量 Prompt。
- 新增：Prompt 精选库首页 — Hero 区 + 分类筛选 + 难度/模型标签 + 瀑布流卡片布局
- 新增：Prompt 详情抽屉 — 右侧滑出式详情面板（vaul），含完整内容、Playground 测试、版本对比
- 新增：热门榜单（Trending） — 统计图表（Recharts）+ 排行榜 + 趋势分析
- 新增：Prompt 银河（Galaxy） — Canvas 星图可视化，以交互式星空方式浏览所有 Prompt
- 新增：合集系统（Collections） — 7 个精选合集 + 合集详情页，按主题组织 Prompt
- 新增：合集详情页 —
/collection/:id路由，Hero 横幅 + 标签 + Prompt 列表 + 404 回退 - 新增：个人主页（Profile） — 用户成就、贡献统计、活跃度日历
- 新增：我的收藏（Favorites） — 收藏夹管理 + 搜索 + 排序
- 新增：提交 Prompt 抽屉 — 底部滑出式提交表单（vaul），分享 Prompt 到精选库
- 新增：暗色/亮色主题 — oklch 色彩空间 CSS 变量，一键切换
- 新增：Favicon — 紫色渐变星星图标（SVG），与品牌视觉一致
- 技术栈：React 18 + TypeScript（严格模式）+ Vite 6 + Tailwind CSS v4 + Framer Motion
- 路由：React Router 7，全页面 lazy 加载 + Suspense
- 状态管理：自定义
usePromptStorehook + localStorage 持久化 - 代码分割：Vite manualChunks 策略（React / Recharts / Motion / UI 独立 chunk）
- 部署：VPS 静态托管（zhiz.chat）
- 修复：vaul 抽屉无障碍警告 — 添加
Drawer.Title+Drawer.Description（sr-only），消除 Radix Dialog DescriptionWarning - 深层修复：发现并修复 Radix Dialog 内部 ID 链接机制问题 —— 自定义
id会覆盖 Radix context 自动生成的 ID，导致DescriptionWarning误报警告 - 零控制台错误/警告：Playwright 全功能验证，0 error / 0 warning
- TypeScript 严格模式：
strict: true，全部类型检查通过
- 同步：全端版本号统一升级至 5.3.0
- 市场描述更新：VSCode / IntelliJ / 浏览器扩展（Chrome/Firefox/Safari）描述追加 PromptHub 链接与功能介绍
- 新增：光标追踪光晕 — 鼠标移动时产生柔和跟随光效（rAF 节流）
- 新增：按钮涟漪效果 — 点击按钮时从点击位置扩散涟漪
- 新增：输出内容逐行揭示 — 结果面板内容逐行 DOM 插入 + 60ms 延迟动画
- 新增：场景卡片聚光灯 — 鼠标悬停时卡片产生动态聚光效果
- 新增：幽灵按钮边框动画 — 次要按钮 hover 时渐变边框流动
- 新增：输入区入场动画 — 页面加载时输入区域分步揭示
- 新增：输出卡片边框微光 — 结果卡片顶部渐变装饰线
- 新增：Hero 徽章微光 — 首屏标签微光扫过动画
- 新增：输入框状态过渡 — focus/blur 时边框、阴影、光晕的弹簧曲线过渡
- 新增：页面区块过渡 — 滚动时各区块渐入揭示（IntersectionObserver）
- 新增：面板/弹窗 3D 入场 — Settings 面板 perspective(1200px) + rotateY(-15deg)，Modal perspective(1000px) + rotateX(8deg)，含 staggered 子元素动画和 dismissing 退场
- 新增：Toast 通知滑入动画 — 顶部滑入 + 弹簧曲线 + 自动消失
- 新增：主题切换过渡 — 暗/亮主题切换时 0.5s 全局过渡
- 新增：滚动揭示 — .reveal-on-scroll + IntersectionObserver 驱动
- 新增：复制按钮反馈 — 复制成功时按钮缩放 + 图标切换动画
- 新增：场景标签选中态 — 渐变底色 + 缩放 + 弹簧曲线
- 新增：3D 悬浮倾斜 — 场景卡片跟随鼠标 3° 透视倾斜 + 光泽层
- 优化：输入聚焦锁定 — 输入框 focus 时锁定倾斜，防止打字时抖动
- 新增：三层锥形渐变光球 — 600px/520px/300px 尺寸，12s/16s/10s 漂移动画
- 新增：网格叠加层 — ::before 伪元素 1px 网格 + 6s gridPulse 呼吸
- 新增：扫描线装饰 — ::after 伪元素 2px 高亮扫描线 + box-shadow 辉光
- 优化：亮色主题光球 — 高饱和度配色（#8b5cf6/#3b82f6/#ec4899），opacity 0.35/0.3/0.25
- 新增：Combobox 组件 — 替换原始 input，支持下拉选择 + 搜索过滤
- 新增：39 个模型预设 — 9 大供应商（Anthropic/OpenAI/Google/DeepSeek/xAI/智谱/Kimi/通义/MiniMax）
- 新增：键盘导航 — 上下键选择 + Enter 确认 + Escape 关闭
- 新增：分组展示 — 按供应商分组，带 provider 标题行
- 优化：设计令牌 — 渐变色、边框、阴影、bg-muted 等全面调优
- 优化：微边框阴影 — 所有阴影追加 0 0 0 1px 微边框层
- 优化：场景标签渐隐 — mask-image 右侧 48px 渐隐 + ::after 间距占位
- 新增：MiSans 小米字体 — 汉仪字库设计，现代干净微圆润
- 新增：4 档精确权重 — Regular(400) / Medium(500) / Semibold(600) / Bold(700)
- 技术：CDN 分片加载 — jsdelivr + cn-font-split 188 块子集，按需加载
- 同步: 全端版本号统一升级至 5.2.2
- 新增：ToolWindow 侧边栏面板 — 右侧 "Easy Prompt" 面板（JCEF 渲染），新手指引 + 一键触发所有功能
- 新增：右键菜单顶层入口 — 编辑器中选中文本右键，"Easy Prompt：智能增强 / 增强选中文本" 直接出现在顶层（无需子菜单）
- 新增：Tools 菜单入口 — Tools → Easy Prompt 子菜单（全部 7 个 Action）
- 新增：状态栏快捷菜单 — 右下角状态栏 "Easy Prompt"，点击弹出 7 项快捷操作
- 新增：首次安装指引通知 — 安装后自动打开 ToolWindow + 弹出通知（含多入口提示）
- 优化：插件图标 — Marketplace / 已安装列表 / ToolWindow 侧边栏均使用统一 Sparkles 风格 SVG 图标
- 优化：快捷键 — 全部统一为 Ctrl+Alt+X（含 Mac OS X keymap），与 VSCode 完全一致
- IntelliJ Marketplace 描述：扩写为完整中英双语（CN 在前 + EN 在后），补齐 Smart Nudge / 多供应商 / 安全加固等卖点
- VSCode Marketplace（README）：核心功能 / 安装 / 配置 / 使用方式章节追加英文翻译（不改动原中文）
- VSCode 短描述（package.json）：更新为中英双语
- 修复: README.md 中 Smart Nudge 行的乱码字符
- 同步: 全端版本号统一升级至 5.2.1
- 升级: 默认 AI 模型统一为 gpt-5.4
- 升级: 默认 API 提供商统一为 VPS AI Robot (
https://vpsairobot.com/v1/chat/completions) - 同步: 全端（VSCode / IntelliJ / Web / Browser）默认配置统一更新
- 同步: 全端版本号统一升级至 5.2.0
- 修正: README.md Web 在线版链接指向
https://prompt.zhiz.chat - 修正: 浏览器扩展设置页 GitHub URL 修正为正确仓库地址
- 新增: 浏览器扩展设置页“关于”区域添加 Web 在线版链接
- 新增: VSCode Welcome 页面 footer 添加 Web 在线版链接
- 修正: Web 端 GitHub URL 大小写修正
- 修正: IntelliJ Marketplace 描述中 Web 添加超链接
- 同步: 全端版本号统一升级至 5.1.1
浏览器扩展新增智能提醒气泡：当用户在 AI 网站（ChatGPT、Claude、Gemini 等 22 个站点）输入内容并暂停 3 秒后，自动弹出提示气泡，引导用户使用 Prompt 增强功能。
- 智能触发：输入 10+ 字符后暂停 3 秒自动显示，不干扰正常输入
- 一键增强：点击气泡中的"增强"按钮或使用快捷键（Cmd+Shift+E / Ctrl+Shift+E）立即增强
- 频率控制：每个 session 仅显示一次，10 秒自动消失，已使用增强功能则不再提醒
- 永久关闭：点击"不再提醒"永久关闭（chrome.storage.local 持久化）
- 视觉设计：暗色主题 (#1e1b2e)、紫色强调、滑入动画，与现有 UI 风格一致
全面升级输入内容校验引擎，从 3 条基础规则升级为 7 条智能规则，有效过滤无意义输入、避免浪费 API 调用。
- 最小长度放宽：从 4 字符降至 2 字符，适配 CJK 双字词（如"翻译"、"总结"）
- 有效字符检测：使用 Unicode
\p{L}\p{N}类别，支持全球脚本（CJK/拉丁/阿拉伯/西里尔等） - 字母必须性检测：拒绝纯数字输入（如 "12345"），要求至少包含 1 个字母字符
- 重复字符检测：拒绝单一字符重复（如 "aaa"、"111"、"哈哈哈"），要求至少 2 个不同有效字符
- 纯 URL 检测：拒绝仅包含 URL 的输入（如 "https://example.com"），但 "帮我解析 https://example.com" 可通过
- 纯邮箱检测：拒绝仅包含邮箱地址的输入
- 纯文件路径检测：拒绝仅包含 Unix/Windows 文件路径的输入
- VSCode：
extension.js增强选中/指定场景增强入口校验 - IntelliJ：
ApiClient.kt使用 Kotlin 原生正则实现等效 7 规则 - Web：
app.jssmartRoute 入口校验 - Browser Popup：使用
Router.isValidInput()统一验证，消除行内重复逻辑 - Browser Content Script：AI 聊天框 inline 增强入口校验
- Browser Service Worker：
handleInlineEnhance入口校验
- 清理：移除 content.js 中 8 个 debugger 语句
- 清理：移除未使用的
MIN_TEXT_LENGTH常量 - 优化：错误提示文案统一为"输入内容无效，请输入有意义的文本内容"
v5.0.0 发布后的 Bug 修复和稳定性改进，主要集中在浏览器扩展 Popup 面板和 Web 端。
- debounce 状态丢失修复：debounce 函数新增
.cancel()方法，pagehide处理器先取消待执行的 debounced save 再同步 flush，避免 Popup 关闭瞬间状态丢失 - 状态恢复重复保存修复：
selectScene()新增skipSave参数，从 Storage 恢复状态时传入true，避免恢复过程触发二次保存 - 场景方法调用错误修复：
handleGenerate中修正Scenes.getScenes()→Scenes.getSceneNames()，修复生成时场景名称获取失败 - 动画 class 残留修复：
showOutput添加animationend事件监听（{ once: true }），动画结束后自动移除is-enteringclass - 清空按钮状态残留修复：清空操作时增加
hideStatus()调用 + 移除is-enteringclass，确保 UI 状态完全重置 - 定时器泄漏修复：新增
_pickerCloseTimer变量管理 Picker 关闭定时器，open/close 时正确清理，防止泄漏 - 事件穿透修复：
openScenesModal中e.stopPropagation()改为e.stopImmediatePropagation()，彻底阻止事件冒泡穿透 - 模态框事件监听泄漏修复：
closeScenesModal中添加modal.removeEventListener("animationend", onEnd)清理，防止 fallback timeout 触发时残留监听器
- 清空按钮进度条残留修复：
handleClear()增加hideProgress()调用，清空时同步隐藏进度条 - CSS 变量修复：修复未定义变量
--text-tertiary→ 正确引用--text-muted - 复制按钮样式修复：补充
#btn-copy.is-copied选择器，复制成功时正确显示样式变化
- SDK 升级 2024.1 -> 2024.3：解决
CredentialAttributes构造函数废弃警告，requestor参数版本已在 2024.3 中标记为 ERROR 级别废弃 - ActionUpdateThread 补全：全部 8 个 Action 类添加
getActionUpdateThread() = ActionUpdateThread.BGT，解决 JetBrains Marketplace 验证警告 - StatusBarWidget API 更新：移除废弃的
getPresentation()覆写，getClickConsumer()添加@Suppress("DEPRECATION") - 构建工具链升级：
jvmToolchain(17)->jvmToolchain(21)，sinceBuild从241提升至243，兼容 IntelliJ 2024.3+
- VSCode：版本号更新
- IntelliJ：版本号 + changeNotes + SDK 升级 + 废弃 API 修复
- Web：版本号 + Bug 修复
- Browser：三平台 manifest 版本号 + Popup Bug 修复
Easy Prompt 迎来 v5.0.0 大版本。全新浏览器扩展正式上线，支持 Chrome / Firefox / Safari 三大平台（MV3），与 VSCode 扩展、IntelliJ 插件、Web 在线版形成四端矩阵。
- Popup 快速增强面板：输入文本 → AI 智能路由 → 生成专业 Prompt，支持场景选择 + 画像切换 + 历史记录
- 场景选择器：97 个场景按 15 分类 + 10 大画像分组浏览，热门标签快速选择
- Content Script 浮动按钮：网页中选中文本自动显示增强按钮，一键发送到 Popup 增强
- Background Service Worker：右键上下文菜单 + 键盘快捷键 + 消息中继
- Options 设置页：支持自定义 API 配置（Base URL / API Key / Model）+ 一键测试连接
- 状态持久化：关闭再打开 Popup，输入/输出/选中场景自动恢复
- 增强历史：本地存储增强记录，支持复制、删除、清空
- 暗色/亮色主题：跟随系统或手动切换
- Major #1: Escape 键双触发 — Focus Trap 和全局键盘监听同时调用
closeScenesModal()，导致面板关闭异常。修复：Focus Trap 中添加e.stopPropagation()+ 关闭函数添加幂等守卫 - Major #2: 动画卡死 —
animationend事件在某些浏览器/GPU 环境下可能不触发，面板永远卡在is-leaving状态。修复：添加 350mssetTimeoutfallback +cleaned幂等标志 - Minor #3: 状态恢复闪烁 — 从 Storage 恢复输出时触发 output-reveal 动画，造成视觉干扰。修复：
showOutput()新增animate参数，恢复时传false - Minor #4: Debounce 丢失 — 300ms debounced save 在 Popup 关闭瞬间可能丢失最后一次状态。修复：添加
pagehide事件监听立即 flush - Minor #5: Badge 分隔符缺失 — 多场景标签拼接使用空字符串，显示为 "场景A场景B"。修复：分隔符改为
", " - Minor #6: CSS 死代码 —
.modal__content中animation: fadeIn已被 Section 15 动画系统覆盖。修复：移除死代码 - Minor #7: CSS 覆盖冲突 —
.scene-card/.history-card/.dropdown__item基础transition被 Section 15 完全覆盖。修复：移除基础冗余声明，添加注释指向
- VSCode: 版本号 + Welcome 页更新
- IntelliJ: 版本号 + changeNotes 更新
- Web: 版本号更新
- Browser: 三平台 manifest 版本号 + Popup/Options/Content/Background 全部审查通过
Easy Prompt v4.1.0 全面升级。引入 10 大用户画像系统和增强历史功能，新增 35 个专业场景（总计 85 个），三端同步。
场景之上抽象出用户画像层，按职业角色分组场景，降低认知负荷：
- 软件工程师：需求分析 + 编码开发 + 质量保障 + 文档 + 运维（5 个分类）
- 内容创作者：通用写作（12 个场景）
- 产品经理：PRD/用户故事/竞品分析/数据分析/会议纪要/验收标准
- 市场运营：广告文案/品牌故事/邮件营销/活动策划/增长策略
- 设计师：设计Brief/UX评审/设计规范/UX文案
- 数据分析师：数据报告/AB测试/指标定义/数据可视化
- HR人事：JD编写/面试指南/绩效评语/入职方案
- 客户服务：FAQ编写/回复模板/反馈分析
- 创业者/管理者：商业计划书/路演PPT/OKR/SWOT/风险评估
- 学生/教育：学习计划/读书笔记/论文大纲/出题生成
- 产品经理：
prd,user-story,competitor,data-analysis,meeting-notes,acceptance - 市场运营：
ad-copy,brand-story,email-marketing,event-plan,growth-hack - 设计师：
design-brief,ux-review,design-spec,copy-ux - 数据分析师：
data-report,ab-test,metric-define,data-viz - HR人事：
jd-write,interview-guide,performance-review,onboarding-plan - 客户服务：
faq-write,response-template,feedback-analysis - 创业者/管理者：
business-plan,pitch-deck,okr,swot,risk-assess - 学生/教育：
study-plan,summary,essay,quiz-gen
- 新增
Ctrl+Alt+Y快捷键查看增强历史 - 支持 before/after 文本对比展示
- 支持一键复制原文/增强结果
- 支持删除单条记录和清空全部
- 最多保留最近 100 条（FIFO）
- 三端存储：VSCode→globalState, IntelliJ→PersistentState, Web→localStorage
- 场景列表/选择器按画像分组展示（取代原有的纯频率排序）
- Web 端新增画像 Tab 页快速筛选
- VSCode 端 QuickPick 添加画像分隔符
- IntelliJ 端 Popup 列表按画像分组
- VSCode: history + persona + package.json 命令注册 + 快捷键
- IntelliJ: ShowHistoryAction + PersonaConfig + 4 个 Action 文件 history save + plugin.xml 注册
- Web: history panel + persona tabs + SCENE_CATEGORIES 15 分类
Easy Prompt 迎来首个大版本升级。全新 Web 在线版正式上线，与 VSCode 扩展、IntelliJ 插件形成三端矩阵，让 Prompt 增强能力触手可及。
- 选题生成 (topic-gen)：根据领域/定位/热点生成选题清单，含爆款潜力评分
- 事实校验 (fact-check)：逐段核查事实性陈述，三级标注（可信/存疑/错误）
- 背景调研 (research)：整理背景资料、关键数据、权威引用、正反观点
- 文风改写 (style-rewrite)：正式↔口语/学术↔通俗/幽默↔文艺风格转换
- 字数调控 (word-adjust)：扩写或缩写到目标字数，核心信息保持率 ≥ 95%
- 平台适配 (platform-adapt)：针对公众号/小红书/知乎/微博/B站/抖音改写
- 合规审查 (compliance)：广告法/平台规则/版权风险三维审查 + 合规版全文
- 标题优化 (headline)：10 个标题方案（数字/悬念/对比/情绪/痛点/行动型）
- 大纲生成 (outline)：结构化大纲（含钩子/论点/素材/节奏/字数估算）
- SEO 优化 (seo-write)：关键词策略 + 内容优化 + 技术 SEO + SEO 评分
- 文案润色 (copy-polish)：错别字/语法/表达/结构/风格五维润色
- 社媒文案 (social-post)：5 版本社媒文案（走心/金句/数据/悬念/互动）
- 纯前端 SPA 架构：
index.html+style.css+app.js+scenes.json，零后端依赖，部署到任意静态服务器即可使用 - 专业级视觉设计：参考 Linear / Vercel / Raycast 设计语言，高斯模糊背景 + 渐变光影 + 流畅微交互动画
- 完整 50 场景支持：场景选择器 + 实时搜索筛选 + 7 大分类浏览 + 使用频率统计
- 双模式增强：智能路由（AI 自动识别意图）+ 指定场景（手动精准选择）
- 全设备响应式：桌面端与移动端自适应布局，支持所有主流浏览器
- Lucide SVG 图标体系：全部使用专业内联 SVG 图标，零外部 CDN 依赖
- 暗色主题：与 VSCode / IntelliJ 端视觉风格统一
- VSCode Welcome 引导页版本号显示修正
- IntelliJ 50 个场景补齐「痛点」(painPoint) 数据，与 core 模块完全同步
- IntelliJ changeNotes 补齐 v3.2.2 更新说明
- Web 场景选择器下拉定位修复（
position: absolute→position: fixed） - Web 背景装饰光影居中偏移修复
- Web GitHub 链接 URL 更正
JBPopupFactory.createListPopupBuilder(JList)→createPopupChooserBuilder(List<String>)：3 处 deprecated API 替换（StatusBarMenuAction / EnhanceWithSceneAction / ShowScenesAction）AnAction.actionPerformed()直接调用 →ActionManager.tryToExecute()：3 处 override-only 违规修复（StatusBarMenuAction / EasyPromptStatusBarWidgetFactory / EnhanceSelectedAction）AnActionEvent.createFromAnAction()→ 完全移除：1 处 scheduled-for-removal API 替换（EasyPromptStatusBarWidgetFactory 改用tryToExecute+contextComponent）- WelcomeDialog 启动模态阻塞 → 非阻塞气泡通知：WelcomeStartupActivity 改为
NotificationGroupManager通知 + "查看使用教程" 按钮，新增isHeadlessEnvironment/isUnitTestMode环境检测跳过
- 取消 Base URL
/v1结尾强制校验：现在支持任意格式的 API 地址，如https://api.example.com/v1或https://api.example.com/v1/chat/completions均可 - 智能 URL 拼接：
callApiOnce()自动检测 URL 是否已包含/chat/completions，避免重复拼接路径 - 配额不足错误提示升级：
friendlyError()使用正则解析$remain/$need金额，区分内置 Key 和自定义 Key 双场景提供指导建议 - IntelliJ 插件 ID 变更：
com.easyprompt.intellij→com.easyprompt.plugin（JetBrains Marketplace 禁止 ID 包含 "intellij"） - IntelliJ 插件描述改为纯英文，符合 JetBrains Marketplace 格式要求（必须以拉丁字母开头，≥40 字符）
- IntelliJ 新增
publishPluginGradle 任务，支持通过 Token 自动发布到 JetBrains Marketplace - WebView 配置面板 Base URL 提示文案更新，展示多种 URL 格式示例
- 修复 JSON 解析错误提示中残留的 "/v1 结尾" 引导文案（双端同步）
- 智能增强（Ctrl+Alt+I）：一键智能增强，按优先级自动选择内容源 — 选中文本 → 当前文件（≤50 行/2000 字符）→ 剪贴板（≤10000 字符）；多来源时弹出选择列表
- Ctrl+Alt+H 快捷键：随时打开使用教程引导页
- 状态栏常驻入口：底部状态栏显示 ✨ Easy Prompt，点击打开快捷菜单
- 场景使用频率排序：场景列表按命中次数降序排列，显示 🔥 命中计数
- 状态栏快捷菜单：6 项快速操作（智能增强/选中增强/指定场景/浏览场景/使用教程/API 配置）
- 增强选中文本无选区时自动 fallback 到智能增强，不再提示"请先选中文本"
handleCommandError()集中错误处理：统一重试/配置/取消操作按钮，根据错误类型智能提供操作建议- Welcome 引导页新增 Ctrl+Alt+I / Ctrl+Alt+H 快捷键说明和状态栏使用提示
- 场景浏览和指定场景增强均按使用频率智能排序
- IntelliJ WelcomeDialog 场景分类扩展至全部 50 个场景（6 个分类，与 VSCode 端完全对齐）
- 5 轮深度审计（20 处修复）：覆盖逻辑正确性、安全加固、多平台一致性、架构优化、边界条件处理
- IntelliJ:
LightVirtualFile→ScratchRootType— 临时文件改为 Scratch 文件，支持语法高亮和正确的文件管理 - IntelliJ: 智能增强竞态条件修复 — 选区偏移量提前保存 + 文档切换检查，避免替换错误位置
- IntelliJ:
runWriteAction→WriteCommandAction— 文档写入操作支持 Ctrl+Z 撤销 - IntelliJ: 模态对话框 →
NotificationGroupManager非阻塞气泡通知，不再打断用户操作 - IntelliJ: 状态栏菜单无编辑器时显示友好提示而非静默失败
- IntelliJ: StatusBarWidget DataContext 改用
CommonDataKeys+FileEditorManager.selectedTextEditor规范引用
- 开箱即用：内置 AI 服务，安装后无需任何配置即可使用
- 支持自定义 API Key（可选）— 填入自己的 Key 后自动切换为用户配置
- 内置配置采用 AES-256-CBC 加密 + 多层混淆保护
- 新增「指定场景增强」功能（Ctrl+Alt+M）- 手动选择场景跳过 AI 意图识别
- 新增「查看使用教程」命令 - 随时查看 Welcome 引导页
- 新增输入长度限制（10000 字符）- 防止超长输入导致错误
- 新增 curl 可用性检查 - 更友好的错误提示
- 新增配置验证 - Base URL 和 API Key 格式检查
- 配置项全部改为可选 — 留空使用内置服务，填写则使用自定义配置
- 项目结构优化：VSCode 扩展文件提升到根目录，解决打包缺失 core/ 的致命 Bug
- 改进 API 安全性：使用 stdin 传递数据，避免 API Key 在命令行参数中暴露
- 增强 JSON 解析健壮性：支持更多格式和边界情况处理
- 优化错误提示：分类常见错误，提供更友好的中文提示和解决建议
- 改进取消操作处理：显示明确的取消确认信息
- 修复 Windows 环境 curl 兼容性问题
- 修复 JSON 解析失败时的 fallback 逻辑
- 修复长文本响应可能被截断的问题
- 50 个场景添加痛点描述和示例
- 增强进度反馈：显示每步耗时
- 优化用户体验：添加「撤销」快捷提示
- 首次发布
- 两步 AI 智能路由：意图识别 + 专业 Prompt 生成
- 50 个专业场景覆盖开发全流程
- 支持复合意图识别
- VSCode 和 IntelliJ IDEA 双平台支持
- 多 API 提供商兼容（OpenAI / Azure / Gemini / DeepSeek / Ollama）
- Welcome 引导页（首次安装自动显示）
- 场景浏览功能（Ctrl+Alt+L）
- 快捷键操作：
- Ctrl+Alt+P：增强选中文本
- Ctrl+Alt+O：快速输入增强
- Ctrl+Alt+L：浏览场景列表