Skip to content

v1.5.4 — 🎯 执行模块 · 模型路由与凭证验证

Choose a tag to compare

@KongFangXun KongFangXun released this 30 Sep 12:39
· 1126 commits to main since this release

🎯 执行模块——模型路由与凭证验证:本版给 Agent 装上路由决策链(三级任务智能分流 / 敏感强制本地 / 本地不可用即硬拒)与凭证隔离 Vault(代码层取不到 token 明文),外加多实例自验证表决、AI 节点治理接入与授权/凭证对账。MCP 工具 103→104 · 5569 tests · MIT。

TL;DR (EN): Execution module — model routing & credential verification. This release adds a routing decision chain (three-tier task routing / sensitive-content forced-local / hard-block when local is unavailable) and a credential isolation Vault (token plaintext never reachable from code level), plus multi-instance voting, AI-node governance onboarding, and mandate/credential reconciliation. MCP tools 103→104 · 5569 tests · MIT.

⚡ Install / Upgrade

# 新装(五形态任选:FDE 插件 / Skill / MCP / CLI / GitHub Action)
curl -fsSL https://raw.githubusercontent.com/KongFangXun/sofagent/refs/tags/v1.5.4/install.sh | bash

# 已装用户升级到本版
npx @sofagent/audit@v1.5.4 --doctor

🔨 核心变更

🧭 模型路由层(三级任务路由 · 判定链三层)

  • 三级任务路由 + 敏感内容强制本地 + 敏感且本地不可用 fail-closed block;判定链三层(L0 声明式映射零模型调用 / L1 语义分类 / L2 规划推理),L1/L2 默认不启用(留 v1.8.0 校准),生产 adjudicate 现行只到 L0——验收口径已写明
  • 本地槽位排队:槽位上限可配 / 超限排队(位置 + 预估等待)/ 超时升级留痕 routeReason / 判定链不占本地主模型槽(行为锁 S457/S458/S463)

🔐 凭证隔离 Vault(代码层拿不到 token)

  • Agent 沙箱 HTTP 请求经 Vault 动态注入凭证,代码层取不到 token 明文(视图/快照/redact 三面零 secret · S460)
  • 授权/凭证对账:范围 / 时效 / 缺授权三类错位可判越权风险(+CREDENTIAL_RECONCILE,DecisionKind 15→16)

🗳️ 多实例自验证(表决)

  • N 实例并发表决:多数决达阈 / 全同票 / 法定人数不足 escalate / 平票 tie / N<2 fail-closed——CLI vote 三参数非法即报错(不静默回退默认值 · S459/S462)

🤖 AI 节点治理接入(第五章补做)

  • 外部 AI 节点登记 + 未注册引用告警(fail-closed)/ 节点事件三类进审计链 / 出站白名单裁决默认全拒(S461)
  • 生态实证:真机实测 @cordisjs/plugin-http@1.5.2 + 运行时 @deepseek-ai/cordis@4.0.2

🚧 发版与门禁强化(工程面)

  • 生产可达判定收紧(import type 不算接线 / 一跳断链 / 循环自证三盲区收口);任务书「零分支」lint;check-dev-prompt 符号归属断言 + 章节对账
  • 文档质量六维评分门禁上线(各维 ≥8 放行 + 分数棘轮);核心文档字数/可读性双棘轮

✅ 质量验证

检查项 结果
npm test 5569 tests 全绿 ✅
acceptance-test 470/470 passed · SKIP: 0 · EXIT: 0 ✅
shellcheck 零 error ✅
check-version 134/134 全绿 ✅
回归检查 85 维度 ✅
release-gate verdict=PASS with conditions(5 项 P1 转阶段九刚性门禁)✅
fresh-eyes 16 视角审查闭环 ✅

⚠️ 破坏性变更

  • MCP 工具数 103 → 104:新增 router_slots(本地槽位态观测 + 路由预览)
  • DecisionKind 15 → 16:+CREDENTIAL_RECONCILE(授权/凭证对账判决类)
  • 浏览器工具 MCP 面退役:playwright_* 工具组从 registry 注销(实现底座保留为 SDK 面);playwright optionalDep 清除

🔗 深入了解

想看什么 链接
全部变更明细 CHANGELOG
路由与槽位架构 ARCHITECTURE
上手指南 HANDBOOK
有问题 / 晒场景 Discussions

📖 详细开发日志