@yivan-lab/pretty-please 1.1.0 → 1.3.0

package/README.md

@@ -11,9 +11,13 @@
 - 🛡️ **智能错误恢复** - 命令失败时 AI 自动分析并调整策略
 - ✏️ **命令编辑** - 执行前可编辑 AI 生成的命令，支持 manual/auto 两种模式
 - 💬 **AI 对话模式** - 随时问 AI 命令怎么用
+- 🌐 **远程执行** - 通过 SSH 在远程服务器执行命令，支持密码/密钥认证
 - 📜 **三种历史记录** - 命令历史、对话历史、Shell 历史统一管理
 - 🎨 **精美界面** - 基于 React + Ink 的终端 UI，Markdown 渲染
+- 🌗 **主题切换** - 支持 dark/light 主题，适配不同终端背景
+- 🏷️ **命令别名** - 常用操作一键触发，支持参数模板
 - 🔧 **多 Provider 支持** - 支持 OpenAI、DeepSeek、Anthropic 等多种 AI
+- 🚀 **一键升级** - 内置 `pls upgrade` 命令，自动更新到最新版本
 
 ## 📦 安装
 
@@ -36,7 +40,7 @@ yarn global add @yivan-lab/pretty-please
 
 ```bash
 # 克隆项目
-git clone https://github.com/yivan-lab/pretty-please.git
+git clone https://github.com/IvanLark/pretty-please.git
 cd pretty-please
 
 # 安装依赖
@@ -51,6 +55,25 @@ pnpm link --global
 
 安装完成后，你可以在任何目录使用 `pls` 或 `please` 命令了！
 
+### 方式三：一键安装（无需 Node.js）
+
+适用于云服务器、DevOps 场景，无需 Node.js 环境：
+
+**Linux / macOS:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/IvanLark/pretty-please/main/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/IvanLark/pretty-please/main/install.ps1 | iex
+```
+
+支持的平台：
+- Linux x64 / arm64
+- macOS Intel / Apple Silicon
+- Windows x64
+
 ## 🚀 快速开始
 
 ### 1. 配置 API
@@ -261,6 +284,8 @@ pls config set <key> <value>  # 设置单个配置项
 | `chatHistoryLimit` | 对话历史保留轮数 | `10` |
 | `commandHistoryLimit` | 命令历史保留条数 | `10` |
 | `shellHistoryLimit` | Shell 历史保留条数 | `15` |
+| `theme` | 界面主题（dark/light） | `dark` |
+| `aliases` | 命令别名配置 | `{}` |
 
 ### 支持的 Provider
 
@@ -274,6 +299,154 @@ pls config set <key> <value>  # 设置单个配置项
 - `fireworks` - Fireworks AI
 - `together` - Together AI
 
