claude-pangu 2.0.18 → 2.0.19

package/commands/expert.md

@@ -0,0 +1,123 @@
+---
+name: expert
+description: 专家模式开关 - 为高级用户提供精简输出，跳过引导信息
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+model: haiku
+---
+
+<command-name>/expert</command-name>
+
+# 专家模式开关
+
+切换专家模式，控制输出详细程度。
+
+## 使用方式
+
+```text
+/expert [on|off|status]
+```
+
+## 执行逻辑
+
+### `/expert on` - 启用专家模式
+
+1. 创建模式标记文件：
+```bash
+mkdir -p ~/.oh-my-claude && echo "expert" > ~/.oh-my-claude/mode
+```
+
+2. 显示确认：
+```text
+⚡ 专家模式已启用
+
+效果:
+• 跳过新手引导
+• 精简输出格式
+• 减少确认步骤
+
+关闭: /expert off
+```
+
+### `/expert off` - 关闭专家模式
+
+1. 删除模式标记文件：
+```bash
+rm -f ~/.oh-my-claude/mode
+```
+
+2. 显示确认：
+```text
+📖 已切换到标准模式
+
+效果:
+• 显示完整引导
+• 详细解释说明
+• 更多操作提示
+```
+
+### `/expert status` - 查看当前状态
+
+1. 检查模式文件：
+```bash
+cat ~/.oh-my-claude/mode 2>/dev/null
+```
+
+2. 根据结果显示：
+
+文件存在且内容为 "expert"：
+```text
+当前模式: ⚡ 专家模式
+```
+
+文件不存在或内容不匹配：
+```text
+当前模式: 📖 标准模式
+```
+
+### `/expert` 无参数 - 切换模式
+
+检查当前状态并切换到相反模式：
+- 如果当前是专家模式 → 切换到标准模式
+- 如果当前是标准模式 → 切换到专家模式
+
+---
+
+## 模式效果对比
+
+| 特性 | 标准模式 | 专家模式 |
+|------|----------|----------|
+| 新手引导 | ✅ 显示 | ❌ 跳过 |
+| 详细解释 | ✅ 完整 | ⚡ 精简 |
+| 操作确认 | ✅ 询问 | ⚡ 直接执行 |
+| 错误提示 | 📚 多选项 | 🎯 首选方案 |
+| 输出格式 | 📖 详细 | ⚡ 紧凑 |
+
+---
+
+## 适用场景
+
+### 推荐使用专家模式
+
+- ✅ 熟悉 oh-my-claude 所有命令
+- ✅ 不需要引导和解释
+- ✅ 追求效率，减少阅读时间
+- ✅ 屏幕空间有限
+
+### 推荐使用标准模式
+
+- ✅ 新用户或偶尔使用
+- ✅ 需要详细的操作指引
+- ✅ 遇到复杂问题需要多选项
+- ✅ 正在学习命令用法
+
+---
+
+## 别名
+
+- `/expert` - 主命令
+- `/pro` - 简写
+- `/专家` - 中文别名
+- `/简洁` - 中文别名

package/commands/hook-perf.md

