Repository navigation
v1.4.7 — 🔌 商业平台接口版
🔌 给商业平台预留的接口一次到位——组织看得见(缺口与绩效)、协作转得动(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三级枚举 + 审阅门联动 · 多租户 v0data/<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) |
📖 详细开发日志