---
slug: "csv-free"
name: "csv-free"
version: "1.0.0"
displayName: "CSV解析生成-免费版"
summary: "CSV解析与生成免费版，提供基础引号规则与逗号分隔，适合简单跨工具数据交换。。CSV解析与生成免费版提供基于RFC 4180的基础引号规则与逗号分隔能力. 适合简单的跨工具数据交换场景，确保"
summary_zh: "CSV解析与生成免费版，提供基础引号规则与逗号分隔，适合简单跨工具数据交换。。CSV解析与生成免费版提供基于RFC 4180的基础引号规则与逗号分隔能力. 适合简单的跨工具数据交换场景，确保"
license: "MIT"
description: |-
  CSV解析与生成免费版提供基于RFC 4180的基础引号规则与逗号分隔能力.
  适合简单的跨工具数据交换场景，确保含逗号/引号的字段正确转义.
  核心能力：
  - 基础引号规则：含逗号/引号的字段双引号包裹，内部引号转义为""
  - 逗号分隔：默认RFC 4180逗号分隔
  - 空字段区分：,, 与 "", 语义不同
  - 列数校验：所有行匹配表头列数
  升级付费版专享：多分隔符识别、编码与BOM处理、解析失败排查、数字日期格式、Excel特性防御.
  适用场景：简单数据导出、基础跨工具交换.
  不适用于：加密文件破解、欧洲Excel分号场景、Excel公式注入防御.
tags:
  - 研发工具
  - 数据格式
  - CSV
  - 工具
  - 效率
  - excel
  - bom
  - 免费版
  - 付费版专
  - 逗号分隔
tools:
  - read
  - exec
  - write
homepage: ""
category: "Automation"
---
# 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="your_api_key_here"
```
配置后需重启会话或开启新终端生效。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尾换行、列数不一致详细诊断.
- **数字与日期格式**：

**输入**: 用户提供付费版专享能力相关的配置参数、输入数据和处理选项.
**输出**: 返回付费版专享能力的处理结果,包含执行状态码、结果数据和执行日志.
#
## 快速开始

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

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

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

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

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

### 2. 逗号分隔(补充)

默认使用RFC 4180标准的逗号分隔。每行一条记录，字段间以逗号分隔.
### 3. 列数校验(补充)

## 使用流程

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

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

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

### 示例2：空字段区分

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

### 示例3：列数校验

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

## 付费版专享能力(补充)

- **多分隔符识别**：分号（欧洲Excel）、`\t`（TSV）、`|`（遗留系统）.
- **编码与BOM处理**：UTF-8 BOM（`0xEF 0xBB 0xBF`）、Latin-1 vs UTF-8、Excel Windows需BOM.
- **解析失败排查**：引号内换行、未转义引号、EOF尾换行、列数不一致详细诊断.
- **数字与日期格式**：`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文件的破解.
- 依赖目标工具的解析行为，跨工具兼容性需实际验证.