前言¶
在 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
