sofagent

_{简体中文 | English}

目录

• 这是什么
• 该不该装？
• 核心特性
• 什么是 FDE Harness
• 多平台挂载
• v1.9.0：判定底座 · 阶段四（消费与收口）
• FDE Harness 两阶段
• 安装
• 使用
• 常见问题
• 生态与文档索引

这是什么

💬 一句话版本：进场时它替你把业务摸清、写成文件；离场后你的数字员工每次改代码、动文件，都按文件过一道安检、留一份记录、存一个快照——出事能查、能回滚。

开源 FDE Harness 层（Harness = 「缰绳」，套住 Agent 的治理层；FDE = Forward Deployed Engineer 前线部署工程师，详见〈什么是 FDE Harness〉）——嵌在成熟 Agent（DSH / OpenClaw / WorkBuddy）与模型层之间做治理：进场把业务判断写成文件（工作流/本体数据/AI 节点），离场按文件审计每次变更。约束层五种能力（注入·审计·回溯·沉淀·进化），五种形态分发（FDE 插件 / Skill / MCP / CLI / Dashboard）。 sofagent 不造 Agent——交付的是让任何 Agent 被管住的那一层（管住强度按宿主分档：DSH/OpenClaw 硬注入可拦截，其余档位为建议性注入 + git hook 审计兜底——见〈多平台挂载〉档位表）。

_{零配置审计实拍：一行命令审计最近一次 commit，密钥泄漏当场拦截（现为 sofagent audit）}

30 秒–2 分钟轻量试用（首次含 npx 拉包（网络依赖），复跑秒级；引擎约 1.1s / 单入口总耗时 0.4-5s（Apple Silicon 约 0.4s，冷路由/低配至 5s，2026-11 实测），双口径见下）：npx -y -p sofagent sofagent audit（任意 git 仓库，密钥泄漏当场拦截）。

💡 npm 通道只有伞包一个形态：npm i -g sofagent 装的就是完整依赖树（依赖包数见下，口径以当轮 npm ls 实测为准）——不存在更小的「轻量包」。要更小安装面，用 npx 临时形态（npx -y -p sofagent sofagent audit，用完即弃不常驻；能力面见 LIMITATIONS）。

💡 试用时提交消息请写 ≥6 字符（如 initial audit test）——A19 质量规则（编号对照见 SECURITY 规则清单）对超短消息（init/add）判红属设计意图（防无意义提交信息），不是故障。

五分钟沙箱演示（v1.5.1 已交付；沙箱隔离、真实文件零接触）：npx -y -p sofagent sofagent audit demo——一条命令跑完「沙箱构建 → 注入 → 故意违规 → 审计拦截 → 快照回滚 → HMAC 举证导出」五幕链路（--speed fast 为 60 秒版；产物落 $SOFAGENT_DATA/demo，不触碰被审仓库）。（demo 经 npm 通道提供；install.sh 安装态 CLI 暂无 demo 子命令）

版本说明：v1.9.0 已发版（2026-11-12）；npm 可安装最新版 @sofagent/audit@1.9.0。

该不该装？

... View full README on GitHub