Cursor对话历史自动保存方案-SpecStory使用指南

Cursor对话历史自动保存方案 - SpecStory

一、简介

SpecStory是一个专门为Cursor编辑器设计的对话历史记录保存工具。通过本指南，您可以快速学会如何使用SpecStory来自动保存与AI助手的对话内容。

二、安装步骤

1. 下载安装包

您有两种方式下载安装包：

1. 直接下载：

   • 访问下载链接直接下载最新版本

2. 官网下载：

   • 访问SpecStory官网
   • 点击"Download Extension"下载最新版本

2. 在Cursor中安装

您可以选择以下两种安装方式之一：

方式一：命令面板安装

1. 打开Cursor编辑器
2. 按下快捷键 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（Mac）打开命令面板
3. 输入并选择 Extensions: Install from VSIX...
4. 选择下载好的specstory-vscode-latest.vsix文件
5. 等待安装完成

方式二：拖拽安装

1. 打开Cursor编辑器
2. 点击左侧扩展图标（或按 Ctrl+Shift+X）打开扩展页面
3. 直接将下载好的specstory-vscode-latest.vsix文件拖入扩展页面
4. 等待安装完成

3. 验证安装

1. 再次打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
2. 输入"SpecStory"
3. 如果能看到相关命令，说明安装成功

三、快速上手

1. 开启自动保存（默认已开启）

1. 打开命令面板

2. 输入 SpecStory: Auto Save

3. 点击启用自动保存功能

2. 查看保存的对话

1. 在Cursor中打开任意项目
2. 左侧资源管理器中会出现 .specstory 文件夹
3. 所有对话历史都保存在 .specstory/history 目录中
4. 对话内容以Markdown格式保存，可直接查看和编辑

3. 分享对话

1. 在对话完成后，打开命令面板
2. 输入 SpecStory: Share Composer and Chat History
3. 获取分享链接，可发送给其他人查看

四、常用功能

1. 快捷键操作

• Ctrl+S（Windows）或 Cmd+S（Mac）：手动保存当前对话
• Ctrl+Shift+F（Windows）或 Cmd+Shift+F（Mac）：搜索历史对话

2. 对话管理

• 在.specstory/history目录下可以看到所有保存的对话
• 每个对话都有唯一的时间戳标识
• 可以直接用文本编辑器打开查看内容

3. 导出功能

1. 在命令面板中输入 SpecStory: Save Composer and Chat History
2. 选择导出格式（Markdown/HTML/PDF）
3. 选择保存位置

五、使用技巧

1. 对话整理

• 给重要对话添加标题：在对话开始前先输入标题
• 使用标签分类：在对话中使用 #标签 来标记主题
• 定期清理：删除不需要的对话记录

2. 搜索技巧

• 使用关键词搜索：支持模糊匹配
• 按日期搜索：可以指定时间范围
• 按标签搜索：使用 #标签 格式

3. 团队协作

• 将.specstory文件夹加入版本控制，方便团队共享对话内容
• 如果不想分享个人对话历史，可以将.specstory添加到.gitignore文件中
• 团队成员可以共享和复用对话内容
• 通过分享链接快速分享特定对话

六、常见问题解决

1. 安装失败

• 确保Cursor版本为最新
• 尝试重启Cursor后重新安装
• 检查是否有权限问题

2. 自动保存不工作

• 检查是否正确开启了自动保存功能
• 确认.specstory文件夹存在且有写入权限
• 重启Cursor尝试解决

3. 找不到历史对话

• 检查默认保存路径（.specstory/history）
• 确认对话是否已经成功保存
• 使用搜索功能查找

七、获取帮助

• 访问SpecStory官方文档
• 在GitHub上提交Issue
• 加入Slack社区获取支持

记住：SpecStory会自动保存您的每一次对话，让您专注于开发，无需担心对话内容丢失。如果遇到问题，可以随时查看官方文档或寻求社区帮助。