数据与隐私

本页是用户手册版的数据说明：它比隐私政策更具体，比安全说明更偏向操作。读完后，你应该清楚 Deskmate 的数据存在哪里、每类数据做什么、什么时候会离开本机，以及如何备份、删除和迁移。

Deskmate 仍处于 early access 阶段，数据结构可能在版本之间变化。涉及手动操作目录前请先备份。

本地优先

Deskmate 默认把用户态数据保存在本机的 ~/.deskmate/ 目录下。这包括 Profile、Agent、会话、知识材料、计划任务、运行产物和日志。

Deskmate 默认把用户态数据保存在本机 ~/.deskmate/。这包括 Profile、Agent、会话、知识材料、计划任务、运行产物和日志。

本地优先并不等于完全离线。当你调用云端模型、MCP server、web search、download 或浏览器工具时，相关请求仍会发送给对应的外部服务。

本地优先不等于完全离线。调用云端模型、MCP server、web search、download 或浏览器工具时，相关请求会发送给对应外部服务。

数据目录总览

下面是 ~/.deskmate/ 的典型结构：

~/.deskmate/
├── app.json
├── profiles/
│   ├── profiles.json
│   └── p_xxx/
│       ├── settings.json
│       ├── auth.json
│       ├── auth.pi.json
│       ├── index.db
│       └── agents/
│           └── a_xxx/
│               ├── AGENT.md
│               ├── knowledge/
│               ├── sessions/
│               │   └── YYYYMM/s_xxx/
│               │       ├── data.json
│               │       ├── messages.jsonl
│               │       └── files/
│               └── schedules/
├── bin/
└── logs/
    ├── dev.db
    └── app.db

其中：

p_xxx 是 profile id。
a_xxx 是 agent id。
s_xxx 是 session id。
YYYYMM 用于把会话按月份分桶。

数据类型说明

Profile

承载用户设置、认证和 Agent 索引。一个 profile 是一组属于你的工作环境。

Agent

一个长期工作单元。AGENT.md 包含 frontmatter 和 system prompt，定义这个 Agent 的身份与行为。

Knowledge

Agent 级的参考资料，供该 Agent 在工作时引用。

Session

一次聊天或任务的记录，包含 data.json、messages.jsonl，以及可能产生的 files/ 目录。

Schedule

计划任务的配置和运行记录。Job runs 与普通 session 分开存放。

Logs

结构化的运行日志，主要用于排障。

Auth

provider 凭证。备份或共享本地目录时必须注意脱敏。

外部调用边界

不是所有操作都会把数据发送到本机之外。下表说明哪些操作默认离开本机：

操作	是否默认离开本机	说明
保存 Agent	否	写入本地目录
保存 Session	否	写入本地目录
调用云端模型	是	发送任务上下文给 provider
调用 MCP server	是	发送工具参数给 server
Web search	是	发送搜索词给搜索服务
Fetch URL	是	请求目标网站
Shell 命令	取决于命令	命令本身可能访问网络
提交 issue	取决于用户	用户手动附加日志/截图

如何备份

退出 Deskmate。
把 ~/.deskmate/ 复制到备份位置。
如果只想备份某个 Agent，复制对应的 profiles/p_xxx/agents/a_xxx/。
如果备份要分享给别人，先删除或脱敏 auth 文件和敏感的 knowledge。

建议在以下时机备份：

升级 early access 版本前。
大规模修改 Agent 前。
删除 profile 前。

如何删除

应用内删除可以处理大多数日常清理：

删除 Agent。
删除 Session。
删除 MCP 配置。
删除 Knowledge 文件。

如果需要手动完全删除：

退出 Deskmate。
删除 ~/.deskmate/。
重新启动时会生成新的数据目录。

删除本地数据不会删除第三方 provider 或 MCP server 已经处理的数据。请到对应服务处理。

如何迁移

推荐的迁移流程：

退出旧设备上的 Deskmate。
复制 ~/.deskmate/。
放到新设备对应的用户目录。
启动 Deskmate。
检查 provider 凭证是否仍然可用。

迁移时需要注意的风险：

跨平台时路径可能不同。
早期版本的数据结构可能发生变化。
凭证迁移可能受 provider 限制。

FAQ

可以直接编辑 AGENT.md 吗？

可以检查内容，但手动编辑前建议先退出应用并备份。错误的 frontmatter 可能导致 Agent 读取失败。

messages.jsonl 可以删除吗？

删除会影响对应 session 的历史记录。建议通过应用内删除 session。

日志可以清理吗？

可以在退出应用后删除 logs 目录下的 db 文件，但这会失去排障历史。

备份里会包含 token 吗？

可能包含。共享备份前必须检查 auth 文件并完成脱敏。

下一步

隐私政策：/privacy
安全说明：/security
故障排除：/docs/troubleshooting