用途:jev 用于需要语义判断而非生成文本的场景,例如门禁(这段 diff 是否有破坏性)、路由(该问题归哪个团队)、排序(哪份文档匹配该报错)或校验(摘要是否与原文一致)。计数、算术、查找与执行仍应交给代码,只把语义判断交给它;不要用它写文章、做多步推理或回答开放问题。
主要能力:CLI 固定使用 jev-latest。stdout 输出稳定 JSON,stderr 输出人类可读诊断。命令包括 noul(一个是/否概率,答案 id 为 q)、choice(从选项中选择)、score(按有序等级评分)、ask(一个完整请求,状态加问题)、map(并发批处理,JSONL 进 JSONL 出)、presets(列出/显示/校验模板,不调用 API)。状态可通过 --state TEXT、--state @PATH 或 stdin 提供;每个判断命令都支持 --assert EXPR,把答案转为退出码 0 或 3。
退出码约定:0 表示请求成功(不代表判断为“是”);1 为用法或基础设施错误,包括无法求值的断言;2 为 map 批次部分成功;3 为断言结果为假;130 为中断。无法求值被刻意视为错误而非假,以免路径拼写错误静默通过门禁。
断言与预设:断言支持 and/or/not、括号、比较运算符、in [list] 以及进入响应信封的路径,支持带方括号的等级描述键;只有比较产生布尔值,无算术,可用 jq 做加权求和。预设是 ./.jev/presets/(仓库优先)或用户配置目录中的 JSON 文件,包含请求与三个不发送到 API 的保留键:description、params、state、questions、assert;{{name}} 占位符必须占满整个字段值,用 --param NAME=VALUE 或 --param NAME=@PATH 传入。jev presets validate 可在消耗 token 前离线检查结构、问题形态与断言语法。
批处理:jev map 并发对多个输入求值一个模板,可用 --each state/text/request 决定每行的解读方式,--concurrency 控制并发。失败行单独失败,运行退出 2;配合 --out FILE 与 --resume,重跑会跳过已成功完成的行,这是检查点而非缓存。
认证与限制:设置 JEV_API_KEY 环境变量,或由 jev login 保存的凭据提供认证;认证失败时应让用户自行在终端运行 jev login,不要索取密钥。速率限制约每秒 20 请求,会以重试与退避处理,建议 --concurrency 不超过 8。写问题时每问只做一个窄判断、给出完整状态、把边缘情况写进 criteria、评分等级描述需具体且从低到高排列、选择项需覆盖可能答案或加入无匹配项;阈值属策略,应结合两侧后果并用自己的数据验证,置信度衡量分布集中度而非正确性。其他细节资料暂未提供。