@@ -0,0 +1,138 @@
+---
+name: hook-perf
+description: Hook 性能监控 - 查看各 Hook 的执行时间，识别性能瓶颈
+allowed-tools:
+  - Bash
+  - Read
+model: haiku
+---
+
+<command-name>/hook-perf</command-name>
+
+# Hook 性能监控
+
+查看 oh-my-claude 43 个 Hook 的执行性能，识别可能影响响应速度的瓶颈。
+
+## 使用方式
+
+```text
+/hook-perf [report|clear|summary]
+```
+
+## 执行流程
+
+### `/hook-perf` 或 `/hook-perf report` - 查看性能报告
+
+执行性能监控脚本：
+
+```bash
+~/.claude/plugins/oh-my-claude/hooks/hook-performance-monitor.sh report
+```
+
+显示格式：
+
+```text
+┌─────────────────────────────────────────────────────────────┐
+│              🔍 Hook 性能监控报告                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  Hook 名称                  平均耗时    最大耗时    调用次数  │
+│  ─────────────────────────────────────────────────────────  │
+│  keyword-detector.sh        120ms       350ms       45      │
+│  todo-enforcer.sh           85ms        200ms       32      │
+│  progress-notifier.sh       45ms        120ms       28      │
+│  ...                                                        │
+│                                                             │
+│  📁 日志位置: ~/.oh-my-claude/performance/                  │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### `/hook-perf clear` - 清除性能日志
+
+```bash
+~/.claude/plugins/oh-my-claude/hooks/hook-performance-monitor.sh clear
+```
+
+输出：
+```text
+✅ 性能日志已清除
+```
+
+### `/hook-perf summary` - 获取 JSON 摘要
+
+```bash
+~/.claude/plugins/oh-my-claude/hooks/hook-performance-monitor.sh summary
+```
+
+返回 JSON 格式的性能数据，可用于进一步分析。
+
+---
+
+## 性能阈值说明
+
+| 阈值 | 说明 |
+|------|------|
+| < 500ms | 正常 |
+| 500-2000ms | ⏱️ 较慢，可能需要优化 |
+| > 2000ms | ⚠️ 非常慢，建议检查 |
+
+---
+
+## 性能优化建议
+
+当发现慢 Hook 时：
+
+1. **检查外部依赖**
+   - 网络请求（API 调用）
+   - 文件系统操作（大量文件扫描）
+   - 外部命令（jq、curl 等）
+
+2. **考虑禁用不必要的 Hook**
+   - 编辑 `hooks/hooks.json`
+   - 注释或删除不需要的 Hook
+
+3. **使用缓存**
+   - 对于重复计算的结果使用缓存
+   - 设置合理的缓存过期时间
+
+4. **异步执行**
+   - 非关键 Hook 可以在后台执行
+   - 避免阻塞主流程
+
+---
+
+## 日志文件位置
+
+```
+~/.oh-my-claude/performance/
+├── hook-timing.log    # 原始执行日志
+└── summary.json       # 性能摘要
+```
+
+---
+
+## 依赖说明
+
+- 需要 `jq` 进行 JSON 分析（可选）
+- 无 jq 时仍可记录日志，但无法生成详细报告
+
+安装 jq：
+```bash
+# macOS
+brew install jq
+
+# Linux
+apt install jq
+
+# Windows
+choco install jq
+```
+
+---
+
+## 别名
+
+- `/hook-perf` - 主命令
+- `/perf-hook` - 英文别名
+- `/性能` - 中文别名

package/commands/map.md

@@ -1,6 +1,6 @@
 ---
 name: map
-description: 命令关系速查图 - 理解 51 个命令的关系和选择逻辑
+description: 命令关系速查图 - 理解 55 个命令的关系和选择逻辑
 allowed-tools:
   - Read
 model: haiku

package/hooks/hook-performance-monitor.sh

@@ -0,0 +1,167 @@
+#!/usr/bin/env bash
+# Hook 性能监控
+# 追踪各 Hook 的执行时间，识别性能瓶颈
+# 触发时机: PostToolUse (周期性检查)
+
+set -euo pipefail
+
+# 性能日志目录
+PERF_LOG_DIR="${HOME}/.oh-my-claude/performance"
+PERF_LOG_FILE="${PERF_LOG_DIR}/hook-timing.log"
+PERF_SUMMARY_FILE="${PERF_LOG_DIR}/summary.json"
+
+# 确保目录存在
+mkdir -p "$PERF_LOG_DIR"
+
+# 性能阈值（毫秒）
+SLOW_HOOK_THRESHOLD=500
+VERY_SLOW_HOOK_THRESHOLD=2000
+
+# 获取当前时间戳（毫秒）
+get_timestamp_ms() {
+    if command -v python3 &>/dev/null; then
+        python3 -c "import time; print(int(time.time() * 1000))"
+    elif command -v node &>/dev/null; then
+        node -e "console.log(Date.now())"
+    else
+        # 降级方案：秒级精度
+        echo "$(($(date +%s) * 1000))"
+    fi
+}
+
+# 记录 Hook 执行时间
+log_hook_timing() {
+    local hook_name="$1"
+    local start_time="$2"
+    local end_time="$3"
+    local duration=$((end_time - start_time))
+    
+    # 追加到日志
+    echo "{\"hook\":\"$hook_name\",\"duration\":$duration,\"timestamp\":$end_time}" >> "$PERF_LOG_FILE"
+    
+    # 检查是否超过阈值
+    if [ "$duration" -gt "$VERY_SLOW_HOOK_THRESHOLD" ]; then
+        echo "⚠️ 非常慢的 Hook: $hook_name (${duration}ms)"
+    elif [ "$duration" -gt "$SLOW_HOOK_THRESHOLD" ]; then
+        echo "⏱️ 较慢的 Hook: $hook_name (${duration}ms)"
+    fi
+}
+
+# 生成性能摘要
+generate_summary() {
+    if [ ! -f "$PERF_LOG_FILE" ]; then
+        echo "{\"error\": \"No performance data\"}"
+        return
+    fi
+    
+    # 使用 jq 生成摘要（如果可用）
+    if command -v jq &>/dev/null; then
+        jq -s '
+            group_by(.hook) | 
+            map({
+                hook: .[0].hook,
+                count: length,
+                avg_ms: (map(.duration) | add / length | floor),
+                max_ms: (map(.duration) | max),
+                min_ms: (map(.duration) | min)
+            }) |
+            sort_by(-.avg_ms)
+        ' "$PERF_LOG_FILE" > "$PERF_SUMMARY_FILE"
+        
+        cat "$PERF_SUMMARY_FILE"
+    else
+        echo "{\"message\": \"Install jq for detailed analysis\"}"
+    fi
+}
+
+# 清理旧日志（保留最近 7 天）
+cleanup_old_logs() {
+    if [ -f "$PERF_LOG_FILE" ]; then
+        # 获取 7 天前的时间戳
+        local cutoff_time
+        cutoff_time=$(( $(get_timestamp_ms) - 7 * 24 * 60 * 60 * 1000 ))
+        
+        if command -v jq &>/dev/null; then
+            jq -c "select(.timestamp > $cutoff_time)" "$PERF_LOG_FILE" > "${PERF_LOG_FILE}.tmp" 2>/dev/null || true
+            mv "${PERF_LOG_FILE}.tmp" "$PERF_LOG_FILE" 2>/dev/null || true
+        fi
+    fi
+}
+
+# 显示性能报告
+show_performance_report() {
+    echo ""
+    echo "┌─────────────────────────────────────────────────────────────┐"
+    echo "│              🔍 Hook 性能监控报告                            │"
+    echo "├─────────────────────────────────────────────────────────────┤"
+    
+    if [ -f "$PERF_SUMMARY_FILE" ] && command -v jq &>/dev/null; then
+        echo "│                                                             │"
+        echo "│  Hook 名称                  平均耗时    最大耗时    调用次数  │"
+        echo "│  ─────────────────────────────────────────────────────────  │"
+        
+        jq -r '.[] | "│  \(.hook | .[0:25] | . + " " * (25 - length))  \(.avg_ms | tostring | . + "ms" + " " * (8 - length))   \(.max_ms | tostring | . + "ms" + " " * (8 - length))   \(.count)       │"' "$PERF_SUMMARY_FILE" 2>/dev/null | head -10
+        
+        echo "│                                                             │"
+    else
+        echo "│  暂无性能数据或 jq 未安装                                   │"
+        echo "│                                                             │"
+        echo "│  💡 安装 jq 以获取详细分析:                                  │"
+        echo "│     brew install jq  (macOS)                                │"
+        echo "│     apt install jq   (Linux)                                │"
+        echo "│     choco install jq (Windows)                              │"
+    fi
+    
+    echo "│                                                             │"
+    echo "│  📁 日志位置: ~/.oh-my-claude/performance/                  │"
+    echo "│                                                             │"
+    echo "│  🔧 命令:                                                   │"
+    echo "│     /hook-perf         查看性能报告                         │"
+    echo "│     /hook-perf clear   清除性能日志                         │"
+    echo "│                                                             │"
+    echo "└─────────────────────────────────────────────────────────────┘"
+}
+
+# 主逻辑
+main() {
+    local action="${1:-report}"
+    
+    case "$action" in
+        "start")
+            # 记录开始时间（由调用者使用）
+            get_timestamp_ms
+            ;;
+        "end")
+            # 记录结束时间并计算耗时
+            local hook_name="${2:-unknown}"
+            local start_time="${3:-0}"
+            local end_time
+            end_time=$(get_timestamp_ms)
+            log_hook_timing "$hook_name" "$start_time" "$end_time"
+            ;;
+        "report")
+            # 显示性能报告
+            generate_summary >/dev/null 2>&1
+            show_performance_report
+            ;;
+        "summary")
+            # 仅生成 JSON 摘要
+            generate_summary
+            ;;
+        "clear")
+            # 清除日志
+            rm -f "$PERF_LOG_FILE" "$PERF_SUMMARY_FILE"
+            echo "✅ 性能日志已清除"
+            ;;
+        "cleanup")
+            # 清理旧日志
+            cleanup_old_logs
+            ;;
+        *)
+            echo "用法: hook-performance-monitor.sh [start|end|report|summary|clear|cleanup]"
+            ;;
+    esac
+}
+
+# 运行主程序
+main "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pangu",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture (原名 oh-my-claude)",
   "keywords": [
     "claude-code",