Repository navigation
v1.5.4 — 🎯 执行模块 · 模型路由与凭证验证
🎯 执行模块——模型路由与凭证验证:本版给 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(本地槽位态观测 + 路由预览) DecisionKind15 → 16:+CREDENTIAL_RECONCILE(授权/凭证对账判决类)- 浏览器工具 MCP 面退役:
playwright_*工具组从 registry 注销(实现底座保留为 SDK 面);playwrightoptionalDep 清除
🔗 深入了解
| 想看什么 | 链接 |
|---|---|
| 全部变更明细 | CHANGELOG |
| 路由与槽位架构 | ARCHITECTURE |
| 上手指南 | HANDBOOK |
| 有问题 / 晒场景 | Discussions |
📖 详细开发日志