gh-chamherry-claude-code-third-party-plugins-plugins-session-manager/commands/continue-session.md at master

zhongwei/gh-chamherry-claude-code-third-party-plugins-plugins-session-manager

Files

Zhongwei Li 6a4a464431 Initial commit

2025-11-29 18:08:43 +08:00

21 KiB

Raw Permalink Blame History

allowed-tools, description

allowed-tools	description
Read, Write, AskUserQuestion, Bash, Grep, Glob	搜索并继续之前保存的会话

智能搜索已保存的会话，支持按项目、时间、关键词过滤，选择后生成 Markdown 格式的会话摘要供在新会话中继续工作。

核心特性:

🔍 智能搜索: 支持按项目、时间范围、关键词搜索
📋 可视化列表: 清晰展示会话信息（标题、时间、进度）
📝 完整导出: 生成包含进度、方案、决策的 Markdown 文档
💡 行动建议: 自动生成后续工作建议

执行步骤

1. 扫描已保存的会话

a. 检查存储目录是否存在（项目本地）

SUMMARY_BASE="./.claude-sessions/summaries"

if [ ! -d "$SUMMARY_BASE" ]; then
    echo "❌ 错误：未找到已保存的会话"
    echo "提示：使用 /session-manager:save 保存当前会话"
    echo "📁 会话将保存在项目目录: ./.claude-sessions/"
    exit 1
fi

b. 查找所有摘要文件（项目本地）

# 查找当前项目的所有会话摘要
find "$SUMMARY_BASE" -maxdepth 2 -name "summary.json" -type f

c. 读取并解析所有摘要文件

使用 Read 工具读取每个 summary.json
提取关键信息用于展示：
- 会话标题
- 项目名称
- 保存时间
- 进度信息（已完成/总数）
- 会话 ID 和存储路径

d. 按保存时间排序（最新的在前）

# 使用 Python 脚本读取和排序
python3 << 'EOF'
import json
import glob
import os
from datetime import datetime

summary_files = glob.glob(os.path.expanduser("~/.claude/session-summary/**/summary.json"), recursive=True)

sessions = []
for file_path in summary_files:
    with open(file_path, 'r', encoding='utf-8') as f:
        data = json.load(f)
        data['_file_path'] = file_path
        sessions.append(data)

# 按 savedAt 时间排序
sessions.sort(key=lambda x: x.get('savedAt', ''), reverse=True)

# 输出 JSON
print(json.dumps(sessions, ensure_ascii=False))
EOF

2. 首次展示（最近 10 个）

a. 提取最近 10 个会话信息

b. 格式化展示选项

每个选项格式：
label: "[时间] 项目名 - 会话标题"
description: "进度：X/Y 已完成 | 文件变更：Z 个"

c. 使用 AskUserQuestion 展示列表

question: "选择要继续的会话（显示最近 10 个）："
header: "会话列表"
multiSelect: false
options:
  - label: "🔍 搜索和过滤"
    description: "按项目、时间或关键词搜索会话"

  - label: "[2025-11-03 16:00] claude-code-init - 添加会话管理插件"
    description: "进度：4/6 已完成 | 文件变更：3 个"

  - label: "[2025-11-03 14:30] my-project - 实现用户认证"
    description: "进度：5/8 已完成 | 文件变更：12 个"

  ... (最多 10 个)

  - label: "📚 查看更多..."
    description: "显示更多会话（第 11-20 个）"

3. 搜索和过滤功能

如果用户选择"搜索和过滤"

a. 提供搜索选项

使用 AskUserQuestion:
  question: "选择搜索条件："
  header: "搜索选项"
  multiSelect: false
  options:
    - label: "按项目过滤"
      description: "只显示特定项目的会话"

    - label: "按时间范围"
      description: "选择时间范围（今天、本周、本月、自定义）"

    - label: "按关键词搜索"
      description: "在标题和描述中搜索关键词"

    - label: "返回会话列表"
      description: "返回主列表"

场景 A: 按项目过滤

提取所有唯一的项目名称

