在 Python 中写判断意图,用 jevac 调用 Claude Code,把它展开成可检查的 Jev API 调用。
import jevascript as j
def classify(email):
category = j.choose("Classify the email.", candidates=["work", "personal", "other"])
needs_reply = j.judge("Does this email ask for a reply?", threshold=0.7)
priority = j.score("How urgently does this email require action?")
return category, needs_reply, priority开发者必须写清判断目标。编译 agent 从调用位置已有的变量中选择 context,补全
state、问题和评分标准。位置参数、结构化数据、自定义关键字参数都可以作为编译材料。
显式约束优先于自动推断。
需要 Python 3.10+,以及已安装并登录的 Claude Code。
python -m pip install -e .
jevac examples/email_classifier.py -o build/email_classifier.py --report build/email_classifier.json检查生成的 Python 后运行它;运行阶段需要 TypeSafe API key:
export TYPESAFE_API_KEY='your-key'
python build/email_classifier.pyjevac 本身不会执行输入文件、生成代码或 Jev 请求。编译会把输入文件源码交给 Claude Code。
生成文件仅依赖普通 Python 和 typesafe-sdk,不需要 JevaScript 或 Claude Code。
邮箱示例使用虚构邮件,输出类别、是否需要回复和处理优先级。
两个例子都已实际通过 Claude Code 编译,源码与编译快照可对照阅读:
- 极简源码 → 生成代码:省略 context 与 rubric。
- 高级源码 → 生成代码:显式阈值、结构化 rubric、中文自定义参数。
- 对应的
.json编译报告列出了 agent 选择的变量与展开说明。
Claude Code 默认使用自己的已配置模型。可用 --model 指定模型,--claude 指定可执行文件,
--timeout 设置编译超时。现有输出文件在生成结果通过校验后原子替换;输入源文件不会被覆盖。
| 原语 | 默认返回值 | 规则 |
|---|---|---|
j.judge(...) |
bool |
P(true) >= threshold,默认阈值 0.5 |
j.choose(...) |
候选值 | 字典候选返回 key,序列候选返回原始 item |
j.score(...) |
float |
默认 0–1;可提供 rubric 和 scale=(low, high) |
没有显式 rubric 时,agent 根据判断维度补出量表,量表会直接呈现在生成代码中。 高级用法保持上述返回类型;输入中的自定义信息由编译 agent 解释:
j.judge("是否需要回复", email, threshold=0.8, 注意="自动回执不算回复请求")
j.choose("最合适的邮件分类", candidates=categories, 优先考虑="邮件实际要求的行动")
j.score("处理优先级", rubric=priority_levels, scale=(0, 100))compiler/ 包含 Python 前端、Claude Code 适配层和展开器。前端找到直接的 j.judge()、
j.choose()、j.score() 调用,并保守地列出调用处可用的绑定。Claude 为每个调用生成一个
helper;展开器传入选中的运行时变量以及原调用的参数,保持原来的控制流与求值位置。
首版每个原语独立调用 Jev,不跨调用做自动批处理。
原文件保持不变,生成文件通过 AST 输出,所以格式和注释可能与源文件不同。 编译检查包括 Python 语法、调用点覆盖、context 绑定及残留 JevaScript 依赖;这不能证明 agent 推断的 context、量表或判断语义正确,仍需要检查生成代码并用自己的样本验证。 再次编译相同源码可能得到不同的展开实现;示例保留实际生成快照供对照。 普通 API 错误直接抛出,不被转换成判断结果。
首版支持直接模块导入 import jevascript as j,不支持原语别名、动态导入和 import alias
被重新绑定。隐式 context 分析是保守的:复杂作用域中未列入的值可直接作为参数传给原语。
不要直接运行含有原语的源文件;未编译的调用会报 CompilationRequired。
官方接口资料:Python SDK、 Advanced 输入。本地调研见 compiler/jev-api-notes.md。
python -m unittest discover -s tests -v这些测试不调用模型,包括用真实 TypeSafe SDK 和模拟 HTTP transport 验证生成快照的请求与返回值。 实际编译需要 Claude Code,实际分类还需要 TypeSafe API key。当前验证环境没有配置这个 key, 尚未验证真实 Jev 分类质量。