TypeSafe AI（Jev）Pi 插件：安装、配置与选型

概览

TypeSafe AI 是 Jev 背后的公司。2026 年 9 月 15 日，官方以 early access 形式发布首个公开的 System One 模型 Jev：软件预先定义问题，模型返回带概率的结构化判定。这些社区 Pi 扩展将它接为判定服务，具体代码仍由你选择的主模型编写。

本页于 2026 年 9 月 22 日更新。先确定希望 Jev 参与哪项决策，再核对包的作者与数据边界。五项均为源码与文档核验，未进行付费 API 实测。

TypeSafe AI ↗Jev 官方介绍 ↗

按要处理的决策选择

y0usaf 侧重工具调用风险与输出建议；Warden 覆盖更广的会话监督；Theo 集成尚未启用的工具发现、技能推荐和显式判定；skill-picker 专门处理大型技能目录；win4r 在任务边界选择主模型。

先试用一个集成，查看判定后再增加自动化。两个 pi-jev 来自不同作者，且都注册 /jev；请按卡片中的作者区分项目，使用已核验的安装命令。

API 访问与安装名称

下方提供 TypeSafe 控制台与官方文档。五项都接受 TYPESAFE_API_KEY，在本机设置后再启动 Pi；主模型订阅不包含 TypeSafe 访问权限。Warden 的云端判定还需明确授权，win4r 还需开启 classifier.enabled 才会发送 Jev 请求。

无命名空间的 npm 包 pi-jev 属于 Theo，y0usaf 发布的是 @y0usaf/pi-jev。win4r 请使用 Git 安装，npm:pi-jev-router 属于另一作者；skill-picker 也使用其作者仓库的 Git 安装。

export TYPESAFE_API_KEY='YOUR_TYPESAFE_API_KEY'

y0usaf：先观察，再启用确认

安装后用 /jev 查看 Key 来源与模式，/jev last 和 /jev output 查看近期判定。默认 gate 为 shadow；/jev mode enforce 在交互会话中为触发阈值的动作请求确认，/jev off 在当前会话关闭两类判定。

可选配置写入 ~/.pi/agent/pi-jev.json，项目 .pi/pi-jev.json 的字段优先。shadow 不拦截，但仍调用 Jev。输出判定发生在命令完成之后，无法阻止执行或撤销泄露。

{
  "gate": { "mode": "shadow" }
}

Warden：本地检查与在线授权

安装后即启用本地检查。用 /warden enable 阅读数据说明，并提供或复用 TypeSafe Key；TYPESAFE_API_KEY 优先于 pi-typesafe 的共享 Key 存储。/warden status 显示当前配置；有在线模型时，/warden test 会发送可能计费的合成请求。

默认模式为 steer。用户配置在 ~/.pi/agent/pi-warden/config.json；项目 .pi/pi-warden.json 可调整或关闭检查，但不能授予云端许可或修改全局后端与模式。明确的项目规则写入 pi-warden.md；启用云端判定前应查看输入内容，规则查找还可能包含其他仓库文档。

Theo：发现工具与推荐技能

用 /jev status 检查配置。可先按需调用 jev_find_tools、jev_find_skill 或 jev_evaluate；/jev auto on 开启用户回合前的工具和技能匹配，/jev auto off 关闭。auto 默认关闭。

工具匹配和技能匹配在有候选时分别请求 Jev，源码中的一次自动流程可能产生两次请求，不能照 README 按一次估算。auto-model 则在本地分类，应单独理解其开销。可选编排需要 pi-subagents；启用工具检查或压缩前，还应查看这些功能新增的外发内容。

Skill-picker：按需搜索技能目录

安装后用 /reload 或重启 Pi。让 Agent 用具体任务调用 skill_search，加载匹配的技能说明；已知名称时可用 skill_load，不会请求 Jev。手动 /skill:name 仍可使用。

可选配置位于 ~/.pi/agent/skill-jev.json，或 PI_CODING_AGENT_DIR 指定的目录；示例保留默认值。搜索会分批并行为全部已启用技能评分。本地加载的说明仍进入主模型上下文，比较开销时应看供应商总用量，不能把本地读取当作零 token。

{
  "minScore": 1.4,
  "maxSkills": 3,
  "shardSize": 50
}

win4r：声明模型后检查路由

Git 安装后重启 Pi，运行 /route init。它以当前模型创建配置起点；填写实际模型档位与能力，再运行 /route reload 和 /route doctor。默认 shadow 只给建议，Jev 分类器也默认关闭。

设置 TYPESAFE_API_KEY 后，用 /route jev on 开启 Jev 请求；先用 /route preview 查看提案，再决定是否启用 /route auto。首次任务或 /route new 可触发分类，续接回合保持模型。该路由器不创建子 Agent，也不删除对话历史。

截至 2026 年 9 月 22 日的选入依据

这是一组选编，依据是可确认的 Pi 包、不同用途、近期仓库活动与能归因的讨论。GitHub 累计星数表示长期关注，不等于搜索量，也不等于近两天增长；五项不是按同一指标排出的热度前五。

AISuperDomain 的 9 月 20 日原帖明确链接 win4r/pi-jev-router；Theo 的原帖发布 v0.4.0，本页核验的是 v0.5.0。Ricker 与 zhouluobo 的高互动帖讨论更广的 Jev 生态，不将其热度归给某一个 Pi 插件。帖子书签、浏览与转帖数未独立核实。

下方更多实现保留上下文裁剪、专门的代码检查和另一种模型路由策略；未列入主推，不影响它们在具体场景中的用途。