claude-pangu 2.0.18 → 2.0.21

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://code.claude.com/plugin-schema.json",
   "name": "oh-my-claude",
-  "version": "2.0.18",
+  "version": "2.0.21",
   "hooks": "./hooks/hooks.json",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
   "author": "ZDragon17",

package/commands/cancel-yishan.md

@@ -1,68 +1,68 @@
----
-name: cancel-yishan
-description: |
-  取消愚公移山循环 - 停止当前的自主循环执行。
-  别名：/stop-yishan, /cancel-yugong, /stop-loop
----
-
-# 取消愚公移山循环
-
-你需要取消当前正在进行的愚公移山循环。
-
-## 取消操作
-
-请执行以下步骤：
-
-### 1. 删除循环状态文件
-
-使用 Bash 工具删除循环状态文件：
-
-```bash
-rm -f .claude/yishan-loop.local.md
-```
-
-### 2. 可选：清理检查点
-
-询问用户是否要清理检查点数据：
-
-```text
-💾 检测到保存的检查点数据
-
-是否同时清理检查点？
-   [1] 保留检查点（推荐，方便以后恢复）
-   [2] 清理检查点（彻底结束任务）
-```
-
-如果用户选择清理：
-
-```bash
-rm -f ~/.oh-my-claude/yishan-checkpoint.json
-```
-
-### 3. 确认取消
-
-删除成功后，向用户确认：
-
-```text
-🛑 愚公移山循环已取消
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📂 已删除: .claude/yishan-loop.local.md
-💾 检查点: [保留/已清理]
-
-循环将在当前响应结束后停止。
-
-💡 提示:
-   • /yishan-resume - 从检查点恢复（如有）
-   • /yishan [新任务] - 开始新任务
-```
-
-## 注意事项
-
-- 取消操作会立即停止循环，当前响应完成后不会再继续
-- 已完成的工作不会被撤销
-- TODO 列表会保留，可以稍后继续处理
-
-## 执行
-
-现在请删除状态文件以取消循环。
+---
+name: cancel-yishan
+description: |
+  取消愚公移山循环 - 停止当前的自主循环执行。
+  别名：/stop-yishan, /cancel-yugong, /stop-loop
+---
+
+# 取消愚公移山循环
+
+你需要取消当前正在进行的愚公移山循环。
+
+## 取消操作
+
+请执行以下步骤：
+
+### 1. 删除循环状态文件
+
+使用 Bash 工具删除循环状态文件：
+
+```bash
+rm -f .claude/yishan-loop.local.md
+```
+
+### 2. 可选：清理检查点
+
+询问用户是否要清理检查点数据：
+
+```text
+💾 检测到保存的检查点数据
+
+是否同时清理检查点？
+   [1] 保留检查点（推荐，方便以后恢复）
+   [2] 清理检查点（彻底结束任务）
+```
+
+如果用户选择清理：
+
+```bash
+rm -f ~/.oh-my-claude/yishan-checkpoint.json
+```
+
+### 3. 确认取消
+
+删除成功后，向用户确认：
+
+```text
+🛑 愚公移山循环已取消
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📂 已删除: .claude/yishan-loop.local.md
+💾 检查点: [保留/已清理]
+
+循环将在当前响应结束后停止。
+
+💡 提示:
+   • /yishan-resume - 从检查点恢复（如有）
+   • /yishan [新任务] - 开始新任务
+```
+
+## 注意事项
+
+- 取消操作会立即停止循环，当前响应完成后不会再继续
+- 已完成的工作不会被撤销
+- TODO 列表会保留，可以稍后继续处理
+
+## 执行
+
+现在请删除状态文件以取消循环。

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/commands/status.md

@@ -1,12 +1,14 @@
 ---
 name: status
-description: 快速查看当前任务状态 - 愚公移山进度、活跃 Agent、最近操作
+description: 快速查看当前任务状态 - 愚公移山进度、活跃 Agent、插件健康状态
 aliases:
   - /状态
   - /state
 allowed-tools:
   - Read
   - TodoRead
+  - Bash
+  - Glob
 model: haiku
 ---
 
@@ -14,14 +16,41 @@ model: haiku
 
 # 任务状态查看器
 
-快速展示当前工作状态，让用户随时掌握全局。
+快速展示当前工作状态和插件健康，让用户随时掌握全局。
 
 ## 职责
 
 1. 显示当前 TODO 进度
 2. 显示活跃的 Agent
 3. 显示最近的操作
-4. 提供快捷操作入口
+4. **显示插件健康状态**
+5. 提供快捷操作入口
+
+## 执行步骤
+
+### 步骤 1: 检查插件健康状态
+
+执行快速健康检查：
+
+```bash
+# 检查关键文件是否存在
+ls ~/.claude/plugins/oh-my-claude/hooks/hooks.json 2>/dev/null && echo "hooks:ok" || echo "hooks:missing"
+ls ~/.claude/commands/yishan.md 2>/dev/null && echo "commands:ok" || echo "commands:missing"
+```
+
+### 步骤 2: 读取 TODO 状态
+
+使用 TodoRead 获取当前任务列表。
+
+### 步骤 3: 检查活跃模式
+
+```bash
+# 检查愚公移山是否活跃
+ls .claude/yishan-loop.local.md 2>/dev/null && echo "yishan:active" || echo "yishan:inactive"
+
+# 检查 Ralph Loop 是否活跃
+ls .claude/ralph-loop.local.md 2>/dev/null && echo "ralph:active" || echo "ralph:inactive"
+```
 
 ## 输出格式
 
@@ -115,9 +144,44 @@ model: haiku
 🔄 当前: 实现用户登录功能
 ```
 
+## 插件健康状态
+
+在状态输出中添加插件健康检查：
+
+```text
+📊 oh-my-claude 状态面板
+═══════════════════════════════════════════════════
+
+🔧 插件状态:
+   版本: v2.0.19
+   ✅ 命令加载: 55 个
+   ✅ Hook 激活: 44 个
+   ✅ Agent 就绪: 20 个
+   ✅ Skill 可用: 10 个
+
+🏔️ 愚公移山模式: 活跃/非活跃
+   [... 其余内容 ...]
+```
+
+### 健康问题提示
+
+如果检测到问题，显示修复建议：
+
+```text
+🔧 插件状态:
+   版本: v2.0.19
+   ⚠️ 命令加载: 45/55 (缺少 10 个)
+   ✅ Hook 激活: 44 个
+   ❌ Agent 就绪: 0 个 (目录缺失)
+
+⚡ 快速修复:
+   /verify --fix  或  npx claude-pangu@latest install
+```
+
 ## 响应要求
 
 1. **即时响应** - 不要执行任何耗时操作
 2. **信息准确** - 反映真实的 TODO 状态
 3. **格式清晰** - 使用表格和图标增强可读性
-4. **提供下一步** - 总是给出可操作的建议
+4. **显示插件健康** - 让用户知道插件是否正常工作
+5. **提供下一步** - 总是给出可操作的建议