csv-free

|- CSV解析与产出免费版包含基于RFC 4180的基础引号规则与逗号分隔能力. 适合简单的跨工具数据交换场景，确保含逗号/引号的字段正确转义. 核心能力： - 基础引号规则：含逗号/引号的字段双引号包裹，内部引号转义为"" - 逗号分隔：默认RFC 4180逗号分隔 - 空字段区分：,, 与 "", 语义不同 - 列数校验：所有行匹配表头列数升级付费版专享：多分隔符识别、编码与BOM处置、解析失败排查、数字日期格式、Excel特性防御. 适用场景：简单数据导出、基础跨工具交换. 不适用于：加密文件破解、欧洲Excel分号场景、Exce...

天轰穿@thcjp

Install

openclaw skills install @thcjp/csv-free

CSV — 解析与生成（免费版）

输入格式

参数名	类型	必填	说明
input	string	是	CSV解析生成-免费版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

核心理念

产出RFC 4180合规的CSV，确保含特殊字符的字段正确转义。免费版覆盖基础引号规则与逗号分隔.

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY=${API_KEY:?请设置环境变量}

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

核心理念(补充)

输入: 用户提供核心理念相关的配置参数、输入数据和处理选项.

参考核心理念的配置文档进行参数调优

核心能力（免费版）

参考核心能力（免费版）的配置文档进行参数调优

1. 基础引号规则

含逗号、引号或换行的字段必须用双引号包裹
引号字段内部的双引号转义为 ""（两个引号），而非反斜杠
空字段 ,, 与空字符串 ,"", 语义不同；要显式

2. 逗号分隔

默认使用RFC 4180标准的逗号分隔。每行一条记录，字段间以逗号分隔.

参考逗号分隔的配置文档进行参数调优

3. 列数校验

校验所有行匹配表头列数，尽早发现列数不一致问题. 输入: 用户提供核心能力（免费版）相关的配置参数、输入数据和处理选项.

参考列数校验的配置文档进行参数调优

付费版专享能力

升级付费版解锁以下高级能力：

多分隔符识别：分号（欧洲Excel）、\t（TSV）、|（遗留系统）.
编码与BOM处理：UTF-8 BOM（0xEF 0xBB 0xBF）、Latin-1 vs UTF-8、Excel Windows需BOM.
解析失败排查：引号内换行、未转义引号、EOF尾换行、列数不一致详细诊断.
数字与日期格式：

输入: 用户提供付费版专享能力相关的配置参数、输入数据和处理选项.

快速开始

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

核心能力（免费版）(补充)

1. 基础引号规则(补充)

含逗号、引号或换行的字段必须用双引号包裹
引号字段内部的双引号转义为 ""（两个引号），而非反斜杠
空字段 ,, 与空字符串 ,"", 语义不同；要显式

2. 逗号分隔(补充)

默认使用RFC 4180标准的逗号分隔。每行一条记录，字段间以逗号分隔.

3. 列数校验(补充)

使用流程

识别目标工具：确认CSV的消费方（默认假设支持逗号分隔）.
应用引号规则：含逗号/引号/换行的字段双引号包裹；内部引号转义为 "".
区分空字段：明确使用 ,,（空）与 ,"",（空字符串）的语义.
校验列数一致：所有行匹配表头列数.
跨工具验证：在目标工具中打开验证渲染正确. 结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.

示例

示例1：含逗号与引号的字段

text

输入数据：姓名="张,三", 备注="他说""你好"""
RFC 4180输出：
"张,三","他说""你好"""

示例2：空字段区分

text

输入：空字段 vs 空字符串字段
,,    → 空字段（null语义）
,"",  → 空字符串字段（""语义）
两者不同，需显式区分

示例3：列数校验

text

表头：name,age,email
行1：张三,30,zhang@example.com     → 3列 ✓
行2：李四,25                       → 2列 ✗ 列数不一致

付费版专享能力(补充)

数字与日期格式：1,234.56 vs 1.234,56本地化、ISO 8601、前导零保留.
Excel特性防御：公式注入（=+-@）、15位精度丢失、科学计数法 E.
前导/尾随空格处理：未引号字段的空格裁剪差异处理.
跨区域设置适配：欧洲Excel分号、系统区域分隔符检测.

错误处理

错误场景	原因	处理方式
字段含逗号未引号	违反RFC 4180引号规则	用双引号包裹含逗号/引号/换行的字段
内部引号未转义	单引号而非 `""`	引号字段内部的双引号转义为两个双引号
列数不一致	某些行多/少字段	校验所有行匹配表头列数，报错或补齐
空字段语义混淆	`,,` 与 `,"",` 混用	显式区分空字段与空字符串字段
Excel中文乱码	缺UTF-8 BOM	免费版不提供BOM处理；付费版提供
欧洲Excel分隔错误	用逗号而非分号	免费版仅支持逗号；付费版支持分号
长数字精度丢失	Excel 15位限制	免费版不提供引号保留；付费版提供
公式注入风险	字段以 `=+-@` 开头	免费版不提供防御；付费版提供 `'` 前缀

常见问题

Q1：免费版支持哪些分隔符？

免费版仅支持逗号分隔（RFC 4180默认）。分号、\t、| 等为付费版专享.

Q2：字段内有双引号怎么处理？

用双引号包裹整个字段，内部的双引号转义为两个双引号 ""。例如 他说"你好" 应写作 "他说""你好""".

Q3：Excel打开CSV中文乱码怎么办？

免费版不提供BOM处理。付费版提供UTF-8 BOM（0xEF 0xBB 0xBF）能力，为Windows Excel加BOM.

Q4：如何防止Excel公式注入？

免费版不提供公式注入防御。付费版提供 ' 前缀防御 =+-@ 开头字段.

Q5：长数字为什么在Excel里变了？

Excel对数字仅保留15位精度。免费版不提供引号保留能力；付费版提供引号包裹并格式化为文本.

Q6：如何升级到付费版？

参考 csv 付费版SKILL.md，解锁多分隔符、编码BOM、解析失败排查、数字日期格式、Excel特性防御等能力.

已知限制

仅支持逗号分隔，不支持分号/\t/|（付费版专享）.
不提供UTF-8 BOM处理（付费版专享）.
不提供解析失败详细排查（付费版专享）.
不提供数字与日期格式指导（付费版专享）.
不提供Excel特性防御（公式注入、精度丢失、科学计数法）（付费版专享）.
不支持加密CSV文件的破解.
依赖目标工具的解析行为，跨工具兼容性需实际验证.