前言¶
在 DSH 插件生态中，处理 CSV 格式的数据文件通常需要编写额外的解析逻辑。xby-csv2 插件提供了直接的转换能力，将 CSV 数据映射为 JSON 结构，便于后续的数据处理或 API 调用。
插件定位¶
这是一个由 xby-skill 维护的联网工具插件，基于 FastMCP 构建，主要解决 CSV 到 JSON 的格式转换需求。
安装与启用¶
使用以下命令安装该插件：
dsh plugin --profile web add github:xby_skill/xby-csv2
安装完成后，插件即可在 DSH 进程中生效。
核心功能¶
1. 设置 API 密钥¶
set_xby_apikey
在聊天中设置 API 密钥，该密钥会自动持久化保存，重启后依然有效。
2. 获取文件信息¶
get_csv_info
获取 CSV 文件的基本信息，包括行数、列数、列名等，用于辅助转换操作。
3. 文件转换¶
convert_csv_file
将 CSV 文件转换为 JSON 文件。
4. 字符串转换¶
convert_csv_string
将 CSV 格式的字符串内容转换为 JSON 格式。
参数与用法¶
以 convert_csv_file 为例，主要参数如下：
file_path：CSV 文件路径，必须是有效的文件路径。output_file_path：输出 JSON 文件路径（可选，默认为 CSV 文件同目录下同名 .json 文件）。delimiter：CSV 分隔符，默认为逗号(,)，支持制表符、分号等。encoding：文件编码，默认为 utf-8，支持 gbk、gb2312 等常见编码。skip_rows：跳过的行数，默认为 0，用于跳过文件开头的注释或空行。header：是否包含表头，默认为 True。orient：JSON 输出格式，默认为 “records”（每行作为一个字典对象的列表），可选值包括 “values”、”split” 等。indent：JSON 缩进，默认为 None（紧凑格式）。
注意事项¶
- 使用前需从小笨羊官网获取 API 密钥。
- 支持自定义分隔符（如制表符、分号）和多种 JSON 输出格式。
- 支持跳过文件开头的注释或空行。
- 调用过程中可能抛出
FileNotFoundError（文件不存在）、ValueError（格式错误）或Exception（其他未知错误）。
生态链接¶
- GitHub 仓库：https://github.com/xby_skill/xby-csv2
- 插件目录：https://www.skillhub.cn/plugins/xby-skill/xby-csv2
