@yivan-lab/pretty-please 1.0.0 → 1.1.0

package/src/shell-hook.ts

@@ -0,0 +1,502 @@
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+import chalk from 'chalk'
+import { CONFIG_DIR, getConfig, setConfigValue } from './config.js'
+import { getHistory } from './history.js'
+
+const SHELL_HISTORY_FILE = path.join(CONFIG_DIR, 'shell_history.jsonl')
+const MAX_SHELL_HISTORY = 20
+
+// Hook 标记，用于识别我们添加的内容
+const HOOK_START_MARKER = '# >>> pretty-please shell hook >>>'
+const HOOK_END_MARKER = '# <<< pretty-please shell hook <<<'
+
+// Shell 类型
+type ShellType = 'zsh' | 'bash' | 'powershell' | 'unknown'
+
+/**
+ * Shell 历史记录项
+ */
+export interface ShellHistoryItem {
+  cmd: string
+  exit: number
+  time: string
+}
+
+/**
+ * Hook 状态
+ */
+export interface HookStatus {
+  enabled: boolean
+  installed: boolean
+  shellType: ShellType
+  configPath: string | null
+  historyFile: string
+}
+
+/**
+ * 检测当前 shell 类型
+ */
+export function detectShell(): ShellType {
+  const shell = process.env.SHELL || ''
+  if (shell.includes('zsh')) return 'zsh'
+  if (shell.includes('bash')) return 'bash'
+  // Windows PowerShell
+  if (process.platform === 'win32') return 'powershell'
+  return 'unknown'
+}
+
+/**
+ * 获取 shell 配置文件路径
+ */
+export function getShellConfigPath(shellType: ShellType): string | null {
+  const home = os.homedir()
+  switch (shellType) {
+    case 'zsh':
+      return path.join(home, '.zshrc')
+    case 'bash':
+      // macOS 使用 .bash_profile，Linux 使用 .bashrc
+      if (process.platform === 'darwin') {
+        return path.join(home, '.bash_profile')
+      }
+      return path.join(home, '.bashrc')
+    case 'powershell':
+      // PowerShell profile 路径
+      return path.join(home, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')
+    default:
+      return null
+  }
+}
+
+/**
+ * 生成 zsh hook 脚本
+ */
+function generateZshHook(): string {
+  return `
+${HOOK_START_MARKER}
+# 记录命令到 pretty-please 历史
+__pls_preexec() {
+  __PLS_LAST_CMD="$1"
+  __PLS_CMD_START=$(date +%s)
+}
+
+__pls_precmd() {
+  local exit_code=$?
+  if [[ -n "$__PLS_LAST_CMD" ]]; then
+    local end_time=$(date +%s)
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    # 转义命令中的特殊字符
+    local escaped_cmd=$(echo "$__PLS_LAST_CMD" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
+    echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> "${CONFIG_DIR}/shell_history.jsonl"
+    # 保持文件不超过 ${MAX_SHELL_HISTORY} 行
+    tail -n ${MAX_SHELL_HISTORY} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
+    unset __PLS_LAST_CMD
+  fi
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec __pls_preexec
+add-zsh-hook precmd __pls_precmd
+${HOOK_END_MARKER}
+`
+}
+
+/**
+ * 生成 bash hook 脚本
+ */
+function generateBashHook(): string {
+  return `
+${HOOK_START_MARKER}
+# 记录命令到 pretty-please 历史
+__pls_prompt_command() {
+  local exit_code=$?
+  local last_cmd=$(history 1 | sed 's/^ *[0-9]* *//')
+  if [[ -n "$last_cmd" && "$last_cmd" != "$__PLS_LAST_CMD" ]]; then
+    __PLS_LAST_CMD="$last_cmd"
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local escaped_cmd=$(echo "$last_cmd" | sed 's/\\\\/\\\\\\\\/g; s/"/\\\\"/g')
+    echo "{\\"cmd\\":\\"$escaped_cmd\\",\\"exit\\":$exit_code,\\"time\\":\\"$timestamp\\"}" >> "${CONFIG_DIR}/shell_history.jsonl"
+    tail -n ${MAX_SHELL_HISTORY} "${CONFIG_DIR}/shell_history.jsonl" > "${CONFIG_DIR}/shell_history.jsonl.tmp" && mv "${CONFIG_DIR}/shell_history.jsonl.tmp" "${CONFIG_DIR}/shell_history.jsonl"
+  fi
+}
+
+if [[ ! "$PROMPT_COMMAND" =~ __pls_prompt_command ]]; then
+  PROMPT_COMMAND="__pls_prompt_command;\${PROMPT_COMMAND}"
+fi
+${HOOK_END_MARKER}
+`
+}
+
+/**
+ * 生成 PowerShell hook 脚本
+ */
+function generatePowerShellHook(): string {
+  return `
+${HOOK_START_MARKER}
+# 记录命令到 pretty-please 历史
+$Global:__PlsLastCmd = ""
+
+function __Pls_RecordCommand {
+    $lastCmd = (Get-History -Count 1).CommandLine
+    if ($lastCmd -and $lastCmd -ne $Global:__PlsLastCmd) {
+        $Global:__PlsLastCmd = $lastCmd
+        $exitCode = $LASTEXITCODE
+        if ($null -eq $exitCode) { $exitCode = 0 }
+        $timestamp = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+        $escapedCmd = $lastCmd -replace '\\\\', '\\\\\\\\' -replace '"', '\\\\"'
+        $json = "{\`"cmd\`":\`"$escapedCmd\`",\`"exit\`":$exitCode,\`"time\`":\`"$timestamp\`"}"
+        Add-Content -Path "${CONFIG_DIR}/shell_history.jsonl" -Value $json
+        # 保持文件不超过 ${MAX_SHELL_HISTORY} 行
+        $content = Get-Content "${CONFIG_DIR}/shell_history.jsonl" -Tail ${MAX_SHELL_HISTORY}
+        $content | Set-Content "${CONFIG_DIR}/shell_history.jsonl"
+    }
+}
+
+if (-not (Get-Variable -Name __PlsPromptBackup -ErrorAction SilentlyContinue)) {
+    $Global:__PlsPromptBackup = $function:prompt
+    function Global:prompt {
+        __Pls_RecordCommand
+        & $Global:__PlsPromptBackup
+    }
+}
+${HOOK_END_MARKER}
+`
+}
+
+/**
+ * 生成 hook 脚本
+ */
+function generateHookScript(shellType: ShellType): string | null {
+  switch (shellType) {
+    case 'zsh':
+      return generateZshHook()
+    case 'bash':
+      return generateBashHook()
+    case 'powershell':
+      return generatePowerShellHook()
+    default:
+      return null
+  }
+}
+
+/**
+ * 安装 shell hook
+ */
+export async function installShellHook(): Promise<boolean> {
+  const shellType = detectShell()
+  const configPath = getShellConfigPath(shellType)
+
+  if (!configPath) {
+    console.log(chalk.red(`❌ 不支持的 shell 类型: ${shellType}`))
+    return false
+  }
+
+  const hookScript = generateHookScript(shellType)
+  if (!hookScript) {
+    console.log(chalk.red(`❌ 无法为 ${shellType} 生成 hook 脚本`))
+    return false
+  }
+
+  // 检查是否已安装
+  if (fs.existsSync(configPath)) {
+    const content = fs.readFileSync(configPath, 'utf-8')
+    if (content.includes(HOOK_START_MARKER)) {
+      console.log(chalk.yellow('⚠️  Shell hook 已安装，跳过'))
+      setConfigValue('shellHook', true)
+      return true
+    }
+  }
+
+  // 确保配置目录存在
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true })
+  }
+
+  // 备份原配置文件
+  if (fs.existsSync(configPath)) {
+    const backupPath = configPath + '.pls-backup'
+    fs.copyFileSync(configPath, backupPath)
+    console.log(chalk.gray(`已备份原配置文件到: ${backupPath}`))
+  }
+
+  // 追加 hook 脚本
+  fs.appendFileSync(configPath, hookScript)
+
+  // 更新配置
+  setConfigValue('shellHook', true)
+
+  console.log(chalk.green(`✅ Shell hook 已安装到: ${configPath}`))
+  console.log(chalk.yellow('⚠️  请重启终端或执行以下命令使其生效:'))
+  console.log(chalk.cyan(`   source ${configPath}`))
+
+  return true
+}
+
+/**
+ * 卸载 shell hook
+ */
+export function uninstallShellHook(): boolean {
+  const shellType = detectShell()
+  const configPath = getShellConfigPath(shellType)
+
+  if (!configPath || !fs.existsSync(configPath)) {
+    console.log(chalk.yellow('⚠️  未找到 shell 配置文件'))
+    setConfigValue('shellHook', false)
+    return true
+  }
+
+  let content = fs.readFileSync(configPath, 'utf-8')
+
+  // 移除 hook 脚本
+  const startIndex = content.indexOf(HOOK_START_MARKER)
+  const endIndex = content.indexOf(HOOK_END_MARKER)
+
+  if (startIndex === -1 || endIndex === -1) {
+    console.log(chalk.yellow('⚠️  未找到已安装的 hook'))
+    setConfigValue('shellHook', false)
+    return true
+  }
+
+  // 移除从标记开始到结束的所有内容（包括换行符）
+  const before = content.substring(0, startIndex)
+  const after = content.substring(endIndex + HOOK_END_MARKER.length)
+  content = before + after.replace(/^\n/, '')
+
+  fs.writeFileSync(configPath, content)
+  setConfigValue('shellHook', false)
+
+  // 清空 shell 历史文件
+  if (fs.existsSync(SHELL_HISTORY_FILE)) {
+    fs.unlinkSync(SHELL_HISTORY_FILE)
+  }
+
+  console.log(chalk.green('✅ Shell hook 已卸载'))
+  console.log(chalk.yellow('⚠️  请重启终端使其生效'))
+
+  return true
+}
+
+/**
+ * 读取 shell 历史记录
+ */
+export function getShellHistory(): ShellHistoryItem[] {
+  const config = getConfig()
+
+  // 如果未启用 shell hook，返回空数组
+  if (!config.shellHook) {
+    return []
+  }
+
+  if (!fs.existsSync(SHELL_HISTORY_FILE)) {
+    return []
+  }
+
+  try {
+    const content = fs.readFileSync(SHELL_HISTORY_FILE, 'utf-8')
+    const lines = content
+      .trim()
+      .split('\n')
+      .filter((line) => line.trim())
+
+    return lines
+      .map((line) => {
+        try {
+          return JSON.parse(line) as ShellHistoryItem
+        } catch {
+          return null
+        }
+      })
+      .filter((item): item is ShellHistoryItem => item !== null)
+  } catch {
+    return []
+  }
+}
+
+/**
+ * 从 pls history 中查找匹配的记录
+ */
+function findPlsHistoryMatch(prompt: string): ReturnType<typeof getHistory>[number] | null {
+  const plsHistory = getHistory()
+
+  // 尝试精确匹配 userPrompt
+  for (const record of plsHistory) {
+    if (record.userPrompt === prompt) {
+      return record
+    }
+  }
+
+  // 尝试模糊匹配（处理引号等情况）
+  const normalizedPrompt = prompt.trim().replace(/^["']|["']$/g, '')
+  for (const record of plsHistory) {
+    if (record.userPrompt === normalizedPrompt) {
+      return record
+    }
+  }
+
+  return null
+}
+
+/**
+ * 格式化 shell 历史供 AI 使用
+ * 对于 pls 命令，会从 pls history 中查找对应的详细信息
+ */
+export function formatShellHistoryForAI(): string {
+  const history = getShellHistory()
+
+  if (history.length === 0) {
+    return ''
+  }
+
+  // pls 的子命令列表（这些不是 AI prompt）
+  const plsSubcommands = ['config', 'history', 'hook', 'help', '--help', '-h', '--version', '-v']
+
+  const lines = history.map((item, index) => {
+    const status = item.exit === 0 ? '✓' : `✗ 退出码:${item.exit}`
+
+    // 检查是否是 pls 命令
+    const plsMatch = item.cmd.match(/^(pls|please)\s+(.+)$/)
+    if (plsMatch) {
+      let args = plsMatch[2]
+
+      // 去掉 --debug / -d 选项，获取真正的参数
+      args = args.replace(/^(--debug|-d)\s+/, '')
+
+      const firstArg = args.split(/\s+/)[0]
+
+      // 如果是子命令，当作普通命令处理
+      if (plsSubcommands.includes(firstArg)) {
+        return `${index + 1}. ${item.cmd} ${status}`
+      }
+
+      // 是 AI prompt，尝试从 pls history 查找详细信息
+      const prompt = args
+      const plsRecord = findPlsHistoryMatch(prompt)
+
+      if (plsRecord) {
+        // 找到对应的 pls 记录，展示详细信息
+        if (plsRecord.reason === 'builtin') {
+          return `${index + 1}. [pls] "${prompt}" → 生成命令: ${plsRecord.command} (包含 builtin，未执行)`
+        } else if (plsRecord.executed) {
+          const execStatus = plsRecord.exitCode === 0 ? '✓' : `✗ 退出码:${plsRecord.exitCode}`
+
+          // 检查用户是否修改了命令
+          if (plsRecord.userModified && plsRecord.aiGeneratedCommand) {
+            return `${index + 1}. [pls] "${prompt}" → AI 生成: ${plsRecord.aiGeneratedCommand} / 用户修改为: ${plsRecord.command} ${execStatus}`
+          } else {
+            return `${index + 1}. [pls] "${prompt}" → 实际执行: ${plsRecord.command} ${execStatus}`
+          }
+        } else {
+          return `${index + 1}. [pls] "${prompt}" → 生成命令: ${plsRecord.command} (用户取消执行)`
+        }
+      }
+      // 找不到记录，只显示原始命令
+      return `${index + 1}. [pls] "${prompt}" ${status}`
+    }
+
+    // 普通命令
+    return `${index + 1}. ${item.cmd} ${status}`
+  })
+
+  return `【用户终端最近执行的命令】\n${lines.join('\n')}`
+}
+
+/**
+ * 获取 hook 状态
+ */
+export function getHookStatus(): HookStatus {
+  const config = getConfig()
+  const shellType = detectShell()
+  const configPath = getShellConfigPath(shellType)
+
+  let installed = false
+  if (configPath && fs.existsSync(configPath)) {
+    const content = fs.readFileSync(configPath, 'utf-8')
+    installed = content.includes(HOOK_START_MARKER)
+  }
+
+  return {
+    enabled: config.shellHook,
+    installed,
+    shellType,
+    configPath,
+    historyFile: SHELL_HISTORY_FILE,
+  }
+}
+
+/**
+ * 显示 shell 历史
+ */
+export function displayShellHistory(): void {
+  const config = getConfig()
+  const history = getShellHistory()
+
+  if (!config.shellHook) {
+    console.log('')
+    console.log(chalk.yellow('⚠️  Shell Hook 未启用'))
+    console.log(chalk.gray('运行 ') + chalk.cyan('pls hook install') + chalk.gray(' 启用 Shell Hook'))
+    console.log('')
+    return
+  }
+
+  if (history.length === 0) {
+    console.log('')
+    console.log(chalk.gray('暂无 Shell 历史记录'))
+    console.log('')
+    return
+  }
+
+  console.log('')
+  console.log(chalk.bold(`终端历史（最近 ${history.length} 条）:`))
+  console.log(chalk.gray('━'.repeat(50)))
+
+  history.forEach((item, index) => {
+    const num = index + 1
+    const status = item.exit === 0 ? chalk.green('✓') : chalk.red(`✗ (${item.exit})`)
+
+    // 检查是否是 pls 命令
+    const isPls = item.cmd.startsWith('pls ') || item.cmd.startsWith('please ')
+
+    if (isPls) {
+      // pls 命令：尝试从 history 查找详细信息
+      const args = item.cmd.replace(/^(pls|please)\s+/, '')
+      const plsRecord = findPlsHistoryMatch(args)
+
+      if (plsRecord && plsRecord.executed) {
+        // 检查用户是否修改了命令
+        if (plsRecord.userModified && plsRecord.aiGeneratedCommand) {
+          console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} "${args}"`)
+          console.log(`     ${chalk.dim('AI 生成:')} ${chalk.gray(plsRecord.aiGeneratedCommand)}`)
+          console.log(
+            `     ${chalk.dim('用户修改为:')} ${plsRecord.command} ${status} ${chalk.yellow('(已修改)')}`
+          )
+        } else {
+          console.log(
+            `  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} "${args}" → ${plsRecord.command} ${status}`
+          )
+        }
+      } else {
+        console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${chalk.magenta('[pls]')} ${args} ${status}`)
+      }
+    } else {
+      console.log(`  ${chalk.cyan(num.toString().padStart(2, ' '))}. ${item.cmd} ${status}`)
+    }
+  })
+
+  console.log(chalk.gray('━'.repeat(50)))
+  console.log(chalk.gray(`配置: 保留最近 ${config.shellHistoryLimit} 条`))
+  console.log(chalk.gray(`文件: ${SHELL_HISTORY_FILE}`))
+  console.log('')
+}
+
+/**
+ * 清空 shell 历史
+ */
+export function clearShellHistory(): void {
+  if (fs.existsSync(SHELL_HISTORY_FILE)) {
+    fs.unlinkSync(SHELL_HISTORY_FILE)
+  }
+  console.log('')
+  console.log(chalk.green('✓ Shell 历史已清空'))
+  console.log('')
+}

