claude-pangu 2.2.8 → 2.2.9

package/commands/xuetu.md

@@ -1,4 +1,19 @@
-# 学徒命令 - 从经验中学习
+---
+name: xuetu
+description: |
+  学徒命令 - 从经验中学习
+  基于持续学习技能，从会话中提取可复用模式。
+  别名：/apprentice, /learner, /remember
+arguments:
+  - name: action
+    description: "操作类型: (空)=分析学习, list=列出, search=搜索, apply=应用, save=保存"
+    required: false
+  - name: query
+    description: "搜索关键词或模式 ID"
+    required: false
+---
+
+# /xuetu - 学徒命令
 
 > 📚 学而时习之，温故而知新
 
@@ -13,49 +28,197 @@
 # 指定提取内容
 /xuetu "如何处理认证错误"
 
-# 英文命令
-/learner extract "auth error handling"
-```
-
-## 管理知识库
-
-```bash
 # 列出所有已学习的模式
 /xuetu list
 
+# 按分类列出
+/xuetu list --category code-patterns
+
 # 搜索特定模式
 /xuetu search "认证"
+/xuetu search --tags auth,jwt
 
 # 应用已学习的模式
-/xuetu apply "处理JWT过期"
+/xuetu apply jwt-refresh-token
+
+# 手动保存模式
+/xuetu save "模式名称" --category code-patterns --tags react,form
+
+# 删除过时的学习成果
+/xuetu delete <pattern-id>
 
 # 导出知识库
-/xuetu export --format=json
+/xuetu export > patterns.json
 
 # 导入知识库
-/xuetu import knowledge.json
+/xuetu import patterns.json
 ```
 
-## 选项
+## 执行流程
 
-```bash
-# 指定分类
-/xuetu --category=patterns 提取认证相关经验
+<xuetu>
+## 学徒学习流程
+
+### 阶段 1: 会话分析
+
+分析当前会话中的：
+- 实现的功能代码
+- 解决的问题
+- 使用的模式
+- 讨论的最佳实践
+
+### 阶段 2: 模式识别
+
+识别以下信号：
+- [ ] 重复出现的代码结构
+- [ ] 解决了特定问题的方案
+- [ ] 用户肯定的实现方式
+- [ ] 通过验证的代码
+
+### 阶段 3: 价值评估
+
+对每个候选内容评估：
+| 维度 | 权重 | 说明 |
+|------|------|------|
+| 可复用性 | 40% | 能否在其他场景使用 |
+| 通用性 | 30% | 是否项目无关 |
+| 正确性 | 20% | 是否是正确做法 |
+| 复杂度 | 10% | 是否值得记录 |
+
+### 阶段 4: 保存学习成果
+
+将有价值的内容保存到 `.claude/learned-patterns/`
+
+分类：
+- `code-patterns/` - 代码模式
+- `solutions/` - 问题解决方案
+- `best-practices/` - 最佳实践
+- `project-knowledge/` - 项目知识
+
+### 阶段 5: 汇报结果
+
+```markdown
+## 📚 学习报告
+
+### 本次学习
+从当前会话识别并保存了以下模式：
+
+#### 1. [code-pattern] React 表单验证
+- **文件**: `code-patterns/react-form-validation.md`
+- **标签**: react, form, zod
+- **来源**: 实现登录表单
 
-# 添加标签
-/xuetu --tags=auth,jwt,error
+#### 2. [solution] Prisma 连接池配置
+- **文件**: `solutions/prisma-connection-pool.md`
+- **标签**: prisma, database
+- **来源**: 修复连接超时
 
-# 从历史会话提取
-/xuetu --session=ses_abc123
+### 统计
+- 总学习成果: 42 个
+- 本次新增: 2 个
 ```
