Skip to content

v1.5.0 · 🛡️ 治理面 · 可见性与本体成熟

Choose a tag to compare

View all tags
@KongFangXun KongFangXun released this 19 Sep 14:34
· 1949 commits to main since this release
v1.5.0
52e7e1b

🛡️ 引擎长出「治理面」——约束层的价值第一次被摆上面板（Dashboard 独立「治理」tab）、本体数据经得起时间追问（双时态时点快照）、证据跨层对得上账（trace_reconcile 三源四态——「别当摄像头当法医」）；MCP 工具面 104 → 105。

TL;DR (EN): The engine grows a governance face — a dedicated Governance tab in the Dashboard (six KPI cards + dataset review + lineage compliance report), bitemporal ontology facts with point-in-time snapshots ("what did the system know on that day"), and cross-layer evidence reconciliation (agent self-report vs git diff vs model behavior, four verdicts — "be a forensics officer, not a camera"); plus a fail-closed DAG Validation Engine, FDE companion-period completion, DSH plugin event wiring, and legacy cleanup. MCP tools 104 → 105. 4905 tests · 105 MCP tools · MIT.

⚡ Install / Upgrade

# 新装（五形态任选：FDE 插件 / Skill / MCP / CLI / GitHub Action）
curl -fsSL https://raw.githubusercontent.com/KongFangXun/sofagent/main/install.sh | bash

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

# 一条命令装全四大功能包（裸名总包）
npm i -g sofagent

# GitHub Action（PR 自动审计）
uses: KongFangXun/sofagent@v1.5.0

🔨 核心变更

📊 治理 KPI 面板（Dashboard「治理」tab）

  • KPI 六卡：安全边界触发率 / 审计覆盖率 / HITL 响应时延 / 趋势对比 / 任务重复执行率 / trace 对账一致率
  • 数据集审阅卡（版本台账抽样 + 分拣/脱敏命中标记——validator 管结构质量，人审管语义质量）+ lineage 合规报告导出（数据从哪来 → 过什么闸 → 版本演进 → 审计链 HMAC 引用——可递交企业合规/法务）+ 治理周报 markdown 导出

🕰 本体数据双时态事实

  • validFrom/validTo + stateAt 时点快照——「系统在某天知道什么」可回放；三层渐进加载（entity 摘要 → relations → 全文，token 预算联动降级留痕）

🛡 Ontology Validation Engine

  • DAG 三色 DFS 环链定位 + schema 兼容三态校验（悬空实体/字段缺失/类型错配）+ 激活前置门 fail-closed——校验器自身异常同样拒绝激活

🔍 跨层证据对账引擎（trace 对账）

  • 新 tool trace_reconcile：Agent 自述 vs git diff vs 模型行为三源对齐，一致/漏报/幻觉/瞒报四态判定 + 回滚闭环豁免——「别当摄像头当法医」

🧩 FDE 陪跑期 + DSH 插件事件接线

  • 14 天陪跑期期满总结报告 + fde_deploy 登记衔接
  • DSH 插件 7 seamHandler 接既有 bridge API（audit 4 事件位 + inject/evolve/rollback 各 1）——判定逻辑零改动纯接线

🔒 BugFix（上版遗留）

  • 存量清扫四件（退役 API / 别名下线 / legacy 旗标 / CLI shim）+ @sofagent/harness → @sofagent/inject 更名——迁移指引见下方破坏性变更

✅ 质量验证

检查项 结果
npm test 4905 tests 全绿 ✅
acceptance-test 437/438 passed · SKIP 1（S410 依赖 gh release，发布后自然闭环）✅
shellcheck 零 error 零 warning ✅
check-version 131/131 全绿 ✅
回归检查 89/89 维度 PASS（gate 运行口径）✅
release-gate verdict=PASS（有条件放行 · 7 项签署前置 tag 前清零）✅
fresh-eyes 23 视角审查闭环（4 轮 sequential + 文档排版视角）✅

⚠️ 破坏性变更

  • @sofagent/harness 更名为 @sofagent/inject——import { ... } from '@sofagent/harness' 改为 @sofagent/inject（旧包名已废弃）
  • checkHistoryChainIntegrity（@public，audit 与 core 双导出）正式移除——迁移至 checkHistoryChainDetailed 结构化三态（v1.4.3 已提前一版公告）
  • composeWithReactAgent 别名从 orchestrator @public 下线——统一走 composeWithDeepAgents（v1.4.3 已公告弃用）
  • loop --legacy 旗标退役——默认路径即 LOOP StateGraph 节点级流转，直接 loop --task <描述>
  • 升级后需重装 git hook：本版 hook 行为有变更（commit-msg 解析链收窄为全局根限定 + post-commit 加密态对账）——git hook 是拷贝而非软链，每个装过 hook 的仓库需逐个重装：sofagent-audit --install-hook（不重装则新仓库仍走旧 hook，无法感知本版修复）

🔗 深入了解

想看什么 链接
全部变更明细 CHANGELOG
上手指南 HANDBOOK
有问题 / 晒场景 Discussions
npm 包 @sofagent/audit · 共 15 包（npm）

📖 详细开发日志

Contributors

public
Assets 2
Loading