package/src/{sysinfo.js → sysinfo.ts}

@@ -1,10 +1,22 @@
-import os from 'os';
-import { execSync } from 'child_process';
+import os from 'os'
+import { execSync } from 'child_process'
+
+/**
+ * 系统信息
+ */
+export interface SystemInfo {
+  os: NodeJS.Platform
+  arch: string
+  shell: string
+  packageManager: string
+  cwd: string
+  user: string
+}
 
 /**
  * 检测包管理器
  */
-function detectPackageManager() {
+function detectPackageManager(): string {
   const managers = [
     { name: 'brew', command: 'brew' },
     { name: 'apt', command: 'apt-get' },
@@ -12,46 +24,46 @@ function detectPackageManager() {
     { name: 'yum', command: 'yum' },
     { name: 'pacman', command: 'pacman' },
     { name: 'zypper', command: 'zypper' },
-    { name: 'apk', command: 'apk' }
-  ];
+    { name: 'apk', command: 'apk' },
+  ]
 
   for (const mgr of managers) {
     try {
-      execSync(`which ${mgr.command}`, { stdio: 'ignore' });
-      return mgr.name;
+      execSync(`which ${mgr.command}`, { stdio: 'ignore' })
+      return mgr.name
     } catch {
       // 继续检测下一个
     }
   }
 
-  return 'unknown';
+  return 'unknown'
 }
 
 /**
  * 获取当前 Shell
  */
-function getCurrentShell() {
-  return process.env.SHELL || 'unknown';
+function getCurrentShell(): string {
+  return process.env.SHELL || 'unknown'
 }
 
 /**
  * 收集系统信息
  */
-export function collectSystemInfo() {
+export function collectSystemInfo(): SystemInfo {
   return {
     os: os.platform(),
     arch: os.arch(),
     shell: getCurrentShell(),
     packageManager: detectPackageManager(),
     cwd: process.cwd(),
-    user: os.userInfo().username
-  };
+    user: os.userInfo().username,
+  }
 }
 
 /**
  * 将系统信息格式化为字符串（供 AI 使用）
  */
-export function formatSystemInfo() {
-  const info = collectSystemInfo();
-  return `OS: ${info.os}, Arch: ${info.arch}, Shell: ${info.shell}, PkgMgr: ${info.packageManager}, CWD: ${info.cwd}`;
+export function formatSystemInfo(): string {
+  const info = collectSystemInfo()
+  return `OS: ${info.os}, Arch: ${info.arch}, Shell: ${info.shell}, PkgMgr: ${info.packageManager}, CWD: ${info.cwd}`
 }

package/src/utils/{console.js → console.ts}

@@ -15,12 +15,12 @@ const colors = {
   warning: '#F59E0B',
   info: '#3B82F6',
   muted: '#6B7280',
-}
+} as const
 
 /**
  * 计算字符串的显示宽度（中文占2个宽度）
  */
-export function getDisplayWidth(str) {
+export function getDisplayWidth(str: string): number {
   let width = 0
   for (const char of str) {
     if (char.match(/[\u4e00-\u9fff\u3400-\u4dbf\uff00-\uffef\u3000-\u303f]/)) {
@@ -35,10 +35,10 @@ export function getDisplayWidth(str) {
 /**
  * 绘制命令框（原生版本）
  */
-export function drawCommandBox(command, title = '生成命令') {
+export function drawCommandBox(command: string, title: string = '生成命令'): void {
   const lines = command.split('\n')
   const titleWidth = getDisplayWidth(title)
-  const maxContentWidth = Math.max(...lines.map(l => getDisplayWidth(l)))
+  const maxContentWidth = Math.max(...lines.map((l) => getDisplayWidth(l)))
   const boxWidth = Math.max(maxContentWidth + 4, titleWidth + 6, 20)
 
   const topPadding = boxWidth - titleWidth - 5
@@ -50,10 +50,7 @@ export function drawCommandBox(command, title = '生成命令') {
     const lineWidth = getDisplayWidth(line)
     const padding = ' '.repeat(boxWidth - lineWidth - 4)
     console.log(
-      chalk.hex(colors.warning)('│ ') +
-      chalk.hex(colors.primary)(line) +
-      padding +
-      chalk.hex(colors.warning)(' │')
+      chalk.hex(colors.warning)('│ ') + chalk.hex(colors.primary)(line) + padding + chalk.hex(colors.warning)(' │')
     )
   }
   console.log(chalk.hex(colors.warning)(bottomBorder))
@@ -62,7 +59,7 @@ export function drawCommandBox(command, title = '生成命令') {
 /**
  * 格式化耗时
  */
-export function formatDuration(ms) {
+export function formatDuration(ms: number): string {
   if (ms < 1000) {
     return `${ms}ms`
   }
@@ -72,9 +69,10 @@ export function formatDuration(ms) {
 /**
  * 输出分隔线
  */
-export function printSeparator(text = '输出', length = 38) {
+export function printSeparator(text: string = '输出', length: number = 38): void {
   const textPart = text ? ` ${text} ` : ''
-  const lineLength = Math.max(0, length - textPart.length)
+  const textWidth = getDisplayWidth(textPart) // 使用显示宽度而不是字符数
+  const lineLength = Math.max(0, length - textWidth)
   const leftDashes = '─'.repeat(Math.floor(lineLength / 2))
   const rightDashes = '─'.repeat(Math.ceil(lineLength / 2))
   console.log(chalk.gray(`${leftDashes}${textPart}${rightDashes}`))
@@ -83,48 +81,48 @@ export function printSeparator(text = '输出', length = 38) {
 /**
  * 输出成功消息
  */
-export function success(message) {
+export function success(message: string): void {
   console.log(chalk.hex(colors.success)('✓ ' + message))
 }
 
 /**
  * 输出错误消息
  */
-export function error(message) {
+export function error(message: string): void {
   console.log(chalk.hex(colors.error)('✗ ' + message))
 }
 
 /**
  * 输出警告消息
  */
-export function warning(message) {
+export function warning(message: string): void {
   console.log(chalk.hex(colors.warning)('⚠️  ' + message))
 }
 
 /**
  * 输出信息消息
  */
-export function info(message) {
+export function info(message: string): void {
   console.log(chalk.hex(colors.info)(message))
 }
 
 /**
  * 输出灰色文本
  */
-export function muted(message) {
+export function muted(message: string): void {
   console.log(chalk.hex(colors.muted)(message))
 }
 
 /**
  * 输出标题
  */
-export function title(message) {
+export function title(message: string): void {
   console.log(chalk.bold(message))
 }
 
 /**
  * 输出主色文本
  */
-export function primary(message) {
+export function primary(message: string): void {
   console.log(chalk.hex(colors.primary)(message))
 }