Skip to content

数据备份、升级与迁移 ​

数据不全在同一个文件中。区分会话数据库、知识库、前端偏好、凭据与项目文件。

数据位置 ​

Desktop 与 CLI(dcl)共用同一个数据目录,默认是用户主目录下的 ~/.deepseek-code(Windows 为 %USERPROFILE%\.deepseek-code)。其中保存供应商配置 config.json、用户设置 settings.json、会话数据库 deepseek_code.db、MCP 配置 mcp-servers.json、技能 skills/、知识库 knowledge/、本地记忆 memory.sqlite3、上传文件 uploads/、App Studio 项目 app-studio/ 和多代理编排设置 orchestrator.toml(没有这个文件时使用默认值)等。Rust 启动日志会打印实际使用的目录。

旧版本把上传文件、App Studio 项目和部分记忆放在系统本地数据目录下的 claude-desktop/ 中(Linux 为 ~/.local/share/claude-desktop,Windows 为 %LOCALAPPDATA%\claude-desktop)。新版本不再读取那里,也不会自动迁移;需要旧文件时手动复制到数据目录对应的子目录。

设置环境变量 DEEPSEEK_CODE_DATA_DIR 可以改用其他目录,CLI 还可以用 --data-dir。

~/.deepseek-code 中的 settings.json 可以配置 hooks,因此模型编辑该目录下的文件需要审批;workspaces/ 子目录是普通会话工作区,不受此限制。

偏好和部分兼容配置在 localStorage,WebView 与浏览器彼此独立。安全存储凭据不能假定通过复制数据库迁移。

项目文件仍在各自磁盘目录,MemEx 等服务数据由其管理。

备份步骤 ​

  1. 结束任务并退出应用,确认后端不再写入。
  2. 备份实际应用数据目录,不只复制可能正在写入的 SQLite 主文件。
  3. 单独备份项目文件、外部服务数据和配置说明。
  4. 记录版本、运行模式、供应商地址与模型 ID,凭据按自己的安全方式保管。
  5. 保留原备份,用副本验证恢复后的会话和知识条目。

更新 ​

备份后查看维护者的版本说明,再安装或构建新版本。启动后验证会话、供应商、项目与关键扩展。

数据库迁移可能影响旧版本兼容性。回退不能只换回旧程序就假定数据可读,应使用兼容的数据备份。

迁移 ​

新机器安装相同或兼容版本,确认数据目录。退出应用后按支持方式恢复,再检查工作路径、MCP 可执行程序、环境变量和原生凭据。

用简单对话与只读工具验收后再继续工作。

日志 ​

日志写在进程工作目录下的 logs,启动方式可能改变位置。反馈时提供版本、模式、复现步骤和相关错误,去掉真实 Key 与无关个人内容。

独立文档站 · Desktop(Tauri 2)与 CLI(Rust)