# 使用指南

## 概述

MCP Session Saver 是一个模型上下文协议（MCP）服务，用于将会话记录保存为Markdown文件。它会自动按照**IDE名称、日期、会话描述**组织文件结构。

## 🎯 如何正确使用 MCP 工具

### MCP 工具的工作原理

MCP（Model Context Protocol）是一个客户端-服务器架构：

```
┌─────────────┐         ┌──────────────────┐         ┌─────────────┐
│             │         │                  │         │             │
│  AI IDE     │ ◄─────► │  MCP 服务器      │ ◄─────► │  文件系统   │
│ (Qoder等)   │  JSON   │ (session-saver)  │  I/O    │             │
│             │  RPC    │                  │         │             │
└─────────────┘         └──────────────────┘         └─────────────┘
```

**关键点**：
- ✅ MCP 工具必须通过 **MCP 客户端**（如 Qoder、Claude Desktop）调用
- ✅ 工具在 MCP 服务器中运行，利用所有优化功能（缓存、并发等）
- ❌ 不能直接运行 `index.js` 来保存会话（它只是启动服务器等待连接）

### ✅ 正确的使用方式

#### 方式1：在 AI IDE 中使用（推荐）

**步骤1：配置 MCP 服务**

在 Qoder 的配置文件中添加：

```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["d:\\Server\\www\\_code\\mcp-session-saver\\index.js"]
    }
  }
}
```

**步骤2：重启 IDE**

完全关闭并重新打开 Qoder，让配置生效。

**步骤3：验证工具已加载**

在对话中询问：
```
你有哪些可用的工具？
```

应该能看到 `save_session`、`list_sessions`、`read_session`、`delete_session`、`search_sessions` 等工具。

**步骤4：使用自然语言调用**

直接在对话中说：

```
保存当前会话
```

或更详细：

```
请保存当前会话到默认目录
IDE: Qoder
描述: MCP工具使用指南讨论
```

Qoder 会自动：
1. 识别这是保存会话的请求
2. 调用 `save_session` MCP 工具
3. 工具执行（利用目录缓存、性能优化等）
4. 返回保存结果

#### 方式2：通过编程方式调用（开发/测试）

如果您想测试或通过代码调用 MCP 工具：

**运行示例程序**：
```bash
node example.js
```

这个示例展示了如何：
- 创建 MCP 客户端
- 连接到 session-saver 服务器
- 调用各种工具（save_session、list_sessions 等）
- 处理返回结果

**示例代码片段**：
```javascript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

// 创建客户端并连接
const client = new Client({ name: 'my-client', version: '1.0.0' }, { capabilities: {} });
const transport = new StdioClientTransport({ command: 'node', args: ['index.js'] });
await client.connect(transport);

// 调用工具
const result = await client.request({
  method: 'tools/call',
  params: {
    name: 'save_session',
    arguments: {
      ide_name: 'VSCode',
      session_description: '测试会话',
      content: '# 会话内容...'
    }
  }
});

console.log(result.content[0].text);
```

### ❌ 错误的使用方式

**不要**直接运行服务器文件：
```bash
# ❌ 错误 - 这只会启动服务器等待连接，不会保存任何内容
node index.js
```

**不要**绕过 MCP 直接操作文件：
```javascript
// ❌ 错误 - 这绕过了 MCP 工具的所有优化
import fs from 'fs';
fs.writeFileSync('session.md', content);
```

**原因**：
- 绕过 MCP 工具会失去所有性能优化（目录缓存、并发处理等）
- 无法利用工具的验证和错误处理机制
- 不符合 MCP 协议的设计理念

### 📊 性能优势

使用 MCP 工具的性能优势（v1.3.1）：

| 功能 | 传统方式 | MCP 工具 | 提升 |
|------|---------|---------|------|
| 单次保存 | ~20-50ms | ~1.79ms | **10-28倍** |
| 连续100次保存 | ~5000ms | ~179ms | **28倍** |
| 目录重复创建 | 每次检查 | 缓存避免99% | **避免99次** |
| 吞吐量 | ~50个/秒 | ~558个/秒 | **11倍** |

### 🔧 故障排除

**问题1：IDE 中看不到工具**

检查清单：
- [ ] MCP 配置文件格式正确（JSON 语法）
- [ ] 路径使用绝对路径
- [ ] Node.js 在系统 PATH 中
- [ ] 已完全重启 IDE

