Skip to content

v1.4.7 — 🔌 商业平台接口版

Choose a tag to compare

@KongFangXun KongFangXun released this 11 Sep 08:22
· 2137 commits to main since this release

🔌 给商业平台预留的接口一次到位——组织看得见(缺口与绩效)、协作转得动(PR 生命周期)、数据进得来(推送与租户路径);引擎与商业层从「能对话」走到「能分工」。

TL;DR (EN): The full interface layer for the commercial platform: gap & contribution queries, PR lifecycle tools, workflow-as-object CRUD, tenant namespace v0, onboard-prompt generator, USB-burned workflows, TrainChannel cloud training, data_push dual-gate ingestion, at-rest encryption wired into the daemon, and repo-hash isolation for runtime audit logs. 95 MCP tools · 4,279 tests · 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.7 --doctor

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

# GitHub Action(PR 自动审计)
uses: KongFangXun/sofagent@v1.4.7

🔨 核心变更

🔌 商业平台接口面(G2 / G4 / G6 / G7 / G13 / G14)

  • 读接口:workflow_gaps 三类缺口判定(可转悬赏 PR)· contribution_query 人机同标准贡献度 + orgId 租户过滤 · 节点级 visibility 三级枚举 + 审阅门联动 · 多租户 v0 data/<tenant>/ 路径隔离
  • 写接口:pr_submit / pr_review / pr_merge 状态机 + confidence 两态三铁律 + branch→trunk 合并联动 + 拒绝留痕进 decision-log
  • 对象化:workflow CRUD 四 tool + schema 校验门(字段路径级错误)+ trigger.schedule 节点级定时

☁️ 云训练执行收口(TrainChannel)

  • TrainChannel 标准接口四动作 + ssh 自管 VM 通道引擎自研 + 托管 API 适配规范(开源不预设云厂商,引擎出参考示例)
  • 双通道事件归一入 train-audit HMAC 链 + 失联止损 kill/cancel + 成本入账,daemon 真实执行接线

🚀 交付与接线收口(FDE 三件 + daemon 批)

  • workflow 烧进 USB(验签后自动加载)· G8 首部署 cron 包(--with-first-deploy-cron + daemon 5 分钟消费)· 上岗 prompt 生成器(职责/边界/工具面三段)
  • data_push 接线(schema 校验 + 敏感分拣双闸)· 静态加密 daemon 启动接线(密钥就绪即密文落盘)· runtime-audit repo-hash 隔离 + audit 规约层与 PROV-O 导出

🔒 BugFix(上版遗留)

  • G8 执行链双层断点闭合(CLI create + daemon 消费)· im-outbox 519 封积压排水 · L2 巡检观测性收口(空 catch 落痕 + 触发源标注)
  • SECURITY / LIMITATIONS 等五处「排期 v1.4.7」宣称全部翻牌兑现;S388 场景 shell 引号语义陷阱修复(CI shellcheck 零告警)

✅ 质量验证

检查项 结果
npm test 4279 tests 全绿 ✅
acceptance-test 328/328 场景全绿(409 断言 · SKIP 0)✅
shellcheck 零 error 零 warning ✅
check-version 109/109 全绿 ✅
回归检查 96 维度 ✅
release-gate verdict=PASS ✅
fresh-eyes 16 视角审查闭环 ✅

⚠️ 破坏性变更

  • MCP 工具 84→95:新增 11 tool(workflow_gaps / contribution_query / pr_submit / pr_review / pr_merge / workflow_create / workflow_update / workflow_node_add / workflow_diff_preview / onboard_prompt / data_push)——纯新增,既有 84 个 tool 签名不变
  • workflow schema 节点级可选字段扩展:visibility(open/private/result-only)与 trigger.schedule(cron)——旧格式无此二字段零破坏
  • 新增导出:reduceAuditHistory / exportProvTurtle / exportProvJsonLd · workflowMergeBranch / prRecordMergedVersion / prRevertToOpen · computeRepoHash · TrainChannel 及配套类型——全部增量,无删除导出
  • 运行时审计日志路径分层:data/audit/runtime/llm-calls.jsonl → data/audit/runtime/<repo-hash>/llm-calls.jsonl(data-sovereignty 同构)——旧路径历史保留可读(读侧 fallback),不迁移不回填

🔗 深入了解

想看什么 链接
全部变更明细 CHANGELOG
上手指南 HANDBOOK
有问题 / 晒场景 Discussions · good first issues
npm 包 @sofagent/audit · 共 14 包(npm)

📖 详细开发日志