Jev CLI
作者 jtsang4
可配置的 Jev 命令行客户端,提交状态和类型化问题。
实现概述
提供配置、诊断和结构化 JSON 评估结果;仓库包含中英文使用文档,并支持直接调用 TypeSafe。
适用任务
适合在终端、Shell 脚本或 CI 里直接调用 Jev:传入 state 和一组 boolean、choice、score 问题(JSON),从标准输出拿到结构化 JSON。输入可以来自文件或标准输入,例如把 git diff 交给一份事先写好的问题清单逐项检查。
运行条件
用 npm install -g @jtsang/jev-cli(或 bun install -g @jtsang/jev-cli)安装,可在 Node 22 以上或 Bun 上运行。执行 jev-cli config set providers.jev.apiKey 写入自己的 TypeSafe 密钥后,运行 jev-cli doctor:它会发送一次很小的评估,确认密钥和模型可用;加 --offline 则只检查配置、不联网。配置保存在 ~/.jev-cli/config.yaml(权限 0600),优先级依次为命令行参数、环境变量、配置文件。
边界与证据
Jev 输出的是判断而不是文字,所以这个 CLI 适合分类、分流、按标准评分和自动核验,不适合生成文本。每个问题都针对同一 state 单独评估,需要组合时由你的代码处理。README 说明 boolean 概率未经校准;jev-latest 和 jev-preview 会随新版本发布而变化,定好阈值后应固定为 jev-1.13.0 这样的具体版本。如果改走 Vercel AI Gateway,需要另一把网关密钥。Jev Atlas 核对了 README,但没有实际运行这个 CLI。
README 中的示例
README 示例:把当前的 git diff 作为 state 通过管道传入,再按问题文件逐项评估。
git diff | jev-cli eval --state-file - --questions-file ./checks.json延伸阅读与核验
相关主题
请求格式参考
从可编辑示例开始,理解请求格式,再按项目文档接入。