sofagent 是一个开源的 FDE Harness，定位在成熟 Agent（DSH / OpenClaw / WorkBuddy）与模型层之间做治理。其核心思路是：进场时把业务判断写成文件（工作流、本体数据、AI 节点），离场后按这些文件审计每一次变更。它不造 Agent，交付的是让任何 Agent 被管住的那一层。
主要能力
约束层提供五种能力：注入、审计、回溯、沉淀、进化。包含 28 条审计规则（密钥泄漏、越界编辑、注入防御、权限红线等），违规当场拦截；支持 fail-fast 但默认非 fail-closed。提供 104 个 MCP 工具和 11 个插件，工具与能力面覆盖证据分档。审计后自动快照，支持一键回到任意快照。AgentShield 提供五类配置面静态扫描。审计历史落 HMAC 链，可通过 --verify-chain 离线复算链完整性。
使用方式
30 秒零配置试用：在任何 git 仓库运行 npx -y -p sofagent sofagent audit，审计最近一次 commit。若只需审计 CLI，可安装 scoped 包：npm i -g @sofagent/audit。五分钟沙箱演示：npx -y -p sofagent sofagent audit demo，跑完“沙箱构建 → 注入 → 故意违规 → 审计拦截 → 快照回滚 → HMAC 举证导出”链路。完整安装需 Node.js ≥ 18，先下载审查再执行；安装脚本写 ~/.sofagent/ 和 ~/.local/bin，仅显式传 --platform 时才写平台集成目录。审计兜底通过 git hook 实现：sofagent audit --install-hook，默认启用 17 条规则，完整 28 条需在 .sofagent/config.yml 开启 extendedRulesEnabled: true。多平台挂载通过 bash install.sh --platform <平台名> 选择档位。
适用场景
适用于企业将 AI 编程智能体引入组织架构时的治理：进场把岗位职责写成文件，离场按文件做绩效考核、组织记忆、试错容错。也适用于希望约束 Agent 行为、审计每次变更、沉淀经验的开发团队。
限制
处于阿尔法施工期（v1.x），功能面快速变动，不承诺接口稳定；自 v2.0.0 起进入贝塔阶段。config.yml 默认非 fail-closed，规则可被 Agent 篡改绕过；多租户写入侧隔离尚未落地。审计日志默认明文落盘，企业部署建议开启静态加密。当前为单机单用户设计。audit 失败可能因提交消息过短（如 init/add）触发 A19 规则。npm i -g sofagent 带来完整依赖树，含 602 个包，其中 5 个含原生模块，新版 npm 可能静默跳过编译。Dashboard 仅随完整安装提供，npm 直装不含静态资产。判定层（S1M）排期 v1.6.0–v1.9.0 建设、v2.0.0 宣告，尚未交付。