+## 🌐 远程执行
+
+通过 SSH 在远程服务器上执行 AI 生成的命令，支持密码/密钥认证。
+
+### 添加远程服务器
+
+```bash
+# 使用默认密钥（~/.ssh/id_rsa）
+pls remote add myserver root@192.168.1.100
+
+# 指定端口
+pls remote add myserver root@192.168.1.100:2222
+
+# 使用指定密钥
+pls remote add myserver root@192.168.1.100 --key ~/.ssh/my_key
+
+# 使用密码认证（每次执行时输入密码）
+pls remote add myserver root@192.168.1.100 --password
+```
+
+### 管理远程服务器
+
+```bash
+pls remote                    # 查看所有服务器
+pls remote list               # 同上
+pls remote test myserver      # 测试连接并采集系统信息
+pls remote remove myserver    # 删除服务器
+```
+
+### 设置默认服务器
+
+```bash
+pls remote default myserver   # 设置默认服务器
+pls remote default            # 查看当前默认服务器
+pls remote default --clear    # 清除默认服务器
+```
+
+设置默认服务器后，使用 `-r` 参数时可以省略服务器名：
+
+```bash
+pls -r 查看磁盘使用情况        # 使用默认服务器
+```
+
+### 设置工作目录
+
+```bash
+pls remote workdir myserver /var/www    # 设置工作目录
+pls remote workdir myserver             # 查看当前工作目录
+pls remote workdir myserver --clear     # 清除工作目录
+```
+
+设置工作目录后，所有命令会自动在该目录下执行。
+
+### 远程执行命令
+
+```bash
+# 指定服务器执行
+pls -r myserver 查看磁盘使用情况
+pls -r myserver 查找大于 100MB 的日志文件
+
+# 使用默认服务器（需先设置）
+pls -r 查看当前目录的文件
+```
+
+### 批量远程执行 ⭐
+
+在多台服务器上并发执行同一个任务，每个服务器自动生成适配其环境的命令：
+
+```bash
+# 批量执行（逗号分隔服务器名）
+pls -r web1,web2,web3 查看 nginx 状态
+pls -r server1,server2 查看磁盘使用情况
+pls -r prod1,prod2,prod3 重启应用服务
+```
+
+**特点：**
+- 🚀 **并发执行** - 所有服务器同时生成命令和执行，速度快
+- 🔧 **自动适配** - 每个服务器根据其系统环境生成独立命令（支持异构环境）
+- 📊 **清晰展示** - 显示每个服务器的命令和执行结果
+- 📝 **历史记录** - 自动记录到每个服务器的历史
+
+**执行流程示例：**
+
+```bash
+$ pls -r web1,web2,web3 查看 nginx 状态
+
+正在为 3 台服务器生成命令...
+
+✓ 命令生成完成
+
+web1 (linux):
+  systemctl status nginx | grep Active
+
+web2 (linux):
+  systemctl status nginx | grep Active
+
+web3 (linux):
+  systemctl status nginx | grep Active
+
+将在 3 台服务器执行以上命令
+执行？ [回车执行 / Ctrl+C 取消]
+
+正在执行...
+
+执行完成:
+
+  ✓ web1 (退出码: 0)
+  ✓ web2 (退出码: 0)
+  ✗ web3 (退出码: 3)
+
+─── web1 ───
+   Active: active (running)
+
+─── web2 ───
+   Active: active (running)
+
+─── web3 ───
+   Active: inactive (dead)
+```
+
+**退出码：**
+- `0` - 全部成功
+- `1` - 部分失败
+- `2` - 全部失败
+
+**限制：**
+- 批量执行模式不支持多步骤命令（只生成单个命令）
+- 不支持命令编辑（直接执行生成的命令）
+
+### 远程 Shell Hook
+
+在远程服务器上安装 Shell Hook，让 AI 了解你在远程服务器上的操作历史：
+
+```bash
+pls remote hook install myserver    # 安装远程 Hook
+pls remote hook status myserver     # 查看状态
+pls remote hook uninstall myserver  # 卸载 Hook
+```
+
+### 远程历史记录
+
+```bash
+pls remote history show myserver        # 查看远程命令历史
+pls remote history clear myserver       # 清空远程命令历史
+pls remote history shell myserver       # 查看远程 Shell 历史
+pls remote history shell-clear myserver # 清空远程 Shell 历史
+```
+
 ## 🔧 Shell Hook（可选）
 
 Shell Hook 可以记录你在终端执行的所有命令，让 AI 更智能地理解上下文。
@@ -289,6 +462,198 @@ pls hook uninstall  # 卸载 hook
 - bash
 - PowerShell
 
