Skip to content

更新记录 ​

当前托管生产私有源提供 Python 0.7.0、0.8.0、0.9.0、0.10.0 与 npm 0.1.0、0.2.0。默认版本仍为 Python 0.10.0 和 npm 0.2.0,向导固定当前可用版本。

Python yi-guard-sdk 0.11.0 与 npm @yilabs/guard 0.3.0 ​

不可变发布资产已于 2026 年 11 月 9 日发布。控制面部署采用相应发布记录后,托管生产私有源才会提供这两个新包名;它们目前还不是生产安装默认版本。

历史版本保留原来的包名。Python 模块 preworld_guard、CLI preworld-guard 与环境变量名称保持兼容;新旧 Python 分发包提供同一个模块,应安装在独立环境中。

Python preworld-guard-sdk 0.10.0 与 npm @preworld/guard 0.2.0 ​

2026 年 11 月 4 日发布。这两个版本保留原来的包名。

  • SDK 每次请求都发送项目身份;令牌与项目不匹配时,在工具执行前拒绝。
  • 只有其他规则条件匹配时才处理缺少可信主体的情况;加载策略时拒绝非法或超长的正则表达式。
  • 客户端重启后会补发持久化审计事件,不必等待新事件;执行前的拒绝也会记审计,并有有界限流。
  • Python 沙箱只继承最小环境变量,其他变量需显式放行;超时后清理整个进程组。命令钩子出错时不执行,未结束的调用记为结果未知。
  • 网关凭据扫描覆盖转义和流式响应,MCP 也扫描结构化内容;这些检查不等于通用内容审查。

Python SDK 0.9.0 与 npm @preworld/guard 0.1.0 ​

2026 年 10 月 15 日起在私有源提供。

  • 新增五个框架适配器:Microsoft Agent Framework、LlamaIndex、Agno、DSPy 和 CrewAI,都走共用的判定路径。见框架适配器。
  • TypeScript SDK @preworld/guard 0.1.0,带 Vercel AI SDK(ai@7)的适配器。见 TypeScript SDK。
  • SUBJECT_REQUIRED:动作没有可信主体,却带着某条规则要和 session.subject_id 比较的参数时,现在按当前模式当作这条规则的拒绝处理。以前这样的规则会悄悄匹配不上,拒绝规则就失效了。所有路径都一样:适配器、@guard.tool、MCP 代理、出站、替代工具和预演。
  • 身份出错时一律不执行:resolve 抛出异常或返回的不是身份时,结果是 GUARD_IDENTITY_UNAVAILABLE,模型看不到错误内容。
  • 连接出错时重试一次:访问控制面遇到连接级错误时重试一次,但只在不会重复副作用的情况下。一个请求最长可能用掉两倍的超时时间。
  • 事件队列按 Agent 分开:从同一目录启动的 Agent 不再共用一个队列,以前这可能让某个 Agent 被 403 阻断。
  • 集合按元素的规范 JSON 排序,按列表写的规则和审批摘要不再随进程变化。
  • openai-agents 放宽到 0.20 及以上、0.24 以下。

0.8.0 ​

2026 年 10 月 12 日起在私有源提供。

  • 所有适配器共用一条判定路径,给模型的内容也统一成 MCP 代理的格式:status、reason_code、message、policy_version,审批时另带票据字段。任何导致无法判定的情况都抛出 GuardUnavailable,工具不执行。
  • 新增适配器:LangGraph(guard_tool_node)、Pydantic AI(guard_hooks)、Google ADK(GuardPlugin)。
  • guard_resume(ticket_id):模型再次提出同一个调用时,适配器按批准执行一次。
  • 已用过、已过期或不匹配的票据现在按拒绝处理(APPROVAL_NOT_CONSUMABLE)。申请时遇到新策略的票据是 POLICY_CHANGED。新增异常 GuardSubjectRequired、GuardFallbackUnavailable、GuardRequestRejected。新增方法 approval_status、cancel_approval、prepare_fallback、execute_fallback、aexecute_fallback。
  • OpenAI Agents:默认情况下,拒绝和待审批现在是工具的结果,运行继续。on_deny="raise" 保留原来的行为。
  • Claude Agent SDK:放行的工具执行前记录 started,并通过 PostToolUseFailure 记录失败的调用。需要 claude-agent-sdk>=0.1.26。
  • LangChain:GuardMiddleware 把审批票据交给模型,降级时执行替代工具。
  • import preworld_guard 不再导入任何框架。

0.7.0 ​

  • Claude 适配器判定不了就不执行:GuardHooks 从不抛异常,任何无法判定的情况都以 GUARD_UNAVAILABLE 拒绝工具。Guard 放行时,你们自己的权限规则现在照常生效(on_allow="allow" 恢复原来的行为)。
  • 访问控制面可以显式配置代理和 CA:GuardClient(proxy=..., ca_bundle=...),或者 PREWORLD_GUARD_PROXY 和 PREWORLD_GUARD_CA_BUNDLE。仍然不读 HTTPS_PROXY 和 SSL_CERT_FILE。
  • 并行的工具调用共用一次策略刷新。
  • 主机从休眠中醒来后,策略能正确刷新。

0.6.2 ​

  • MCP 代理的 HTTP 下游校验 Host 和 Origin(--allowed-host、--allowed-origin)。
  • 转发上游服务的进度通知。未知工具和不存在的资源返回 JSON-RPC -32602。嵌入资源的文本也会被检查。

0.6.1 ​

  • 云托管网关用到的授权桥。

0.6.0 ​

  • MCP 上游的逐用户 OAuth,授权保存在你们这边的加密 vault 里:preworld-guard mcp-auth connect、status、disconnect。新增 oauth extra。
  • 上游服务发来的 sampling、表单和 URL 提问可以转发,每一次都单独判定和审计。

0.5.0 ​

  • 针对接入包的 preworld-guard connection-check。
  • 资产清单,以及自动登记包装过的工具。
  • 离线策略回放(preworld-guard policy-replay)。云端预演改为在信息不足时如实说明,不去猜。

0.4.0 ​

  • 出站连接检查每一条 DNS 解析结果,只连接检查过的地址。内网要显式配置地址段。
  • HTTP broker 支持模型请求,包括流式。
  • identity extra:broker 和 MCP 代理的 JWT 校验。上游凭据按可信主体选择。

0.3.0 ​

  • GuardClient.start():注册执行器、发心跳、确认已加载的策略。
  • 在你们这边保存审批快照并恢复执行(@guard.tool(..., pending=True)、guard.pending.resume)。
  • preworld-guard diagnose。
  • HTTP broker 用的 gateway extra。