+</xuetu>
+
+## 学习成果格式
+
+### 代码模式
+
+```markdown
+## 模式：React 表单验证
+
+### 触发条件
+- 实现表单验证逻辑
+- 使用 react-hook-form
+
+### 模式代码
+\`\`\`typescript
+import { useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { z } from 'zod';
+
+const schema = z.object({
+  email: z.string().email('请输入有效邮箱'),
+  password: z.string().min(8, '密码至少8位'),
+});
+
+export function LoginForm() {
+  const { register, handleSubmit, formState: { errors } } = useForm({
+    resolver: zodResolver(schema),
+  });
+  // ...
+}
+\`\`\`
+
+### 学习来源
+- 会话: 2026-02-03-login
+```
+
+### 解决方案
+
+```markdown
+## 解决方案：Next.js Cookies 问题
+
+### 问题描述
+在服务端组件中 cookies() 报错
+
+### 根本原因
+cookies() 需要在异步上下文中调用
+
+### 解决方案
+\`\`\`typescript
+import { cookies } from 'next/headers';
+
+export default async function Page() {
+  const cookieStore = await cookies();
+  const token = cookieStore.get('token');
+}
+\`\`\`
+```
+
+## 存储位置
+
+```
+.claude/
+└── learned-patterns/
+    ├── index.json              # 学习索引
+    ├── code-patterns/          # 代码模式
+    ├── solutions/              # 解决方案
+    ├── best-practices/         # 最佳实践
+    └── project-knowledge/      # 项目知识
+```
+
+## 配置选项
+
+在 `.claude/settings.json` 中配置：
+
+```json
+{
+  "omc": {
+    "continuousLearning": {
+      "enabled": true,
+      "autoLearn": true,
+      "storage": "project",
+      "minConfidence": 0.7
+    }
+  }
+}
+```
+
+## 与其他命令的关系
+
+| 命令 | 功能 | 范围 |
+|------|------|------|
+| `/learn` | 项目画像 | 项目结构、技术栈 |
+| `/xuetu` | 个人经验 | 模式、解决方案 |
+| `/snippet` | 代码片段 | 可直接复制的代码 |
 
 ## 命令别名
 
 - `/xuetu` - 学徒（中文）
-- `/learner` - Learner（英文）
-- `/learn` - 简写
+- `/apprentice` - 英文别名
+- `/learner` - 学习者
 - `/remember` - 记住
 
 ---
 
-加载 learner 技能以获取详细指南。
+加载 continuous-learning 技能以获取详细指南。

package/hooks/keyword-detector.sh

@@ -96,6 +96,28 @@ EOF
     exit 0
 fi
 
+# ---- 深度工作模式检测 (Deepwork/Hephaestus) ----
+# 特征：目标导向、自主实现、端到端、深度
+deepwork_mode=false
+if echo "$prompt_lower" | grep -qE '(deepwork|huoshen|火神|hephaestus|深度工作)'; then
+    deepwork_mode=true
+elif echo "$prompt_lower" | grep -qE '(目标导向|goal[-_]?oriented|自主.{0,5}(实现|完成|开发)|autonomous.{0,5}(implement|develop|complete))' || \
+     echo "$prompt_lower" | grep -qE '(端到端|end[-_]?to[-_]?end|e2e).{0,10}(实现|完成|开发|implement|develop|complete)' || \
+     echo "$prompt_lower" | grep -qE '(深度.{0,5}(理解|探索|分析)|deep.{0,5}(understand|explore|analyze))' || \
+     echo "$prompt_lower" | grep -qE '(给我.{0,5}目标|只需要.{0,5}目标|不用.{0,5}(告诉|说).{0,5}怎么做)' || \
+     echo "$prompt_lower" | grep -qE '(你来决定|你自己决定|自己想办法|自己规划)'; then
+    deepwork_mode=true
+fi
+
+if [ "$deepwork_mode" = true ]; then
+    cat << 'EOF'
+{
+  "systemMessage": "\n\n<deepwork-mode>\n🔥 **火神深度工作模式已激活！**\n\n[目标导向 - 自主探索 - 端到端完成]\n\n## 为什么选择此模式\n检测到需要深度理解和自主完成的任务。\n\n## 核心特性\n\n### 1. 🎯 目标导向\n- 只需提供目标，我来决定实现路径\n- 不需要详细步骤指引\n\n### 2. 🔭 探索优先\n在写任何代码前，并行启动 2-5 个探索任务：\n```\n@wukong - 探索项目结构\n@wukong - 分析代码风格\n@wukong - 搜索相似实现\n@wukong - 识别测试模式\n```\n\n### 3. 🎨 模式匹配\n- 学习项目的编码规范\n- 按照项目风格编写代码\n- 让代码看起来像项目原作者写的\n\n### 4. ✅ 端到端完成\n- 100% 完成才算完成\n- 每个声明都有验证证据\n- 不接受部分完成\n\n## 执行流程\n```\nPhase 0: 目标理解\n    ↓\nPhase 1: 并行探索 (2-5 @wukong)\n    ↓\nPhase 2: 模式学习 → 项目画像\n    ↓\nPhase 3: 自主实现\n    ↓\nPhase 4: 验证循环 (测试→修复→测试)\n    ↓\nPhase 5: 最终验证 + 证据展示\n```\n\n## 完成标志\n```\n<promise>深度工作完成</promise>\n```\n\n**给我目标，我交付完美。**\n</deepwork-mode>\n"
+}
+EOF
+    exit 0
+fi
+
 # ---- 蜂群模式检测 (Swarm) ----
 # 特征：批量、所有、N个同类任务
 swarm_mode=false