解决方案：
```bash
# 验证 Node.js 可用
node --version

# 验证工具文件存在
ls d:\Server\www\_code\mcp-session-saver\index.js

# 查看 IDE 的 MCP 日志（如果有）
```

**问题2：调用工具时出错**

常见错误及解决：
```
错误: "路径不能为空"
→ 解决: 配置 MCP_SESSION_BASE_DIR 或传入 base_dir 参数

错误: "路径不能包含 '..' 字符"
→ 解决: 使用绝对路径或不包含 .. 的相对路径

错误: "会话内容过大"
→ 解决: 内容限制为 10MB，请分割大型会话
```

**问题3：性能不如预期**

检查：
- 确保使用的是 v1.3.1 或更高版本（包含性能优化）
- 连续保存到同一目录时性能最佳（目录缓存生效）
- 查看是否有磁盘 I/O 瓶颈

### 新特性！

- ✨ **配置文件支持**: 通过 `config.json` 一次配置默认路径，多次使用无需重复指定
- ✨ **智能默认值**: 未配置时自动使用 `~/Documents/ide_sessions`
- ✨ **参数可选**: `base_dir` 参数变为可选，使用更简单

## 快速开始

### 安装依赖

```bash
cd d:\Server\www\_code\mcp_save_session
npm install
```

### 测试功能

运行测试脚本验证服务是否正常工作：

```bash
npm test
```

测试脚本会：
- 创建示例会话文件
- 保存3个测试会话（VSCode、Cursor、Windsurf）
- 列出所有保存的会话
- 显示详细的会话信息

**预期输出：**
```
=== MCP Session Saver 功能测试 ===

测试1: 保存VSCode会话...
✅ 已保存到: test_sessions\VSCode\2025-12-15\10-30-00_实现用户登录功能.md

测试2: 保存Cursor会话...
✅ 已保存到: test_sessions\Cursor\2025-12-15\10-30-00_优化数据库查询性能.md

测试3: 保存Windsurf会话...
✅ 已保存到: test_sessions\Windsurf\2025-12-15\14-20-00_用户模块代码审查.md

测试4: 列出所有会话...
找到 3 个会话记录:
...
```

### 配置默认保存路径（可选但推荐）

有三种方式可以配置默认保存路径，按优先级从高到低：

#### 方法1：在MCP配置文件中设置环境变量（推荐）

在MCP客户端的配置文件中，通过 `env` 字段设置环境变量 `MCP_SESSION_BASE_DIR`。

