858 lines
21 KiB
Markdown
858 lines
21 KiB
Markdown
---
|
||
allowed-tools: Read, Write, AskUserQuestion, Bash, Grep, Glob
|
||
description: 搜索并继续之前保存的会话
|
||
---
|
||
|
||
智能搜索已保存的会话，支持按项目、时间、关键词过滤，选择后生成 Markdown 格式的会话摘要供在新会话中继续工作。
|
||
|
||
**核心特性**:
|
||
- 🔍 **智能搜索**: 支持按项目、时间范围、关键词搜索
|
||
- 📋 **可视化列表**: 清晰展示会话信息（标题、时间、进度）
|
||
- 📝 **完整导出**: 生成包含进度、方案、决策的 Markdown 文档
|
||
- 💡 **行动建议**: 自动生成后续工作建议
|
||
|
||
---
|
||
|
||
## 执行步骤
|
||
|
||
### 1. 扫描已保存的会话
|
||
|
||
a. 检查存储目录是否存在（项目本地）
|
||
```bash
|
||
SUMMARY_BASE="./.claude-sessions/summaries"
|
||
|
||
if [ ! -d "$SUMMARY_BASE" ]; then
|
||
echo "❌ 错误：未找到已保存的会话"
|
||
echo "提示：使用 /session-manager:save 保存当前会话"
|
||
echo "📁 会话将保存在项目目录: ./.claude-sessions/"
|
||
exit 1
|
||
fi
|
||
```
|
||
|
||
b. 查找所有摘要文件（项目本地）
|
||
```bash
|
||
# 查找当前项目的所有会话摘要
|
||
find "$SUMMARY_BASE" -maxdepth 2 -name "summary.json" -type f
|
||
```
|
||
|
||
c. 读取并解析所有摘要文件
|
||
- 使用 Read 工具读取每个 summary.json
|
||
- 提取关键信息用于展示：
|
||
* 会话标题
|
||
* 项目名称
|
||
* 保存时间
|
||
* 进度信息（已完成/总数）
|
||
* 会话 ID 和存储路径
|
||
|
||
d. 按保存时间排序（最新的在前）
|
||
```bash
|
||
# 使用 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 展示列表
|
||
```yaml
|
||
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. 提供搜索选项
|
||
```yaml
|
||
使用 AskUserQuestion:
|
||
question: "选择搜索条件："
|
||
header: "搜索选项"
|
||
multiSelect: false
|
||
options:
|
||
- label: "按项目过滤"
|
||
description: "只显示特定项目的会话"
|
||
|
||
- label: "按时间范围"
|
||
description: "选择时间范围（今天、本周、本月、自定义）"
|
||
|
||
- label: "按关键词搜索"
|
||
description: "在标题和描述中搜索关键词"
|
||
|
||
- label: "返回会话列表"
|
||
description: "返回主列表"
|
||
```
|
||
|
||
#### 场景 A: 按项目过滤
|
||
|
||
1. 提取所有唯一的项目名称
|
||
```python
|
||
projects = list(set(s['projectName'] for s in sessions))
|
||
projects.sort()
|
||
```
|
||
|
||
2. 展示项目列表供选择
|
||
```yaml
|
||
question: "选择项目："
|
||
header: "项目过滤"
|
||
multiSelect: false
|
||
options:
|
||
- label: "项目名称 1"
|
||
description: "{该项目的会话数} 个会话"
|
||
- label: "项目名称 2"
|
||
description: "{该项目的会话数} 个会话"
|
||
...
|
||
```
|
||
|
||
3. 过滤并展示该项目的会话列表
|
||
|
||
#### 场景 B: 按时间范围
|
||
|
||
1. 提供时间范围选项
|
||
```yaml
|
||
question: "选择时间范围："
|
||
header: "时间过滤"
|
||
multiSelect: false
|
||
options:
|
||
- label: "今天"
|
||
description: "只显示今天保存的会话"
|
||
|
||
- label: "本周"
|
||
description: "显示本周保存的会话"
|
||
|
||
- label: "本月"
|
||
description: "显示本月保存的会话"
|
||
|
||
- label: "最近 7 天"
|
||
description: "显示最近 7 天的会话"
|
||
|
||
- label: "最近 30 天"
|
||
description: "显示最近 30 天的会话"
|
||
```
|
||
|
||
2. 根据选择过滤会话
|
||
```python
|
||
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]
|
||
```
|
||
|
||
3. 展示过滤后的会话列表
|
||
|
||
#### 场景 C: 按关键词搜索
|
||
|
||
1. 询问用户输入关键词
|
||
```yaml
|
||
question: "请输入搜索关键词："
|
||
header: "关键词搜索"
|
||
multiSelect: false
|
||
options:
|
||
- label: "输入关键词"
|
||
description: "在标题、描述、关键词中搜索"
|
||
```
|
||
|
||
2. 从用户输入中提取关键词（使用 Other 选项）
|
||
|
||
3. 在会话数据中搜索
|
||
```python
|
||
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
|
||
```
|
||
|
||
4. 展示搜索结果
|
||
- 如果找到 0 个：提示未找到，返回主列表
|
||
- 如果找到 1-10 个：直接展示
|
||
- 如果找到 >10 个：展示前 10 个 + "查看更多"
|
||
|
||
### 4. 用户选择会话
|
||
|
||
#### 提取会话数据
|
||
|
||
1. 根据用户选择，定位到对应的 summary.json
|
||
|
||
2. 读取完整的摘要数据
|
||
```bash
|
||
# 读取 summary.json
|
||
Read tool: {SESSION_DIR}/summary.json
|
||
```
|
||
|
||
3. 可选：读取详细日志（如果需要提取更多上下文）
|
||
```bash
|
||
# 读取 details.jsonl（可选）
|
||
Read tool: {SESSION_DIR}/details.jsonl
|
||
```
|
||
|
||
### 5. 生成导出文件
|
||
|
||
#### 创建导出目录（项目本地）
|
||
```bash
|
||
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 内容
|
||
|
||
使用以下模板生成导出文件：
|
||
|
||
```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
|
||
```
|
||
|
||
#### 写入导出文件
|
||
|
||
```bash
|
||
# 使用 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 秒
|
||
|
||
### 导出文件生成
|
||
- 一次性生成完整内容
|
||
- 不进行额外的文件读取
|
||
- 使用模板字符串拼接
|
||
|
||
---
|
||
|
||
## 使用技巧
|
||
|
||
### 最佳实践
|
||
|
||
1. **定期保存会话**
|
||
- 完成重要阶段后立即保存
|
||
- 结束工作前保存当天进度
|
||
|
||
2. **使用清晰的标题**
|
||
- 第一条消息描述清楚要做什么
|
||
- 便于后续搜索和识别
|
||
|
||
3. **利用搜索功能**
|
||
- 项目较多时，先按项目过滤
|
||
- 记不清时间时，使用关键词搜索
|
||
|
||
4. **选择性恢复**
|
||
- 不一定要恢复全部内容
|
||
- 只复制需要的部分到新会话
|
||
|
||
5. **保持存储整洁**
|
||
- 定期清理旧会话（手动）
|
||
- 备份重要会话
|
||
|
||
### 高级用法
|
||
|
||
**多项目管理**:
|
||
```bash
|
||
# 在不同项目间快速切换
|
||
cd ~/project-a
|
||
/session-manager:continue # 恢复 project-a 的工作
|
||
|
||
cd ~/project-b
|
||
/session-manager:continue # 恢复 project-b 的工作
|
||
```
|
||
|
||
**长期项目跟踪**:
|
||
```bash
|
||
# 每周五保存
|
||
/session-manager:save
|
||
|
||
# 下周一恢复，按时间过滤"本周"
|
||
/session-manager:continue
|
||
→ 选择"按时间范围" → "本周"
|
||
```
|
||
|
||
**任务切换**:
|
||
```bash
|
||
# 紧急任务插入时
|
||
/session-manager:save # 保存当前任务
|
||
|
||
# 完成紧急任务后
|
||
/session-manager:continue # 恢复之前的任务
|
||
```
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
- ⚠️ 搜索只在摘要数据中进行（不搜索详细日志）
|
||
- ⚠️ 导出文件不会自动清理，需要手动管理
|
||
- ⚠️ 大量会话（>50）时，列表加载可能稍慢
|
||
- ⚠️ 导出文件可能包含敏感信息，注意安全
|
||
|
||
---
|
||
|
||
## 未来增强
|
||
|
||
以下功能计划在未来版本中添加：
|
||
|
||
- [ ] 会话标签功能
|
||
- [ ] 会话笔记添加
|
||
- [ ] 自动清理旧会话
|
||
- [ ] 导出格式自定义
|
||
- [ ] 会话对比功能
|
||
- [ ] 团队共享支持
|
||
|
||
---
|
||
|
||
🤖 Generated with Claude Code
|