M AI 员工技能商店
AI 员工平台 返回商城
返回技能商店

Moss CSV 处理插件

v1.0.0 · 数据处理 · 官方

CSV Excel 数据 统计 Moss

简介

Moss CSV 处理插件 v1.0，让 AI 员工直接操作本地 CSV 表格：

  • 读取预览：一键读取表头、数据行，支持限制行数防止超大文件
  • 条件筛选：按列名 + 运算符筛选，导出为新 CSV
  • 列统计：自动计算计数、求和、平均、最大、最小（数值列）
  • 格式转换：CSV → JSON 或 CSV → Excel（xlsx）
  • 编码友好：默认 UTF-8-BOM，兼容 Excel 导出的中文 CSV
  • 纯本地处理：数据不上传，适合内网环境

适合：销售报表、运营数据、导出清单、日志汇总等 CSV 文件的快速分析。

四种操作（action）

action功能典型场景
read读取 CSV 内容「帮我看看 sales.csv 里有什么」
filter按条件筛选行「筛出销售额大于 1 万的记录」
stats列数据统计「算一下销售额总和和平均值」
convert转 JSON / Excel「把这个 CSV 转成 Excel」

筛选运算符（filter）

operator含义示例
eq等于月份 = 1月
contains包含姓名包含 张
gt / lt大于 / 小于销售额 > 10000
gte / lte大于等于 / 小于等于数量 >= 50

安装

第 1 步：解压插件

解压到固定目录，例如：

D:\moss-plugins\数据处理\CSV处理插件\

目录应包含：

文件作用
csv_plugin.py主程序
run.batWindows 启动脚本
run.shmacOS / Linux 启动脚本
CSV处理插件.md用户文档

第 2 步：复制 Python 环境

将 python/ 文件夹复制到本插件目录（与其他 Moss 插件相同）。

第 3 步：可选依赖（转 Excel 时需要）

仅在使用 convert → xlsx 时需要：

python\python.exe -m pip install openpyxl

read / filter / stats / 转 JSON 无需 pip。

第 4 步：测试

run.bat --action read --filepath D:\test\sales.csv

返回 "success": true 且有 headers、rows 即安装成功。

命令行示例

REM 读取全部（或限制行数）
run.bat --action read --filepath D:\data\sales.csv
run.bat --action read --filepath D:\data\sales.csv --max_rows 20

REM 筛选：月份等于 1月
run.bat --action filter --filepath D:\data\sales.csv --column 月份 --operator eq --value 1月 --output D:\data\jan.csv

REM 筛选：销售额大于 10000
run.bat --action filter --filepath D:\data\sales.csv --column 销售额 --operator gt --value 10000

REM 统计单列（或全部数值列）
run.bat --action stats --filepath D:\data\sales.csv --column 销售额

REM 转 JSON
run.bat --action convert --filepath D:\data\sales.csv --target json --output D:\data\sales.json

REM 转 Excel
run.bat --action convert --filepath D:\data\sales.csv --target xlsx --output D:\data\sales.xlsx

REM 制表符分隔 CSV
run.bat --action read --filepath D:\data\tab.csv --delimiter "\t"

注册技能 csv_tool

在 Moss 工作台 → 技能 → 添加技能，填写以下四件套：

技能名称

csv_tool

技能描述

CSV表格数据处理工具 v1.0。支持：读取(read)、筛选(filter)、统计(stats)、转换(convert)。可读取CSV表头和数据行、按列条件筛选并导出新文件、对数值列做求和/平均/最大最小统计、转换为JSON或Excel。筛选支持等于/包含/大于/小于等运算符。当用户需要处理CSV、分析表格、筛选数据、统计列数据、CSV转Excel或JSON时使用。read/filter/stats/convert均需提供filepath指向CSV文件完整路径。

脚本路径

D:\moss-plugins\数据处理\CSV处理插件\run.bat

（改成你实际解压路径）

参数 JSON（整段复制到「参数定义」框）

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "操作类型。read=读取CSV，filter=按条件筛选，stats=列统计，convert=格式转换",
      "enum": ["read", "filter", "stats", "convert"]
    },
    "filepath": {
      "type": "string",
      "description": "CSV文件完整路径，必填，如 D:\\data\\sales.csv"
    },
    "output": {
      "type": "string",
      "description": "输出文件路径。filter筛选结果、convert转换结果保存路径"
    },
    "column": {
      "type": "string",
      "description": "列名。filter筛选的目标列；stats统计的目标列，不填则统计所有数值列"
    },
    "operator": {
      "type": "string",
      "description": "filter筛选运算符：eq等于、contains包含、gt大于、lt小于、gte大于等于、lte小于等于",
      "enum": ["eq", "contains", "gt", "lt", "gte", "lte"]
    },
    "value": {
      "type": "string",
      "description": "filter筛选的比较值，如 1月、10000、张三"
    },
    "target": {
      "type": "string",
      "description": "convert转换目标格式：json 或 xlsx",
      "enum": ["json", "xlsx"]
    },
    "delimiter": {
      "type": "string",
      "description": "CSV分隔符，默认逗号。制表符文件填 \\t"
    },
    "encoding": {
      "type": "string",
      "description": "文件编码，默认 utf-8-sig，兼容Excel导出中文"
    },
    "max_rows": {
      "type": "string",
      "description": "read时最多读取行数，防止超大文件，如 50"
    }
  },
  "required": ["action", "filepath"]
}

AI 对话示例

安装并注册技能后，在 任务对话 中可直接说：

场景示例
读取预览帮我读取 D:\报表\sales.csv 的前 20 行
条件筛选从 sales.csv 里筛出销售额大于 10000 的记录，保存到 D:\报表\high_sales.csv
列统计统计 D:\报表\sales.csv 销售额列的总和、平均值
格式转换把 D:\报表\sales.csv 转成 Excel，保存到 D:\报表\sales.xlsx
组合分析先读 sales.csv，再统计各月销售额
Moss AI 会根据你的描述自动选择 action 并传入 filepath、column 等参数，无需手动写命令行。

常见错误

现象原因处理
文件不存在filepath 路径错误检查完整路径和文件名
转 xlsx 失败未安装 openpyxlpip install openpyxl
中文乱码编码不对尝试 --encoding gbk
筛选结果为空列名或值不匹配先用 read 查看表头和实际值
python folder missing未复制 python 环境复制 python 到插件目录

能力边界

已支持暂不支持
CSV 读/筛/统计/转 JSON/xlsxxls 旧格式
常用筛选运算符多条件 AND/OR 组合
UTF-8 / GBK 编码超大文件流式处理
本地文件路径在线 URL 下载

与其他插件配合

  • json_tool：CSV 转 JSON 后可用 JSON 插件进一步处理
  • data_clean：筛选/export 前先清洗去重、校验
  • excel_tool：convert 转 xlsx 后可用 Excel 插件加样式图表

包内完整用户文档见 CSV处理插件.md。