**Windows 系统：**
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["d:\\Server\\www\\_code\\mcp_save_session\\index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "D:\\Users\\YourName\\Documents\\ide_sessions"
      }
    }
  }
}
```

**macOS 系统：**
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["/path/to/mcp_save_session/index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "/Users/yourname/Documents/ide_sessions"
      }
    }
  }
}
```
或者使用快捷路径：
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["/path/to/mcp_save_session/index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "~/Documents/ide_sessions"
      }
    }
  }
}
```

**Linux 系统：**
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["/path/to/mcp_save_session/index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "/home/yourname/Documents/ide_sessions"
      }
    }
  }
}
```
或者使用快捷路径：
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["/path/to/mcp_save_session/index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "~/Documents/ide_sessions"
      }
    }
  }
}
```

**此方法的优势：**
- ✅ 配置集中管理，与MCP服务配置在一起
- ✅ 优先级高于config.json
- ✅ 不需要单独创建config.json文件
- ✅ 重启MCP客户端后立即生效

#### 方法2：使用config.json配置文件

在项目根目录创建 `config.json` 文件来配置默认会话保存路径。

**步骤1: 创建配置文件**

在项目根目录下创建 `config.json`，根据操作系统选择相应格式：

**Windows 系统:**
```json
{
  "defaultBaseDir": "D:\\Users\\YourName\\Documents\\ide_sessions"
}
```
⚠️ **注意**: Windows 路径必须使用双反斜杠 `\\` 转义

**macOS 系统:**
```json
{
  "defaultBaseDir": "/Users/yourname/Documents/ide_sessions"
}
```
或者使用快捷路径：
```json
{
  "defaultBaseDir": "~/Documents/ide_sessions"
}
```

**Linux 系统:**
```json
{
  "defaultBaseDir": "/home/yourname/Documents/ide_sessions"
}
```
或者使用快捷路径：
```json
{
  "defaultBaseDir": "~/Documents/ide_sessions"
}
```

**此方法的优势：**
- ✅ 不依赖MCP客户端配置
- ✅ 可以独立管理
- ✅ 适合开发和测试环境

**步骤2: 路径格式说明**

| 操作系统 | 路径分隔符 | 示例 | 支持 ~ |
|----------|----------|------|----------|
| Windows  | `\\` (双反斜杠) | `D:\\Users\\...` | ✗ |
| macOS    | `/` (正斜杠) | `/Users/...` | ✓ |
| Linux    | `/` (正斜杠) | `/home/...` | ✓ |

**配置优先级:**
```
调用时指定的 base_dir > 环境变量 MCP_SESSION_BASE_DIR > config.json 中的配置 > 默认路径 ~/Documents/ide_sessions
```

**配置方法对比：**

| 方法 | 优先级 | 配置位置 | 适用场景 |
|------|---------|----------|----------|
| base_dir参数 | 最高 | 调用时传入 | 临时指定不同路径 |
| 环境变量MCP_SESSION_BASE_DIR | 高 | MCP配置文件的env字段 | 生产环境推荐 |
| config.json | 中 | 项目根目录 | 开发测试环境 |
| 默认路径 | 最低 | ~/Documents/ide_sessions | 备用方案 |

**配置后的优势:**
- ✅ 使用工具时无需每次指定 `base_dir`
- ✅ 统一管理所有会话保存位置
- ✅ 更简洁的API调用
- ✅ 仍可在需要时临时指定其他路径

## 运行和部署

### 运行方式说明

MCP服务通过**标准输入/输出（stdio）**与客户端通信，不适合直接单独运行。必须通过支持MCP协议的客户端来使用。

#### ❌ 不推荐：直接运行

```bash
node index.js
```

直接运行只会启动服务并等待stdio输入，无法直接交互使用。

#### ✅ 推荐：通过MCP客户端运行

将服务配置到MCP客户端中，客户端会自动启动和管理服务进程。

### 部署到MCP客户端

#### 方法1：Claude Desktop（推荐）

**步骤1：找到配置文件**

- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
  - 完整路径示例: `C:\Users\你的用户名\AppData\Roaming\Claude\claude_desktop_config.json`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

**步骤2：编辑配置文件**

如果文件不存在，创建一个新的JSON文件：

```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["d:\\Server\\www\\_code\\mcp_save_session\\index.js"]
    }
  }
}
```

**注意事项：**
- 使用**绝对路径**指向 `index.js`
- Windows路径需要使用双反斜杠 `\\` 转义
- 确保Node.js在系统PATH中

**步骤3：重启Claude Desktop**

完全关闭Claude Desktop并重新打开，服务会自动加载。

**步骤4：验证服务**

在Claude对话中询问：
```
你有哪些可用的工具？
```

如果看到 `save_session` 和 `list_sessions` 工具，说明配置成功！

#### 方法2：Cline（VSCode插件）

**步骤1：安装Cline插件**

在VSCode扩展市场搜索并安装 `Cline`。

**步骤2：配置MCP服务器**

打开VSCode设置（Ctrl+,），搜索 `Cline`，找到MCP服务器配置项。

或者直接编辑 `settings.json`：

```json
{
  "cline.mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["d:\\Server\\www\\_code\\mcp_save_session\\index.js"]
    }
  }
}
```

**步骤3：重启VSCode**

重新加载窗口或重启VSCode。

#### 方法3：其他MCP客户端

对于其他支持MCP的客户端：

1. 查阅客户端的MCP配置文档
2. 添加服务器配置，指定：
   - 命令: `node`
   - 参数: `["d:\\Server\\www\\_code\\mcp_save_session\\index.js"]`
3. 重启客户端

### 使用示例

配置完成后，在MCP客户端中可以这样使用：

**保存会话：**
```
请帮我保存今天的开发记录：

