SuperAPI AI 工具集

jev-control-plane

智能体与模型

查看项目

更新于 10-25 03:47

技能介绍

Jev Control Plane 用于为加载该技能的编码智能体环境独立操作 Jev。它面向单运行时环境的安装配置、状态检查、启用/禁用切换、后端选择,以及调用已批准的 routing、pruning、review 命令。Jev 是可选组件,各 profile 相互隔离;当所选操作没有可用后端时,按失败关闭处理。

用途与基本方式 每个独立智能体环境应使用唯一的 lower-kebab-case profile ID(如 jeopi、gjc、aside-u0)。--profile 选择 Jev 状态,--agent 选择 Agent Skill 目标位置;不得静默切换 profile 或回退到旧共享配置。在执行任何实时操作前,先用 status 检查确切 profile。状态返回 2 表示未激活或未配置,应跳过 Jev 门禁;返回 3 表示失败关闭,即配置无效或评估的操作链没有可用后端;返回 0 仅表示所请求链未被已知不可用,不证明模型质量或宿主强制执行。

配置与启用 使用 jev-plugin.mjs 进行初始设置或更新,采用先预览后应用模式:configure 带 --agent 和 --backend 可准备或更新 profile;不带 --apply 只校验并返回预览,带 --apply 则执行仅配置的写入,不下载也不推理,新 profile 默认关闭。API 配置要求 --key-env 指向调用进程中已存在的非空环境变量,除非该 profile 的 API 后端已保存密钥;省略 --key-env 可保留已有密钥,且只能使用变量名而非字面凭据。enable 和 disable 切换 JEV_ENABLED,不带 --apply 预览,带 --apply 写入。status 只显示已保存配置,不访问任何后端。后端注册表固定五种:api(向 JEV_API_ENDPOINT 发送 POST,带 Bearer 授权)、local(现有 Python /v1/systemone 服务器读取基础模型 logits)、ollama(原生 /api/chat 的 JSON-from-chat 适配器)、lmstudio(OpenAI 兼容 /v1/chat/completions 适配器)、systemone(支持 typesafe 默认、decide 和 vllm-jev-decision 驱动)。

可选会话集成与宿主行为 host-plan 为只读会话加载计划,不安装、注册、加载或启用任何内容;model-plan 只输出建议性 argv,不执行计划。Profile 默认 JEV_RUNTIME_MODE=advisory、JEV_REVIEW_MODE=off。显式 configure --runtime-mode assist 可在已注册且启用的集成中加载受信任的选中技能指令。不同宿主的自动行为不同:Claude 在提示时注入选中技能指令,不自动修剪历史或强制执行动作;jeopi/OMP/Pi 以自定义消息注入,上下文回调只能移除较旧的 Jev 自定义消息;Codex 0.162.1 使用 UserPromptSubmit 注入和可选的 PreToolUse 审查,要求在 /hooks 中信任精确钩子定义。审查模式 off 不审查,advisory 报告判定,enforce 在非 permit 时拒绝,但钩子从不返回宿主权限授予;宿主失败、钩子被跳过或超时可能失败开放,不构成操作系统安全边界。

策略、操作与限制 每个操作可配置 backend 和 fallback 允许列表;解析顺序为 CLI --backend、操作后端、JEV_MODE、api,不允许跨 profile 回退。所有后端默认 tier 为 unvalidated,只有 api 和 systemone 的校准决策头驱动在精确服务模型证明下才可为 validated;local、Ollama、LM Studio 永不 validated,因此永不 permit。route-skills 的门限和适配阈值均为 0.30,失败时显式返回 none;prune-context 按位置键提问,除非答案为否且置信度至少 0.8 否则保留;review 结果绑定后端信息,非 validated 层级的 permit 会降为 proposal_only。缺失凭据、后端不可达、契约错误、响应格式错误和超时均视为不可用。向托管服务传输任务、上下文或提案数据前应请求批准,输出应视为提案并按宿主确认策略处理。