@yivan-lab/pretty-please 1.2.0 → 1.3.1

package/README.md

@@ -464,25 +464,126 @@ pls hook uninstall  # 卸载 hook
 
 ## 🌗 主题系统
 
-支持深色和浅色两种主题，适配不同终端背景：
+支持多种内置主题和自定义主题，适配不同终端背景和个人喜好：
+
+### 内置主题
 
 ```bash
 pls theme              # 查看当前主题
 pls theme list         # 查看所有可用主题
 pls theme dark         # 切换到深色主题
-pls theme light        # 切换到浅色主题
+pls theme nord         # 切换到 Nord 主题
 ```
 
-主题说明：
+**可用的内置主题：**
 - **dark（深色）** - 明亮的颜色，适合深色终端背景（默认）
 - **light（浅色）** - 较深的颜色，适合浅色终端背景
+- **nord（北欧冷色）** - 冷色调护眼主题，适合长时间使用
+- **dracula（德古拉暗色）** - 高对比暗色主题，色彩丰富但不刺眼
+- **retro（复古终端绿）** - 经典终端荧光绿，致敬老派 hacker 风格
+- **contrast（高对比度）** - 极高对比度，适合视力辅助和强光环境
+- **monokai（经典编辑器）** - Monokai 经典配色，开发者熟悉的选择
 
 也可以通过配置命令切换：
 
 ```bash
-pls config set theme light
+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`）
+
 ## 🏷️ 命令别名
 
 将常用的操作保存为别名，一键触发：
@@ -594,7 +695,13 @@ pls hook status
 # 主题
 pls theme                # 查看当前主题
 pls theme list           # 查看所有主题
-pls theme <dark|light>   # 切换主题
+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                # 查看所有别名

package/bin/pls.tsx

@@ -2,6 +2,7 @@
 import { Command } from 'commander'
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
+import path from 'path'
 import { exec } from 'child_process'
 import fs from 'fs'
 import os from 'os'