基础目录: D:\Administrator\Documents\ide_sessions
IDE: Qoder
会话描述: 实现用户登录功能
内容:
# 今日工作
- 完成了用户登录功能
- 修复了3个bug
- 进行了代码审查
```

**查看会话：**
```
请列出我在D:\Administrator\Documents\ide_sessions目录下保存的所有Qoder会话
```

客户端会自动调用相应的MCP工具完成操作。

### 环境要求

- **Node.js**: v16.x 或更高版本
- **npm**: 7.x 或更高版本
- **操作系统**: Windows / macOS / Linux
- **MCP客户端**: Claude Desktop, Cline, 或其他支持MCP的客户端

### 验证部署

**检查清单：**

- [ ] Node.js已安装且在PATH中
- [ ] 已运行 `npm install` 安装依赖
- [ ] 已运行 `npm test` 验证功能正常
- [ ] MCP客户端配置文件已正确编辑
- [ ] 配置中使用了绝对路径
- [ ] 已重启MCP客户端
- [ ] 客户端中可以看到工具列表

**故障排查：**

1. **客户端看不到工具**
   - 检查配置文件语法是否正确（JSON格式）
   - 确认路径是否正确（使用绝对路径）
   - 查看客户端的错误日志
   - 完全重启客户端

2. **Node.js找不到**
   - 确认Node.js已安装：`node --version`
   - 确认Node.js在系统PATH中
   - 或使用Node.js的完整路径作为command

3. **依赖缺失**
   - 运行 `npm install` 安装依赖
   - 检查是否有错误信息

## 目录结构

会话文件按以下层次结构保存：

```
基础目录/
  └── IDE名称/
      └── 日期/
          └── 时间_会话描述.md
```

### 示例

```
D:/Administrator/Documents/ide_sessions/
  ├── VSCode/
  │   ├── 2025-12-15/
  │   │   ├── 10-30-00_实现用户登录功能.md
  │   │   ├── 14-20-15_修复用户注册Bug.md
  │   │   └── 16-45-30_完善错误处理.md
  │   ├── 2025-12-16/
  │   │   └── 09-00-00_代码审查总结.md
  │   └── 2025-12-17/
  │       └── 11-15-00_修复登录Bug.md
  ├── Cursor/
  │   └── 2025-12-15/
  │       ├── 08-30-00_优化数据库查询.md
  │       ├── 13-45-00_生成用户API.md
  │       └── 15-20-00_AI辅助代码重构.md
  └── Windsurf/
      └── 2025-12-15/
          └── 17-00-00_快速修复样式问题.md
```

## 配置MCP客户端

### 1. Claude Desktop

配置文件位置：
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

配置内容：
```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["D:\\path\\to\\mcp_save_session\\index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "D:\\Users\\YourName\\Documents\\ide_sessions"
      }
    }
  }
}
```

**说明：**
- `args`: 指定index.js的绝对路径
- `env.MCP_SESSION_BASE_DIR`: 设置会话保存的默认目录（可选）
- Windows路径需要使用双反斜杠 `\\` 转义

### 2. Cline (VSCode插件)

在Cline的设置中添加MCP服务器：

```json
{
  "mcpServers": {
    "session-saver": {
      "command": "node",
      "args": ["D:\\path\\to\\mcp_save_session\\index.js"],
      "env": {
        "MCP_SESSION_BASE_DIR": "D:\\Users\\YourName\\Documents\\ide_sessions"
      }
    }
  }
}
```

**说明：**
- `env.MCP_SESSION_BASE_DIR`: 可选，设置为你希望的默认保存目录

### 3. 其他MCP客户端

参考相应客户端的文档配置MCP服务器。

## 可用工具

### save_session - 保存会话记录

保存一个会话到Markdown文件。

**参数：**

| 参数名 | 类型 | 必需 | 说明 |
|--------|------|------|------|
| base_dir | string | **否** | 保存会话的基础目录路径（可选，优先级最高。未指定时依次使用：环境变量MCP_SESSION_BASE_DIR > config.json配置 > 默认路径~/Documents/ide_sessions） |
| ide_name | string | **是** | IDE名称（如：VSCode, Cursor, Windsurf） |
| session_description | string | **是** | 会话描述（简短描述会话内容） |
| content | string | **是** | 会话内容（Markdown格式） |
| session_time | string | 否 | 会话时间（ISO 8601格式，默认当前时间） |

**示例调用：**

使用配置文件（简单）：
```json
{
  "ide_name": "VSCode",
  "session_description": "实现用户登录功能",
  "content": "# 今日工作\n\n- 完成用户登录功能\n- 修复3个bug"
}
```

指定特定路径：
```json
{
  "base_dir": "D:\\Administrator\\Documents\\ide_sessions",
  "ide_name": "VSCode",
  "session_description": "实现用户登录功能",
  "content": "# 今日工作\n\n- 完成用户登录功能\n- 修复3个bug"
}
```

**返回：**

```
✅ 会话已保存到: D:\Administrator\Documents\ide_sessions\VSCode\2025-12-15\10-30-00_实现用户登录功能.md
```

### list_sessions - 列出会话记录

列出已保存的会话记录。

**参数：**

| 参数名 | 类型 | 必需 | 说明 |
|--------|------|------|------|
| base_dir | string | **否** | 会话保存的基础目录路径（可选，优先级最高。未指定时依次使用：环境变量MCP_SESSION_BASE_DIR > config.json配置 > 默认路径） |
| ide_name | string | 否 | 筛选指定IDE的会话 |
| date_filter | string | 否 | 筛选指定日期的会话（格式: YYYY-MM-DD） |

**示例调用：**

使用配置文件（简单）：

列出所有会话：
```json
{}
```

列出VSCode的所有会话：
```json
{
  "ide_name": "VSCode"
}
```

列出VSCode在 2025-12-15 的所有会话：
```json
{
  "ide_name": "VSCode",
  "date_filter": "2025-12-15"
}
```

指定特定路径：

列出所有会话：
```json
{
  "base_dir": "D:\\Administrator\\Documents\\ide_sessions"
}
```

列出VSCode的所有会话：
```json
{
  "base_dir": "D:\\Administrator\\Documents\\ide_sessions",
  "ide_name": "VSCode"
}
```

列出VSCode在 2025-12-15 的所有会话：
```json
{
  "base_dir": "D:\\Administrator\\Documents\\ide_sessions",
  "ide_name": "VSCode",
  "date_filter": "2025-12-15"
}
```

**返回示例：**

```
找到 3 个会话记录:

