一键保存文件

要解决什么

在编辑器、脚本或内部工具里生成内容后，导出本地文件往往是临门一脚：跟进笔记、JSON 备份、CSV 文本、轻量配置片段，都需要能直接落盘，而不是让用户再复制粘贴到别处。手动下载容易遇到编码异常、扩展名缺失、非法字符导致保存失败等问题。

如何工作

核心能力是把内存中的文本或通用 Blob 交给浏览器保存流程，围绕 file-saver 的 saveAs（或等价的 Blob + 临时链接）实现。

• 数据准备：导出文本、JSON 或 CSV 时，先确保内容非空；提供 saveTextFile 与 saveJsonFile，可选实现 saveBlob。
• 触发保存：点击「下载」/「保存到本地」按钮后，先清洗文件名中的非法字符，默认补全扩展名，再调用保存接口。
• 命名与清洗：文件名需过滤掉系统不允许的字符，避免因命名问题导致下载失败或被截断。
• 体验兜底：若浏览器拦截下载，应提示用户允许本次下载；空内容直接拒绝保存并给出提示，而不是生成 0 字节文件。

注意点

• 依赖浏览器下载权限，弹窗被拦截时需用户手动允许。
• 定位是单文件或通用 Blob 下载，不负责多文件打包；需要 ZIP 请配合「附件打包 ZIP」类能力使用。
• 保存后要自测：写入一段中文文本，确认文件可打开且编码正常，避免乱码。
• 文件名默认带扩展名，避免下游工具无法识别类型。