mcpField
C
cli-anything-openrefine

cli-anything-openrefine

github.com/hkuds数据与数据库57.6k195 次安装5 周前更新
代码仓库

关于 cli-anything-openrefine

面向自动化 Agent 工作流的 OpenRefine 命令行技能,可用于清理和转换数据、复用操作历史并导出 CSV/TSV。它支持 JSON 输出和隔离会话,便于脚本与 CI 检测命令失败。

主要功能

  1. 01清理与转换数据
  2. 02复用 OpenRefine 操作历史
  3. 03导出 CSV 和 TSV
  4. 04JSON 输出与隔离会话
  5. 05REPL 管道执行及错误状态

适用场景

  1. 01自动清理导入的 CSV 数据
  2. 02应用已有的操作历史
  3. 03导出处理后的 CSV 或 TSV
  4. 04在 CI 中运行并检测失败

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-openrefine

安装后在 Claude Code 中输入/cli-anything-openrefine确认已加载。

详细介绍

CLI-Anything OpenRefine

当任务需要在自动化 Agent 工作流中进行 OpenRefine 数据清理、转换、可复用操作历史记录,或导出 CSV/TSV 时,请使用此 skill。

前置条件

安装 harness:

cd openrefine/agent-harness
python -m pip install -e .

在后端命令之前启动 OpenRefine:

openrefine -i 127.0.0.1 -p 3333

使用 OPENREFINE_URL=http://127.0.0.1:3333 设置自定义服务器,或传入 --base-url。

Agent 命令规则

  • 在每个一次性命令上优先使用 --json。
  • 使用 --session <path> 来隔离任务状态。
  • 在执行 row、apply、export、undo 或 redo 命令之前,请先导入或打开一个项目。
  • 现有的 OpenRefine 操作历史 JSON 可以直接传给 data apply。
  • 生成的文件是常规的 OpenRefine 操作 JSON 以及导出的 CSV/TSV 数据。

常用命令

cli-anything-openrefine --json server ping
cli-anything-openrefine --json project list
cli-anything-openrefine --json --session run/session.json project import messy.csv --name cleanup
cli-anything-openrefine --json --session run/session.json data rows --limit 10
cli-anything-openrefine --json ops text-transform run/trim.json --column Name --expression 'value.trim()'
cli-anything-openrefine --json --session run/session.json data apply run/trim.json
cli-anything-openrefine --json --session run/session.json data export run/clean.csv --format csv
cli-anything-openrefine --json --session run/session.json session undo
cli-anything-openrefine --json --session run/session.json session redo

REPL

不带子命令运行 cli-anything-openrefine 即可进入 REPL。

对于自动化用户旅程,请通过 stdin 管道传入以换行分隔的 REPL 命令。重定向的流会自动使用仅 ASCII 的输入/输出路径,而交互式终端则保留 Unicode 横幅、提示历史记录和样式:

printf 'help\nexit\n' | cli-anything-openrefine

当 REPL 被重定向时,Unicode 载荷会以可逆的 ASCII 反斜杠转义形式呈现,从而防止旧版 Windows 输出编码将成功的命令变成失败的旅程。

如果任何命令失败,管道化工作流会在 exit 或 EOF 时返回非零退出状态,使 CI 能够检测到不成功的用户旅程。

错误处理

当设置了 --json 时,命令失败会将一个带有 ok: false 的 JSON 对象写入 stderr。

评论

支持 Markdown