package/hooks/ralph-loop.sh

@@ -17,6 +17,8 @@ RALPH_STATE_FILE=".claude/ralph-loop.local.md"
 
 # 如果状态文件不存在，允许正常退出
 if [ ! -f "$RALPH_STATE_FILE" ]; then
+    # Stop hook 需要输出 JSON 响应，即使是允许停止的情况
+    echo '{}' 2>/dev/null || true
     exit 0
 fi
 
@@ -34,6 +36,7 @@ COMPLETION_PROMISE=${COMPLETION_PROMISE:-DONE}
 if [ "$MAX_ITERATIONS" -gt 0 ] 2>/dev/null && [ "$ITERATION" -ge "$MAX_ITERATIONS" ] 2>/dev/null; then
     echo "🛑 Ralph Loop: 已达最大迭代次数 ($MAX_ITERATIONS)" >&2
     rm -f "$RALPH_STATE_FILE"
+    echo '{}' 2>/dev/null || true
     exit 0
 fi
 

package/hooks/todo-continuation.sh

@@ -16,6 +16,8 @@ YISHAN_STATE_FILE=".claude/yishan-loop.local.md"
 
 # 如果状态文件不存在，允许正常退出
 if [ ! -f "$YISHAN_STATE_FILE" ]; then
+    # Stop hook 需要输出 JSON 响应，即使是允许停止的情况
+    echo '{}' 2>/dev/null || true
     exit 0
 fi
 
@@ -31,6 +33,7 @@ MAX_ITERATIONS=${MAX_ITERATIONS:-50}
 if [ "$MAX_ITERATIONS" -gt 0 ] 2>/dev/null && [ "$ITERATION" -ge "$MAX_ITERATIONS" ] 2>/dev/null; then
     echo "🛑 愚公移山: 已达最大迭代次数 ($MAX_ITERATIONS)" >&2
     rm -f "$YISHAN_STATE_FILE"
+    echo '{}' 2>/dev/null || true
     exit 0
 fi
 

package/package.json

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

package/scripts/install.sh

@@ -19,6 +19,21 @@ NC='\033[0m' # No Color
 # 配置
 REPO="ZDragon17/oh-my-claude"
 PLUGIN_NAME="oh-my-claude"
+
+# Windows 兼容性：确保 HOME 变量正确设置
+if [[ "$(uname -s)" == MINGW* ]] || [[ "$(uname -s)" == MSYS* ]] || [[ "$(uname -s)" == CYGWIN* ]]; then
+    # Windows Git Bash 环境
+    IS_WINDOWS=true
+    # 如果 HOME 未设置或为空，使用 USERPROFILE
+    if [ -z "$HOME" ] && [ -n "$USERPROFILE" ]; then
+        HOME=$(cygpath -u "$USERPROFILE" 2>/dev/null || echo "$USERPROFILE" | sed 's|\\|/|g' | sed 's|^\([A-Za-z]\):|/\L\1|')
+    fi
+    # 确保 HOME 是 Unix 风格路径 (/c/Users/xxx)
+    HOME=$(cygpath -u "$HOME" 2>/dev/null || echo "$HOME")
+else
+    IS_WINDOWS=false
+fi
+
 INSTALL_DIR="$HOME/.claude/plugins/$PLUGIN_NAME"
 COMMANDS_DIR="$HOME/.claude/commands"
 SKILLS_DIR="$HOME/.claude/skills"
