Repository navigation
v1.4.9 — 📡 设备接入与数据承接版
📡 引擎从「单机审计」长成「多设备数据承接层」——设备注册/心跳/派单一条链(G9)、授权读取 + 加密上行 + 审计计量一条链(G10/G11)、router 过站 session 承接一条链(T7),外加敏感识别三层插槽(T8)、权重灰度 AB(T9)、连接器注册与 workflow 模板血缘(G5b/G1);MCP 工具面 95 → 104。
TL;DR (EN): The engine now brokers multi-device data: device registry/heartbeat/dispatch (G9), authorized reads + encrypted uploads with audit metering (G10/G11), and router session ingestion for distillation (T7) — plus a 3-tier sensitive-detection slot architecture (T8), weight canary AB (T9), and connector/workflow-template lineage (G5b/G1). MCP tools 95 → 104. 4805 tests · 104 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.4.9 --doctor
# 一条命令装全四大功能包(裸名总包)
npm i -g sofagent
# GitHub Action(PR 自动审计)
uses: KongFangXun/sofagent@v1.4.9
🔨 核心变更
📡 设备接入与数据面(G9/G10/G11)
- 设备注册/发现/心跳(Ed25519 身份 + 注册表 + 心跳新鲜度判定 + 任务捎带/回执进审计链)
- 数据目录白名单授权读取(
device_data_query——平台拉数据必经授权门)+ 采集声明 opt-in 上行(device_data_push——WAL 加密暂存 / 明文不落盘 / 断点续传 / 审计计量 evidence 落盘) - 派单语义:在线才派单 + 掉线改派/挂起告警(路由算法留给 v1.5.1 事件总线)
🧠 训练数据飞轮(T7/T8/T9)
- router 过站 session 承接:
router_session_pushschema fail-closed + 签名验签 + 切窗滚动 + 脱敏贯通 + cost 台账 - 敏感识别三层插槽(L0 内置正则 / L1 词典 / L2 NER 外挂协议)——分类器与脱敏管线共用一套架构
- 权重灰度发布 AB:hash 稳定分流 + 三维度劣化独立触发 + 噪声保护 + 回退 HMAC 留痕
🔌 平台接口面(G5b/G1)
- 连接器注册/发现(白名单三形态 + null 策略全拒 + 租户隔离)
- workflow 模板导出/导入 + 血缘追踪(事件流往返 / 环防护 / 完整性校验 / 私域泄漏拒绝)
🛠 工程效能(T6/T10)
- installer skill 四步装机引导(逐步 rollback + doctor 判据 + 验签 fail-closed)
- 执行侧模型清单双源扫描随心跳上报 + 执行时 skill 快照(打包/清理/审计锚点)
🔒 BugFix(上版遗留)
- 13 项修复:train webhook SSRF / fs-watch 启动行分流 / 引擎崩溃退出码独立为 4 / 审计链黄色 verdict 定位面 等(明细见开发日志)
✅ 质量验证
| 检查项 | 结果 |
|---|---|
| npm test | 4805 tests 全绿 ✅ |
| acceptance-test | 433/433 passed · SKIP: 0 · EXIT: 0 ✅ |
| shellcheck | 零 error 零 warning ✅ |
| check-version | 119/119 全绿 ✅ |
| 回归检查 | 90 维度 ✅ |
| release-gate | verdict=CONDITIONAL PASS(0 P0;RC-3/RC-5 已 tag 前收口)✅ |
| fresh-eyes | 单盲四角色两轮闭环(P0=0 / P1=0 终态)✅ |
⚠️ 破坏性变更
无公开包 API 破坏性变更。内部:@sofagent/daemon 巡检器 re-export shim 化(真实现迁至 core federation.ts),直接 deep-import 巡检器路径的调用方需改走包根导出。
🔗 深入了解
| 想看什么 | 链接 |
|---|---|
| 全部变更明细 | CHANGELOG |
| 上手指南 | HANDBOOK |
| 有问题 / 晒场景 | Discussions |
| npm 包 | @sofagent/audit · 共 15 包(npm) |
📖 详细开发日志