claude-pangu 2.2.1 → 2.2.2

package/.claude-plugin/plugin.json

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

package/commands/session.md

@@ -3,13 +3,16 @@ name: session
 description: |
   会话管理命令 - 保存、恢复和管理工作会话。
   支持跨会话断点续传，保留 TODO 状态和上下文。
+  
+  ⚡ v2.2.2: 集成 MCP 工具，自动读取 Claude Code 原生会话历史！
 
   子命令：
-  - save [name]   保存当前会话
-  - list          列出可恢复会话
+  - save [name]   保存当前会话（增强功能）
+  - list          列出所有会话（原生 + 自定义）
   - resume [id]   恢复指定会话
   - info [id]     查看会话详情
   - delete [id]   删除会话
+  - search [query] 搜索会话内容
 
   别名：/会话, /ses
 aliases:
@@ -22,6 +25,10 @@ allowed-tools:
   - Glob
   - TodoRead
   - TodoWrite
+  - mcp_session_list
+  - mcp_session_read
+  - mcp_session_search
+  - mcp_session_info
 model: sonnet
 ---
 
@@ -36,17 +43,26 @@ model: sonnet
 > 工欲善其事，必先利其器。
 > 会话管理让长任务不再因中断而丢失进度。
 
+## ⚡ 重要更新 (v2.2.2)
+
+**现在 `/session list` 会自动读取 Claude Code 原生会话历史！**
+
+- 使用 MCP 内置工具 `mcp_session_list` 读取 `~/.claude/transcripts/` 数据
+- 无需手动保存，自动有历史记录
+- 保留 `/session save` 作为增强功能（添加 TODO 快照和上下文摘要）
+
 ## 命令解析
 
 根据 `$ARGUMENTS` 执行对应操作：
 
 | 参数 | 操作 |
 |------|------|
-| `save [name]` | 保存当前会话 |
-| `list` | 列出所有会话 |
+| `save [name]` | 保存当前会话（增强：含 TODO 和上下文） |
+| `list` | 列出所有会话（原生 + 自定义） |
 | `resume [id]` | 恢复指定会话 |
 | `info [id]` | 查看会话详情 |
 | `delete [id]` | 删除指定会话 |
+| `search [query]` | 🆕 搜索会话内容 |
 | (空) | 显示帮助 |
 
 ---
@@ -55,7 +71,10 @@ model: sonnet
 
 ### 1. /session save [name]
 
-**保存当前会话状态**
+**保存当前会话状态（增强功能）**
+
+> 💡 注意：Claude Code 会自动保存对话历史到 `~/.claude/transcripts/`。
+> `/session save` 是**增强功能**，额外保存 TODO 状态和上下文摘要，方便恢复时快速了解进度。
 
 执行步骤：
 
@@ -116,34 +135,58 @@ model: sonnet
 
 执行步骤：
 
-1. 读取 `~/.oh-my-claude/sessions/index.json`
-2. 按时间倒序排列
-3. 显示会话列表
+1. **首先调用 MCP 工具获取 Claude 原生会话**
+   ```
+   调用 mcp_session_list(limit=10) 获取最近 10 个原生会话
+   ```
+
+2. **然后读取 oh-my-claude 自定义会话**（如有）
+   - 读取 `~/.oh-my-claude/sessions/index.json`
+
+3. **合并显示，原生会话优先**
 
 **输出格式**：
 ```text
-📂 已保存的会话
+📂 会话历史
 ═══════════════════════════════════════════════════
 
+🔵 Claude Code 原生会话 (自动记录):
+────────────────────────────────────────────────────
+Session ID                       消息数  日期        Agents
+ses_3f803d400ffeqQhnIgcXJCicub   221     2026-01-29  sisyphus, compaction
+ses_402f9b282ffeAeJFapgAfmdyWG   83      2026-01-27  sisyphus, compaction
+ses_406f114ceffed43sk6bd2qCKqR   225     2026-01-26  sisyphus, compaction
+
+💡 使用 /session info ses_xxx 查看详情
+💡 使用 /session search "关键词" 搜索内容
+
+🟢 oh-my-claude 增强会话 (手动保存):
+────────────────────────────────────────────────────
 序号  ID                    名称              进度    保存时间
-────  ────────────────────  ────────────────  ──────  ──────────────
 [1]   ses_1706012345_a1b2   重构认证模块       40%     2小时前
-[2]   ses_1706011234_c3d4   API文档编写        100%    昨天
-[3]   ses_1706009999_e5f6   修复登录Bug        75%     3天前
+
+💡 使用 /session resume [序号或ID] 恢复增强会话
 
 ═══════════════════════════════════════════════════
-💡 使用 /session resume [序号或ID] 恢复会话
-💡 使用 /session info [序号或ID] 查看详情
 ```
 