📁 **VSCode** / **2025-12-15** / 10-30-00_实现用户登录功能.md
   路径: D:\Administrator\Documents\ide_sessions\VSCode\2025-12-15\10-30-00_实现用户登录功能.md
   创建时间: 2025/12/15 10:30:00
   大小: 256 字节

📁 **VSCode** / **2025-12-15** / 14-20-15_修复用户注册Bug.md
   路径: D:\Administrator\Documents\ide_sessions\VSCode\2025-12-15\14-20-15_修复用户注册Bug.md
   创建时间: 2025/12/15 14:20:15
   大小: 312 字节

📁 **Cursor** / **2025-12-15** / 08-30-00_优化数据库查询.md
   路径: D:\Administrator\Documents\ide_sessions\Cursor\2025-12-15\08-30-00_优化数据库查询.md
   创建时间: 2025/12/15 08:30:00
   大小: 189 字节
```

## 使用场景

### 1. 保存开发日志

```markdown
# 今日开发工作

## 完成的功能
- 实现了用户注册接口
- 添加了邮箱验证功能
- 完善了错误处理

## 技术细节
- 使用了nodemailer发送邮件
- 实现了验证码过期机制
- 添加了防暴力破解限制

## 遇到的问题
1. SMTP配置问题
   - 解决方案：使用应用专用密码
2. 验证码存储
   - 解决方案：使用Redis存储，设置TTL

## 明天计划
- 完成密码重置功能
- 添加单元测试
```

### 2. 记录代码审查

```markdown
# 代码审查 - 用户模块

## 审查人员
- 主审: 张三
- 协审: 李四

## 审查内容
- controllers/user.js
- services/user.js
- models/user.js

## 发现的问题

### 严重
1. 缺少SQL注入防护
   - 位置：line 45
   - 建议：使用参数化查询

### 一般
1. 日志记录不完整
2. 错误信息暴露敏感信息

## 改进建议
- 统一错误处理
- 添加输入验证
- 完善日志记录
```

### 3. AI对话记录

```markdown
# AI辅助编程对话

## 问题
如何优化大量数据的查询性能？

## AI分析
当前问题：
- 查询涉及多个表联接
- 没有使用索引
- 每次都查询全量数据

## 优化方案
1. 添加复合索引
2. 实现分页查询
3. 使用缓存机制
4. 考虑数据库读写分离

