文件透视与转码

功能概述

文件透视与转码（插件标识：file-inspector）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。Magic Bytes 秒破假后缀；精准探测 CSV/TXT 编码，一键转为 Excel 不乱码的 UTF-8-BOM，CRLF/LF 换行符无损统合。

• 底层核心痛点：
• 痛点 A（Excel 打开 CSV 严重乱码）：现代业务系统或数据库导出的 CSV 往往是标准无 BOM 的 UTF-8 编码。在 Windows 上直接双击用微软 Excel 打开时，Excel 由于历史机制会将其误判为系统默认 ANSI（GBK），导致所有中文字符全部变成“锟斤拷”、“烫烫烫”、“文件”等灾难性乱码；反之，国内老旧财务系统导出的 GBK 文本在 Mac 或 Linux 上又会报编码错。
• 痛点 B（假后缀欺骗与损坏假象）：从很多现代图片网站或微信网页端下载的图片，虽然文件名写着 .jpg 或 .png，但双击系统看图软件却提示“文件已损坏”或无法导入剪映/Photoshop。究其底层真实物理格式，其实是 WebP、AVIF 甚至是一个 403 权限拒绝的 HTML 文本文件。普通用户由于不掌握二进制查看能力，以为文件损坏直接废弃。
• 痛点 C（换行符混乱导致的冲突）：Windows（CRLF）与 Unix（LF）换行符混杂，常常导致脚本执行报错（如 Linux 运行 bash 提示 \r: command not found）或 Git 提交全量污染。
• 最简收敛路径：
• 采用 标准布局三（工作台面板布局，workbenchPanel + subList）！
• 顶部工作台直观呈现：真实 MIME 类型、真实应有后缀、当前假后缀比对、字符集编码（附带置信度）、换行符规范；
• 提供核心一键操作：「一键转为 Excel 兼容 UTF-8-BOM」、「一键修正假后缀扩展名」、「一键换行符统合为 LF/CRLF」；
• 底部列表提供前 100 行安全解码预览，用户无需打开第三方编辑器即可直观看到乱码修复效果。

• 架构标准：@ztools/declarative-ui 声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具

---

核心功能特性

1. 转为 UTF-8-BOM：在文件头部写入 EF BB BF 三字节签名，Windows 平台双击 Excel 无论何种版本均能 100% 自动识别 UTF-8，彻底告别所有中文乱码！
2. 转为标准纯 UTF-8（无 BOM）：用于 Linux / 编程语言代码文件，剥离无用 BOM 避免编译器报警。
3. 转为 GBK / GB18030：用于对接国内陈旧工业控制机或老税控机。
4. 统合换行符：一键在 CRLF（Windows \r\n）与 LF（Unix/macOS \n）之间无缝转换。
5. 纯二进制文件（EXE / DLL / 压缩包）尝试文本转码防呆拦截：若文件被识别为二进制格式（包含空字节 \0 且无文本特征），转码动作自动置灰禁用，并明确提示「此文件为二进制文件，不可作为文本进行字符转码」，防止误操作破坏文件结构。
6. 只读文件或正在被占用：转码重写时采用原子化备份策略（先写入 .tmp 临时文件，校验成功后再行替换覆盖），若发生占用错误，原文件绝对不损坏。

---

典型高频使用场景

• 场景 1：打开文件透视工作台，拖入或选择文件查看真实格式与编码 — 当你需要快速执行该任务时，按下 Alt+Space 输入 文件透视 / 文件转码 / 文件编码检测 / 检查文件 / file inspector，回车即可直接进入 file-inspector-workbench 视图完成处理并一键复制或导出结果。
• 场景 2：自动识别当前选中或剪贴板中的 CSV 文件，一键转换为带 BOM 的 UTF-8 解决 Excel 乱码 — 当你需要快速执行该任务时，按下 Alt+Space 输入 csv乱码修复 / csv转utf8bom / 解决excel乱码 / 修复csv，回车即可直接进入 file-fix-csv-bom 视图完成处理并一键复制或导出结果。
• 场景 3：通过二进制魔数识别真实格式，一键将假后缀（如伪装成jpg的webp）还原为真实扩展名 — 当你需要快速执行该任务时，按下 Alt+Space 输入 修复假后缀 / 识别真实文件后缀 / 后缀修复 / fix extension，回车即可直接进入 file-fix-extension 视图完成处理并一键复制或导出结果。

---

唤醒指令与全键盘快捷操作指南

在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 文件透视与转码 的对应功能模块：

全局高频键盘快捷键

---

架构性能与安全隐私保障

• 声明式 UI 零闪烁渲染：界面严格采用 @ztools/declarative-ui 的 List / Detail / Form / ActionPanel 语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。
• 最小权限与沙箱隔离：本插件在清单（plugin.json）中显式声明最小化权限集 ["fs", "shell", "dialog"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。
• Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。

---

延伸阅读与技术内链

关联技术与效率专栏文章

• C盘又红了别乱删！用这个清爽无捆绑的空间分析器，10秒揪出偷吃硬盘的元凶
• 电脑文件太多找半天？这款免费开源神器，100万个文件也能0.03秒瞬间搜出！
• 100 万文件检索仅需 0.035ms！基于 Rust 的 NTFS MFT 裸盘索引与 USN 增量追踪实战
• 卸载电脑里臃肿的广告软件吧！这一个不到100M的开源工具箱，顶替38款日常软件

同分类热门效率插件推荐（系统工具）

• Everything 文件秒搜 插件详情与使用指南
• 软件管理与强力卸载 插件详情与使用指南
• 磁盘空间分析器 插件详情与使用指南
• 进程监控与管理 插件详情与使用指南
• 浏览 ZTools 插件市场全部扩展
• 下载 ZTools 极客桌面效率中枢（Windows & macOS）