跳过主要内容
有时，当您更新 Cline 或某些设置发生变化时，您可能会失去对先前任务的访问权限。本指南将帮助您恢复和重建 Cline 任务历史记录，以便您可以重新访问重要的对话和工作。
大多数情况可以通过运行内置的恢复命令来解决。

​
快速恢复

1

打开命令面板

按 Cmd/Ctrl + Shift + P 打开命令面板。
2

运行恢复命令

输入 “Cline: Reconstruct Task History” 并选择它。
3

确认操作

将出现确认提示。点击 Yes 继续。
4

等待重建

Cline 将扫描您的任务文件夹并重建历史记录索引。
5

验证恢复

检查您的历史记录面板以确认您的任务已恢复。

​
Cline 存储数据的位置

​
存储路径

# macOS
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/
# Windows
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\
# Linux
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/
对于 VS Code Insiders，将 Code 替换为 Code - Insiders。对于 JetBrains IDEs，将 <IDE> 替换为您具体的 IDE 名称（例如，IntelliJIdea2023.3, PyCharm2023.3, WebStorm2023.3）。

​
目录结构

saoudrizwan.claude-dev/
├── state/
│   ├── taskHistory.json          # Main history index
│   └── taskHistory.backup.*.json # Backups
├── tasks/
│   └── <task-id>/                # Individual task data
│       ├── api_conversation_history.json
│       ├── ui_messages.json
│       └── task_metadata.json
└── checkpoints/
    └── <workspace-hash>/         # Per-workspace checkpoint storage
        └── .git/                 # Shadow Git repository for snapshots
taskHistory.json 文件只是一个索引。实际的对话数据位于 tasks/ 下的各个任务文件夹中。

​
使用恢复命令

恢复命令会扫描所有任务文件夹并从头开始重建历史记录索引。 它执行的操作：
  1. 备份您当前的 taskHistory.json
  2. 扫描 tasks/ 目录
  3. 从每个任务文件夹读取对话数据
  4. 重新计算 token 使用量和成本
  5. 创建一个新的 taskHistory.json
恢复命令通过读取现有任务文件夹中的数据来重建索引。如果 tasks/ 目录或单个任务文件夹已被永久删除，则无法恢复相关数据。

​
手动恢复

​
从备份恢复

Cline 会自动创建备份。在 state/ 文件夹中查找它们。 
# macOS/Linux
cd ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/state/
ls taskHistory.backup.*.json

# Pick the most recent one and restore it
cp taskHistory.backup.1234567890.json taskHistory.json

​
迁移到新机器

切换到新电脑？您可以带走所有的 Cline 对话。无论您使用的是 VS Code 还是 JetBrains IDE，过程都是一样的。
1

定位并复制您的 Cline 数据

在您的旧机器上，使用上面的存储路径找到 saoudrizwan.claude-dev 文件夹并复制整个文件夹。
2

设置您的新机器

在您的新机器上，安装您的 IDE（VS Code 或 JetBrains）和 Cline 扩展。
3

关闭您的 IDE

在继续之前，确保您的 IDE 已完全关闭。
4

传输您的数据

将 saoudrizwan.claude-dev 文件夹粘贴到新机器上相同的存储路径。
5

启动并验证

打开您的 IDE。您的任务历史记录现在应该出现在 Cline 中。
数据格式在不同操作系统之间是相同的——跨平台迁移（例如，Windows → macOS）无需任何额外步骤即可工作。

​
常见问题

以下是一些常见问题及其解决方案

​
VS Code 更新后历史记录为空

从命令面板运行 “Cline: Reconstruct Task History”。如果不起作用，请检查是否有备份文件可以恢复。

​
重新安装 VS Code 后历史记录丢失

VS Code 通常在卸载时保留扩展数据。只需重新安装 Cline 并运行恢复命令即可。

​
“未找到任务”错误

当 tasks/ 文件夹为空或丢失时会发生此情况。常见原因：
  • VS Code 数据被完全清除
  • 您正在查看错误的 VS Code 安装（标准版 vs Insiders 版）
  • 文件夹被手动删除
检查您的 IDE 的正确存储路径并验证文件夹是否存在。

​
恢复运行但缺少部分任务

损坏的任务文件夹在恢复期间会被跳过。命令将显示恢复了多少任务以及跳过了多少任务。检查错误消息以了解哪些任务无法恢复的详细信息。

​
需要额外帮助？

如果您需要帮助，您可以：
  1. 在 cline/cline打开一个 GitHub issue
  2. 在我们的 Discord 服务器上寻求帮助 - 加入我们的社区以获得更快的支持
报告问题时，请包括：
  • 您的操作系统和 IDE（VS Code 或 JetBrains IDE 名称/版本）
  • Cline 版本
  • 数据丢失前发生了什么
  • 任何错误消息
  • 任务导出数据：包含受影响任务文件夹中的相关 JSON 文件（例如 api_conversation_history.json、ui_messages.json、task_metadata.json），以帮助我们了解出了什么问题