@@ -126,10 +127,19 @@ function executeCommand(command: string): Promise<{ exitCode: number; output: st
 
     console.log('') // 空行
 
-    // 计算命令框宽度，让分隔线长度一致
+    // 计算命令框宽度，让分隔线长度一致（限制终端宽度）
+    const termWidth = process.stdout.columns || 80
+    const maxContentWidth = termWidth - 6
     const lines = command.split('\n')
-    const maxContentWidth = Math.max(...lines.map(l => console2.getDisplayWidth(l)))
-    const boxWidth = Math.max(maxContentWidth + 4, console2.getDisplayWidth('生成命令') + 6, 20)
+    const wrappedLines: string[] = []
+    for (const line of lines) {
+      wrappedLines.push(...console2.wrapText(line, maxContentWidth))
+    }
+    const actualMaxWidth = Math.max(
+      ...wrappedLines.map((l) => console2.getDisplayWidth(l)),
+      console2.getDisplayWidth('生成命令')
+    )
+    const boxWidth = Math.max(console2.MIN_COMMAND_BOX_WIDTH, Math.min(actualMaxWidth + 4, termWidth - 2))
     console2.printSeparator('输出', boxWidth)
 
     // 使用 bash 并启用 pipefail，确保管道中任何命令失败都能正确返回非零退出码
@@ -217,11 +227,21 @@ configCmd
 configCmd
   .command('set <key> <value>')
   .description('设置配置项 (apiKey, baseUrl, provider, model, shellHook, chatHistoryLimit)')
-  .action((key, value) => {
+  .action(async (key, value) => {
     try {
+      const oldConfig = getConfig()
+      const oldShellHistoryLimit = oldConfig.shellHistoryLimit
+
       setConfigValue(key, value)
       console.log('')
       console2.success(`已设置 ${key}`)
+
+      // 如果修改了 shellHistoryLimit，自动重装 hook
+      if (key === 'shellHistoryLimit') {
+        const { reinstallHookForLimitChange } = await import('../src/shell-hook.js')
+        await reinstallHookForLimitChange(oldShellHistoryLimit, Number(value))
+      }
+
       console.log('')
     } catch (error: any) {
       console.log('')
@@ -243,8 +263,10 @@ const themeCmd = program.command('theme').description('管理主题')
 themeCmd
   .command('list')
   .description('查看所有可用主题')
-  .action(async () => {
-    const { themes } = await import('../src/ui/theme.js')
+  .option('--custom', '只显示自定义主题')
+  .option('--builtin', '只显示内置主题')
+  .action(async (options: { custom?: boolean; builtin?: boolean }) => {
+    const { getAllThemeMetadata, isBuiltinTheme } = await import('../src/ui/theme.js')
     const config = getConfig()
     const currentTheme = config.theme || 'dark'
 
@@ -252,37 +274,82 @@ themeCmd
     console2.title('🎨 可用主题:')
     console2.muted('━'.repeat(50))
 
-    Object.keys(themes).forEach((themeName) => {
-      const isCurrent = themeName === currentTheme
-      const prefix = isCurrent ? '●' : '○'
-      const label = themeName === 'dark' ? 'dark (深色)' : 'light (浅色)'
-      const color = themeName === 'dark' ? '#00D9FF' : '#0284C7'
+    // 动态获取所有主题元数据
+    const allThemes = getAllThemeMetadata()
 
-      if (isCurrent) {
-        console.log(`  ${chalk.hex(color)(prefix)} ${chalk.hex(color).bold(label)} ${chalk.gray('(当前)')}`)
-      } else {
-        console.log(`  ${chalk.gray(prefix)} ${label}`)
+    // 根据选项过滤主题
+    const builtinThemes = allThemes.filter((meta) => isBuiltinTheme(meta.name))
+    const customThemes = allThemes.filter((meta) => !isBuiltinTheme(meta.name))
+
+    // 显示内置主题
+    if (!options.custom) {
+      if (builtinThemes.length > 0) {
+        console.log('')
+        console2.info('内置主题:')
+        builtinThemes.forEach((meta) => {
+          const isCurrent = meta.name === currentTheme
+          const prefix = isCurrent ? '●' : '○'
+          const label = `${meta.name} (${meta.displayName})`
+
+          if (isCurrent) {
+            console.log(`  ${chalk.hex(meta.previewColor)(prefix)} ${chalk.hex(meta.previewColor).bold(label)} ${chalk.gray('(当前)')}`)
+          } else {
+            console.log(`  ${chalk.gray(prefix)} ${label}`)
+          }
+        })
       }
-    })
+    }
 
+    // 显示自定义主题
+    if (!options.builtin) {
+      if (customThemes.length > 0) {
+        console.log('')
+        console2.info('自定义主题:')
+        customThemes.forEach((meta) => {
+          const isCurrent = meta.name === currentTheme
+          const prefix = isCurrent ? '●' : '○'
+          const label = `${meta.name} (${meta.displayName})`
+          const emoji = ' ✨'
+
+          if (isCurrent) {
+            console.log(`  ${chalk.hex(meta.previewColor)(prefix)} ${chalk.hex(meta.previewColor).bold(label)}${emoji} ${chalk.gray('(当前)')}`)
+          } else {
+            console.log(`  ${chalk.gray(prefix)} ${label}${emoji}`)
+          }
+        })
+      } else if (options.custom) {
+        console.log('')
+        console2.muted('  还没有自定义主题')
+        console2.muted('  使用 pls theme create <name> 创建')
+      }
+    }
+
+    console.log('')
     console2.muted('━'.repeat(50))
     console.log('')
   })
 
 themeCmd
-  .argument('[name]', '主题名称 (dark, light)')
+  .argument('[name]', '主题名称')
   .description('切换主题')
-  .action((name?: string) => {
+  .action(async (name?: string) => {
+    const { getThemeMetadata, getAllThemeMetadata, isValidTheme } = await import('../src/ui/theme.js')
+
     if (!name) {
       // 显示当前主题
       const config = getConfig()
       const currentTheme = config.theme || 'dark'
-      const label = currentTheme === 'dark' ? 'dark (深色)' : 'light (浅色)'
-      const color = currentTheme === 'dark' ? '#00D9FF' : '#0284C7'
+      const meta = getThemeMetadata(currentTheme as any)
+
+      if (meta) {
+        console.log('')
+        console.log(`当前主题: ${chalk.hex(meta.previewColor).bold(`${meta.name} (${meta.displayName})`)}`)
+        if (meta.description) {
+          console2.muted(`  ${meta.description}`)
+        }
+        console.log('')
+      }
 
-      console.log('')
-      console.log(`当前主题: ${chalk.hex(color).bold(label)}`)
-      console.log('')
       console2.muted('使用 pls theme list 查看所有主题')
       console2.muted('使用 pls theme <name> 切换主题')
       console.log('')
@@ -291,12 +358,91 @@ themeCmd
 
     // 切换主题
     try {
+      // 验证主题是否存在
+      if (!isValidTheme(name)) {
+        const allThemes = getAllThemeMetadata()
+        const themeNames = allThemes.map((m) => m.name).join(', ')
+        throw new Error(`未知主题 "${name}"，可用主题: ${themeNames}`)
+      }
+
       setConfigValue('theme', name)
-      const label = name === 'dark' ? 'dark (深色)' : 'light (浅色)'
-      const color = name === 'dark' ? '#00D9FF' : '#0284C7'
+      const meta = getThemeMetadata(name)
 
+      if (meta) {
+        console.log('')
+        console2.success(`已切换到 ${chalk.hex(meta.previewColor).bold(`${meta.name} (${meta.displayName})`)} 主题`)
+        if (meta.description) {
+          console2.muted(`  ${meta.description}`)
+        }
+        console.log('')
+      }
+    } catch (error: any) {
+      console.log('')
+      console2.error(error.message)
       console.log('')
-      console2.success(`已切换到 ${chalk.hex(color).bold(label)} 主题`)
+      process.exit(1)
+    }
+  })
+
+// theme create - 创建主题模板
+themeCmd
+  .command('create <name>')
+  .description('创建自定义主题模板')
+  .option('-d, --display-name <name>', '显示名称')
+  .option('-c, --category <type>', '主题类别 (dark 或 light)', 'dark')
+  .action(async (name: string, options: { displayName?: string; category?: string }) => {
+    const { createThemeTemplate } = await import('../src/ui/theme.js')
+
+    try {
+      // 验证主题名称格式
+      if (!/^[a-z0-9-]+$/.test(name)) {
+        throw new Error('主题名称只能包含小写字母、数字和连字符')
+      }
+
+      // 验证类别
+      const category = options.category as 'dark' | 'light'
+      if (category !== 'dark' && category !== 'light') {
+        throw new Error('主题类别必须是 dark 或 light')
+      }
+
+      // 创建主题目录
+      const themesDir = path.join(os.homedir(), '.please', 'themes')
+      if (!fs.existsSync(themesDir)) {
+        fs.mkdirSync(themesDir, { recursive: true })
+      }
+
+      // 检查主题文件是否已存在
+      const themePath = path.join(themesDir, `${name}.json`)
+      if (fs.existsSync(themePath)) {
+        throw new Error(`主题 "${name}" 已存在`)
+      }
+
+      // 创建主题模板
+      const displayName = options.displayName || name
+      const template = createThemeTemplate(name, displayName, category)
+
+      // 保存到文件
+      fs.writeFileSync(themePath, JSON.stringify(template, null, 2), 'utf-8')
+
+      // 显示成功信息
+      console.log('')
+      console2.success(`已创建主题模板: ${themePath}`)
+      console.log('')
+
+      console2.info('📝 下一步:')
+      console.log(`  1. 编辑主题文件修改颜色配置`)
+      console2.muted(`     vim ${themePath}`)
+      console.log('')
+      console.log(`  2. 验证主题格式`)
+      console2.muted(`     pls theme validate ${themePath}`)
+      console.log('')
+      console.log(`  3. 应用主题查看效果`)
+      console2.muted(`     pls theme ${name}`)
+      console.log('')
+
+      console2.info('💡 提示:')
+      console2.muted('  - 使用在线工具选择颜色: https://colorhunt.co')
+      console2.muted('  - 参考内置主题: pls theme list')
       console.log('')
     } catch (error: any) {
       console.log('')
@@ -306,6 +452,75 @@ themeCmd
     }
   })
 
+// theme validate - 验证主题文件
+themeCmd
+  .command('validate <file>')
+  .description('验证主题文件格式')
+  .action(async (file: string) => {
+    const { validateThemeWithDetails } = await import('../src/ui/theme.js')
+
+    try {
+      // 读取主题文件
+      const themePath = path.isAbsolute(file) ? file : path.join(process.cwd(), file)
+
+      if (!fs.existsSync(themePath)) {
+        throw new Error(`文件不存在: ${themePath}`)
+      }
+
+      const content = fs.readFileSync(themePath, 'utf-8')
+      const theme = JSON.parse(content)
+
+      // 验证主题
+      const result = validateThemeWithDetails(theme)
+
+      console.log('')
+
+      if (result.valid) {
+        console2.success('✓ 主题验证通过')
+        console.log('')
+
+        if (theme.metadata) {
+          console2.info('主题信息:')
+          console.log(`  名称: ${theme.metadata.name} (${theme.metadata.displayName})`)
+          console.log(`  类别: ${theme.metadata.category}`)
+          if (theme.metadata.description) {
+            console.log(`  描述: ${theme.metadata.description}`)
+          }
+          if (theme.metadata.author) {
+            console.log(`  作者: ${theme.metadata.author}`)
+          }
+        }
+
+        console.log('')
+      } else {
+        console2.error('✗ 主题验证失败')
+        console.log('')
+        console2.info('错误列表:')
+        result.errors.forEach((err, idx) => {
+          console.log(`  ${idx + 1}. ${err}`)
+        })
+        console.log('')
+
+        console2.info('修复建议:')
+        console2.muted(`  1. 编辑主题文件: vim ${themePath}`)
+        console2.muted('  2. 参考内置主题格式')
+        console2.muted('  3. 确保所有颜色使用 #RRGGBB 格式')
+        console.log('')
+
+        process.exit(1)
+      }
+    } catch (error: any) {
+      console.log('')
+      if (error.message.includes('Unexpected token')) {
+        console2.error('JSON 格式错误，请检查文件语法')
+      } else {
+        console2.error(error.message)
+      }
+      console.log('')
+      process.exit(1)
+    }
+  })
+
 // history 子命令
 const historyCmd = program.command('history').description('查看或管理命令历史')
 
@@ -962,24 +1177,17 @@ remoteCmd.action(() => {
   displayRemotes()
 })
 
-// chat 子命令
-const chatCmd = program.command('chat').description('AI 对话模式，问答、讲解命令')
-
-chatCmd
-  .command('clear')
-  .description('清空对话历史')
-  .action(() => {
-    clearChatHistory()
-    console.log('')
-    console2.success('对话历史已清空')
-    console.log('')
-  })
-
-// 默认 chat 命令（进行对话）
-chatCmd
-  .argument('[prompt...]', '你的问题')
+// chat 命令（AI 对话）
+program
+  .command('chat')
+  .description('AI 对话模式，问答、讲解命令')
+  .argument('[prompt...]', '你的问题（不提供则显示状态）')
   .option('-d, --debug', '显示调试信息')
   .action((promptArgs, options) => {
+    // Workaround: Commander.js 14.x 的子命令 option 解析有 bug
+    // 直接从 process.argv 检查 --debug
+    const debug = process.argv.includes('--debug') || process.argv.includes('-d')
+
     const prompt = promptArgs.join(' ')
 
     if (!prompt.trim()) {
@@ -995,8 +1203,8 @@ chatCmd
       console2.muted('━'.repeat(40))
       console.log('')
       console2.muted('用法:')
-      console2.info('  pls chat <问题>    与 AI 对话')
-      console2.info('  pls chat clear     清空对话历史')
+      console2.info('  pls chat <问题>          与 AI 对话')
+      console2.info('  pls history chat clear   清空对话历史')
       console.log('')
       return
     }
@@ -1019,7 +1227,7 @@ chatCmd
       render(
         React.createElement(Chat, {
           prompt,
-          debug: options.debug,
+          debug: debug,  // 使用 debug 变量
           showRoundCount: true,
           onComplete: () => process.exit(0),
         })
@@ -1297,9 +1505,6 @@ program
 
         // 处理步骤结果
         if (!stepResult || stepResult.cancelled) {
-          console.log('')
-          console2.muted('已取消执行')
-          console.log('')
           process.exit(0)
         }
 
@@ -1495,10 +1700,19 @@ async function executeRemoteCommand(
 
   console.log('') // 空行
 
-  // 计算命令框宽度，让分隔线长度一致
+  // 计算命令框宽度，让分隔线长度一致（限制终端宽度）
+  const termWidth = process.stdout.columns || 80
+  const maxContentWidth = termWidth - 6
   const lines = command.split('\n')
-  const maxContentWidth = Math.max(...lines.map(l => console2.getDisplayWidth(l)))
-  const boxWidth = Math.max(maxContentWidth + 4, console2.getDisplayWidth('生成命令') + 6, 20)
+  const wrappedLines: string[] = []
+  for (const line of lines) {
+    wrappedLines.push(...console2.wrapText(line, maxContentWidth))
+  }
+  const actualMaxWidth = Math.max(
+    ...wrappedLines.map((l) => console2.getDisplayWidth(l)),
+    console2.getDisplayWidth('生成命令')
+  )
+  const boxWidth = Math.max(console2.MIN_COMMAND_BOX_WIDTH, Math.min(actualMaxWidth + 4, termWidth - 2))
   console2.printSeparator(`远程输出 (${remoteName})`, boxWidth)
 
   try {