read-gbk - 文件读取工具

读取本地文本文件，自动检测编码（优先 GBK，失败则尝试 UTF-8）。

前置要求

需要 Python 环境（Python 3.8+）

如果没有 Python，先安装：

方式 1：Miniconda（推荐）
bash

下载安装：https://docs.conda.io/en/latest/miniconda.html

方式 2：Python 官方安装包
bash

下载：https://www.python.org/downloads/

⚠️ 安装时勾选 Add Python to PATH

方式 3：winget 安装（Windows）
bash
winget install Python.Python.3.11

自动安装的依赖

无需手动安装这些库，首次使用时会自动安装。

快速开始

bash
node {skillDir}/scripts/read-file.js 文件路径.txt

支持的文件格式

编码检测逻辑

1. 1. 首先尝试用 GBK 解码（Windows 中文环境默认）
2. 如果 GBK 解码失败，尝试 UTF-8
3. 如果都失败，返回错误信息

示例

bash

读取普通文本文件

读取 CSV 文件

读取 Word 文档

输出

• - 成功：输出文件内容（stdout）
• 失败：输出错误信息（stderr），退出码 1

注意事项

• - 二进制文件（如 .exe, .zip, .jpg）不支持
• 超大文件（>50MB）可能被截断
• 首次读取 .docx 文件时会自动安装 python-docx（约 2-5 秒）
• 避免在 PowerShell 管道中使用（如 | Select-Object），直接输出即可