## 实施结果
- 查询速度提升75%
- 内存使用降低40%
- 用户体验明显改善
```

### 4. 学习笔记

```markdown
# React Hooks 学习笔记

## useState
- 用于在函数组件中添加状态
- 返回当前状态和更新函数
- 可以使用多次

示例：
\`\`\`javascript
const [count, setCount] = useState(0);
\`\`\`

## useEffect
- 处理副作用操作
- 可以模拟生命周期方法
- 清理函数防止内存泄漏

示例：
\`\`\`javascript
useEffect(() => {
  // 副作用代码
  return () => {
    // 清理代码
  };
}, [dependencies]);
\`\`\`

## 最佳实践
1. 遵循Hook规则
2. 合理拆分组件
3. 使用自定义Hook复用逻辑
```

## 文件名规范

### 时间戳格式

文件名使用 `YYYY-MM-DD_HH-MM-SS.md` 格式：
- `YYYY`: 四位年份
- `MM`: 两位月份（01-12）
- `DD`: 两位日期（01-31）
- `HH`: 两位小时（00-23）
- `MM`: 两位分钟（00-59）
- `SS`: 两位秒（00-59）

示例：`2025-12-15_14-30-45.md`

### 非法字符处理

IDE名称和会话名中的以下字符会被替换为下划线：
- `<` `>` `:` `"` `/` `\` `|` `?` `*`

示例：
- 输入：`Bug修复: #123`
- 输出：`Bug修复_ #123`

## Markdown文件格式

每个保存的会话文件包含：

```markdown
# [会话名称]

**IDE:** [IDE名称]  
**时间:** [格式化的时间]

---

[会话内容]
```

## 技巧和最佳实践

### 1. 组织会话

建议使用有意义的会话名称，例如：
- `项目开发` - 日常开发工作
- `Bug修复` - 问题修复记录
- `代码审查` - 代码审查笔记
- `AI对话` - 与AI的交互记录
- `学习笔记` - 学习和研究内容

### 2. 内容格式

建议使用Markdown格式组织内容：
- 使用标题分层
- 使用列表整理要点
- 使用代码块展示代码
- 使用表格组织数据

### 3. 定期整理

- 定期清理过期的会话记录
- 归档重要的会话
- 建立命名规范

### 4. 备份

- 定期备份会话目录
- 使用版本控制管理重要会话
- 考虑云端同步

## 故障排除

### 问题1：无法创建目录

**原因：** 权限不足或路径不存在

**解决方案：**
- 确保基础目录路径正确
- 检查目录访问权限
- 使用绝对路径

### 问题2：文件保存失败

**原因：** 磁盘空间不足或文件被占用

**解决方案：**
- 检查磁盘空间
- 确保文件没有被其他程序打开
- 检查文件系统权限

### 问题3：中文乱码

**原因：** 编码问题

**解决方案：**
- 确保使用UTF-8编码
- 使用支持UTF-8的文本编辑器

## 进阶使用

### 自定义时间

可以指定会话的时间，用于批量导入历史记录：

```json
{
  "base_dir": "D:\\Administrator\\Documents\\ide_sessions",
  "ide_name": "VSCode",
  "session_name": "历史记录",
  "content": "...",
  "session_time": "2025-12-01T10:00:00"
}
```

### 批量导入

可以编写脚本批量导入会话记录：

```javascript
const sessions = [
  { ide: 'VSCode', name: '会话1', content: '...', time: '2025-12-01T10:00:00' },
  { ide: 'VSCode', name: '会话2', content: '...', time: '2025-12-02T10:00:00' },
  // ...
];

for (const session of sessions) {
  // 调用save_session工具
}
```

## 常见问题

**Q: 可以修改已保存的会话吗？**
A: 可以，直接编辑对应的Markdown文件即可。

**Q: 如何搜索会话内容？**
A: 可以使用文本编辑器或IDE的全局搜索功能，在会话目录中搜索。

**Q: 可以导出会话吗？**
A: 会话已经是Markdown格式，可以直接使用或转换为其他格式（PDF、HTML等）。

**Q: 支持多个基础目录吗？**
A: 支持，每次调用时指定不同的base_dir即可。

**Q: 如何删除会话？**
A: 直接删除对应的Markdown文件或目录即可。

## 许可证

MIT License