-**无会话时**：
+**无自定义会话时**：
 ```text
-📂 已保存的会话
+📂 会话历史
 ═══════════════════════════════════════════════════
 
-😴 暂无保存的会话
+🔵 Claude Code 原生会话 (自动记录):
+────────────────────────────────────────────────────
+[显示 mcp_session_list 结果]
+
+💡 使用 /session info ses_xxx 查看详情
+💡 使用 /session search "关键词" 搜索内容
 
-💡 使用 /session save "任务名称" 保存当前会话
+🟢 oh-my-claude 增强会话:
+────────────────────────────────────────────────────
+😴 暂无增强会话
+
+💡 使用 /session save "任务名称" 保存当前 TODO 和上下文
 
 ═══════════════════════════════════════════════════
 ```
@@ -218,13 +261,42 @@ model: sonnet
 
 执行步骤：
 
-1. 解析会话标识（同 resume）
-2. 读取会话文件
-3. 显示详细信息
+1. **判断会话类型**
+   - 如果 ID 以 `ses_` 开头且长度 > 20 字符 → Claude 原生会话
+   - 如果 ID 是短格式或序号 → oh-my-claude 增强会话
 
-**输出格式**：
+2. **原生会话（Claude Code 自动记录）**
+   ```
+   调用 mcp_session_info(session_id="ses_xxx") 获取元数据
+   调用 mcp_session_read(session_id="ses_xxx", limit=5) 获取最近消息预览
+   ```
+
+3. **增强会话（oh-my-claude 保存）**
+   - 读取 `~/.oh-my-claude/sessions/{session_id}.json`
+
+**原生会话输出格式**：
+```text
+📋 会话详情 (Claude Code 原生)
+═══════════════════════════════════════════════════
+
+🏷️ 基本信息:
+   Session ID: ses_3f803d400ffeqQhnIgcXJCicub
+   消息数量: 221
+   时间范围: 2026-01-29 10:30:00 ~ 15:45:30
+   使用的 Agent: sisyphus, compaction
+
+📝 最近消息预览:
+   [user] 修复 /session 命令问题...
+   [assistant] 我来检查 session 命令的实现...
+   ...
+
+═══════════════════════════════════════════════════
+💡 使用 /session search "关键词" 在此会话中搜索
+```
+
+**增强会话输出格式**：
 ```text
-📋 会话详情
+📋 会话详情 (oh-my-claude 增强)
 ═══════════════════════════════════════════════════
 
 🏷️ 基本信息:
@@ -259,16 +331,54 @@ model: sonnet
 
 ---
 
-### 5. /session delete [id]
+### 5. /session search [query]
+
+**🆕 搜索会话内容**
+
+执行步骤：
+
+1. **调用 MCP 搜索工具**
+   ```
+   调用 mcp_session_search(query="关键词", limit=20)
+   ```
+
+2. **显示搜索结果**
+
+**输出格式**：
+```text
+🔍 搜索结果: "认证"
+═══════════════════════════════════════════════════
+
+找到 3 个匹配项:
+
+[ses_3f803d400ffe...] 消息 msg_001 (user)
+   ...实现 JWT **认证**模块...
+
+[ses_3f803d400ffe...] 消息 msg_005 (assistant)
+   ...我来设计**认证**流程架构...
+
+[ses_402f9b282ffe...] 消息 msg_012 (user)
+   ...OAuth **认证**集成...
+
+═══════════════════════════════════════════════════
+💡 使用 /session info ses_xxx 查看会话详情
+```
+
+---
+
+### 6. /session delete [id]
 
 **删除指定会话**
 
+> ⚠️ 注意：只能删除 oh-my-claude 增强会话。Claude Code 原生会话由系统管理，不支持删除。
+
 执行步骤：
 
 1. 解析会话标识
-2. 确认删除（显示会话名称）
-3. 删除会话文件
-4. 更新索引
+2. 确认是增强会话（原生会话拒绝删除）
+3. 确认删除（显示会话名称）
+4. 删除会话文件
+5. 更新索引
 
 **输出格式**：
 ```text
