更新记录
当前托管生产私有源提供 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/guard0.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。新增oauthextra。 - 上游服务发来的 sampling、表单和 URL 提问可以转发,每一次都单独判定和审计。
0.5.0
- 针对接入包的
preworld-guard connection-check。 - 资产清单,以及自动登记包装过的工具。
- 离线策略回放(
preworld-guard policy-replay)。云端预演改为在信息不足时如实说明,不去猜。
0.4.0
- 出站连接检查每一条 DNS 解析结果,只连接检查过的地址。内网要显式配置地址段。
- HTTP broker 支持模型请求,包括流式。
identityextra:broker 和 MCP 代理的 JWT 校验。上游凭据按可信主体选择。
0.3.0
GuardClient.start():注册执行器、发心跳、确认已加载的策略。- 在你们这边保存审批快照并恢复执行(
@guard.tool(..., pending=True)、guard.pending.resume)。 preworld-guard diagnose。- HTTP broker 用的
gatewayextra。