sofagent 是纯本地纪律层，数据不出本机——但以下数据以明文 Markdown 存储，请评估风险：
| 文件 | 位置 | 可能含 |
|---|---|---|
task/logs/ |
.sofagent/task/logs/YYYY-MM/YYYY-MM-DD.md |
任务摘要、代码片段、API 响应摘要、对话摘要 |
think.md |
.sofagent/think.md |
反思记录，可能含踩坑细节、失败模式、决策推理 |
scoring/ |
.sofagent/scoring/ |
Skill 使用记录 |
orchestrator/ |
.sofagent/orchestrator/ |
编排决策历史 |
当前状态（v0.99）：
- ✅ 脱敏：sanitize() 管道扫描 API Key / 密码 / 手机号，写入前自动打码
- ✅ 数据保留：cleanup.sh 支持 --purge --before 定时清理 + tar.gz 归档
- ✅ 审计日志：task-record.sh 独立审计日志 + task/logs 追溯双通道
⚠️ 明文存储：.sofagent/下文件仍为 Markdown 明文，未做加密⚠️ 企业生产环境暂不建议使用——数据明文存储 + LLM 自评无外部基准，GDPR / 等保 / SOC2 场景直接出局。age 加密推到 v1.x+ 待评估（v0.85 砍削决策：先验证核心价值再谈企业级）.sofagent/目录权限为 700（仅当前用户可访问），但同一服务器其他用户若有 root 权限可读
企业环境建议：
- 对
.sofagent/目录做 gpg 加密或放在加密卷上 - 脱敏/保留/审计能力已在 v0.71 落地，详见 企业部署指南
install.sh 是 sofagent 的一键安装脚本。以下是其完整行为清单，供安全审查：
| 操作 | 路径 | 说明 |
|---|---|---|
| 创建目录 | ~/.openclaw/skills/sofagent/ 或 ~/.workbuddy/skills/sofagent/ |
按平台部署 Skill 文件 |
| 创建目录 | ${项目目录}/.sofagent/task/logs/ |
数据目录，权限 700 |
| 复制文件 | 宪法(fde.md) + 6 核心 Skill + 数据模板 + 配套脚本 | 从仓库 sofagent/skill/ 和 sofagent/scripts/ 复制到目标目录 |
| 写入配置 | ~/.openclaw/openclaw.json（仅 OpenClaw） |
注册加载链 Hook |
| 写入配置 | ~/.openclaw/config.json（仅 OpenClaw） |
注入 loopDetection 断路器 |
| npm install | agency-orchestrator（仅 OpenClaw + 有 npm） |
编排引擎依赖 |
| 安装服务 | launchd(macOS) / systemd(Linux) | daemon 后台进程（交互确认后） |
- ❌ 不会
sudo——所有操作在用户权限范围内 - ❌ 不会改系统文件——不碰
/etc、/usr、/System - ❌ 不会联网下载额外内容（除了 npm install ao，且可
--no-ao跳过） - ❌ 不会执行远程脚本（
--remote模式只做 git clone 官方仓库） - ❌ 不会收集或上传任何用户数据
install.sh 拆分为以下模块，便于逐模块审查：
| 模块 | 行数 | 职责 |
|---|---|---|
install.sh |
193 | 主入口（组装 + 参数解析） |
lib/config.sh |
143 | 配置加载 + 常量定义 |
lib/daemon-lib.sh |
142 | daemon 公共函数库 |
lib/daemon-register.sh |
115 | Hook + daemon 注册 |
lib/file-deploy.sh |
109 | 文件部署 |
lib/platform-detect.sh |
102 | 平台探测 + 参数解析 |
lib/post-install.sh |
97 | 安装后检查 + 输出 |
如果你发现安全问题（不是普通 Bug），请通过以下方式私密报告：
- 邮件：kong.yao@evfrey.com
- GitHub 私密 Issue：新建 Issue 时选 "Security" 标签
请不要在公开 Issue 中披露安全漏洞细节。
- 确认：7 天内确认收到报告
- 初步评估：30 天内给出初步评估和影响范围
- 修复：根据严重程度排期——高危（数据泄露/权限提升）优先修复并发布补丁版本
本安全策略适用于 sofagent 项目仓库内的所有文件。第三方依赖（如 agency-orchestrator、OpenClaw）的安全问题请向对应项目报告。
sofagent-audit（v0.92+）是 TypeScript CLI，执行 execFileSync('git', ...) 读取 git diff 和文件系统。不使用 eval、不 spawn shell、不执行外部脚本。命令参数使用数组传入（['diff', '--unified=3', range]），range 参数经过正则校验 [a-zA-Z0-9~^.\-]，无命令注入风险。
数据访问：审计工具只读取 git diff 输出和 .sofagent/task/logs/ 目录下的 Markdown 文件，不发起网络请求，不写入任何文件。
信任边界：审计工具本身是确定性的——给定相同的 git diff 和日志，输出相同。但审计 A7/A8 的结果依赖 Agent 日志的真实性（Agent 可以伪造日志）。这不是审计工具的安全漏洞，是架构级别的信任模型选择。详见 LIMITATIONS.md（「审计工具信任模型：Agent 自我报告」节）。
agency-orchestrator (ao) 是 sofagent 编排引擎的运行时依赖（npm 包 agency-orchestrator@0.7.5，Apache-2.0 许可）。install.sh 已将版本号 pin 到具体版本。
降级路径：
install.sh --no-ao是 v0.85 起推荐的默认路径（非 OpenClaw 平台）。编排能力退化为手工拆解，约束层不受影响task-orchestrate.ts（已从 bash 迁移至 TypeScript）在 ao 不可用时自动切到默认编排模式
供应链安全建议：
- 每次
npm install后运行npm audit - 定期检查 agency-orchestrator 仓库 的 CHANGELOG
- 内网环境建议预装 ao 并验证
ao compose --version通过后再部署