claude-pangu 2.1.4 → 2.1.6

package/.claude-plugin/plugin.json

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

package/README.md

@@ -803,6 +803,8 @@ model: sonnet
 - [x] v2.1.2 - **用户体验简化** 🎯（`/do` 作为唯一入口、精简帮助输出）
 - [x] v2.1.3 - **版本检测修复** 🐛（plugin.json 版本同步）
 - [x] v2.1.4 - **用户体验第三轮** ✨（工作流模板、偏好设置、友好错误、自诊断）
+- [x] v2.1.5 - **macOS 兼容性修复** 🍎（Shell 脚本跨平台兼容、grep 语法修复）
+- [x] v2.1.6 - **稳定性与精准度优化** 🎯（关键词误判修复、愚公循环增强、Hook 去重）
 
 ## 🤝 贡献
 

package/hooks/agent-collaboration.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # agent-collaboration.sh - 多 Agent 协作协议处理器
 # 处理 @agent 调用语法，支持多 Agent 间的无缝协作

package/hooks/agent-handoff-prompt.sh

@@ -4,27 +4,11 @@
 #
 # 触发时机: PostToolUse (Task 工具完成后)
 # 功能: 根据完成的 Agent 类型，智能推荐下一步操作
+#
+# 兼容性: macOS (bash 3.2+), Linux (bash 4.0+), Windows (Git Bash)
 
-# 错误处理设置
-set -o pipefail
-
-# 超时保护 (最大执行时间 1.5 秒)
-TIMEOUT_SECONDS=1.5
-
-# 超时处理函数
-timeout_handler() {
-    # 静默退出，不影响用户体验
-    exit 0
-}
-
-# 设置超时 trap (如果支持)
-if command -v timeout >/dev/null 2>&1; then
-    # 使用 timeout 命令包装主逻辑
-    TIMEOUT_AVAILABLE=true
-else
-    # 没有 timeout 命令，使用简单的执行
-    TIMEOUT_AVAILABLE=false
-fi
+# 错误捕获：任何错误都静默退出，不影响用户体验
+trap 'exit 0' ERR EXIT
 
 # 获取工具输出（带默认值保护）
 TOOL_OUTPUT="${CLAUDE_TOOL_OUTPUT:-}"
@@ -37,7 +21,8 @@ if [ -z "$TOOL_OUTPUT" ]; then
 fi
 
 # 安全检查：如果工具输出过长（超过 50KB），跳过处理以避免性能问题
-OUTPUT_LENGTH=${#TOOL_OUTPUT}
+# 使用 wc -c 替代 ${#var}，更兼容老版本
+OUTPUT_LENGTH=$(printf '%s' "$TOOL_OUTPUT" | wc -c | tr -d ' ')
 if [ "$OUTPUT_LENGTH" -gt 51200 ]; then
     exit 0
 fi
@@ -379,39 +364,70 @@ EOF
 }
 
 # 检测最后使用的 Agent（从输出中推断）
