# 数据与隐私：NearWork 会把我的文件上传到云端吗

> NearWork 本地优先：配置、会话、记忆与知识库都保存在你电脑的 LINGXI_HOME 目录。本文说明哪些数据留在本地、哪些请求会发到模型服务商、API Key 如何加密存储。

**一句话结论**：你的文件、会话、记忆、知识库和 API Key 都留在本机设备上；真正会离开电脑的，只有你发起请求时送给模型服务商的那部分上下文。

## 本地存了什么

所有用户数据统一放在数据根目录 `LINGXI_HOME`（默认 `~/.LingXi`，Windows 为 `C:\Users\<用户名>\.LingXi`，可用环境变量改到别的盘）：

| 路径 | 内容 |
|---|---|
| `config.json` | 模型槽位、供应商、权限模式、推理深度等配置 |
| `auth.json` | NearWork 官方登录态（桌面端与 CLI 共享），过期后可撤销重登 |
| `sessions/`、`session/` | 会话正文与会话索引 |
| `memory/` | 长期记忆与知识库（含导入文档的分块与向量） |
| `skills/`、`mcp.json`、`hooks.json` | 技能、MCP 服务、钩子配置 |
| `tasks/`、`teams/` | 定时任务配置与团队数据 |
| `log/`、`backups/`、`screenshots/` | 日志、备份、截图 |

这些目录不会被自动上传。想彻底清除，关掉应用后直接删除整个 `LINGXI_HOME` 目录即可（不可恢复，建议先备份）。

## 什么会离开本机

| 动作 | 数据流向 |
|---|---|
| 发送对话 | 上下文（含你附加的文件内容）发送给**当前槽位选中的模型服务商** |
| 使用官方模型 | 请求先经 NearWork 中转服务（用于鉴权与计费），再转发到上游模型 |
| 自带 API Key | 请求直连该供应商官方接口，NearWork 不经手 |
| 联网搜索 / 网页抓取 | 关键词或 URL 走官方中继服务，再调上游 |
| 文件读写、命令执行、浏览器操作 | 全部在本机执行，不经过云端 |
| 语音识别 / 合成 | 使用需要联网的服务时，音频会发送给你选定的服务商 |

换句话说：**是「模型推理」这一步需要联网，不是「你的数据」整体上云**。不想让某类内容出网，就别把它附到对话里，或用本地部署模型。

## API Key 怎么存

桌面端通过操作系统提供的加密能力（Electron `safeStorage`，Windows 走 DPAPI、macOS 走 Keychain）把 Key 加密后再写入 `config.json`，明文不落盘；界面上也默认隐藏。

这也带来一个使用上的注意点：**密文与当前系统账户绑定**。换机器或重装系统后把 `config.json` 拷过去，Key 需要重新输入一次——其他数据（会话、记忆、技能）不受影响。

CLI 方式则优先读环境变量（如 `DEEPSEEK_API_KEY`），适合放在个人 shell 配置或密钥管理工具里，不要提交到代码仓库。

## 权限边界由你控制

涉及写入文件、执行命令、访问浏览器这类动作时，NearWork 默认会先问你。四种权限模式：

| 模式 | 行为 |
|---|---|
| `normal`（默认） | 只读自动，写入与命令需确认 |
| `strict` | 每步确认 |
| `auto` | 全自动，危险命令仍拦截 |
| `full_access` | 全部放行 |

建议只在受控的、可回滚的任务里使用 `auto` 及以上；处理生产环境目录时保持 `normal`。

## 常见问题

### 会话记录会被用来训练模型吗？

客户端不会主动回传会话；使用官方模型时，请求正文会经过 NearWork 的中转服务完成鉴权与计费转发。如果你对数据流向有严格要求，建议切换到「自带 API Key + 直连供应商」的模式，并按该供应商的数据政策评估；更严格的做法是接入本地部署的模型，让推理也留在局域网内。

### 公司电脑、涉密环境能用吗？

可以，但要按合规要求配置：使用自带 Key 直连、把 `LINGXI_HOME` 指到加密盘、权限保持 `normal`、关闭联网搜索类工具、必要时只接本地模型。这样除了模型推理本身，所有数据都留在本机。

### 换电脑怎么迁移，密钥要重填吗？

复制整个 `LINGXI_HOME` 目录到新机器即可带走会话、记忆、知识库、技能与 MCP 配置；由于 API Key 的加密与系统账户绑定，需要在设置里重新输入一次。官方登录态（`auth.json`）通常可以直接复用。

### 卸载后数据还在吗？

卸载程序一般不会删除 `LINGXI_HOME`，这是为了避免误删你的会话与知识库。确认不需要时手动删除该目录即可。

## 下一步

- 想接外部工具，先看[MCP 配置指南](/docs/features/mcp)里的安全提醒。
- 还不熟悉权限模式？回[快速开始](/docs/start/quick-start)。
- 计费与额度的口径见[定价页](/pricing)。
