@becrafter/prompt-manager 0.0.19 → 0.1.2

package/README.md

@@ -2,303 +2,205 @@
 
 [![npm version](https://badge.fury.io/js/%40becrafter%2Fprompt-manager.svg)](https://www.npmjs.com/package/@becrafter/prompt-manager)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 
-一个基于MCP协议的Prompt管理服务，支持HTTP流式传输、Web管理界面和桌面应用，可将静态提示词模板转换为可通过API调用的动态服务。
+> **一个提示词管理工具，帮你把常用的 AI 提示词整理成库，随时调用。**
 
-## 核心特性
+## 这是什么？
 
-- 🛠️ **MCP协议支持**：完全兼容模型上下文协议（MCP），可与各种AI客户端集成
-- 🌐 **HTTP流式传输**：基于StreamableHTTP协议优化，提供稳定的长连接支持
-- 📁 **递归扫描**：自动发现子目录中的 prompt 文件
-- ⚙️ **灵活配置**：支持命令行参数和环境变量配置
-- 🖥️ **原生桌面壳**：内置 Electron 菜单应用，可一键启动/停止服务，并内嵌管理后台
-- 📋 **管理界面**：提供Web管理界面，方便创建、编辑和管理提示词
+想象一下，你经常用 AI 写代码、做翻译、写文案...每次都要重新输入类似的提示词，很麻烦。
 
-## 快速开始
+**Prompt Manager 就是帮你管理这些提示词的工具：**
 
-### 1. 安装
+- 📝 把提示词保存成模板，随时调用
+- 🔍 快速搜索你需要的提示词
+- 🌐 通过网页界面管理，简单直观
+- 💻 也可以作为服务运行，让其他程序调用
 
-```bash
-# 全局安装
-npm install -g @becrafter/prompt-manager
+**简单说：就像收藏夹，但专门用来管理 AI 提示词。**
 
-# 或作为项目依赖安装
-npm install @becrafter/prompt-manager 
-```
+## 快速开始
 
-### 2. 启动服务器
+### 方式一：命令行使用（适合技术人员）
 
 ```bash
-# 使用默认配置启动
-prompt-manager
-
-# 指定提示词目录
-prompt-manager --prompts-dir ./my-prompts
-
-# 指定端口
-prompt-manager --port 5621
-```
-
-> 默认情况下，服务会在 `~/.prompt-manager/prompts` 下创建并读取提示词目录。第一次启动会将仓库中的 `examples/prompts` 同步过去，方便快速体验。
-
-### 3. CLI 命令
-
-新版本的命令行逻辑已经集中在 `app/cli` 中，支持拓展式命令分发。常用用法保持不变：
+# 1. 安装
+npm install -g @becrafter/prompt-manager
 
-```bash
-# 默认等价于 prompt-manager start
+# 2. 启动服务
 prompt-manager
 
-# 显式使用 start/run 命令
-prompt-manager start --port 6000
-prompt-manager run --prompts-dir ./examples/prompts
-
-# 获取帮助/版本信息
-prompt-manager --help
-prompt-manager --version
+# 3. 打开浏览器访问
+# http://localhost:5621/admin
 ```
 
-后续如需增加自定义子命令，只需在 `app/cli/commands` 下添加对应实现并在 `app/cli/index.js` 注册即可。
-
-## 桌面菜单应用（Electron）
-
-为了让非技术同学也能便捷地运行服务，仓库新增了一个 Electron 菜单栏应用，位于 `app/desktop`。打包后的应用会连同 Node.js 运行时、`prompt-manager` 代码以及依赖一并分发，无需再额外配置环境。
-
-### 目录与结构
-
-- `app/desktop/main.js`：Electron 主进程，负责托盘 UI、服务生命周期、升级流程
-- `app/desktop/assets/`：托盘、安装图标等资源
-- `app/desktop/package.json`：单独的桌面工程配置与 `electron-builder` 打包描述
+就这么简单！服务启动后，打开浏览器就能看到管理界面。
 
-### 菜单功能
+### 方式二：桌面应用（适合所有人）
 
-- **启/停服务**：根据当前状态切换文案，直接调用服务的 `startServer/stopServer`
-- **复制服务地址**：一键复制当前 `http://127.0.0.1:<port>` 地址，方便分享或调试
-- **打开管理后台**：在独立窗口中嵌入服务自带的 `/admin` 前端，可直接登录管理 prompt
-- **检查更新**：调用 npm Registry 获取最新版本，下载 tarball、自动安装依赖，并保留 `examples/prompts` 内的示例内容（实际数据位于 `~/.prompt-manager/prompts`，不会受影响）
-- **关于服务**：展示桌面端、服务端、Electron、Chromium、Node.js 等组件版本
-- **退出服务**：先平滑停止 Express 服务，再退出 Electron 进程
+下载桌面应用，双击运行，点击菜单栏图标就能管理提示词。
 
-### 本地开发/调试
+> 💡 桌面应用正在开发中，敬请期待
 
-```bash
-# 安装依赖（仓库根目录已经装好 server 依赖）
-cd app/desktop
-npm install
-
-# 启动托盘应用（也可使用根目录脚本 npm run desktop:dev）
-npm run dev
-```
+## 怎么用？
 
-启动后系统托盘只会出现一个图标，所有交互都在菜单里完成。
+### 1. 创建提示词
 
-### 打包发布
+在管理界面点击"新建"，输入提示词内容：
 
-```bash
-# 在仓库根目录执行，会调用 app/desktop 内的 electron-builder
-npm run desktop:build
+```yaml
+name: 代码审查
+description: 帮我审查代码质量
+messages:
+  - role: user
+    content:
+      text: |
+        请审查以下代码，找出潜在问题：
+        
+        {{code}}
 ```
 
-`electron-builder` 会输出 macOS `.dmg`、Windows `.exe`（NSIS）以及 Linux `.AppImage` 安装包，`extraResources` 中包含 `prompt-manager` 的源码与依赖，从而保证离线可用。
-
-### 升级机制
-
-菜单中的 "检查更新" 会：
-
-1. 读取当前运行的服务版本（`app.getPath('userData')/prompt-manager/package.json`）
-2. 对比 npm Registry 上的最新版本
-3. 在用户确认后停止服务、下载最新 tarball、重新写入运行目录
-4. 通过 `npm install --omit=dev` 在沙盒目录中重新安装依赖
-5. 保留示例 `examples/prompts` 目录（若存在），用户自定义数据保存在 `~/.prompt-manager/prompts`，无需额外迁移
+### 2. 使用提示词
 
-整个过程无需系统层面的 Node/npm，真正实现"装上即用"。
-
-## 配置选项
-
-### 命令行参数
-
-| 参数 | 简写 | 描述 |
-|------|------|------|
-| `--prompts-dir <目录>` | `-p` | 指定 prompts 文件所在目录 |
-| `--port <端口>` | `-P` | 指定服务器端口 (默认: 5621) |
-| `--help` | `-h` | 显示帮助信息 |
-| `--version` | `-v` | 显示版本信息 |
-
-### 环境变量
+保存后，你可以：
+- 在管理界面直接使用
+- 通过 API 调用（适合程序员）
+- 在支持 MCP 协议的 AI 客户端中使用
 
-| 环境变量 | 描述 | 默认值 |
-|----------|------|--------|
-| `MCP_SERVER_NAME` | 服务器名称 | `prompt-manager` |
-| `SERVER_PORT` | 服务器端口 | `5621` |
-| `PROMPTS_DIR` | Prompts目录路径 | `~/.prompt-manager/prompts` |
-| `MCP_SERVER_VERSION` | 服务器版本 | `0.0.19` |
-| `LOG_LEVEL` | 日志级别 (error, warn, info, debug) | `info` |
-| `MAX_PROMPTS` | 最大prompt数量限制 | `100` |
-| `RECURSIVE_SCAN` | 是否启用递归扫描子目录 | `true` |
-| `ADMIN_ENABLE` | 是否启用管理界面 | `true` |
-| `ADMIN_PATH` | 管理界面路径 | `/admin` |
-| `ADMIN_USERNAME` | 管理员用户名 | `admin` |
-| `ADMIN_PASSWORD` | 管理员密码 | `admin` |
+### 3. 管理提示词
 
-> 安装或首次运行时，会自动将 `env.example` 内容写入 `~/.prompt-manager/.env`（如果该文件尚未存在），方便在系统范围内共享配置。
+- 📁 按文件夹分类整理
+- 🔍 快速搜索
+- ✏️ 随时编辑
+- 🗑️ 删除不需要的
 
-## API 接口
+## 常见使用场景
 
-### MCP协议接口
-
-服务器实现了MCP协议，支持以下工具：
-
-- `search_prompts`: 搜索提示词
-- `get_prompt`: 获取指定提示词的完整内容
-- `reload_prompts`: 重新加载所有提示词
-
-### Web管理接口
-
-#### 获取提示词列表
-
-```
-GET /prompts[?search=关键词]
-```
-
-返回所有可用的提示词列表，支持搜索功能。
-
-#### 获取单个提示词详情
-
-```
-GET /api/prompts/:name[?path=文件路径]
-```
+**场景 1：团队共享提示词**
+- 把团队常用的提示词整理在一起
+- 新成员直接使用，不用重复写
 
-返回指定名称的提示词详细信息。
+**场景 2：个人知识库**
+- 把好用的提示词保存下来
+- 按项目、按类型分类管理
 
-#### 创建/更新提示词
+**场景 3：集成到其他工具**
+- 作为服务运行
+- 其他程序通过 API 调用你的提示词库
 
-```
-POST /api/prompts
-```
+## 提示词格式
 
-创建或更新提示词文件。
+提示词用 YAML 格式保存，很简单：
 
-请求体示例：
-```json
-{
-  "name": "my-prompt",
-  "group": "default",
-  "yaml": "name: my-prompt\ndescription: 我的自定义提示词\nmessages:\n  - role: user\n    content:\n      text: 这是一个{{参数}}示例\n"
-}
+```yaml
+name: 提示词名称
+description: 简短描述
+messages:
+  - role: user
+    content:
+      text: 提示词内容，可以用 {{变量名}} 来占位
+arguments:
+  - name: 变量名
+    description: 变量说明
+    type: string
+enabled: true
 ```
 
-#### 删除提示词
+**示例：代码审查提示词**
 
-```
-DELETE /api/prompts/:name[?path=文件路径]
+```yaml
+name: code-review
+description: 代码审查助手
+messages:
+  - role: user
+    content:
+      text: |
+        请审查这段 {{language}} 代码：
+        
+        ```{{language}}
+        {{code}}
+        ```
+        
+        请指出：
+        1. 潜在问题
+        2. 改进建议
+arguments:
+  - name: language
+    description: 编程语言
+    type: string
+  - name: code
+    description: 要审查的代码
+    type: string
+enabled: true
 ```
 
-删除指定的提示词文件。
+## 配置说明
 
-#### 切换提示词启用状态
+### 命令行参数
 
+```bash
+prompt-manager --port 6000              # 指定端口
+prompt-manager --prompts-dir ./prompts  # 指定提示词目录
 ```
-POST /api/prompts/:name/toggle[?path=文件路径]
-```
-
-切换提示词的启用/禁用状态。
-
-#### 处理提示词
 
-```
-POST /process
-```
+### 环境变量
 
-处理指定的提示词，支持参数替换。
+创建 `.env` 文件（可选）：
 
-请求体示例：
-```json
-{
-  "promptName": "code-review",
-  "arguments": {
-    "language": "JavaScript",
-    "code": "function hello() { console.log('Hello'); }"
-  }
-}
+```env
+SERVER_PORT=5621
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=你的密码
 ```
 
-#### 分组管理
-
-```
-GET /api/groups
-```
+## 常见问题
 
-获取所有分组列表。
+**Q: 提示词保存在哪里？**  
+A: 默认保存在 `~/.prompt-manager/prompts` 目录
 
-```
-POST /api/groups
-```
+**Q: 可以多人使用吗？**  
+A: 可以，把提示词目录共享，或者部署为服务供团队使用
 
-创建新分组。
+**Q: 支持哪些 AI 客户端？**  
+A: 支持 MCP 协议的客户端都可以使用（如 Claude Desktop）
 
-```
-PATCH /api/groups/rename
-```
+**Q: 需要编程基础吗？**  
+A: 使用网页界面不需要，但作为服务运行需要基本的命令行知识
 
-重命名分组。
+## 技术细节（可选看）
 
-```
-PATCH /api/groups/status
-```
+### 作为库使用
 
-更新分组启用状态。
+```javascript
+import { startServer } from '@becrafter/prompt-manager-core';
 
-```
-DELETE /api/groups?path=分组路径
+await startServer({
+  configOverrides: {
+    promptsDir: './my-prompts',
+    port: 3000
+  }
+});
 ```
 
-删除分组（仅当分组为空时）。
+### API 接口
 
-## 提示词格式
+- `GET /prompts` - 获取提示词列表
+- `GET /api/prompts/:name` - 获取单个提示词
+- `POST /api/prompts` - 创建/更新提示词
+- `POST /process` - 处理提示词（支持参数替换）
 
-提示词文件使用 YAML 格式，需要包含以下基本结构：
+### MCP 协议支持
 
-```yaml
-name: prompt-name
-description: 提示词描述
-messages:
-  - role: user
-    content:
-      text: 提示词内容，支持 {{参数名}} 格式的参数替换
-arguments:
-  - name: 参数名
-    description: 参数描述
-    type: string|number|boolean
-    required: true|false
-enabled: true|false  # 是否启用该提示词
-```
+支持以下 MCP 工具：
+- `search_prompts` - 搜索提示词
+- `get_prompt` - 获取提示词
+- `reload_prompts` - 重新加载
 
 ## 开发
 
-### 项目结构
-
-```
-prompt-manager/
-├── app/
-│   ├── cli/            # 命令行命令分发与共享工具
-│   └── desktop/        # Electron 菜单应用
-├── packages/
-│   ├── admin-ui/       # 内置管理后台静态资源
-│   └── server/         # 服务端核心逻辑
-├── examples/
-│   └── prompts/        # 随包示例提示词（首次启动会同步到 ~/.prompt-manager/prompts）
-├── scripts/            # 安装/维护脚本（如 env 同步）
-├── bin/                # 可执行入口
-└── package.json
-```
-
-### 本地开发
-
 ```bash
-# 克隆仓库
-git clone https://github.com/BeCrafter/prompt-manager.git
-cd prompt-manager
+# 克隆项目
+git clone https://github.com/BeCrafter/prompt-server.git
+cd prompt-server
 
 # 安装依赖
 npm install
@@ -309,4 +211,13 @@ npm run dev
 
 ## 许可证
 
-MIT License
+MIT License
+
+## 相关链接
+
+- [npm 包](https://www.npmjs.com/package/@becrafter/prompt-manager)
+- [问题反馈](https://github.com/BeCrafter/prompt-server/issues)
+
+---
+
+**Made with ❤️ by BeCrafter**

package/app/desktop/main.js

@@ -16,7 +16,9 @@ const ServiceManager = require('./src/services/service-manager');
 const TrayManager = require('./src/ui/tray-manager');
 const UpdateManager = require('./src/services/update-manager');
 const AboutDialogManager = require('./src/ui/about-dialog-manager');
+const SplashManager = require('./src/ui/splash-manager');
 const IconManager = require('./src/utils/icon-manager');
+const RuntimeSync = require('./src/utils/runtime-sync');
 
 class PromptManagerApp {
   constructor() {
@@ -30,6 +32,7 @@ class PromptManagerApp {
     this.updateManager = new UpdateManager(this.logger, this.errorHandler, this.runtimeManager);
     this.aboutDialogManager = new AboutDialogManager(this.logger, this.runtimeManager, this.iconManager);
     this.trayManager = new TrayManager(this.logger, this.errorHandler, this.iconManager);
+    this.splashManager = new SplashManager(this.logger, this.iconManager);
     
     this.isInitialized = false;
   }
@@ -40,6 +43,14 @@ class PromptManagerApp {
     try {
       this.logger.info('Initializing Prompt Manager Desktop Application');
       
+      // 显示启动画面
+      await this.splashManager.showSplash();
+      this.splashManager.updateStatus('正在初始化...', 20);
+      
+      // 同步环境配置
+      await RuntimeSync.syncRuntime();
+      this.splashManager.updateStatus('正在同步工具箱...', 35);
+      
       // 初始化日志系统
       await this.logger.initialize();
       
@@ -47,23 +58,36 @@ class PromptManagerApp {
       this.setupApplicationMenu();
       
       // 初始化系统托盘
+      this.splashManager.updateStatus('正在启动托盘服务...', 60);
       await this.trayManager.initialize(this.stateManager);
       
       // 设置事件监听
       this.setupEventListeners();
       
       // 确保运行时环境
+      this.splashManager.updateStatus('正在准备运行时环境...', 70);
       const serverRoot = await this.runtimeManager.ensureRuntimeEnvironment();
       this.stateManager.set('runtimeRoot', serverRoot);
       
       // 启动服务
+      this.splashManager.updateStatus('正在启动核心服务...', 80);
       await this.startService();
       
       this.isInitialized = true;
       this.logger.info('Application initialized successfully');
       
+      // 关闭启动画面
+      this.splashManager.updateStatus('准备就绪...', 100);
+      setTimeout(() => {
+        this.splashManager.closeSplash();
+      }, 500); // 短暂延迟以显示完成状态
+      
     } catch (error) {
       this.logger.error('Application initialization failed', error);
+      
+      // 关闭启动画面
+      this.splashManager.closeSplash();
+      
       this.errorHandler.handleError('APP_INIT_FAILED', error, {
         logFilePath: this.logger.getLogFilePath()
       });
@@ -167,6 +191,9 @@ class PromptManagerApp {
     try {
       this.stateManager.set('isQuitting', true);
       
+      // 关闭启动画面
+      await this.splashManager.closeSplash();
+      
       // 停止服务
       await this.stopService();