@@ -280,6 +390,19 @@ model: sonnet
 ═══════════════════════════════════════════════════
 ```
 
+**尝试删除原生会话时**：
+```text
+⚠️ 无法删除
+═══════════════════════════════════════════════════
+
+ses_3f803d400ffeqQhnIgcXJCicub 是 Claude Code 原生会话，
+由系统自动管理，不支持手动删除。
+
+💡 如需清理，请查看 ~/.claude/transcripts/ 目录
+
+═══════════════════════════════════════════════════
+```
+
 ---
 
 ## 数据结构
@@ -351,42 +474,73 @@ model: sonnet
 当 `$ARGUMENTS` 为空或为 `help` 时显示：
 
 ```text
-📖 会话管理命令
+📖 会话管理命令 (v2.2.2 集成 MCP 工具)
 ═══════════════════════════════════════════════════
 
 用法: /session <子命令> [参数]
 
 子命令:
-  save [name]    保存当前会话
-                 例: /session save "重构认证模块"
-
-  list           列出所有已保存的会话
+  list           列出所有会话 (原生 + 增强)
+                 🆕 自动读取 Claude Code 原生会话历史！
                  例: /session list
 
-  resume [id]    恢复指定会话
+  info [id]      查看会话详细信息
+                 支持原生会话 ID 和增强会话 ID
+                 例: /session info ses_3f803d400ffe...
+                 例: /session info 1
+
+  search [query] 🆕 搜索会话内容
+                 例: /session search "认证"
+                 例: /session search "JWT token"
+
+  save [name]    保存当前会话 (增强功能)
+                 额外保存 TODO 状态和上下文摘要
+                 例: /session save "重构认证模块"
+
+  resume [id]    恢复增强会话
                  支持序号或ID
                  例: /session resume 1
                  例: /session resume ses_1706012345_a1b2
 
-  info [id]      查看会话详细信息
-                 例: /session info 1
-
-  delete [id]    删除指定会话
+  delete [id]    删除增强会话
+                 注意：不能删除原生会话
                  例: /session delete 1
 
 ═══════════════════════════════════════════════════