projects = list(set(s['projectName'] for s in sessions))
projects.sort()

展示项目列表供选择

question: "选择项目："
header: "项目过滤"
multiSelect: false
options:
  - label: "项目名称 1"
    description: "{该项目的会话数} 个会话"
  - label: "项目名称 2"
    description: "{该项目的会话数} 个会话"
  ...

过滤并展示该项目的会话列表

场景 B: 按时间范围

提供时间范围选项

question: "选择时间范围："
header: "时间过滤"
multiSelect: false
options:
  - label: "今天"
    description: "只显示今天保存的会话"

  - label: "本周"
    description: "显示本周保存的会话"

  - label: "本月"
    description: "显示本月保存的会话"

  - label: "最近 7 天"
    description: "显示最近 7 天的会话"

  - label: "最近 30 天"
    description: "显示最近 30 天的会话"

根据选择过滤会话

from datetime import datetime, timedelta

now = datetime.now()

# 根据选择计算时间范围
if choice == "今天":
    start = now.replace(hour=0, minute=0, second=0)
elif choice == "本周":
    start = now - timedelta(days=now.weekday())
elif choice == "本月":
    start = now.replace(day=1, hour=0, minute=0, second=0)
# ...

# 过滤会话
filtered = [s for s in sessions if datetime.fromisoformat(s['savedAt']) >= start]

展示过滤后的会话列表

场景 C: 按关键词搜索

询问用户输入关键词

question: "请输入搜索关键词："
header: "关键词搜索"
multiSelect: false
options:
  - label: "输入关键词"
    description: "在标题、描述、关键词中搜索"

从用户输入中提取关键词（使用 Other 选项）

在会话数据中搜索

keyword = user_input.lower()

filtered = []
for session in sessions:
    # 搜索标题
    if keyword in session['overview']['title'].lower():
        filtered.append(session)
        continue

    # 搜索描述
    if keyword in session['overview'].get('description', '').lower():
        filtered.append(session)
        continue

    # 搜索关键词列表
    if any(keyword in kw.lower() for kw in session['overview'].get('keywords', [])):
        filtered.append(session)
        continue

展示搜索结果
- 如果找到 0 个：提示未找到，返回主列表
- 如果找到 1-10 个：直接展示
- 如果找到 >10 个：展示前 10 个 + "查看更多"

4. 用户选择会话

提取会话数据

根据用户选择，定位到对应的 summary.json

读取完整的摘要数据

# 读取 summary.json
Read tool: {SESSION_DIR}/summary.json

可选：读取详细日志（如果需要提取更多上下文）

# 读取 details.jsonl（可选）
Read tool: {SESSION_DIR}/details.jsonl

5. 生成导出文件

创建导出目录（项目本地）

EXPORT_DIR="./.claude-sessions/exports"
mkdir -p "$EXPORT_DIR"

# 生成文件名
TIMESTAMP=$(date +"%Y-%m-%d-%H-%M")
EXPORT_FILE="$EXPORT_DIR/${TIMESTAMP}-${SESSION_UUID}.md"

生成 Markdown 内容

使用以下模板生成导出文件：

# 会话恢复：{会话标题}

> **会话 ID**: {uuid}
> **项目**: {项目名称} (`{项目路径}`)
> **会话时间**: {开始时间} - {结束时间}
> **保存时间**: {保存时间}
> **消息总数**: {消息数} ({用户消息数} 用户 + {AI消息数} 助手)

---

## 📋 工作概述

{从 summary.json 提取的描述}

**关键词**: {关键词1}, {关键词2}, {关键词3}

---

## 📈 项目进度

### ✅ 已完成任务 ({已完成数量})

{遍历 todos，筛选 status === "completed"}
- [x] {任务1内容}
- [x] {任务2内容}
...

### 🔄 进行中任务 ({进行中数量})

{遍历 todos，筛选 status === "in_progress"}
- [ ] {任务内容} - 🔄 {activeForm}

### 📋 待办任务 ({待办数量})

{遍历 todos，筛选 status === "pending"}
- [ ] {任务内容}

