数据存储位置
DesireCore 将所有数据存储在本地文件系统中，不依赖云端服务器存储你的个人数据。
登录账号后，订阅、credit、云端模型列表等账号资源会从 DesireCore 在线服务同步；本地对话、智能体、文件和自定义 API Key 仍保存在本机。
各平台数据根目录
| 平台 | 数据根目录 |
|---|---|
| macOS | ~/.desirecore/ |
| Windows | 用户文件夹\.desirecore\ |
| Linux | ~/.desirecore/ |
~表示用户主目录。例如 macOS 上/Users/你的用户名/.desirecore/
如果设置了 DESIRECORE_HOME，DesireCore 会优先使用该路径。开发版和生产版默认隔离：生产版通常使用 ~/.desirecore/，开发版通常使用 ~/.desirecore-dev/。
目录结构详解
| 目录 | 用途 | 包含内容 | 可否删除 |
|---|---|---|---|
config/ | 全局配置 | 用户设置、算力配置和受保护的本地密钥存储 | 删除后恢复默认设置，并失去本机凭据 |
config/avatar/ | 用户头像 | JPEG/PNG/WebP 格式的头像文件 | 可安全删除 |
agents/ | 智能体本体 | 每个智能体一个子目录（Git 仓库） | 删除后失去智能体数据 |
agents/desirecore/ | 核心智能体 | DesireCore 内置智能体 | 删除后自动重装 |
users/ | 用户数据 | 个人画像、偏好、与各智能体的关系记忆 | 删除后失去个性化数据 |
skills/ | 全局技能 | 所有已安装的全局技能包 | 删除后内置技能自动重装 |
runs/ | 运行记录 | 会话记录、任务回执 | 可安全删除（丢失历史记录） |
cache/ | 缓存 | 索引缓存、关系图谱缓存 | 可安全删除（自动重建） |
logs/ | 日志 | 运行日志和错误排查信息 | 可安全删除 |
market/ | 市场数据 | 官方市场仓库缓存 | 可安全删除（重新拉取） |
registry/ | 注册表缓存 | 模型、服务、市场元数据 | 可安全删除（重新同步） |
apps/ / services/ | 应用与服务 | 已安装应用、派生服务和状态 | 删除后需重新安装 |
应用程序目录
DesireCore 应用本身的安装路径：
| 平台 | 应用安装路径 |
|---|---|
| macOS | /Applications/DesireCore.app |
| Windows | C:\Users\你的用户名\AppData\Local\Programs\desirecore\ |
| Linux | 取决于 AppImage 文件所在的位置 |
配置文件
| 文件 | 路径 | 说明 |
|---|---|---|
| 用户配置 | config/user-profile.json | 用户基本信息和偏好 |
| 算力配置 | config/compute.json | 算力 Provider、模型和 API Key 引用，不包含 Key 明文 |
| 快捷键配置 | config/shortcuts.json | 自定义快捷键 |
| 通知数据 | config/notifications.json | 通知中心状态和未读记录 |
| 本地密钥存储 | config/secrets.json | 算力 API Key、账号会话等敏感值；原始文件始终被应用内导出排除 |
| 调度状态 | config/schedules/ 或运行记录目录 | 定时任务配置、触发历史和状态 |
备份建议
以下目录包含不可再生的重要数据，建议定期备份：
| 优先级 | 目录 | 原因 |
|---|---|---|
| 高 | agents/ | 智能体的所有学习成果和配置 |
| 高 | users/ | 个人画像和关系记忆 |
| 中 | config/ | 个人设置和算力配置；直接复制时也可能包含本地密钥 |
| 中 | skills/ | 用户自定义的技能 |
| 低 | runs/ | 历史任务记录 |
你可以通过「设置 > 数据与隐私 > 导出数据」选择性导出数据作为普通备份。普通备份适合在同一设备和身份下建立恢复点；换机时请使用同一页面的「迁移到新设备」，以便正确处理用户身份和按身份隔离的数据。
应用内普通备份和迁移包都不会直接归档原始 config/secrets.json。迁移向导可以由你明确选择，将符合条件的、用户管理的算力 Provider API Key 写入独立的 scrypt + AES-256-GCM 加密载荷。账号会话、官方云端凭据以及 OAuth、CLI 管理的凭据不会因此迁移。
清除数据
在「设置 > 数据与隐私 > 清除本地数据」中，你可以选择性地清除：
| 数据类别 | 清除范围 | 是否可恢复 |
|---|---|---|
| 对话记录 | 聊天消息、会话历史、回执 | 不可恢复 |
| 智能体 | 配置、人设、记忆（核心智能体自动重装） | 不可恢复 |
| 技能 | 全局技能（内置技能自动重装） | 不可恢复 |
| 算力 | 供应商配置、模型列表 | 不可恢复 |
| 存储 | S3 或对象存储连接配置 | 不可恢复 |
| 代码托管 | GitHub、Gitee、Gitea 等连接配置 | 不可恢复 |
| 用户档案 | 身份、头像、记忆库 | 不可恢复 |
| 市场数据 | 官方市场仓库缓存 | 自动重建 |
| 缓存与日志 | 索引缓存、日志文件、错误排查信息 | 自动重建 |
审计日志可以在导出数据中作为独立类别导出；当前清除入口没有独立的审计日志类别，相关执行记录会随对话记录、缓存与日志等实际存储位置一并处理。
直接复制整个数据根目录不同于应用内导出：它可能连同 config/secrets.json 一起复制，应按包含敏感凭据的文件处理。若迁移包包含可选的加密 API Key，请将包与迁移口令分开保存；无法迁移的登录状态和外部管理凭据需要在新设备重新授权。