-💡 提示: 使用 /session save 在重要节点保存进度
+💡 提示: Claude Code 自动记录对话历史，无需手动保存
+💡 提示: /session save 用于添加 TODO 快照等增强信息
 ```
 
 ---
 
 ## 执行规则
 
-1. **自动收集上下文** - 保存时自动收集当前任务和决策
-2. **保持 TODO 状态** - 恢复时完整还原任务状态
-3. **友好的时间显示** - 使用相对时间（2小时前、昨天）
-4. **支持多种标识方式** - 序号、完整ID、部分ID
-5. **Windows 兼容** - 使用 `$HOME` 路径变量
+1. **优先使用 MCP 工具** - list/info/search 使用 mcp_session_* 工具
+2. **自动收集上下文** - 保存时自动收集当前任务和决策
+3. **保持 TODO 状态** - 恢复时完整还原任务状态
+4. **友好的时间显示** - 使用相对时间（2小时前、昨天）
+5. **支持多种标识方式** - 序号、完整ID、部分ID
+6. **Windows 兼容** - 使用 `$HOME` 路径变量
+
+## MCP 工具使用说明
+
+执行 `/session list` 时：
+```
+1. 调用 mcp_session_list(limit=10) 获取原生会话
+2. 读取 ~/.oh-my-claude/sessions/index.json 获取增强会话
+3. 合并显示
+```
+
+执行 `/session info ses_xxx` 时：
+```
+1. 如果是长 ID (>20字符) → 调用 mcp_session_info(session_id="ses_xxx")
+2. 如果是短 ID 或序号 → 读取 ~/.oh-my-claude/sessions/{id}.json
+```
+
+执行 `/session search "关键词"` 时：
+```
+调用 mcp_session_search(query="关键词", limit=20)
+```
 
 ## 现在执行
 

package/package.json

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

package/skills/session/SKILL.md

@@ -3,6 +3,8 @@ name: session
 description: |
   会话持久化与恢复技能 - 跨会话保存和恢复工作进度，实现断点续传。
   支持保存 TODO 状态、上下文摘要、关键决策等信息。
+  
+  ⚡ v2.2.2: 集成 MCP 工具，自动读取 Claude Code 原生会话历史！
 ---
 
 # 会话持久化与恢复 (Session Persistence)
@@ -14,9 +16,46 @@ description: |
 > 工欲善其事，必先利其器。
 > 会话管理让长任务不再因中断而丢失进度。
 
+## ⚡ 重要更新 (v2.2.2)
+
+**现在会自动读取 Claude Code 原生会话历史！**
+
+- 使用 MCP 内置工具读取 `~/.claude/transcripts/` 数据
+- 无需手动保存，自动有历史记录
+- `/session save` 作为增强功能（添加 TODO 快照和上下文摘要）
+
+### 数据来源
+
+| 类型 | 存储位置 | 特点 |
+|------|----------|------|
+| 原生会话 | `~/.claude/transcripts/` | Claude Code 自动记录，无需手动操作 |
+| 增强会话 | `~/.oh-my-claude/sessions/` | 手动保存，包含 TODO 和上下文 |
+
 ## 功能概述
 
-### 1. 会话保存 (/session save)
+### 1. 会话列表 (/session list) - 🆕 集成 MCP
+
+列出所有可恢复的会话：
+- **原生会话**: 调用 `mcp_session_list` 获取 Claude Code 自动记录的会话
+- **增强会话**: 读取 `~/.oh-my-claude/sessions/index.json`
+- 按时间倒序排列
+- 相对时间显示（如"2小时前"）
+
+### 2. 会话详情 (/session info) - 🆕 支持原生会话
+
+查看会话详细信息：
+- **原生会话**: 调用 `mcp_session_info` + `mcp_session_read` 获取元数据和消息预览
+- **增强会话**: 读取本地 JSON 文件
+- 显示消息数量、时间范围、使用的 Agent
+
+### 3. 会话搜索 (/session search) - 🆕 新增功能
+
+搜索会话内容：
+- 调用 `mcp_session_search` 进行全文搜索
+- 支持关键词搜索
+- 返回匹配的消息片段
+
+### 4. 会话保存 (/session save) - 增强功能
 
 保存当前工作状态，包括：
 - TODO 任务列表及状态
@@ -25,37 +64,34 @@ description: |
 - 使用的 Agent 记录
 - 当前进度百分比
 
-### 2. 会话列表 (/session list)
+> 💡 注意：Claude Code 会自动保存对话历史，此功能用于额外保存 TODO 和上下文。
 
-列出所有可恢复的会话：
-- 按时间倒序排列
-- 显示进度百分比
-- 相对时间显示（如"2小时前"）
+### 5. 会话恢复 (/session resume)
 
-### 3. 会话恢复 (/session resume)
-
-恢复指定会话：
+恢复增强会话：
 - 恢复 TODO 列表
 - 注入上下文摘要
 - 显示恢复状态概览
 
-### 4. 会话详情 (/session info)
-
-查看会话详细信息：
-- 基本信息（ID、名称、时间）
-- 进度统计
-- Agent 使用记录
-- 关键决策列表
-
-### 5. 会话删除 (/session delete)
+### 6. 会话删除 (/session delete)
 
-删除不再需要的会话：
+删除增强会话：
 - 确认删除
 - 清理存储文件
+- ⚠️ 不能删除原生会话（由系统管理）
 
 ## 数据存储
 
-### 存储位置
+### 原生会话（Claude Code 管理）
+
+```
+~/.claude/transcripts/
+├── ses_3f803d400ffeqQhnIgcXJCicub.jsonl
+├── ses_402f9b282ffeAeJFapgAfmdyWG.jsonl
+└── ...
+```
+
+### 增强会话（oh-my-claude 管理）
 
 ```
 ~/.oh-my-claude/sessions/