**进度总览**: {已完成}/{总数} 已完成 ({完成百分比}%)

---

## 📐 实施方案

{如果 implementation.hasDesignDoc === true}

**方案文档**: `{implementation.designDocPath}`

### 主要变更点

{遍历 implementation.mainChanges}
1. {变更点1}
2. {变更点2}
...

{如果没有方案文档}
_本会话未包含正式的实施方案文档_

---

## 💡 关键决策

{遍历 keyDecisions}

### 决策 {序号} - {格式化时间}

**问题**: {decision.question}

**选择**: {decision.answer}

{如果有多个选项，展示所有选项}
_可选项_:
- {选项1描述}
- {选项2描述}
...

---
{如果没有关键决策}
_本会话未记录关键决策_

---

## 📂 文件变更记录

{遍历 filesModified，按类型分组}

### ✨ 已创建文件 ({创建文件数量})

{筛选 operation === "created"}
- `{相对路径1}` - {格式化时间}
- `{相对路径2}` - {格式化时间}
...

### 📝 已修改文件 ({修改文件数量})

{筛选 operation === "modified"}
- `{相对路径1}` - {格式化时间}
- `{相对路径2}` - {格式化时间}
...

### 🗑️ 已删除文件 ({删除文件数量})

{筛选 operation === "deleted"}
- `{相对路径1}` - {格式化时间}
...

{如果没有文件变更}
_本会话未修改任何文件_

---

## 🎯 后续行动建议

根据当前进度和待办任务，建议：

{自动生成建议，基于：}
1. 继续完成进行中的任务：
   {如果有 in_progress 任务}
   - {任务内容} - 当前状态：{activeForm}

2. 开始下一个待办任务：
   {取第一个 pending 任务}
   - {任务内容}

3. 验证已完成功能：
   {基于已完成的任务生成验证建议}
   - 测试 {相关功能}
   - 验证 {相关文件} 的正确性

4. 更新文档：
   {如果有文档相关的待办}
   - 完善 {文档名称}

{如果所有任务都已完成}
🎉 **恭喜！所有任务已完成！**

建议：
- 进行全面测试
- 更新项目文档
- 准备提交代码

---

## 📚 详细对话记录

完整的对话记录已保存在：

{SESSION_DIR}/details.jsonl


如需查看完整上下文，可以：
1. 使用文本编辑器打开上述文件
2. 使用 `cat` 命令查看：`cat {SESSION_DIR}/details.jsonl`
3. 使用 `jq` 格式化查看：`jq -r '.content' {SESSION_DIR}/details.jsonl`

---

<!--
═══════════════════════════════════════════════════════════════
🤖 FOR AI ASSISTANT ONLY - 仅供 AI 助手参考
═══════════════════════════════════════════════════════════════

本部分专门提供给 AI 助手，用户通常不需要查看此内容。

## 📁 完整对话数据源

**文件路径**: `{SESSION_DIR}/details.jsonl`

**数据格式**: JSONL (每行一个 JSON 对象)

**包含内容**:
- 所有用户消息 (type: "user")
- 所有 AI 响应 (type: "assistant")
- 所有工具调用 (type: "tool_use")
- 时间戳和元数据

## 🎯 何时读取完整对话

**建议读取的场景**:
1. ✅ 用户要求了解详细的讨论过程
2. ✅ 需要理解某个决策的完整背景
3. ✅ 任务涉及之前讨论的具体技术细节
4. ✅ 当前摘要信息不足以完成任务
5. ✅ 需要验证之前的某个结论或约定

**无需读取的场景**:
1. ❌ 只需要了解当前进度状态
2. ❌ 只需要知道下一步做什么
3. ❌ 摘要信息已经足够清晰
4. ❌ 任务是全新的，不依赖历史细节

## 📖 如何读取

使用 Read 工具读取完整文件：

Read tool: {SESSION_DIR}/details.jsonl


**注意事项**:
- 文件可能较大 (50KB - 10MB)，建议只在必要时读取
- 可以使用 Grep 工具搜索特定内容而非读取全部
- 如果只需要某类消息，可以用 Python 过滤

