> 内容来源：Onevium 官方文档
> 文章: 预览、编辑并保存本地文件
> 原文: https://onevium.com/zh/docs/file-editing
> 语言：简体中文
> 更新于: 2026-09-28
> 适用版本: 1.2.2+

---

# 预览、编辑并保存本地文件

从聊天链接或文件列表打开本地文件，编辑 Markdown、文本与 CSV，并区分 Office 预览、未保存草稿和磁盘变化。

## 先分清正在看哪份文件

Onevium 可以从聊天中的本地文件链接或项目文件列表打开文件。先看顶部路径：编辑项目文件会修改磁盘上的原文件；上传到消息里的附件可能是副本，不能把它当成原项目文件。

本例使用练习项目中的 `notes.md`，内容可以是两行普通笔记。不要拿正在被其他任务修改的文件练习。

## 打开目标文件

- 点击会话顶部的**浏览全部文件**，在文件列表选择 `notes.md`。
- 助手回复里有可点击的本地文件链接时，也可以直接打开；带行号的引用可用于定位内容。
- 已打开文件后，用顶部的分段路径切换目录或选择旁边的文件。

先核对路径和正文，再开始修改。路径无权限、文件已移动或临时文件已过期时，按面板提示重新选择正确文件；不要仅凭文件名猜测位置。

## 改一段 Markdown 并保存

1. 打开 `notes.md`。Markdown 可在支持的预览编辑界面中直接修改，也可切到**源码 / Source**查看和编辑原始文本。
2. 在末尾增加一行“下一步：复核支付回调测试”。顶部出现**未保存的更改 / Unsaved changes**时，说明这还是编辑草稿。
3. 点击顶部**保存 / Save**，或在文件编辑区使用 macOS 的 `⌘S`、Windows/Linux 的 `Ctrl+S`。
4. 等待显示**已保存 / Saved**，再重新打开文件核对。保存出错时先阅读错误，不能把输入框里看得见的文字当成已写入磁盘。

保存文件不等于提交 Git。需要核对修改范围时，点击**查看更改 / View changes**，或按[文件、终端与 Review](https://onevium.com/zh/docs/files-terminal-review)检查差异。

## 各类文件能做什么

| 文件                  | 使用方式                                    |
| ------------------- | --------------------------------------- |
| Markdown、普通文本及可编辑源码 | 修改内容后显式保存；Markdown 可查看排版或切换源码           |
| CSV / TSV           | 预览为表格；需要改数据时切到源码编辑分隔文本，再保存并回到预览核对列      |
| Excel 工作簿           | 只读工作表预览；不要把 CSV 的文本编辑能力理解为可直接编辑 `.xlsx` |
| PDF、Word、PowerPoint | 阅读预览；需要改原文档时使用相应外部应用                    |
| 图片、音频等媒体            | 按格式查看、缩放或播放；预览本身不修改文件                   |
| 太大、截断或不支持的文件        | 可能只提供预览或外部打开入口，以实际面板为准                  |

CSV 练习可以先修改一个单元格对应的文本值，保留分隔符和引号，再回到表格预览检查列是否对齐。表格能显示，不代表它是 Excel 编辑器。

## 文件被别的任务修改时

如果助手、终端命令或外部编辑器也改了同一文件，面板可能显示**磁盘上的文件已更改**或冲突提示。

- 你没有未保存修改时，可以重新载入，查看磁盘最新内容。
- 你还有编辑草稿时，先保留需要的文字，再决定如何合并。冲突状态下不要反复点击保存去覆盖另一份修改。
- **从磁盘重新加载**可能丢弃当前未保存的草稿；先阅读确认提示。

需要同时处理不同任务时，使用不同文件或独立工作目录。两个分屏会话指向同一目录，仍会共享文件。

## 核对保存结果

对 Git 项目，可在目标项目终端运行：

```bash
git diff -- notes.md
```

确认只改了刚才的一行。非 Git 项目可以用文件面板重新打开，或在外部编辑器中核对实际文件。一次编辑成功不代表整个项目通过了测试。

## 常见问题

| 现象              | 处理方法                            |
| --------------- | ------------------------------- |
| 看不到保存按钮         | 先确认格式可编辑并实际修改了内容；只读预览不会出现编辑保存操作 |
| CSV 看起来像普通代码    | 切换到预览查看表格；修改数据则在源码中完成           |
| 保存后原项目没变化       | 核对路径，是否打开了附件副本或另一个目录中的同名文件      |
| 提示文件发生冲突        | 保留自己的草稿，核对磁盘改动，再合并或重新加载         |
| Office 文件不能直接修改 | 使用外部应用；当前面板提供的是只读预览             |

## 下一步

用[Review 与终端](https://onevium.com/zh/docs/files-terminal-review)验收文件改动，或阅读[输入框工具](https://onevium.com/zh/docs/tools-menu)了解附件、文件引用与排队消息。