+# 使用多个 grep 调用替代 \| 语法，提高 macOS 兼容性
 detect_agent() {
     local output="$1"
     
-    # 检测常见的 Agent 标识
-    if echo "$output" | grep -qi "扁鹊\|bianque\|诊断\|望闻问切"; then
+    # 检测常见的 Agent 标识（每个 Agent 使用独立的条件判断）
+    if echo "$output" | grep -qi "扁鹊" || \
+       echo "$output" | grep -qi "bianque" || \
+       echo "$output" | grep -qi "望闻问切"; then
         echo "bianque"
-    elif echo "$output" | grep -qi "悟空\|wukong\|探索\|火眼金睛"; then
+    elif echo "$output" | grep -qi "悟空" || \
+         echo "$output" | grep -qi "wukong" || \
+         echo "$output" | grep -qi "火眼金睛"; then
         echo "wukong"
-    elif echo "$output" | grep -qi "诸葛\|zhuge\|架构\|战略"; then
+    elif echo "$output" | grep -qi "诸葛" || \
+         echo "$output" | grep -qi "zhuge" || \
+         echo "$output" | grep -qi "架构设计"; then
         echo "zhuge"
-    elif echo "$output" | grep -qi "鲁班\|luban\|实现\|巧匠"; then
+    elif echo "$output" | grep -qi "鲁班" || \
+         echo "$output" | grep -qi "luban" || \
+         echo "$output" | grep -qi "精工巧匠"; then
         echo "luban"
-    elif echo "$output" | grep -qi "包拯\|baozheng\|测试\|TDD"; then
+    elif echo "$output" | grep -qi "包拯" || \
+         echo "$output" | grep -qi "baozheng" || \
+         echo "$output" | grep -qi "测试专家"; then
         echo "baozheng"
-    elif echo "$output" | grep -qi "魏征\|weizheng\|审查\|review"; then
+    elif echo "$output" | grep -qi "魏征" || \
+         echo "$output" | grep -qi "weizheng" || \
+         echo "$output" | grep -qi "代码审查"; then
         echo "weizheng"
-    elif echo "$output" | grep -qi "墨子\|mozi\|安全\|漏洞"; then
+    elif echo "$output" | grep -qi "墨子" || \
+         echo "$output" | grep -qi "mozi" || \
+         echo "$output" | grep -qi "安全审计"; then
         echo "mozi"
-    elif echo "$output" | grep -qi "孙子\|sunzi\|性能\|优化"; then
+    elif echo "$output" | grep -qi "孙子" || \
+         echo "$output" | grep -qi "sunzi" || \
+         echo "$output" | grep -qi "性能优化"; then
         echo "sunzi"
-    elif echo "$output" | grep -qi "李白\|libai\|需求\|用户故事"; then
+    elif echo "$output" | grep -qi "李白" || \
+         echo "$output" | grep -qi "libai" || \
+         echo "$output" | grep -qi "需求分析"; then
         echo "libai"
-    elif echo "$output" | grep -qi "司马迁\|simaqian\|文档\|记录"; then
+    elif echo "$output" | grep -qi "司马迁" || \
+         echo "$output" | grep -qi "simaqian" || \
+         echo "$output" | grep -qi "文档撰写"; then
         echo "simaqian"
-    elif echo "$output" | grep -qi "仓颉\|cangjie\|数据库\|SQL"; then
+    elif echo "$output" | grep -qi "仓颉" || \
+         echo "$output" | grep -qi "cangjie" || \
+         echo "$output" | grep -qi "数据库设计"; then
         echo "cangjie"
-    elif echo "$output" | grep -qi "顾恺之\|gukaizhi\|UI\|界面"; then
+    elif echo "$output" | grep -qi "顾恺之" || \
+         echo "$output" | grep -qi "gukaizhi" || \
+         echo "$output" | grep -qi "界面美学"; then
         echo "gukaizhi"
-    elif echo "$output" | grep -qi "李冰\|libing\|DevOps\|部署"; then
+    elif echo "$output" | grep -qi "李冰" || \
+         echo "$output" | grep -qi "libing" || \
+         echo "$output" | grep -qi "DevOps"; then
         echo "libing"
-    elif echo "$output" | grep -qi "嫦娥\|change\|云\|serverless"; then
+    elif echo "$output" | grep -qi "嫦娥" || \
+         echo "$output" | grep -qi "change" || \
+         echo "$output" | grep -qi "云服务"; then
         echo "change"
-    elif echo "$output" | grep -qi "老子\|laozi\|简化\|至简"; then
+    elif echo "$output" | grep -qi "老子" || \
+         echo "$output" | grep -qi "laozi" || \
+         echo "$output" | grep -qi "大道至简"; then
         echo "laozi"
     else
         echo "unknown"
@@ -435,8 +451,8 @@ main() {
     fi
 }
 
-# 错误捕获：如果发生错误，静默退出
-trap 'exit 0' ERR
+# 移除 EXIT trap 以允许正常输出
+trap - EXIT
 
 # 执行主函数
 main

package/hooks/agent-usage-reminder.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Agent Usage Reminder - Agent 使用提醒
 # ============================================================================
@@ -8,12 +8,17 @@
 # 1. 根据任务类型推荐合适的 Agent
 # 2. 提供 Agent 使用示例
 # 3. 避免过度提醒（有冷却期）
+#
+# 注意：
+# - 此 Hook 优先级为 low，在 keyword-detector.sh 之后执行
+# - 如果 keyword-detector 已经输出了推荐，此 Hook 不再重复
+# - 主要用于补充 keyword-detector 未覆盖的场景
 # ============================================================================
 
 # 配置
 STATE_DIR=".claude"
 REMINDER_STATE_FILE="$STATE_DIR/agent-reminder-state.json"
-COOLDOWN_SECONDS=300  # 5 分钟冷却期
+COOLDOWN_SECONDS=600  # 10 分钟冷却期（增加，避免打扰）
 
 # 获取用户输入
 user_input="${CLAUDE_USER_PROMPT:-}"
@@ -23,6 +28,21 @@ if [ -z "$user_input" ]; then
     exit 0
 fi
 
+# 检查是否已经被 keyword-detector 覆盖（这些关键词 keyword-detector 已经处理）
+# 如果匹配这些关键词，keyword-detector 已经给出了更详细的提示，此处跳过
+if echo "$user_input" | grep -qiE '(愚公|移山|ultrawork|ulw|persist|yishan|yugong)'; then
+    exit 0
+fi
+if echo "$user_input" | grep -qiE '(扁鹊|bianque|debug|fix.*bug|报错|异常)'; then
+    exit 0
+fi
+if echo "$user_input" | grep -qiE '(墨子|mozi|security|安全|漏洞)'; then
+    exit 0
+fi
+if echo "$user_input" | grep -qiE '(孙子|sunzi|perf|性能|优化.*速度)'; then
+    exit 0
+fi
+
 # 检查冷却期
 current_time=$(date +%s)
 last_reminder_time=0

package/hooks/agent-usage-tracker.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Agent 使用追踪器 - Agent Usage Tracker (PostToolUse Hook)
 # ============================================================================

package/hooks/anthropic-context-window-limit-recovery.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Anthropic Context Window Limit Recovery Hook
 # 功能：检测上下文窗口限制错误并提供恢复策略
 # 帮助在达到上下文限制时优雅地恢复工作

package/hooks/ast-grep.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # ast-grep.sh - AST-Grep 结构化代码搜索工具
 # 基于 AST (抽象语法树) 的代码搜索和重构

package/hooks/at-agent-summoner.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # @Agent 召唤器 - At Agent Summoner Hook (UserPromptSubmit)
 # ============================================================================

package/hooks/atlas.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Atlas Hook - 核心编排逻辑
 # 灵感来自希腊神话中托举天空的巨人阿特拉斯
 # 功能：提供工作流编排的核心指导和约束

package/hooks/auto-slash-command.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 自动斜杠命令 - Auto Slash Command Hook (UserPromptSubmit)
 # ============================================================================

package/hooks/auto-update-checker.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # auto-update-checker.sh - 自动更新检查器
 # 检查 oh-my-claude 是否有新版本可用

package/hooks/background-compaction.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Background Compaction Hook
 # 功能：检测后台任务数量并建议清理完成的任务
 # 防止后台任务堆积导致资源浪费

package/hooks/background-notification.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Background Notification Hook - 后台任务完成通知
 # ============================================================================

package/hooks/code-quality-checker.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # code-quality-checker.sh - 代码质量检查器
 # 包含 comment-checker 和 thinking-block-validator 功能

package/hooks/context-compression.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # context-compression.sh - 智能上下文压缩管理器
 # 解决 Claude 上下文限制，实现智能信息压缩和关键保留

package/hooks/context-smart-alert.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Context Smart Alert - 智能上下文预警 (Enhanced)
 # ============================================================================

package/hooks/context-window-monitor.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Context Window Monitor - 上下文窗口监控器
 # ============================================================================

package/hooks/delegate-task-retry.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Delegate Task Retry Hook - 任务委派自动重试
 # ============================================================================

package/hooks/directory-agents-injector.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # directory-agents-injector.sh - 目录特定代理注入器
 # 根据当前工作目录自动注入相关的 Agent 配置

package/hooks/directory-readme-injector.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Directory README Injector Hook
 # 功能：检测当前目录的 README.md 并将关键信息注入上下文
 # 帮助 Agent 快速理解项目结构和约定

package/hooks/edit-error-recovery.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Edit Error Recovery Hook
 # 功能：检测编辑工具错误并提供恢复建议
 # 处理常见的 Edit 工具失败场景

package/hooks/empty-task-response-detector.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Empty Task Response Detector - 空任务响应检测器
 # ============================================================================

package/hooks/error-friendly-display.sh

@@ -4,8 +4,12 @@
 #
 # 触发时机: PostToolUse
 # 功能: 检测错误并根据用户偏好显示友好的错误信息
+#
+# 兼容性: macOS (bash 3.2+), Linux (bash 4.0+), Windows (Git Bash)
 
+# 遇到错误静默退出，不影响主流程
 set -e
+trap 'exit 0' ERR
 
 # 获取输入
 TOOL_NAME="${CLAUDE_TOOL_NAME:-}"
@@ -33,65 +37,93 @@ get_verbosity() {
 }
 
 # 检测错误类型
+# 使用多个 grep -qi 调用替代 -E 扩展正则，提高 macOS 兼容性
 detect_error_type() {
     local output="$1"
     
     # 权限错误
-    if echo "$output" | grep -qiE "EACCES|EPERM|permission denied|access denied"; then
+    if echo "$output" | grep -qi "EACCES" || \
+       echo "$output" | grep -qi "EPERM" || \
+       echo "$output" | grep -qi "permission denied" || \
+       echo "$output" | grep -qi "access denied"; then
         echo "permission"
         return
     fi
     
     # 文件不存在
-    if echo "$output" | grep -qiE "ENOENT|no such file|not found|does not exist"; then
+    if echo "$output" | grep -qi "ENOENT" || \
+       echo "$output" | grep -qi "no such file" || \
+       echo "$output" | grep -qi "not found" || \
+       echo "$output" | grep -qi "does not exist"; then
         echo "not_found"
         return
     fi
     
     # 网络错误
-    if echo "$output" | grep -qiE "ECONNREFUSED|ETIMEDOUT|network|connection"; then
+    if echo "$output" | grep -qi "ECONNREFUSED" || \
+       echo "$output" | grep -qi "ETIMEDOUT" || \
+       echo "$output" | grep -qi "network" || \
+       echo "$output" | grep -qi "connection refused"; then
         echo "network"
         return
     fi
     
     # 语法错误
-    if echo "$output" | grep -qiE "SyntaxError|ParseError|unexpected token|invalid syntax"; then
+    if echo "$output" | grep -qi "SyntaxError" || \
+       echo "$output" | grep -qi "ParseError" || \
+       echo "$output" | grep -qi "unexpected token" || \
+       echo "$output" | grep -qi "invalid syntax"; then
         echo "syntax"
         return
     fi
     
     # 类型错误
-    if echo "$output" | grep -qiE "TypeError|cannot read|undefined is not|null is not"; then
+    if echo "$output" | grep -qi "TypeError" || \
+       echo "$output" | grep -qi "cannot read" || \
+       echo "$output" | grep -qi "undefined is not" || \
+       echo "$output" | grep -qi "null is not"; then
         echo "type"
         return
     fi
     
     # 内存错误
-    if echo "$output" | grep -qiE "ENOMEM|out of memory|heap|allocation"; then
+    if echo "$output" | grep -qi "ENOMEM" || \
+       echo "$output" | grep -qi "out of memory" || \
+       echo "$output" | grep -qi "heap" || \
+       echo "$output" | grep -qi "allocation failed"; then
         echo "memory"
         return
     fi
     
     # 磁盘空间
-    if echo "$output" | grep -qiE "ENOSPC|no space|disk full"; then
+    if echo "$output" | grep -qi "ENOSPC" || \
+       echo "$output" | grep -qi "no space" || \
+       echo "$output" | grep -qi "disk full"; then
         echo "disk"
         return
     fi
     
     # 超时
-    if echo "$output" | grep -qiE "timeout|timed out|deadline exceeded"; then
+    if echo "$output" | grep -qi "timeout" || \
+       echo "$output" | grep -qi "timed out" || \
+       echo "$output" | grep -qi "deadline exceeded"; then
         echo "timeout"
         return
     fi
     
     # Git 错误
-    if echo "$output" | grep -qiE "fatal:|error:.*git|conflict|merge"; then
+    if echo "$output" | grep -qi "^fatal:" || \
+       echo "$output" | grep -qi "git.*error" || \
+       echo "$output" | grep -qi "merge conflict"; then
         echo "git"
         return
     fi
     
     # 依赖错误
-    if echo "$output" | grep -qiE "module not found|cannot find module|import error|no module named"; then
+    if echo "$output" | grep -qi "module not found" || \
+       echo "$output" | grep -qi "cannot find module" || \
+       echo "$output" | grep -qi "import error" || \
+       echo "$output" | grep -qi "no module named"; then
         echo "dependency"
         return
     fi
@@ -211,8 +243,19 @@ get_quick_fix() {
 main() {
     # 只处理有错误的情况
     if [ "$EXIT_CODE" = "0" ]; then
-        # 检查输出中是否包含错误信息
-        if ! echo "$TOOL_OUTPUT" | grep -qiE "error|failed|exception|fatal"; then
+        # 检查输出中是否包含错误信息（使用多个 grep 替代 -E）
+        has_error=false
+        if echo "$TOOL_OUTPUT" | grep -qi "error"; then
+            has_error=true
+        elif echo "$TOOL_OUTPUT" | grep -qi "failed"; then
+            has_error=true
+        elif echo "$TOOL_OUTPUT" | grep -qi "exception"; then
+            has_error=true
+        elif echo "$TOOL_OUTPUT" | grep -qi "^fatal:"; then
+            has_error=true
+        fi
+        
+        if [ "$has_error" = "false" ]; then
             exit 0
         fi
     fi

package/hooks/error-recovery.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # error-recovery.sh - 任务恢复和错误重试机制
 # 实现智能错误检测、重试策略和任务恢复

package/hooks/failure-transparency.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 失败透明化 - Failure Transparency Hook (PostToolUse)
 # ============================================================================

package/hooks/first-use-onboarding.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 渐进式引导检测 - Progressive Onboarding Hook (UserPromptSubmit)
 # ============================================================================

package/hooks/hook-performance-monitor.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # Hook 性能监控
 # 追踪各 Hook 的执行时间，识别性能瓶颈
 # 触发时机: PostToolUse (周期性检查)

package/hooks/interactive-bash-session.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Interactive Bash Session Hook - tmux 会话管理
 # ============================================================================

package/hooks/keyword-detector.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # 关键词检测器 - UserPromptSubmit Hook
 # 检测用户输入中的关键词并注入相应的上下文
 #
@@ -93,7 +93,12 @@ fi
 # 第五优先级：测试类（质量保障）
 # ============================================================================
 
-if echo "$prompt_lower" | grep -qE '(测试|单元测试|集成测试|test|unit[-_]?test|integration[-_]?test|tdd|jest|vitest|pytest|包拯|baozheng|开封|coverage|覆盖率|e2e|端到端)'; then
+# 优化：移除单独的"测试"/"test"，避免误触发
+# "测试一下这个功能"不应触发测试模式
+# 只有明确的测试开发需求才触发
+if echo "$prompt_lower" | grep -qE '(单元测试|集成测试|unit[-_]?test|integration[-_]?test|tdd|jest|vitest|pytest|包拯|baozheng|开封|coverage|覆盖率|e2e|端到端|测试用例|test[-_]?case|测试覆盖|写测试|添加测试|补测试)' || \
+   echo "$prompt_lower" | grep -qE '(写|添加|补充|增加|创建).{0,5}测试' || \
+   echo "$prompt_lower" | grep -qE '测试.{0,5}(用例|覆盖|框架|策略)'; then
     cat << 'EOF'
 {
   "systemMessage": "\n\n⚖️ **包拯测试提示**\n\n检测到测试相关需求，建议：\n- 使用 /baozheng 命令进入测试模式\n- 包拯擅长：单元测试、集成测试、TDD、测试覆盖率分析\n"
@@ -119,7 +124,14 @@ fi
 # 第七优先级：性能类（慢就是问题）
 # ============================================================================
 
-if echo "$prompt_lower" | grep -qE '(性能|优化|慢|performance|optimize|slow|孙子|sunzi|perf|瓶颈|bottleneck|缓存|cache|内存|memory|cpu|加速)'; then
+# 优化：移除单独的"优化"/"optimize"，避免误触发
+# "优化样式"、"优化布局"不应触发性能模式
+# 只有明确的性能相关词才触发
+if echo "$prompt_lower" | grep -qE '(性能|慢|slow|孙子|sunzi|perf|瓶颈|bottleneck|内存|memory|cpu|加速|响应时间|latency|qps|tps|并发|concurrent)' || \
+   echo "$prompt_lower" | grep -qE '优化.{0,5}(性能|速度|响应|延迟|内存|cpu|加载|渲染)' || \
+   echo "$prompt_lower" | grep -qE '(性能|速度|响应|延迟|加载|渲染).{0,5}优化' || \
+   echo "$prompt_lower" | grep -qE 'optimi[sz]e.{0,10}(performance|speed|memory|cpu|loading)' || \
+   echo "$prompt_lower" | grep -qE '(performance|speed|memory|cpu|loading).{0,10}optimi[sz]'; then
     cat << 'EOF'
 {
   "systemMessage": "\n\n⚔️ **孙子性能提示**\n\n检测到性能相关问题，建议：\n- 使用 /sunzi 命令进入性能优化模式\n- 孙子擅长：性能分析、瓶颈定位、优化策略\n"
@@ -132,7 +144,11 @@ fi
 # 第八优先级：API/集成类
 # ============================================================================
 
-if echo "$prompt_lower" | grep -qE '(api|接口|集成|对接|integrate|webhook|sdk|rest|graphql|grpc|郑和|zhenghe|西洋|第三方|openapi|swagger)'; then
+# 优化：移除单独的"接口"，避免误触发
+# "接口报错了"应该触发扁鹊，不是郑和
+# 只有明确的 API 开发/集成需求才触发
+if echo "$prompt_lower" | grep -qE '(api|集成|对接|integrate|webhook|sdk|rest[-_]?api|graphql|grpc|郑和|zhenghe|西洋|第三方|openapi|swagger|调用.{0,5}接口|接口.{0,5}(设计|开发|封装|对接))' || \
+   echo "$prompt_lower" | grep -qE '(设计|开发|封装|对接|调用).{0,5}(api|接口)'; then
     cat << 'EOF'
 {
   "systemMessage": "\n\n⛵ **郑和 API 提示**\n\n检测到 API/集成相关需求，建议：\n- 使用 /zhenghe 命令进入 API 模式\n- 郑和擅长：API 集成、SDK 封装、外部服务对接\n"
@@ -249,7 +265,11 @@ fi
 # 第十七优先级：文档类
 # ============================================================================
 
-if echo "$prompt_lower" | grep -qE '(文档|注释|记录|document|comment|readme|changelog|history|司马迁|simaqian|史记|shiji|wiki)'; then
+# 优化：移除单独的"记录"，避免误触发
+# "记录一下状态"不应触发文档模式
+# 只有明确的文档撰写需求才触发
+if echo "$prompt_lower" | grep -qE '(文档|注释|readme|changelog|司马迁|simaqian|史记|shiji|wiki|写.{0,3}(文档|注释)|添加.{0,3}注释|(api|接口).{0,3}文档|技术文档|使用文档)' || \
+   echo "$prompt_lower" | grep -qE '(撰写|编写|更新|完善).{0,5}文档'; then
     cat << 'EOF'
 {
   "systemMessage": "\n\n📜 **司马迁文档提示**\n\n检测到文档相关需求，建议：\n- 使用 /simaqian 命令进入文档模式\n- 司马迁擅长：技术文档撰写、变更记录、代码注释\n"

package/hooks/lib/message-dedup.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 消息去重工具库 - Message Deduplication Library
 # ============================================================================

package/hooks/lsp-tools.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # lsp-tools.sh - LSP (Language Server Protocol) 工具集成
 # 提供类型信息、符号定义、引用查找等 IDE 级别的代码分析能力

package/hooks/operation-history.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 操作历史记录 - Operation History Hook (PostToolUse)
 # ============================================================================

package/hooks/output-truncator.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # output-truncator.sh - 输出管理和截断器
 # 智能截断大型输出，防止令牌溢出

package/hooks/preemptive-compaction.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # preemptive-compaction.sh - 抢占式上下文压缩
 # 在达到令牌限制之前主动压缩上下文，避免硬性截断

package/hooks/progress-notifier.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # 进度通知器 - Progress Notifier (PostToolUse Hook)
 # ============================================================================

package/hooks/ralph-loop.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Ralph Loop Hook - 自引用循环控制
 # ============================================================================
@@ -51,6 +51,6 @@ if [ -f "$RALPH_STATE_FILE" ]; then
 fi
 
 # 返回 JSON 阻止退出并注入继续指令
-printf '{"decision":"block","systemMessage":"\\n\\n🔄 **Ralph Loop 第 %d 次迭代**\\n\\n[自检] 任务是否完成？\\n\\n## 继续条件\\n- 检查 TODO 列表，如有未完成项则继续工作\\n- 验证所有要求都已满足\\n\\n## 完成条件\\n当所有任务完成后：\\n1. 输出: <promise>%s</promise>\\n2. 使用 /cancel-ralph 结束循环\\n\\n**如果任务未完成，继续工作。不要停止。**\\n"}\n' "$NEXT_ITERATION" "$COMPLETION_PROMISE"
+printf '{"decision":"block","systemMessage":"\\n\\n🔄 **Ralph Loop 第 %d 次迭代**\\n\\n## 强制自检流程\\n\\n**必须执行以下步骤：**\\n\\n1. 调用 `mcp_todoread` 工具查看当前 TODO 列表\\n2. 检查是否有 `pending` 或 `in_progress` 状态的任务\\n3. 如果有未完成任务 → 继续工作，不要停止\\n4. 如果所有任务都是 `completed` → 执行结束流程\\n\\n## 结束方式\\n\\n当所有 TODO 完成后：\\n1. 向用户报告任务完成\\n2. 执行: `rm -f .claude/ralph-loop.local.md` 删除循环状态文件\\n3. 循环将自动结束\\n\\n**⚠️ 不要跳过 todoread 检查！**\\n"}\n' "$NEXT_ITERATION"
 
 exit 0

package/hooks/rules-injector.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # rules-injector.sh - 规则注入系统
 # 根据项目和目录自动注入自定义规则

package/hooks/session-recovery.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Session Recovery Hook - 会话恢复机制
 # ============================================================================

package/hooks/task-checkpointing.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # task-checkpointing.sh - 任务断点续传管理器
 # 解决 Claude 上下文限制，实现长任务的智能断点和恢复

package/hooks/think-mode.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # think-mode.sh - 思维模式 Hook
 # 启用深度思考和推理模式，增强复杂问题分析

package/hooks/thinking-block-validator.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Thinking Block Validator - 思维块验证器
 # ============================================================================

package/hooks/todo-continuation.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # TODO 续航检查器 (Todo Continuation Checker)
 # ============================================================================
@@ -44,6 +44,6 @@ fi
 
 # 返回 JSON 阻止退出
 # 注意：使用 printf 而不是 echo 来确保正确的 JSON 格式
-printf '{"decision":"block","systemMessage":"\\n\\n🏔️ **愚公移山 第 %d 次搬石**\\n\\n[自检] 检查 TODO 列表，如有未完成项则继续工作。\\n\\n如果所有任务已完成，请输出: <promise>移山完毕</promise>\\n然后使用 /cancel-yishan 结束循环。\\n"}\n' "$NEXT_ITERATION"
+printf '{"decision":"block","systemMessage":"\\n\\n🏔️ **愚公移山 第 %d 次搬石**\\n\\n## 强制自检流程\\n\\n**必须执行以下步骤：**\\n\\n1. 调用 `mcp_todoread` 工具查看当前 TODO 列表\\n2. 检查是否有 `pending` 或 `in_progress` 状态的任务\\n3. 如果有未完成任务 → 继续工作，不要停止\\n4. 如果所有任务都是 `completed` → 执行结束流程\\n\\n## 结束方式\\n\\n当所有 TODO 完成后：\\n1. 向用户报告任务完成\\n2. 执行: `rm -f .claude/yishan-loop.local.md` 删除循环状态文件\\n3. 循环将自动结束\\n\\n**⚠️ 不要跳过 todoread 检查！**\\n"}\n' "$NEXT_ITERATION"
 
 exit 0

package/hooks/tool-output-validator.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 # ============================================================================
 # Tool Output Validator - 工具输出验证器 (PostToolUse Hook)
 # ============================================================================

package/package.json

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

package/scripts/install.sh

@@ -1,8 +1,10 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # oh-my-claude 一键安装脚本
 # 用法: curl -fsSL https://raw.githubusercontent.com/ZDragon17/oh-my-claude/main/scripts/install.sh | bash
 # 或者: wget -qO- https://raw.githubusercontent.com/ZDragon17/oh-my-claude/main/scripts/install.sh | bash
+#
+# 兼容性: macOS (bash 3.2+), Linux (bash 4.0+), Windows (Git Bash)
 
 set -e
 
@@ -41,13 +43,13 @@ show_banner() {
 check_dependencies() {
     info "检查依赖..."
 
-    # 检查 git
-    if ! command -v git &> /dev/null; then
+    # 检查 git (使用 >/dev/null 2>&1 替代 &> 以兼容 bash 3.2)
+    if ! command -v git >/dev/null 2>&1; then
         error "需要 git，请先安装: https://git-scm.com/"
     fi
 
     # 检查 Claude Code
-    if ! command -v claude &> /dev/null; then
+    if ! command -v claude >/dev/null 2>&1; then
         warn "未检测到 Claude Code CLI"
         warn "请先安装 Claude Code: https://claude.ai/code"
         warn "安装后重新运行此脚本"