## 💡 智能决策建议

**第一步**: 评估摘要信息是否充足
- 如果摘要中的进度、决策、文件变更信息足够 → 直接使用摘要
- 如果用户询问"为什么这样决定"、"当时怎么讨论的" → 读取完整对话

**第二步**: 按需读取
- 如果决定读取，使用 Read 工具读取 details.jsonl
- 可以结合 Grep 搜索关键词，避免读取全部

**第三步**: 向用户解释
- 如果读取了完整对话，告知用户："我查看了完整的对话记录..."
- 这样用户知道你的决策基于完整信息

═══════════════════════════════════════════════════════════════
END OF AI ASSISTANT SECTION
═══════════════════════════════════════════════════════════════
-->

---

## 🔗 如何继续工作

### 方式 1：粘贴到新会话（推荐）

1. 复制上述内容（从"工作概述"到"后续行动建议"）
2. 在新 Claude Code 会话中粘贴
3. 添加你的新请求，例如：

继续之前的工作，{描述你要做什么}


### 方式 2：引用导出文件

在新会话中输入：

@./.claude-sessions/exports/{timestamp}-{uuid}.md

继续之前的工作，{描述你要做什么}


### 方式 3：手动选择性恢复

只复制你需要的部分：
- 如果只需要恢复进度：复制"项目进度"部分
- 如果需要方案细节：复制"实施方案"部分
- 如果需要决策上下文：复制"关键决策"部分

---

**导出时间**: {当前时间}
**导出工具**: session-manager v1.0.0

🤖 Generated by session-manager plugin

写入导出文件

# 使用 Write 工具写入
Write tool: $EXPORT_FILE

6. 展示结果

输出格式化的成功信息：

✅ 会话已成功导出！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📄 导出信息
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
会话标题: {标题}
项目名称: {项目名}
会话时间: {开始时间} - {结束时间}
进度状态: {已完成}/{总数} 已完成

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 文件位置（项目本地）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
导出文件: ./.claude-sessions/exports/{timestamp}-{uuid}.md
文件大小: {文件大小}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 如何继续工作
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

方式 1（推荐）: 在新会话中输入

  继续之前的工作：{会话标题}

  @~/.claude/session-exports/{timestamp}-{uuid}.md

  {描述你要继续做的具体工作}

方式 2: 打开导出文件并复制相关内容

  cat ~/.claude/session-exports/{timestamp}-{uuid}.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 后续建议行动
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{列出 2-3 个具体的后续行动建议}
1. {建议1}
2. {建议2}
3. {建议3}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 Generated by session-manager plugin

错误处理

场景 1: 没有已保存的会话

❌ 错误：未找到已保存的会话

存储目录: ~/.claude/session-summary/

可能原因：
1. 还没有保存过任何会话
2. 存储目录被删除或移动
3. 权限问题导致无法访问

建议：
- 使用 /session-manager:save 保存当前会话
- 检查存储目录是否存在：ls -la ~/.claude/session-summary/
- 检查目录权限

场景 2: 摘要文件读取失败

❌ 错误：无法读取会话摘要文件

文件: {文件路径}
错误: {错误信息}

可能原因：
1. 文件已损坏
2. 文件权限问题
3. JSON 格式错误

建议：
- 尝试读取其他会话
- 检查文件完整性：cat {文件路径}
- 如果多个文件都无法读取，可能需要重新保存会话

场景 3: 搜索无结果

ℹ️ 未找到匹配的会话

搜索条件: {条件描述}

建议：
- 尝试使用不同的关键词
- 检查时间范围是否过窄
- 查看所有会话：选择"返回会话列表"

场景 4: 导出文件创建失败

❌ 错误：无法创建导出文件

目标文件: {文件路径}
错误: {错误信息}

可能原因：
1. 磁盘空间不足
2. 导出目录不存在或无写入权限
3. 文件名包含非法字符

建议：
- 检查磁盘空间：df -h
- 创建导出目录：mkdir -p ~/.claude/session-exports
- 检查目录权限：ls -ld ~/.claude/session-exports

