Skillppx logo

read-gbk

自动检测并读取本地GBK/UTF-8编码文本文件，支持多种格式。

已扫描
适合谁
需要处理中文编码文件的技术人员、日常使用中文文本文件的办公用户
不适合谁
无需本地文件读取的纯在线用户、不熟悉命令行操作的初学者
国内可用性
国内友好。面向国内用户较友好。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @delicate314/read-gbk
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

read-gbk - 文件读取工具

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

前置要求

需要 Python 环境（Python 3.8+）

如果没有 Python，先安装：

方式 1：Miniconda（推荐）

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

方式 2：Python 官方安装包

# 下载：https://www.python.org/downloads/
# ⚠️ 安装时勾选 "Add Python to PATH"

方式 3：winget 安装（Windows）

winget install Python.Python.3.11

自动安装的依赖

文件类型依赖库安装方式
.docxpython-docx首次读取时自动安装
.pdfpypdf首次读取时自动安装

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

快速开始

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

支持的文件格式

格式说明
.txt纯文本文件（GBK/UTF-8 自动检测）
.mdMarkdown 文件
.csvCSV 文件（GBK 编码常见于 Excel 导出）
.log日志文件
.docxWord 文档（自动安装 python-docx）
.pdfPDF 文档（自动安装 pypdf，仅支持文字版 PDF）
.jsonJSON 文件
.xmlXML 文件
.ini / .cfg配置文件

编码检测逻辑

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

示例

# 读取普通文本文件
node {skillDir}/scripts/read-file.js "D:\文档\笔记.txt"

# 读取 CSV 文件
node {skillDir}/scripts/read-file.js "D:\数据\报表.csv"

# 读取 Word 文档
node {skillDir}/scripts/read-file.js "D:\华为项目\病历.docx"

输出

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

注意事项

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

已收录 1 个 Skill

相关推荐