File Converter

核心用法

file-converter 是一款基于 Bash + Python3 标准库的本地文件格式转换工具，通过 scripts/script.sh 接收命令和文件路径，所有处理结果输出至 stdout。

主要功能模块

| 类别 | 命令 | 说明 |

|------|------|------|

| **格式转换** | `csv2json`, `json2csv`, `tsv2csv`, `md2html` | 数据格式互转，Markdown 仅支持基础语法（h1-h3、粗体、斜体） |

| **SQL 生成** | `csv2sql <file> <table>` | 生成带列名转义的 INSERT 语句 |

| **JSON 处理** | `pretty-json`, `minify-json` | 美化或压缩 JSON，2 空格缩进 |

| **编码解码** | `base64-enc`, `url-encode/decode` | 注意：`base64-dec` 实现不完整（解码调用被注释） |

| **文件检测** | `detect`/`stats`, `hex` | 文件类型识别、大小/行数/字数统计、十六进制转储 |

显著优点

• 纯本地执行：无网络请求，无持久化存储，数据不离开本地环境
• 零依赖部署：仅依赖 Python3 标准库（csv/json/re/urllib.parse）和系统命令
• 管道友好：输出至 stdout，可灵活重定向或串联 Unix 管道
• 透明可审计：开源脚本，转换逻辑清晰可见

潜在局限与风险

| 问题 | 影响 | 建议 |

|------|------|------|

| **YAML/XML 未实现** | 描述中提及但实际不可用 | 需手动安装 PyYAML/lxml 替代 |

| **Markdown 支持简陋** | 表格、列表、代码块、链接均不支持 | 复杂文档请使用 Pandoc |

| **base64-dec 功能残缺** | 解码命令无效 | 使用系统 `base64 -d` 替代 |

| **tsv2csv 无引号处理** | 含制表符的字段可能破坏 CSV 结构 | 预处理转义或使用专业工具 |

| **无输入验证** | 恶意构造的文件可能引发异常 | 不信任来源文件先隔离检测 |

适合人群

• 需要快速轻量格式转换的开发人员与数据工程师
• 对数据隐私敏感、禁止外发处理的场景
• CI/CD 流水线中的自动化格式规范化任务
• 教育/学习目的，理解基础文本格式转换原理

常规风险提示

• 处理大型文件时注意内存占用（Python 一次性加载）
• csv2sql 生成的语句请 review 后再执行，避免 SQL 注入风险（虽单引号已转义）
• 输出重定向前建议先用 detect 确认文件类型，避免覆盖错误

核心用法

File Converter 是一款基于 Bash 和 Python3 标准库构建的轻量级文件格式转换工具。用户通过 bash scripts/script.sh <命令> <文件> 的形式调用，所有处理均在本地完成，结果输出至 stdout，可通过重定向保存到文件。

该技能支持四大类操作：文本格式转换（csv2json、json2csv、md2html、tsv2csv）、数据格式转换（csv2sql、pretty-json、minify-json）、编码处理（base64-enc/url-encode/url-decode）以及文件检查（detect、stats、hex）。典型使用场景包括：将 CSV 数据批量转为 JSON 供 API 调用、将 Markdown 简单转为 HTML 用于邮件、生成 SQL INSERT 语句导入数据库、对配置文件进行 JSON 美化或压缩等。

显著优点

纯本地化与零依赖是最大亮点。仅依赖 Python3 标准库（csv、json、re、urllib.parse），无需安装任何第三方包，彻底规避供应链攻击风险。无网络请求设计确保敏感数据（如用户 CSV、配置文件）不会外泄，符合 GDPR 数据最小化原则。

功能实用且直观。csv2json/json2csv 支持表头自动映射；csv2sql 自动生成带转义的 INSERT 语句；md2html 虽仅支持基础语法（h1-h3、加粗、斜体），但满足快速预览需求；hex 命令支持 xxd/od 双降级方案，兼容性强。

透明可信。代码结构清晰，无危险函数调用，安全扫描获得 A 级评分（85分），所有合规检查项均通过。

潜在缺点与局限性

功能覆盖不完整。SKILL.md 描述中提及的 YAML/XML 转换（json2yaml、yaml2json、xml2json 等）实际未实现；base64-dec 命令存在但功能被注释，属于无效指令。

md2html 能力有限。仅通过正则处理简单 Markdown 语法，不支持表格、列表、代码块、链接、图片等常见元素，复杂文档转换效果不佳。

错误处理较薄弱。tsv2csv 采用简单 sed 替换，不处理含制表符的引用字段；部分命令缺少输入合法性校验，异常文件可能导致非预期输出。

T3 来源可信度。作者为个人开发者，虽账号历史 3 年+且有 12 stars，但缺乏企业背书或知名开源组织托管。

适合的目标群体

• 开发者与运维人员：需要快速在 JSON/CSV/SQL 间转换数据，或批量处理配置文件
• 数据分析师：轻量级数据预处理，生成标准格式供下游工具使用
• 隐私敏感型用户：要求数据绝对本地处理，拒绝云端服务的场景
• 教育/教学场景：演示基础文件格式原理，代码简单易懂

使用风险

性能风险：纯 Bash/Python 实现，大文件处理时效率不及编译型工具（如 jq、csvkit）。建议用于 MB 级以下文件。

功能一致性风险：描述与实现存在偏差（YAML/XML 缺失），用户需以实际代码为准，避免依赖未实现功能。

格式兼容性风险：tsv2csv 的简化实现、md2html 的有限语法支持，可能在边缘场景产生非预期结果，关键业务需人工校验。

维护风险：个人项目更新频率不确定，base64-dec 等已知问题长期未修复，建议用户关注仓库动态或自行 fork 维护。