# @promptx/$(basename $pkg)

## 2.4.1

### Patch Changes

- [#572](https://github.com/Deepractice/PromptX/pull/572) [`afe93c6`](https://github.com/Deepractice/PromptX/commit/afe93c68a917e75c0cf43dc0ddd16f9531425554) Thanks [@dfwgj](https://github.com/dfwgj)! - fix(runtime): 修复工具执行期间空闲超时误触发导致回复被截断的问题

  AI 调用工具后（`message_delta` stop_reason=tool_use），SDK 进入静默等待状态，直到工具执行完成返回 `tool_result`。这段静默期内没有任何流式事件重置空闲计时器，导致超过 10 分钟后触发 "Request timeout after 600000ms"，将仍在进行中的请求强制中断。

  修复方式：检测到工具执行开始时，启动心跳定时器（间隔为 timeout/2，最大 2 分钟），持续重置空闲计时器直到 tool_result 返回。工具结果到达、请求正常完成或异常清理时，心跳自动停止。

- Updated dependencies [[`afe93c6`](https://github.com/Deepractice/PromptX/commit/afe93c68a917e75c0cf43dc0ddd16f9531425554)]:
  - @promptx/mcp-workspace@2.4.1
  - @promptx/mcp-office@2.4.1
  - @promptx/mcp-server@2.4.1
  - @agentxjs/runtime@2.0.2
  - @promptx/config@2.4.1
  - @promptx/core@2.4.1

## 2.4.0

### Minor Changes

- [#565](https://github.com/Deepractice/PromptX/pull/565) [`51bd52f`](https://github.com/Deepractice/PromptX/commit/51bd52f042c47af8c1ed75a8c4cbb3e3441efb9d) Thanks [@dfwgj](https://github.com/dfwgj)! - ## v2.3.0

  ### 新功能

  - **飞书接入**：支持通过飞书机器人与 PromptX 交互，使用 WebSocket 长连接模式无需公网 IP，实现类似 OpenClaw 的多平台接入能力
  - **工作区功能**：新增工作区侧边栏，支持项目文件浏览、拖拽文件到对话输入、文件读写管理
  - **DeepSeek 预配置**：AgentX 配置新增 DeepSeek 预设，开箱即用
  - **Windows Git 检测**：首页添加 Git 安装状态检测与引导提示
  - **MCP Workspace 服务**：新增内置 MCP 工作区服务，支持文件操作和配置管理

  ### 优化

  - **RoleX 全面优化**：修复组织操作相关的 bug，拆分 action 工具为 4 个领域工具以减少 LLM 调用失败
  - **资源去重**：修复资源页面重复 key 警告，V2 角色正确覆盖 V1 同名角色
  - **通知中心**：新增 v2.3.0 版本更新通知

  ### 修复

  - 修复工作区文件夹自动展开导致的性能问题
  - 修复 Windows 平台 Git 检测与路径问题
  - 清理调试日志输出

### Patch Changes

- [#565](https://github.com/Deepractice/PromptX/pull/565) [`51bd52f`](https://github.com/Deepractice/PromptX/commit/51bd52f042c47af8c1ed75a8c4cbb3e3441efb9d) Thanks [@dfwgj](https://github.com/dfwgj)! - ## Bug Fixes

  - **runtime**: 修复对话超时误触发问题 — 将绝对超时改为空闲超时（`timeout({ each: 600000 })`），每次 AI 输出都会重置计时器，只有真正超过 600 秒无任何响应才触发超时
  - **mcp-workspace**: 修复生产环境打包缺失问题 — 将 `external` 改为 `noExternal`，确保 `@promptx/logger` 和 `@modelcontextprotocol/sdk` 被打包进产物；同时在 `electron-builder.yml` 补充 `extraResources` 配置，生产包中正确包含 mcp-workspace

  ## New Features

  - **desktop**: 设置页新增「接入其他平台」Tab，提供 Trae 及 Claude/Cursor 等 AI 工具的一键复制 MCP 配置

- Updated dependencies [[`51bd52f`](https://github.com/Deepractice/PromptX/commit/51bd52f042c47af8c1ed75a8c4cbb3e3441efb9d), [`51bd52f`](https://github.com/Deepractice/PromptX/commit/51bd52f042c47af8c1ed75a8c4cbb3e3441efb9d)]:
  - @promptx/mcp-workspace@2.4.0
  - @promptx/mcp-office@2.4.0
  - @promptx/mcp-server@2.4.0
  - @agentxjs/runtime@2.0.1
  - @promptx/config@2.4.0
  - @promptx/core@2.4.0

## 2.3.0

### Minor Changes

- [#563](https://github.com/Deepractice/PromptX/pull/563) [`a046d33`](https://github.com/Deepractice/PromptX/commit/a046d33b218a084ee463076df96cf3e035b54d5c) Thanks [@dfwgj](https://github.com/dfwgj)! - ## v2.3.0

  ### 新功能

  - **飞书接入**：支持通过飞书机器人与 PromptX 交互，使用 WebSocket 长连接模式无需公网 IP，实现类似 OpenClaw 的多平台接入能力
  - **工作区功能**：新增工作区侧边栏，支持项目文件浏览、拖拽文件到对话输入、文件读写管理
  - **DeepSeek 预配置**：AgentX 配置新增 DeepSeek 预设，开箱即用
  - **Windows Git 检测**：首页添加 Git 安装状态检测与引导提示
  - **MCP Workspace 服务**：新增内置 MCP 工作区服务，支持文件操作和配置管理

  ### 优化

  - **RoleX 全面优化**：修复组织操作相关的 bug，拆分 action 工具为 4 个领域工具以减少 LLM 调用失败
  - **资源去重**：修复资源页面重复 key 警告，V2 角色正确覆盖 V1 同名角色
  - **通知中心**：新增 v2.3.0 版本更新通知

  ### 修复

  - 修复工作区文件夹自动展开导致的性能问题
  - 修复 Windows 平台 Git 检测与路径问题
  - 清理调试日志输出

### Patch Changes

- Updated dependencies [[`a046d33`](https://github.com/Deepractice/PromptX/commit/a046d33b218a084ee463076df96cf3e035b54d5c)]:
  - @promptx/mcp-server@2.3.0
  - @promptx/core@2.3.0
  - @promptx/config@2.3.0
  - @promptx/mcp-office@2.3.0

## 2.2.1

### Patch Changes

- [#559](https://github.com/Deepractice/PromptX/pull/559) [`667ef7d`](https://github.com/Deepractice/PromptX/commit/667ef7dce149c0bada64c4934a5ed2711f2adc65) Thanks [@dfwgj](https://github.com/dfwgj)! - # v2.2.1 版本更新

  ## 🎉 RoleX V2 完整认知循环支持

  ### 核心操作

  - **want** - 制定产品目标（如：发布新功能、优化用户体验）
  - **plan** - 为目标制定执行计划（⚠️ 必须传入 id 参数）
  - **todo** - 创建具体任务
  - **finish** - 完成任务
  - **achieve** - 达成目标，沉淀经验
  - **focus** - 查看当前进行中的工作
  - **abandon** - 放弃目标/任务

  ### 自我沉淀（学习循环）

  - **reflect** - 反思遇到的问题，创建经验
  - **realize** - 总结领悟的原则
  - **master** - 沉淀为标准操作流程（SOP）
  - **synthesize** - 向其他角色传授知识
  - **forget** - 遗忘过时的知识

  ## 🔧 修复与改进

  ### RoleX V2 核心修复

  - 修复 plan 操作未传递 id 参数导致 todo 操作失败的问题
  - 修复 "No focused plan" 错误
  - 更新 RolexBridge 和 RolexActionDispatcher 正确传递所有参数
  - 添加关键警告：plan 操作必须传入 id 参数

  ### 大禹迁移功能修复

  - 更新大禹迁移文档适配 RoleX 1.3.0 数据库存储模式
  - 移除过时的 "born → activate → synthesize" 流程
  - 更新为正确模式：synthesize 直接传入 targetRole 参数
  - 添加职位命名规范："角色名+岗位"格式（如"产品经理岗位"）
  - 说明 appoint 的 position 参数必须与 establish 的 name 完全一致

  ### 记忆工具优化

  - remember/recall 工具检测到 V2 角色时提供清晰引导
  - 引导 V2 角色使用 action 工具的认知循环操作
  - 提供完整的示例代码和操作说明

  ### AgentX 用户体验

  - 添加两个 V2 专属预设问题：
    - "激活大禹帮我把 v1 迁移到 v2"
    - "查看我现在的组织架构"
  - 预设问题仅在系统设置开启 V2 时显示
  - 优化布局：V2 关闭时 2 列，V2 开启时 3 列

  ### 通知系统

  - 添加 v2.2.1 版本更新通知
  - 修复通知服务自动合并新通知的问题
  - 新通知现在会自动出现在通知列表中

  ## 📝 文档更新

  ### MCP 工具描述

  - 更新 action 工具描述，添加完整的 V2 学习循环示例
  - 添加职位命名规范和组织操作示例
  - 强调 plan 操作的 id 参数要求

  ### 大禹角色文档

  - migration-workflow.execution.md - 更新迁移工作流
  - rolex-api.knowledge.md - 更新 API 速查表
  - 添加实际迁移经验和最佳实践

  ## 🌐 国际化

  - 添加中英文通知文本
  - 添加 AgentX 预设问题的中英文翻译

  ## ⚠️ 重要提示

  ### plan 操作关键要点

  plan 操作如果不传入 id 参数，focused_plan_id 不会被设置，导致后续 todo 操作失败并报错 "No focused plan. Call plan first."

  **错误示例：**

  ```json
  { "operation": "plan", "role": "_", "source": "..." }
  ```

  **正确示例：**

  ```json
  { "operation": "plan", "role": "_", "source": "...", "id": "my-plan" }
  ```

  ### 职位命名规范

  - establish 创建职位时，name 必须是"角色名+岗位"格式（如"产品经理岗位"）
  - appoint 任命时，position 参数必须与 establish 的 name 完全一致
  - 验证方式：用 directory 检查 members 列表，而不是只看命令返回值

- Updated dependencies [[`667ef7d`](https://github.com/Deepractice/PromptX/commit/667ef7dce149c0bada64c4934a5ed2711f2adc65)]:
  - @promptx/mcp-server@2.2.1
  - @promptx/core@2.2.1
  - @promptx/config@2.2.1
  - @promptx/mcp-office@2.2.1

## 2.2.0

### Minor Changes

- [#557](https://github.com/Deepractice/PromptX/pull/557) [`c4669b3`](https://github.com/Deepractice/PromptX/commit/c4669b3824418a83817d9e393d7ffa5c935191d2) Thanks [@dfwgj](https://github.com/dfwgj)! - ## 新特性

  - 新增通知中心
  - AgentX 配置增加预设与 OpenAI 协议识别功能
  - V2 RoleX 内核从 v0.11.0 更新到 v1.3.0

  ## 问题修复

  - 修复对话重命名后无效的 bug
  - 修复 Windows 平台点击 Git 链接无响应的 bug

  ## 临时变更

  - V2 的角色导入导出与删除功能暂时下架

### Patch Changes

- Updated dependencies [[`c4669b3`](https://github.com/Deepractice/PromptX/commit/c4669b3824418a83817d9e393d7ffa5c935191d2)]:
  - @promptx/mcp-server@2.2.0
  - @promptx/config@2.2.0
  - @promptx/core@2.2.0
  - @promptx/mcp-office@2.2.0

## 2.1.1

### Patch Changes

- [#553](https://github.com/Deepractice/PromptX/pull/553) [`3599084`](https://github.com/Deepractice/PromptX/commit/3599084408333a62cf5b77d0bf041fa5854779bc) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: 角色/工具详情面板添加导出按钮，支持 v1 和 v2 角色导出

  - 角色和工具详情面板右上角新增导出按钮（非 system 资源可见）
  - 后端 resources:download 支持 version 参数，v2 角色正确定位 ~/.rolex/roles/ 目录
  - v2 角色导出的 ZIP 以 roleId 为顶层目录，确保导入时还原正确 ID
  - 添加 i18n 键：export / exportSuccess / exportFailed（中英文）

  fix: macOS 上 AgentX 对话时子进程不再显示 Dock 图标

  - macOS 启动时检测 Electron Helper 二进制（LSUIElement=true），用于 spawn 子进程
  - buildOptions 和 AgentXService 的 MCP server 在 macOS 上优先使用 Helper 二进制
  - 所有 spawn 调用添加 windowsHide: true

- Updated dependencies []:
  - @promptx/config@2.1.1
  - @promptx/core@2.1.1
  - @promptx/mcp-office@2.1.1
  - @promptx/mcp-server@2.1.1

## 2.1.0

### Minor Changes

- [#551](https://github.com/Deepractice/PromptX/pull/551) [`ae02351`](https://github.com/Deepractice/PromptX/commit/ae02351ccbfa09f592fd22268fee77a7634e428f) Thanks [@dfwgj](https://github.com/dfwgj)! - **AgentX 支持多配置管理**

  - 新增多 API 配置（Profile）功能：可保存多组 API Key / Base URL / 模型，随时一键切换激活
  - 设置页面 AgentX 配置区改为列表 + 弹窗形式，支持新增、编辑、删除
  - 旧版单配置自动迁移为名为 "Default" 的 Profile，无需手动重新配置
  - Windows 平台在设置页面新增 Git 安装提示，附官网下载链接
  - 移除内置 MinGit，改为要求用户自行安装 Git for Windows

### Patch Changes

- Updated dependencies []:
  - @promptx/config@2.1.0
  - @promptx/core@2.1.0
  - @promptx/mcp-office@2.1.0
  - @promptx/mcp-server@2.1.0

## 1.28.3

### Patch Changes

- [`1f700f7`](https://github.com/Deepractice/PromptX/commit/1f700f7d6807bfe1e8b5341347ca1372893ba8d8) Thanks [@deepracticexc](https://github.com/deepracticexc)! - fix(desktop): 修复 macOS 应用图标尺寸和显示问题

  - 为图标添加 15% 边距，解决 Launchpad 中图标过大的问题
  - 重新生成 icns 文件，修复 Dock 栏中图标显示为正方形的问题
  - 更新所有尺寸变体（16x16 到 1024x1024）
  - macOS 现在会正确应用圆角效果

- Updated dependencies []:
  - @promptx/config@1.28.3
  - @promptx/core@1.28.3
  - @promptx/mcp-server@1.28.3

## 1.28.2

### Patch Changes

- Updated dependencies [[`373e824`](https://github.com/Deepractice/PromptX/commit/373e82494033f44a0f4ab77fb4f7f0183ae80ad8)]:
  - @promptx/mcp-server@1.28.2
  - @promptx/config@1.28.2
  - @promptx/core@1.28.2

## 1.28.1

### Patch Changes

- Security patch release - fix all 14 security vulnerabilities. Removed unused electron-icon-builder (deprecated phantomjs dependency), updated electron-builder to 26.7.0, and force-updated indirect dependencies via pnpm overrides to resolve tar, qs, brace-expansion, form-data, lodash, and tough-cookie vulnerabilities.

# @promptx/desktop

## 1.28.0

### Patch Changes

- Updated dependencies
  - @promptx/mcp-server@1.28.0
  - @promptx/core@1.28.0
  - @promptx/config@1.28.0

## 1.27.8

### Patch Changes

- Updated dependencies []:
  - @promptx/core@1.27.8
  - @promptx/mcp-server@1.27.8
  - @promptx/config@1.27.8

## 1.27.7

### Patch Changes

- [#515](https://github.com/Deepractice/PromptX/pull/515) [`0e4980f`](https://github.com/Deepractice/PromptX/commit/0e4980fa9844f077c634b2a6758d5f28a7d5cc24) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: 资源编辑器预览模式添加复制提示词按钮

  - 在资源编辑器的预览标签页中，将原本的"保存文件"按钮替换为"复制提示词"按钮
  - 点击按钮可将预览的完整提示词内容复制到剪贴板，并显示成功提示
  - 修复预览内容区域无法滚动的问题，通过在多层 flex 容器中添加 min-h-0 解决
  - 新增中英文翻译：copyPrompt（复制提示词）、copySuccess（复制成功提示）

- Updated dependencies []:
  - @promptx/core@1.27.7
  - @promptx/mcp-server@1.27.7
  - @promptx/config@1.27.7

## 1.27.6

### Patch Changes

- Updated dependencies [[`9bd7f80`](https://github.com/Deepractice/PromptX/commit/9bd7f807884288693c49cfa0b0bbec1e2ec8d0f1)]:
  - @promptx/core@1.27.6
  - @promptx/mcp-server@1.27.6
  - @promptx/config@1.27.6

## 1.27.5

### Patch Changes

- [#511](https://github.com/Deepractice/PromptX/pull/511) [`e09b76d`](https://github.com/Deepractice/PromptX/commit/e09b76dcaf3e3e8c57cb9bb9f12d4133b3e665f5) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: add refresh button and batch import functionality

  - Add refresh button to reload resource list
  - Add batch import feature for importing multiple resources at once
  - Improve resource management user experience

- [#511](https://github.com/Deepractice/PromptX/pull/511) [`e09b76d`](https://github.com/Deepractice/PromptX/commit/e09b76dcaf3e3e8c57cb9bb9f12d4133b3e665f5) Thanks [@dfwgj](https://github.com/dfwgj)! - fix: disable notification sounds on macOS startup (#493)

  - Set notification adapter to silent by default to prevent system sounds on app launch
  - Add autoplayPolicy to BrowserWindow webPreferences to prevent media autoplay
  - Fix issue where macOS played notification sound every time the app started

  This change improves the user experience by making notifications silent by default, following desktop application best practices. Users can still see notifications, but without the disruptive sound effects.

- [#511](https://github.com/Deepractice/PromptX/pull/511) [`e09b76d`](https://github.com/Deepractice/PromptX/commit/e09b76dcaf3e3e8c57cb9bb9f12d4133b3e665f5) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: single instance lock and UX improvements

  - Add single instance lock to prevent multiple app instances
  - Auto open main window on startup for better UX
  - Focus existing window when user clicks shortcut while app is running
  - Add resource type validation framework for import
  - Fix logger file lock issue with graceful fallback to console
  - Fix logs list refresh after clearing all logs

- Updated dependencies []:
  - @promptx/core@1.27.5
  - @promptx/mcp-server@1.27.5
  - @promptx/config@1.27.5

## 1.27.4

### Patch Changes

- [#497](https://github.com/Deepractice/PromptX/pull/497) [`46a7f1d`](https://github.com/Deepractice/PromptX/commit/46a7f1dc3abee1dd597e0238f8427c393c7598f2) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: add refresh button and batch import functionality

  - Add refresh button to reload resource list
  - Add batch import feature for importing multiple resources at once
  - Improve resource management user experience

- [#497](https://github.com/Deepractice/PromptX/pull/497) [`46a7f1d`](https://github.com/Deepractice/PromptX/commit/46a7f1dc3abee1dd597e0238f8427c393c7598f2) Thanks [@dfwgj](https://github.com/dfwgj)! - fix: disable notification sounds on macOS startup (#493)

  - Set notification adapter to silent by default to prevent system sounds on app launch
  - Add autoplayPolicy to BrowserWindow webPreferences to prevent media autoplay
  - Fix issue where macOS played notification sound every time the app started

  This change improves the user experience by making notifications silent by default, following desktop application best practices. Users can still see notifications, but without the disruptive sound effects.

- Updated dependencies []:
  - @promptx/config@1.27.4
  - @promptx/core@1.27.4
  - @promptx/mcp-server@1.27.4

## 1.27.3

### Patch Changes

- [#488](https://github.com/Deepractice/PromptX/pull/488) [`d112e73`](https://github.com/Deepractice/PromptX/commit/d112e73ebb7bc9a9c6ddcb9f8c45798b672248a5) Thanks [@dfwgj](https://github.com/dfwgj)! - feat: integrate main window with unified resource, logs and settings management (#486)

  - Add main window page with sidebar navigation integrating three major modules
  - Implement sidebar component for unified navigation
  - Add internationalized date picker support (Chinese/English)
  - Fix dialog animation sliding from top-left corner
  - Add TypeScript type declarations for static assets (images, etc.)
  - Optimize log filtering with custom date picker
  - Add multiple shadcn/ui components (separator, sheet, skeleton, tooltip)

  feat: add resource import/export functionality (#327)

  - Implement resource import: support importing roles and tools from ZIP files
  - Support custom configuration: customizable resource ID, name and description
  - Implement resource export: auto-package as ZIP archive, cross-platform compatible
  - Add file selection dialog: integrate Electron dialog API
  - Add shadcn/ui components: Select, Tabs, Textarea, InputGroup
  - Optimize Select component styling: add selected state background highlight
  - Complete i18n support: Chinese/English translations for all import/export features
  - Add dependency: adm-zip for cross-platform ZIP file handling

  Technical implementation:

  - Use AdmZip library for cross-platform compression/decompression
  - ZIP format is universal across Windows/Linux/macOS, no special handling needed
  - IPC communication: resources:import, resources:download, dialog:openFile
  - Resource validation: check DPML file structure integrity

  feat: complete application logs management page (#487)

  - Add standalone logs window page with real-time log viewing and management
  - Implement log filtering: by type (error/normal), date, keyword search
  - Add log operations: view details, delete individual logs, clear all with one click
  - Integrate IPC communication: logs:list, logs:read, logs:delete, logs:clear
  - Optimize responsive layout: flexbox layout with independent scrolling for list and content areas
  - Complete i18n support: Chinese/English translations covering all features
  - Optimize Input component: adjust focus border from 3px to 1px for better visual experience

  🤖 Generated with Claude Code

  Co-Authored-By: Claude <noreply@anthropic.com>

- Updated dependencies []:
  - @promptx/config@1.27.3
  - @promptx/core@1.27.3
  - @promptx/mcp-server@1.27.3

## 1.27.2

### Patch Changes

- [#480](https://github.com/Deepractice/PromptX/pull/480) [`d6aa5cb`](https://github.com/Deepractice/PromptX/commit/d6aa5cbea68d15e08041724e903639b2f021989d) Thanks [@dfwgj](https://github.com/dfwgj)! - Resource Manager UX: Prevent the edit modal from opening when clicking action icons

  - Context: Resource cards use `onClick` to open the edit modal. Clicking right-side action icons (Edit, View/External link, Delete) bubbled to the card, unintentionally triggering the modal.
  - Fix: Call `e.stopPropagation()` in each icon’s `onClick` (or on the icon container) to block event bubbling and ensure only the intended action runs.
  - Touched file: `apps/desktop/src/view/pages/resources-window/index.tsx`.
  - Impact: Affects the behavior of “Edit”, “View/External link”, and “Delete” icons on role/tool cards.
  - UX: Clicking action icons now performs the expected operation without opening the editor.
  - Compatibility: Non-breaking patch; no API or data shape changes.

- Updated dependencies []:
  - @promptx/config@1.27.2
  - @promptx/core@1.27.2
  - @promptx/mcp-server@1.27.2

## 1.27.1

### Patch Changes

- [#477](https://github.com/Deepractice/PromptX/pull/477) [`61d8101`](https://github.com/Deepractice/PromptX/commit/61d8101902314ef53ce7d866902a25364e576f86) Thanks [@dfwgj](https://github.com/dfwgj)! - ### fix(resource, desktop): Revert resource path logic and fix system role activation

  This update addresses a critical regression that affected resource loading and system role activation. The changes are broken down as follows:

  - **Reverted Path Resolution Logic in `@promptx/resource`**: A recent modification to the path handling logic within the `@promptx/resource` package was identified as the root cause of widespread resource loading failures. This change has been reverted to its previous, stable state. This ensures that the application can once again reliably locate and parse resource files (e.g., roles, tools) from their correct directories, resolving the loading failures.

  - **Fixed System Role Activation Bug**: A direct consequence of the pathing issue was a severe bug that made it impossible to activate or utilize any of the built-in system roles (such as `sean`, `luban`, or `nuwa`) in the desktop application. The fix restores the correct path resolution, allowing the application to find the necessary system role definition files and making these essential roles fully functional and accessible to users again.

  - **Optimized Resource Management UI**: The resource management page has been refined to provide a better user experience. Previously, it displayed both user-created custom resources and internal system resources. This was confusing and exposed core components to unintended user actions. The page now leverages the corrected path logic to distinguish between resource types and filters out all built-in system resources from the view. As a result, users will now only see and be able to manage their own custom-defined resources, creating a cleaner and safer management interface.

- Updated dependencies []:
  - @promptx/core@1.27.1
  - @promptx/mcp-server@1.27.1
  - @promptx/config@1.27.1

## 1.27.0

### Minor Changes

- [#470](https://github.com/Deepractice/PromptX/pull/470) [`40db475`](https://github.com/Deepractice/PromptX/commit/40db4752adfc0c534c88876d2ce59f7ffce79de7) Thanks [@dfwgj](https://github.com/dfwgj)! - Change: Add zh/en locale toggle, stabilize i18n initialization and paths, and refactor/optimize resource management and settings in the desktop app.

  Details

  - Main process i18n
    - Defer initialization to `app.whenReady()` to avoid early userData access and path issues.
    - Resolve translation files from `../../src/main/i18n` in development and `__dirname/i18n` in production.
    - Persist the selected locale to Electron `userData/language.json`.
    - Harden `t()` with initialization guard, key existence warnings, and English fallback.
  - Runtime detection
    - Use `app.isPackaged` instead of unreliable `NODE_ENV` for environment checks.
    - Improve resource path resolution under both dev and packaged modes.
    - Add renderer-side support to keep localization consistent across processes.
  - Auto-start decoupling
    - Migrate auto-start management from `@promptx/config` into the desktop main process for clearer responsibility boundaries.
  - Resource management refactor
    - Extract `ResourceEditor` into a separate component to improve maintainability and reuse.
  - Resource management enhancements
    - Replace `window.alert` with `sonner` toasts for non-blocking notifications.
    - Standardize modals as `shadcn/ui` `Dialog`.
    - Optimize the workflows for resource download, delete, and save.
  - Settings page overhaul
    - Migrate the settings page to React + `shadcn/ui` to unify the tech stack and design system.
    - Introduce a language selector UI for zh/en toggle.
  - Renderer bootstrap
    - Initialize the React renderer and baseline `shadcn/ui` configuration to support future page and component upgrades.

  Motivation

  - Make localization reliable across dev/prod environments and align UX for language switching.
  - Reduce cross-package coupling by moving platform-specific behavior (auto-start) into the desktop app.
  - Improve maintainability and consistency of resource management and UI components.

  Impact

  - Developers should rely on the desktop app APIs/settings for auto-start, not `@promptx/config`.
  - Translation files are expected under `src/main/i18n` at development time and copied to `out/main/i18n` in production.
  - Resource-related messages should use `t('resources.*')` instead of hardcoded strings.
  - UI notifications and dialogs follow `sonner` and `shadcn/ui` conventions.

  Migration Guide

  - Ensure `en.json` and `zh-CN.json` exist in `apps/desktop/src/main/i18n`; production builds copy them to `out/main/i18n`.
  - Replace any hardcoded messages in main/windows with `t(...)` calls and provide keys in both locales.
  - Use the desktop app’s settings or IPC for auto-start controls; remove usage of auto-start options from `@promptx/config`.
  - In renderer, replace `window.alert` with `sonner` toasts and use `shadcn/ui` `Dialog` for modals.

  Notes

  - This is a minor release focusing on i18n stability and UI consistency. If your extension or custom tooling depends on the old auto-start configuration in `@promptx/config`, treat this as a potential breaking change and follow the migration steps above.

### Patch Changes

- Updated dependencies [[`40db475`](https://github.com/Deepractice/PromptX/commit/40db4752adfc0c534c88876d2ce59f7ffce79de7)]:
  - @promptx/config@1.27.0
  - @promptx/mcp-server@1.27.0
  - @promptx/core@1.27.0

## 1.26.0

### Minor Changes

- [#461](https://github.com/Deepractice/PromptX/pull/461) [`395f07f`](https://github.com/Deepractice/PromptX/commit/395f07f9429b5417f1ec2a233fb5d8d692b74ff7) Thanks [@dfwgj](https://github.com/dfwgj)! - feat(settings): add Settings page and integrate @promptx/config

  Summary

  - Introduces a Settings page that centralizes control for auto-start and service networking.
  - Integrates `@promptx/config` to persist defaults across Desktop and CLI.

  Details

  - Auto-start
    - Uses `AutoStartManager` with IPC handlers: `auto-start:enable`, `auto-start:disable`, `auto-start:status`.
    - Adds a UI toggle; supports starting hidden; works on Windows/macOS/Linux.
  - Service network configuration
    - Reads defaults from `ServerConfigManager`.
    - Supports `port` (default `5203`), `host` (`localhost`), `transport` (`stdio|http`), `corsEnabled`, `debug`.
    - Persists to `~/.promptx/server-config.json`; creates directory/file on first run if missing.
  - Updater
    - No hardcoded repository; respects `electron-builder.yml` `publish` (CDN-first, GitHub fallback).

  User Experience

  - One-click enable/disable auto-start; takes effect after restart. On error, the toggle rolls back with a retry prompt.
  - Network settings updated via Settings or CLI and reused as defaults on next launch.

  Compatibility

  - Electron main process ESM compatible; development/runtime on Node 18+.
  - macOS uses LaunchAgent; Windows/Linux use standard OS mechanisms.

  Testing

  - Verified auto-start enable/disable/status on Windows and macOS.
  - Confirmed persistence of `~/.promptx/server-config.json` and default reload after restart.

  Refs

  - #370 Auto-start
  - #458 Service network configuration

### Patch Changes

- Updated dependencies [[`395f07f`](https://github.com/Deepractice/PromptX/commit/395f07f9429b5417f1ec2a233fb5d8d692b74ff7), [`f33c42b`](https://github.com/Deepractice/PromptX/commit/f33c42b3195ba264d77e21aecf8c9775cbe48eb6), [`395f07f`](https://github.com/Deepractice/PromptX/commit/395f07f9429b5417f1ec2a233fb5d8d692b74ff7)]:
  - @promptx/config@1.26.0
  - @promptx/core@1.26.0
  - @promptx/mcp-server@1.26.0

## 1.25.2

### Patch Changes

- [#454](https://github.com/Deepractice/PromptX/pull/454) [`52fe234`](https://github.com/Deepractice/PromptX/commit/52fe23401f5ef9c69512ccd348b0d480a8543803) Thanks [@deepracticexs](https://github.com/deepracticexs)! - Fix multiple desktop update and installation issues

  **Issue #450: Update check failure**

  - Fixed YAML parsing error in latest.yml caused by multi-line sha512 hash
  - Modified workflow to ensure sha512 is single-line with quotes
  - Added YAML validation step in release workflow

  **Issue #450: CDN not being used**

  - Removed hardcoded GitHub repo config in UpdateManager
  - Now uses electron-builder.yml publish config (CDN first, GitHub fallback)
  - Ensures promptx.deepractice.ai CDN is tried before GitHub

  **Issue #449: Windows installer requires admin**

  - Added `requestedExecutionLevel: highestAvailable` to Windows config
  - Installer now automatically prompts for UAC elevation when needed
  - Prevents silent failure on double-click

- Updated dependencies [[`01b9cd7`](https://github.com/Deepractice/PromptX/commit/01b9cd78d9a60e38f347e117a5d96b7fa902653c)]:
  - @promptx/core@1.25.2
  - @promptx/mcp-server@1.25.2

## 1.25.1

### Patch Changes

- Updated dependencies [[`16c4575`](https://github.com/Deepractice/PromptX/commit/16c4575e61c054d0af6f3176f0ff2d82b3364621)]:
  - @promptx/mcp-server@1.25.1
  - @promptx/core@1.25.1

## 1.25.0

### Patch Changes

- Updated dependencies [[`be63d3c`](https://github.com/Deepractice/PromptX/commit/be63d3c1c93779f3b2201cfb4358e6f07bbdc61f), [`25468ba`](https://github.com/Deepractice/PromptX/commit/25468bae26bd052107bab3dce373e50e95f9d627)]:
  - @promptx/core@1.25.0
  - @promptx/mcp-server@1.25.0

## 1.24.1

### Patch Changes

- [#435](https://github.com/Deepractice/PromptX/pull/435) [`1bcb923`](https://github.com/Deepractice/PromptX/commit/1bcb923ccc48bc65e883f42c57f6e7a6ec91e1a8) Thanks [@deepracticexs](https://github.com/deepracticexs)! - fix: downgrade @npmcli/arborist to support Node 18.17+

  - Downgrade @npmcli/arborist from 9.1.4 to 8.0.1 to support Node 18.17+ instead of requiring Node 20.17+
  - Update engines.node to >=18.17.0 across all packages for consistency
  - Update @types/node to ^18.0.0 to match the supported Node version
  - Remove unused installPackage() method from PackageInstaller.js
  - Fix turbo.json by removing incorrect extends config

  This change removes the dependency on glob@11 and cacache@20 which required Node 20+, allowing users with Node 18.17+ to install and use PromptX without warnings.

  Fixes #387

- Updated dependencies [[`1bcb923`](https://github.com/Deepractice/PromptX/commit/1bcb923ccc48bc65e883f42c57f6e7a6ec91e1a8)]:
  - @promptx/core@1.24.1
  - @promptx/mcp-server@1.24.1

## 1.24.0

### Patch Changes

- Updated dependencies [[`92e3096`](https://github.com/Deepractice/PromptX/commit/92e309648d1d89ff124fd1a4de4a7bec8f368eb8), [`83054d9`](https://github.com/Deepractice/PromptX/commit/83054d9b3d911ae2ba20256b0ddb9299b738da0b), [`42c7c9e`](https://github.com/Deepractice/PromptX/commit/42c7c9e0e353ade237160e41e111d868d764d108), [`4bda583`](https://github.com/Deepractice/PromptX/commit/4bda5834ee4f9fb8eae134b77961dff30b22a26d)]:
  - @promptx/mcp-server@1.24.0
  - @promptx/core@1.24.0

## 1.23.4

### Patch Changes

- Updated dependencies []:
  - @promptx/core@1.23.4
  - @promptx/mcp-server@1.23.4

## 1.23.3

### Patch Changes

- [#421](https://github.com/Deepractice/PromptX/pull/421) [`c3387a1`](https://github.com/Deepractice/PromptX/commit/c3387a17a618f6725f46231973594270ac4c31d7) Thanks [@deepracticexs](https://github.com/deepracticexs)! - # Multiple improvements across roles, toolx, and desktop

  ## Core Features

  ### DPML Tag Attributes Support

  - Support tags with attributes in resource discovery (e.g., `@!thought://name[key="value"]`)
  - Enable more flexible resource referencing in role definitions
  - Improve DPML specification documentation

  ### Nuwa Role Enhancements

  - Implement dynamic Socratic dialogue flow with flexible Structure
  - Add constructive guidance principle for AI prompt design
  - Clarify DPML sub-tag usage rules
  - Expand ISSUE framework knowledge

  ### Luban Role Improvements

  - Shift research methodology from "finding packages" to "understanding principles first"
  - Establish 3-step research process: principle → complexity → solution
  - Add real case study showing principle-first approach
  - Define clear criteria for native capabilities vs npm packages
  - Apply constructive expression throughout

  ## Bug Fixes

  ### ToolX Stability

  - Add top-level exception handling to prevent main process crashes
  - Convert all errors to structured MCP format
  - Ensure sandbox cleanup always executes
  - Improve error logging for debugging

  ### Desktop Update UX

  - Fix "no update available" incorrectly shown as error dialog
  - Distinguish between check failure (error) and no update (info)
  - Add separate error handling for download failures
  - Prioritize PromptX CDN over GitHub for better user experience

  ## Related Issues

  - Fixes #405: Luban's research methodology improvement

- Updated dependencies [[`c3387a1`](https://github.com/Deepractice/PromptX/commit/c3387a17a618f6725f46231973594270ac4c31d7)]:
  - @promptx/core@1.23.3
  - @promptx/mcp-server@1.23.3

## 1.23.2

### Patch Changes

- [`84854cf`](https://github.com/Deepractice/PromptX/commit/84854cf98dcbdbbdef47ac956e039ec3257393ca) Thanks [@deepracticexs](https://github.com/deepracticexs)! - 测试 R2 CDN 和 PromptX Worker 自动更新

  - 使用 PromptX Worker 实现 latest 自动重定向
  - R2 上传改为独立 Phase
  - 优化国内用户下载体验

- Updated dependencies []:
  - @promptx/core@1.23.2
  - @promptx/mcp-server@1.23.2

## 1.23.1

### Patch Changes

- [#418](https://github.com/Deepractice/PromptX/pull/418) [`68e88be`](https://github.com/Deepractice/PromptX/commit/68e88be92244543dff288af9d866e25f7b843e99) Thanks [@deepracticexs](https://github.com/deepracticexs)! - 使用 Cloudflare R2 优化国内用户自动更新体验

  - 配置多 provider 自动更新策略：GitHub 优先，R2 兜底
  - 发布时自动同步安装包到 Cloudflare R2
  - 国内用户可通过 CDN 加速下载更新

- Updated dependencies []:
  - @promptx/core@1.23.1
  - @promptx/mcp-server@1.23.1

## 1.23.0

### Patch Changes

- Updated dependencies [[`665b71a`](https://github.com/Deepractice/PromptX/commit/665b71a58425b56eb4bf7f636485ef79c9e5da6c), [`df8140b`](https://github.com/Deepractice/PromptX/commit/df8140ba9a4d6715ba21d9fe0c37d92ee8db5127), [`a90ad4a`](https://github.com/Deepractice/PromptX/commit/a90ad4a159e112388109dac632cbad0da694a2bf)]:
  - @promptx/core@1.23.0
  - @promptx/mcp-server@1.23.0

## 1.22.0

### Patch Changes

- Updated dependencies [[`3eb7471`](https://github.com/Deepractice/PromptX/commit/3eb747132bf8ad30112624372cffec5defcc3105), [`6410be3`](https://github.com/Deepractice/PromptX/commit/6410be33eb7452b540c9df18493c9798e404cb8d), [`a6239a6`](https://github.com/Deepractice/PromptX/commit/a6239a69e91f4aa3bfcb66ad1e802fbc7749b54b)]:
  - @promptx/mcp-server@1.22.0
  - @promptx/core@1.22.0

## 1.21.0

### Patch Changes

- Updated dependencies [[`108bb4a`](https://github.com/Deepractice/PromptX/commit/108bb4a333503352bb52f4993a35995001483db6)]:
  - @promptx/core@1.21.0
  - @promptx/mcp-server@1.21.0

## 1.20.0

### Patch Changes

- Updated dependencies [[`b79494d`](https://github.com/Deepractice/PromptX/commit/b79494d3611f6dfad9740a7899a1f794ad53c349), [`5c630bb`](https://github.com/Deepractice/PromptX/commit/5c630bb73e794990d15b67b527ed8d4ef0762a27), [`54be2ef`](https://github.com/Deepractice/PromptX/commit/54be2ef58d03ea387f3f9bf2e87f650f24cac411)]:
  - @promptx/core@1.20.0
  - @promptx/mcp-server@1.20.0

## 1.19.0

### Patch Changes

- Updated dependencies [[`54d6b6a`](https://github.com/Deepractice/PromptX/commit/54d6b6ac92e5971211b483fc412e82894fb85714)]:
  - @promptx/core@1.19.0
  - @promptx/mcp-server@1.19.0

## 1.18.0

### Patch Changes

- [#373](https://github.com/Deepractice/PromptX/pull/373) [`9812fef`](https://github.com/Deepractice/PromptX/commit/9812fefb90104838235b58dd600b29cc9960f0bc) Thanks [@deepracticexs](https://github.com/deepracticexs)! - Replace tray icons with new professional pixel-art design

  - Added new tray icon assets in dedicated `/assets/icons/tray/` directory
  - Implemented cross-platform tray icon support:
    - macOS: Uses template image for automatic theme adaptation
    - Windows: Detects system theme and switches between black/white icons
    - Linux: Uses default black icon
  - Added visual status indication through different icon variants:
    - Running: Normal icon (pixel version)
    - Stopped: Transparent/gray icon for reduced visual prominence
    - Error: Reserved for future customization
  - Removed programmatic icon generation (createPIcon) in favor of designer-provided assets
  - Added automatic theme change listener for Windows to update icon dynamically

- Updated dependencies [[`ad52333`](https://github.com/Deepractice/PromptX/commit/ad5233372ae4d4835a5f5626ebb5dd585077f597)]:
  - @promptx/core@1.18.0
  - @promptx/mcp-server@1.18.0

## 1.17.3

### Patch Changes

- Updated dependencies [[`e409b52`](https://github.com/Deepractice/PromptX/commit/e409b522bf9694547bd18095e048374d72dde120)]:
  - @promptx/core@1.17.3
  - @promptx/mcp-server@1.17.3

## 1.17.2

### Patch Changes

- Updated dependencies [[`f5891a6`](https://github.com/Deepractice/PromptX/commit/f5891a60d66dfaabf56ba12deb2ac7326d288025)]:
  - @promptx/core@1.17.2
  - @promptx/mcp-server@1.17.2

## 1.17.1

### Patch Changes

- Updated dependencies [[`c7ed9a1`](https://github.com/Deepractice/PromptX/commit/c7ed9a113e0465e2955ad1d11ad511a2f327440d)]:
  - @promptx/core@1.17.1
  - @promptx/mcp-server@1.17.1

## 1.17.0

### Minor Changes

- [#355](https://github.com/Deepractice/PromptX/pull/355) [`93c3f6e`](https://github.com/Deepractice/PromptX/commit/93c3f6edfbf1d920eab32f259fdd6617624aba56) Thanks [@deepracticexs](https://github.com/deepracticexs)! - feat: Replace update-electron-app with electron-updater for better update experience

  - Implement comprehensive update state machine with 6 states (idle, checking, update-available, downloading, ready-to-install, error)
  - Add automatic update check and download on startup
  - Show dynamic tray menu based on update state
  - Display download progress and version information
  - Add install confirmation dialog when manually checking
  - Support update state persistence across app restarts
  - Skip redundant checks if update already downloaded
  - Fix state transition for auto-download scenario
  - Improve user experience with smart update flow

  Breaking Changes: None

  Migration: The update system will automatically work with existing installations. First update using the new system will be seamless.

### Patch Changes

- Updated dependencies []:
  - @promptx/core@1.17.0
  - @promptx/mcp-server@1.17.0

## 1.16.0

### Patch Changes

- [#347](https://github.com/Deepractice/PromptX/pull/347) [`eb7a2be`](https://github.com/Deepractice/PromptX/commit/eb7a2be1ef4fffed97a9dc20eaaacd9065fc0e01) Thanks [@deepracticexs](https://github.com/deepracticexs)! - 重命名 Welcome 为 Discover，更准确地反映功能定位

  ### 主要更改

  #### @promptx/core

  - 将 `WelcomeCommand` 重命名为 `DiscoverCommand`
  - 将 `WelcomeHeaderArea` 重命名为 `DiscoverHeaderArea`
  - 将 `welcome` 文件夹重命名为 `discover`
  - 更新常量 `WELCOME` 为 `DISCOVER`
  - 更新状态 `welcome_completed` 为 `discover_completed`

  #### @promptx/mcp-server

  - 将 `welcomeTool` 重命名为 `discoverTool`
  - 更新工具描述，强调"探索 AI 潜能"的核心价值
  - 添加 `focus` 参数支持，允许按需筛选角色或工具
  - 更新 action 工具中的相关引用

  #### @promptx/cli

  - CLI 命令从 `welcome` 改为 `discover`
  - 更新帮助文档和示例

  #### @promptx/desktop

  - 更新 `PromptXResourceRepository` 中的相关引用

  ### 影响

  - **Breaking Change**: CLI 命令 `promptx welcome` 需要改为 `promptx discover`
  - MCP 工具名从 `promptx_welcome` 改为 `promptx_discover`
  - 所有文档和注释中的 Welcome 相关内容都已更新

- Updated dependencies [[`68b8304`](https://github.com/Deepractice/PromptX/commit/68b8304a5d5e7569f3534f6cfe52348c457b0ce9), [`57f430d`](https://github.com/Deepractice/PromptX/commit/57f430d2af2c904f74054e623169963be62783c5), [`eb7a2be`](https://github.com/Deepractice/PromptX/commit/eb7a2be1ef4fffed97a9dc20eaaacd9065fc0e01)]:
  - @promptx/mcp-server@1.16.0
  - @promptx/core@1.16.0

## 1.15.1

### Patch Changes

- Updated dependencies [[`7a80317`](https://github.com/Deepractice/PromptX/commit/7a80317ba1565a9d5ae8de8eab43cb8c37b73eb5)]:
  - @promptx/core@1.15.1
  - @promptx/mcp-server@1.15.1

## 1.15.0

### Patch Changes

- Updated dependencies [[`16ee7ee`](https://github.com/Deepractice/PromptX/commit/16ee7eec70925629dd2aec47997f3db0eb70c74c)]:
  - @promptx/mcp-server@1.15.0
  - @promptx/core@1.15.0

## 1.14.2

### Patch Changes

- [#337](https://github.com/Deepractice/PromptX/pull/337) [`9385a49`](https://github.com/Deepractice/PromptX/commit/9385a49aba66540853a2fda6ddc9a168217534fa) Thanks [@deepracticexs](https://github.com/deepracticexs)! - Fix auto-update detection issue (#336)

  - Remove manual "Check for Updates" button from tray menu to avoid user confusion
  - Add comprehensive ASCII-only logging for auto-updater events
  - Simplify update manager to rely on automatic 1-hour update checks
  - Clean up unused dialog and icon loading code

  The manual update check button was ineffective due to update-electron-app's stateless design. When users selected "Later" on an update, the library wouldn't re-prompt for the same version. This change removes the confusing button and adds detailed logging to track update status transparently.

- Updated dependencies [[`94483a8`](https://github.com/Deepractice/PromptX/commit/94483a8426e726e76a7cb7700f53377ae29d9aec)]:
  - @promptx/mcp-server@1.14.2
  - @promptx/core@1.14.2

## 1.14.1

### Patch Changes

- Updated dependencies [[`4a6ab6b`](https://github.com/Deepractice/PromptX/commit/4a6ab6b579101921ba29f2a551bb24c75f579de1), [`abcff55`](https://github.com/Deepractice/PromptX/commit/abcff55b916b7db73e668023a964fba467cc8cb6)]:
  - @promptx/core@1.14.1
  - @promptx/mcp-server@1.14.1

## 1.14.0

### Minor Changes

- [`cde78ed`](https://github.com/Deepractice/PromptX/commit/cde78ed4a1858df401596e8b95cae91d8c80ef7a) Thanks [@deepracticexs](https://github.com/deepracticexs)! - # feat: implement importx unified module loading architecture

  实现 importx 统一模块加载架构，彻底解决 PromptX 工具开发中的模块导入复杂性，为开发者提供零认知负担的统一导入体验。

  ## 🚀 核心架构变更

  ### importx 统一导入架构

  - **移除复杂系统**：删除 ESModuleRequireSupport.js (276 行复杂逻辑)
  - **统一导入接口**：为所有工具提供统一的 `importx()` 函数
  - **自动类型检测**：importx 自动处理 CommonJS/ES Module/内置模块差异
  - **简化 ToolSandbox**：大幅重构，消除循环依赖和复杂 fallback 逻辑

  ### Electron 环境优化

  - **pnpm 超时修复**：解决 Electron 环境下 pnpm 安装超时问题
  - **utilityProcess 通信**：实现进程间可靠通信机制
  - **Worker 脚本**：专用的 electron-pnpm-worker-script.js
  - **依赖管理增强**：PnpmInstaller、SystemPnpmRunner、ElectronPnpmWorker

  ### 关键问题修复

  - **importx parentURL 修复**：使用工具沙箱的 package.json 作为模块解析基础
  - **文件边界临时禁用**：解决 ~/.promptx 访问限制问题
  - **filesystem 工具更新**：适配新的 importx 架构

  ## 📈 性能和稳定性提升

  - **依赖管理测试**：从 62.5% → 87.5% 通过率
  - **importx 架构测试**：100% 通过率
  - **沙箱环境测试**：100% 通过率
  - **axios, validator** 等 CommonJS 包：正常导入
  - **nanoid, fs-extra** 等混合包：正常导入

  ## 💡 开发者体验

  ### 认知负担归零

  - 只需学习一个 `importx()` 函数
  - 统一所有模块类型的导入语法
  - 自动处理版本兼容性问题

  ### 架构简化

  - 代码量减少：移除 276 行复杂逻辑
  - 维护性提升：统一架构易于理解和扩展
  - Electron 兼容：解决特殊环境问题

  ## 🔄 内部优化 (向下兼容)

  ### ToolSandbox 内部重构

  - 内部统一使用 `importx()` 进行模块导入，外部 API 保持不变
  - 自动处理 CommonJS/ES Module 兼容性
  - 删除了内部复杂的 ESModuleRequireSupport 类

  ### 工具开发建议

  - 新工具推荐使用 `importx()` 进行模块导入
  - 现有工具继续工作，无需强制迁移
  - `require()` 和 `loadModule()` 仍然支持

  ## 🛠️ 使用指南

  ### 推荐的导入方式

  ```javascript
  // 推荐方式 (统一、简单)
  const axios = await importx("axios")
  const chalk = await importx("chalk")
  const fs = await importx("fs")

  // 仍然支持的方式
  const axios = require("axios") // 对于 CommonJS
  const chalk = await loadModule("chalk") // 对于 ES Module
  ```

  ### 对于框架使用者

  - 现有 ToolSandbox API 完全兼容
  - 内部性能和稳定性自动提升
  - 无需代码修改

  ## 🎯 影响范围

  - **开发者**：统一的模块导入体验，显著降低学习成本
  - **系统架构**：简化的代码结构，提升维护性
  - **性能**：提升的依赖管理可靠性，更快的模块解析
  - **Electron 应用**：解决环境特殊性问题，提升稳定性

  这是 PromptX 工具生态的重要里程碑，实现了"零认知负担"的模块导入理念。

### Patch Changes

- [#314](https://github.com/Deepractice/PromptX/pull/314) [`c78d7e0`](https://github.com/Deepractice/PromptX/commit/c78d7e0fa960f05eb4018ee01d1e5d21cf0a950b) Thanks [@deepracticexs](https://github.com/deepracticexs)! - feat(desktop): add About dialog to tray menu

  - Add About dialog accessible from system tray menu
  - Display app version and basic information
  - Improve user experience with easy access to app details

- Updated dependencies [[`cde78ed`](https://github.com/Deepractice/PromptX/commit/cde78ed4a1858df401596e8b95cae91d8c80ef7a), [`801fc4e`](https://github.com/Deepractice/PromptX/commit/801fc4edb1d99cf079baeecbb52adf7d2a7e404e)]:
  - @promptx/core@1.14.0
  - @promptx/mcp-server@1.14.0

## 1.13.0

### Minor Changes

- [`b578dab`](https://github.com/Deepractice/PromptX/commit/b578dabd5c2a2caea214912f1ef1fcefd65d3790) Thanks [@deepracticexs](https://github.com/deepracticexs)! - feat: implement auto-updater mechanism for PromptX desktop app

  Added comprehensive auto-updater functionality using electron-updater with GitHub Releases integration.

  **Key Features:**

  - Automatic update checking on app startup (3 seconds delay)
  - Manual update checking via system tray menu
  - User-controlled download and installation process
  - Support for skipping specific versions
  - Development mode detection with appropriate messaging

  **User Experience:**

  - Non-intrusive background update checking
  - Clear dialogs with PromptX branding instead of system notifications
  - Three-option update flow: "Download Now", "Remind Me Later", "Skip This Version"
  - Automatic architecture detection (Intel/Apple Silicon/Universal on macOS)
  - Update status reflected in system tray menu

  **Technical Implementation:**

  - Integration with existing Clean Architecture pattern
  - UpdateManager class following SOLID principles
  - Proper error handling and logging throughout
  - GitHub Releases as update distribution channel
  - Support for multi-platform builds (macOS x64/arm64/universal, Windows setup/portable, Linux AppImage/deb/rpm)

  **Configuration Updates:**

  - Updated electron-builder.yml for multi-architecture builds
  - Fixed GitHub Actions workflow for proper artifact generation
  - Added metadata files (latest-mac.yml, latest.yml, latest-linux.yml) for update detection
  - Configured publish settings for GitHub provider

  **Security & Reliability:**

  - Disabled auto-download - requires explicit user consent
  - Version validation and checksum verification
  - Graceful fallback for network/server errors
  - Development mode safeguards

  This implements the high-priority feature request from issue #305, providing users with seamless update experience while maintaining full control over when updates are downloaded and installed.

### Patch Changes

- Updated dependencies [[`d60e63c`](https://github.com/Deepractice/PromptX/commit/d60e63c06f74059ecdc5435a744c57c1bfe7f7d0)]:
  - @promptx/core@1.13.0
  - @promptx/mcp-server@1.13.0

## 1.12.0

### Patch Changes

- Updated dependencies []:
  - @promptx/core@1.12.0
  - @promptx/mcp-server@1.12.0

## 1.11.0

### Patch Changes

- Updated dependencies [[`c3c9c45`](https://github.com/Deepractice/PromptX/commit/c3c9c451b9cdd5abaa5c1d51abe594ad14841354)]:
  - @promptx/mcp-server@1.11.0
  - @promptx/core@1.11.0

## 1.10.1

### Patch Changes

- Fix release workflow and prepare for beta release

  - Update changeset config to use unified versioning for all packages
  - Fix resource discovery and registry generation bugs
  - Update pnpm-lock.yaml for CI compatibility
  - Prepare for semantic versioning with beta releases
  - Fix npm publishing conflicts by using proper versioning strategy

- Updated dependencies []:
  - @promptx/core@1.10.1
  - @promptx/mcp-server@1.10.1

## 1.10.0

### Minor Changes

- [#292](https://github.com/Deepractice/PromptX/pull/292) [`f346df5`](https://github.com/Deepractice/PromptX/commit/f346df58b4e2a28432a9eed7bbfed552db10a9de) Thanks [@deepracticexs](https://github.com/deepracticexs)! - feat(desktop): Add resource management UI with GitHub-style design

  ### New Features

  - **Resource Management Interface**: New dedicated page to view and search all PromptX resources
  - **GitHub-style UI**: Clean, light-themed interface inspired by GitHub's design language
  - **Advanced Filtering**: Dual-layer filtering system for Type (Roles/Tools) and Source (System/User)
  - **Real-time Search**: Instant search across resource names, descriptions, and tags
  - **Resource Statistics**: Dashboard showing total resources breakdown by type and source

  ### Technical Improvements

  - **Enhanced Logging**: Consolidated logging system with file output to ~/.promptx/logs
  - **IPC Communication**: Fixed data structure issues in Electron IPC layer
  - **Renderer Process Logging**: Added dedicated logger for renderer process with main process integration
  - **Resource Loading**: Improved resource fetching from PromptX core with proper error handling

  ### UI/UX Enhancements

  - **Responsive Layout**: Properly structured layout with search bar and filter controls
  - **Visual Hierarchy**: Clear separation between search, filters, and resource listing
  - **Simplified Interaction**: Removed unnecessary buttons and click events for cleaner interface
  - **Better Organization**: Resources grouped by source (System/User) with clear visual indicators

  ### Bug Fixes

  - Fixed resource loading issue where data wasn't properly passed from main to renderer process
  - Resolved IPC handler duplicate registration errors
  - Fixed file path issues in development mode

### Patch Changes

- Updated dependencies []:
  - @promptx/cli@1.10.0

## 1.9.0

### Patch Changes

- Updated dependencies [[`50d6d2c`](https://github.com/Deepractice/PromptX/commit/50d6d2c6480e90d3bbc5ab98efa396cb68a865a1), [`3da84c6`](https://github.com/Deepractice/PromptX/commit/3da84c6fddc44fb5578421d320ee52e59f241157), [`2712aa4`](https://github.com/Deepractice/PromptX/commit/2712aa4b71e9752f77a3f5943006f99f904f157e)]:
  - @promptx/cli@1.9.0

## 1.8.0

### Patch Changes

- Updated dependencies [[`50d6d2c`](https://github.com/Deepractice/PromptX/commit/50d6d2c6480e90d3bbc5ab98efa396cb68a865a1), [`3da84c6`](https://github.com/Deepractice/PromptX/commit/3da84c6fddc44fb5578421d320ee52e59f241157), [`2712aa4`](https://github.com/Deepractice/PromptX/commit/2712aa4b71e9752f77a3f5943006f99f904f157e)]:
  - @promptx/cli@1.8.0