+## 🌗 主题系统
+
+支持多种内置主题和自定义主题，适配不同终端背景和个人喜好：
+
+### 内置主题
+
+```bash
+pls theme              # 查看当前主题
+pls theme list         # 查看所有可用主题
+pls theme dark         # 切换到深色主题
+pls theme nord         # 切换到 Nord 主题
+```
+
+**可用的内置主题：**
+- **dark（深色）** - 明亮的颜色，适合深色终端背景（默认）
+- **light（浅色）** - 较深的颜色，适合浅色终端背景
+- **nord（北欧冷色）** - 冷色调护眼主题，适合长时间使用
+- **dracula（德古拉暗色）** - 高对比暗色主题，色彩丰富但不刺眼
+- **retro（复古终端绿）** - 经典终端荧光绿，致敬老派 hacker 风格
+- **contrast（高对比度）** - 极高对比度，适合视力辅助和强光环境
+- **monokai（经典编辑器）** - Monokai 经典配色，开发者熟悉的选择
+
+也可以通过配置命令切换：
+
+```bash
+pls config set theme nord
+```
+
+### 自定义主题
+
+创建你自己的主题配色方案：
+
+#### 1. 创建主题模板
+
+```bash
+# 创建深色主题
+pls theme create my-ocean --display-name "我的海洋主题"
+
+# 创建浅色主题
+pls theme create my-light --display-name "我的浅色" --category light
+```
+
+这会在 `~/.please/themes/` 目录下生成一个 JSON 模板文件。
+
+#### 2. 编辑主题文件
+
+```bash
+vim ~/.please/themes/my-ocean.json
+```
+
+主题文件格式：
+
+```json
+{
+  "metadata": {
+    "name": "my-ocean",
+    "displayName": "我的海洋主题",
+    "description": "深邃的海洋蓝配色",
+    "category": "dark",
+    "author": "Your Name"
+  },
+  "colors": {
+    "primary": "#0077BE",
+    "secondary": "#5DADE2",
+    "accent": "#48C9B0",
+    "success": "#2ECC71",
+    "error": "#E74C3C",
+    "warning": "#F39C12",
+    "info": "#3498DB",
+    "text": {
+      "primary": "#ECF0F1",
+      "secondary": "#BDC3C7",
+      "muted": "#95A5A6",
+      "dim": "#7F8C8D"
+    },
+    "border": "#34495E",
+    "divider": "#2C3E50",
+    "code": {
+      "background": "#1C2833",
+      "text": "#ECF0F1",
+      "keyword": "#C678DD",
+      "string": "#98C379",
+      "function": "#61AFEF",
+      "comment": "#5C6370"
+    }
+  }
+}
+```
+
+#### 3. 验证主题
+
+```bash
+pls theme validate ~/.please/themes/my-ocean.json
+```
+
+验证通过后会显示主题信息，失败会给出详细的错误提示。
+
+#### 4. 应用自定义主题
+
+```bash
+pls theme my-ocean
+```
+
+#### 5. 管理自定义主题
+
+```bash
+# 查看所有主题（内置 + 自定义）
+pls theme list
+
+# 只查看自定义主题
+pls theme list --custom
+
+# 只查看内置主题
+pls theme list --builtin
+```
+
+自定义主题在列表中会显示 ✨ 标记。
+
+**主题文件位置：** `~/.please/themes/`
+
+**颜色格式：** 所有颜色必须使用十六进制格式（如 `#00D9FF`）
+
+## 🏷️ 命令别名
+
+将常用的操作保存为别名，一键触发：
+
+### 基本使用
+
+```bash
+# 添加简单别名
+pls alias add disk "查看磁盘使用情况，按使用率排序"
+pls alias add mem "查看内存使用最高的 10 个进程"
+
+# 使用别名（两种格式都支持）
+pls disk
+pls @disk
+
+# 查看所有别名
+pls alias
+pls alias list
+
+# 删除别名
+pls alias remove disk
+```
+
+### 参数模板
+
+支持动态参数，让别名更灵活：
+
+```bash
+# 添加带参数的别名
+pls alias add taillog "查看 {{file}} 的最后 {{lines:20}} 行日志"
+
+# 使用时传参
+pls taillog --file=/var/log/system.log                # lines 使用默认值 20
+pls taillog --file=/var/log/system.log --lines=50     # 自定义 lines
+pls taillog file=/var/log/nginx.log lines=100         # 不带 -- 也可以
+```
+
+参数格式说明：
+- `{{param}}` - 必填参数，不提供会报错
+- `{{param:default}}` - 可选参数，有默认值
+
+### 别名 + 额外描述
+
+别名后可以追加额外的描述：
+
+```bash
+pls disk 显示详情      # 等同于 pls 查看磁盘使用情况，按使用率排序 显示详情
+```
+
+## 🚀 版本升级
+
+### 自动更新提示
+
+程序会每 24 小时检查一次新版本，发现更新时在命令结束后提示：
+
+```
+⚠ 发现新版本: 1.1.0 → 1.2.0，运行 pls upgrade 更新
+```
+
+### 升级命令
+
+```bash
+# 升级到最新版本
+pls upgrade
+```
+
+升级方式：
+- **二进制安装**（curl/irm）：自动下载并替换
+- **npm 安装**：提示使用 `npm update -g @yivan-lab/pretty-please`
+
 ## 🎯 命令参考
 
 ### 基础命令
@@ -326,6 +691,26 @@ pls hook
 pls hook install
 pls hook uninstall
 pls hook status
+
+# 主题
+pls theme                # 查看当前主题
+pls theme list           # 查看所有主题
+pls theme <name>         # 切换主题（dark/light/nord/dracula/retro/contrast/monokai）
+
+# 自定义主题
+pls theme create <name> --display-name "名称" # 创建主题模板
+pls theme validate <file>                    # 验证主题文件
+pls theme list --custom                      # 只显示自定义主题
+pls theme list --builtin                     # 只显示内置主题
+
+# 别名
+pls alias                # 查看所有别名
+pls alias list           # 同上
+pls alias add <name> "<prompt>"  # 添加别名
+pls alias remove <name>  # 删除别名
+
+# 升级
+pls upgrade              # 升级到最新版本
 ```
 
 ## 🏗️ 技术架构
@@ -355,11 +740,15 @@ pretty-please/
 │   ├── shell-hook.ts        # Shell 集成
 │   ├── builtin-detector.ts  # Shell builtin 检测
 │   ├── sysinfo.ts           # 系统信息采集
+│   ├── upgrade.ts           # 版本升级模块
+│   ├── alias.ts             # 命令别名管理
 │   ├── components/          # React Ink 组件
 │   │   ├── MultiStepCommandGenerator.tsx
 │   │   ├── Chat.tsx
 │   │   ├── MarkdownDisplay.tsx
 │   │   └── ...
+│   ├── ui/
+│   │   └── theme.ts         # 主题系统
 │   └── utils/
 │       └── console.ts       # 原生输出工具
 ├── package.json