核心功能与用法
File Converter 是一个基于 Bash 和 Python3 标准库的本地文件格式转换工具集，通过 scripts/script.sh 脚本接受命令行参数执行转换操作，所有输出均重定向至 stdout，无持久化存储。
主要转换能力：
- 结构化数据：CSV ↔ JSON 双向转换、CSV 生成 SQL INSERT 语句、TSV 转 CSV
- 格式美化：JSON 美化打印（2 空格缩进）与压缩（去空格）
- 编码解码：Base64 编码、URL 编解码（Python urllib.parse 实现）
- 简易 Markdown：基础 HTML 转换（支持 h1-h3 标题、粗体、斜体，不支持表格/列表/代码块等复杂语法）
- 文件检测：file 命令检测类型、文件大小/行数/词数统计、hex 十六进制转储
显著优点
- 纯本地处理：无网络调用，数据不离开本地环境
- 零依赖部署：仅需 bash 4+、python3 标准库及系统常用工具（file/xxd/sed/base64）
- 管道友好：stdout 输出设计，便于 shell 脚本集成与链式处理
- 开箱即用：无需安装额外 Python 包或外部 API
潜在局限与风险
- 功能描述不实：文档声称支持 YAML/XML 转换，实际代码未实现（json2yaml/yaml2json/xml2json 等命令缺失）
- Markdown 支持简陋：仅正则替换处理基础格式，复杂文档转换会丢失结构
- TSV2CSV 缺陷：简单 sed 替换制表符，无法处理含制表符的引号字段
- Base64 解码不可用：命令存在但实现被注释，功能残缺
- 无错误兜底：对畸形输入（如非数组 JSON 转 CSV）缺乏健壮处理
适用场景
- 开发调试中的快速格式转换与数据探查
- CI/CD 流水线中的轻量级数据处理环节
- 离线环境下的敏感数据转换（无云依赖）
- 简单的 Markdown 文档快速转 HTML
常规风险提示
- 输入文件路径需自行校验，脚本未做路径注入防护
- 大文件处理可能受 shell 内存限制
- 编码转换依赖系统 locale 设置，非 UTF-8 环境可能出现乱码