dsh-tool-csv 使用指南

为 AI Agent 提供零依赖、纯函数的 CSV 文本处理能力（解析/查询/统计/转 JSON），遵循 RFC 4180 严格引号校验。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit#path:packages/dsh-tool-csv

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

这个插件和 dsh-tool-json 有什么区别？

JSON 工具处理对象/数组形态数据，CSV 工具处理表格形态数据（导出文件、报告片段），两者构成 DSH 的结构化数据处理对子。

是否会读我的本地 CSV 文件或联网？

不会。插件是纯函数实现，只处理调用时传入的 csv 字符串，不读文件、不写文件、不联网、不 eval。

输入超大会怎样？

直接抛错。CSV 文本超过 256000 字节（约 256KB）会被拒绝且不截断，避免返回错误数据；超时上限 2000 毫秒。

单个工具调用最多返回多少行？

parse/to_json/query 默认最多返回 100 行，可在 limit 参数上调（取整数、非法值回退默认），防止输出膨胀。

如何卸载这个工具？

与 DSH profile bundle 卸载一致：dsh plugin --profile web remove tool-csv，web 与 headless 是两个独立 profile，需各自卸载。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则