交互流程示例

示例 1: 快速选择最近的会话

用户: /session-manager:continue

系统: 显示最近 10 个会话列表

用户: 选择第二个会话

系统: ✅ 会话已成功导出！
      导出文件: ~/.claude/session-exports/2025-11-03-16-30-abc123.md

示例 2: 按项目搜索

用户: /session-manager:continue

系统: 显示最近 10 个会话列表

用户: 选择"搜索和过滤"

系统: 显示搜索选项

用户: 选择"按项目过滤"

系统: 显示所有项目列表
      - my-app (3 个会话)
      - another-project (5 个会话)

用户: 选择"my-app"

系统: 显示 my-app 的 3 个会话

用户: 选择第一个

系统: ✅ 会话已成功导出！

示例 3: 按关键词搜索

用户: /session-manager:continue

系统: 显示最近 10 个会话列表

用户: 选择"搜索和过滤"

系统: 显示搜索选项

用户: 选择"按关键词搜索"

系统: 请输入搜索关键词

用户: 输入"认证"（通过 Other 选项）

系统: 找到 2 个匹配的会话
      - [2025-11-03] my-app - 实现用户认证功能
      - [2025-11-02] api-service - 添加 JWT 认证

用户: 选择第一个

系统: ✅ 会话已成功导出！

跨平台兼容性

路径处理

✅ 使用 $HOME 而非 ~
✅ 使用绝对路径
✅ 使用 find 命令递归搜索（标准工具）

JSON 处理

✅ 优先使用 Python 3（系统自带）
✅ 处理 UTF-8 编码
✅ 使用 ensure_ascii=False 保留中文

时间处理

✅ 解析 ISO 8601 格式
✅ 格式化为本地可读格式
✅ 计算时间范围（今天、本周等）

文件操作

✅ 使用 mkdir -p 创建目录
✅ 使用 date 生成时间戳
✅ 使用 cat 展示文件内容

性能优化

会话列表加载

只读取 summary.json（不读取 details.jsonl）
默认只展示最近 10 个（减少交互负担）
按需加载更多（"查看更多"选项）

搜索性能

在内存中进行搜索（Python 脚本）
不使用磁盘索引（保持简单）
对于大量会话（>100），可能需要 2-3 秒

导出文件生成

一次性生成完整内容
不进行额外的文件读取
使用模板字符串拼接

使用技巧

最佳实践

定期保存会话
- 完成重要阶段后立即保存
- 结束工作前保存当天进度
使用清晰的标题
- 第一条消息描述清楚要做什么
- 便于后续搜索和识别
利用搜索功能
- 项目较多时，先按项目过滤
- 记不清时间时，使用关键词搜索
选择性恢复
- 不一定要恢复全部内容
- 只复制需要的部分到新会话
保持存储整洁
- 定期清理旧会话（手动）
- 备份重要会话

高级用法

多项目管理:

# 在不同项目间快速切换
cd ~/project-a
/session-manager:continue  # 恢复 project-a 的工作

cd ~/project-b
/session-manager:continue  # 恢复 project-b 的工作

长期项目跟踪:

# 每周五保存
/session-manager:save

# 下周一恢复，按时间过滤"本周"
/session-manager:continue
→ 选择"按时间范围" → "本周"

任务切换:

# 紧急任务插入时
/session-manager:save  # 保存当前任务

# 完成紧急任务后
/session-manager:continue  # 恢复之前的任务

注意事项

⚠️ 搜索只在摘要数据中进行（不搜索详细日志）
⚠️ 导出文件不会自动清理，需要手动管理
⚠️ 大量会话（>50）时，列表加载可能稍慢
⚠️ 导出文件可能包含敏感信息，注意安全

未来增强

以下功能计划在未来版本中添加：

会话标签功能
会话笔记添加
自动清理旧会话
导出格式自定义
会话对比功能
团队共享支持

🤖 Generated with Claude Code

21 KiB Raw Permalink Blame History Unescape Escape