@@ -272,10 +287,40 @@ setup_hooks() {
 import json
 import sys
 import os
+import platform
+import re
 
 settings_file = "$SETTINGS_FILE"
 install_dir = "$INSTALL_DIR"
 
+# Windows 兼容性：确保路径格式正确
+# Claude Code 在 Windows 上执行 bash 命令时需要 Unix 风格路径
+def normalize_path_for_hooks(path):
+    """将路径转换为 Git Bash 兼容格式"""
+    if platform.system() == 'Windows':
+        # 如果是 Windows 原生路径 (C:\Users\...)，转换为 /c/Users/...
+        if re.match(r'^[A-Za-z]:', path):
+            drive = path[0].lower()
+            rest = path[2:].replace('\\\\', '/').replace('\\', '/')
+            return f'/{drive}{rest}'
+        # 如果已经是 Unix 风格但使用了反斜杠
+        path = path.replace('\\\\', '/').replace('\\', '/')
+    return path
+
+install_dir = normalize_path_for_hooks(install_dir)
+
+# Windows 上需要使用 bash -c '. script' 格式，否则 stdout 不会被捕获
+is_windows = platform.system() == 'Windows'
+
+def make_hook_command(script_path):
+    """生成 hook 命令，Windows 使用特殊格式"""
+    if is_windows:
+        # Windows: bash -c '. "script.sh"' 格式确保 stdout 正确输出
+        return f"bash -c '. \"{script_path}\"'"
+    else:
+        # macOS/Linux: 标准格式
+        return f'bash "{script_path}"'
+
 try:
     with open(settings_file, 'r', encoding='utf-8') as f:
         settings = json.load(f)
@@ -283,30 +328,50 @@ except Exception as e:
     print(f"读取 settings.json 失败: {e}", file=sys.stderr)
     sys.exit(1)
 
-# 定义核心 hooks（只添加最重要的几个）
+# 定义核心 hooks（使用绝对路径，不依赖环境变量）
 core_hooks = {
     "PostToolUse": [
         {
-            "type": "command",
-            "command": f'bash "{install_dir}/hooks/progress-notifier.sh"',
-            "timeout": 3000
+            "matcher": "TodoWrite",
+            "hooks": [
+                {
+                    "type": "command",
+                    "command": make_hook_command(f"{install_dir}/hooks/progress-notifier.sh"),
+                    "timeout": 3000
+                }
+            ]
         },
         {
-            "type": "command",
-            "command": f'bash "{install_dir}/hooks/context-smart-alert.sh"',
-            "timeout": 2000
+            "matcher": "*",
+            "hooks": [
+                {
+                    "type": "command",
+                    "command": make_hook_command(f"{install_dir}/hooks/context-smart-alert.sh"),
+                    "timeout": 2000
+                }
+            ]
         }
     ],
     "Stop": [
         {
-            "type": "command",
-            "command": f'bash "{install_dir}/hooks/todo-continuation.sh"',
-            "timeout": 3000
+            "matcher": "*",
+            "hooks": [
+                {
+                    "type": "command",
+                    "command": make_hook_command(f"{install_dir}/hooks/todo-continuation.sh"),
+                    "timeout": 3000
+                }
+            ]
         },
         {
-            "type": "command",
-            "command": f'bash "{install_dir}/hooks/ralph-loop.sh"',
-            "timeout": 3000
+            "matcher": "*",
+            "hooks": [
+                {
+                    "type": "command",
+                    "command": make_hook_command(f"{install_dir}/hooks/ralph-loop.sh"),
+                    "timeout": 3000
+                }
+            ]
         }
     ]
 }
@@ -315,14 +380,31 @@ core_hooks = {
 if "hooks" not in settings:
     settings["hooks"] = {}
 
+def extract_commands_from_hooks(hooks_list):
+    """从 hooks 列表中提取所有 command"""
+    commands = []
+    for h in hooks_list:
+        if isinstance(h, dict):
+            # 新格式: {"matcher": "...", "hooks": [{"command": "..."}]}
+            if "hooks" in h:
+                for inner_hook in h.get("hooks", []):
+                    if "command" in inner_hook:
+                        commands.append(inner_hook["command"])
+            # 旧格式: {"type": "command", "command": "..."}
+            elif "command" in h:
+                commands.append(h["command"])
+    return commands
+
 for hook_type, hooks in core_hooks.items():
     if hook_type not in settings["hooks"]:
         settings["hooks"][hook_type] = []
 
     # 添加新的 hooks（避免重复）
-    existing_commands = [h.get("command", "") for h in settings["hooks"][hook_type] if isinstance(h, dict)]
+    existing_commands = extract_commands_from_hooks(settings["hooks"][hook_type])
     for hook in hooks:
-        if hook["command"] not in existing_commands:
+        # 从新格式中提取 command
+        hook_command = hook.get("hooks", [{}])[0].get("command", "")
+        if hook_command and hook_command not in existing_commands:
             settings["hooks"][hook_type].append(hook)
 
 # 写回文件