🔒安全设计
核心介绍
LZ-Agent 作为信息安全体系的执行层,具备以下安全机制,防止越权执行与虚假报告。
一、主机白名单守卫(ops_guard.py)
按代码实情:守卫对象是目标主机,不是命令内容。
- 放行范围:安全三机 .71/.74/.75 + 路由器 172.168.100.1 + 本机 .77(含 localhost/127.0.0.1/空 host)
- 约束对象:仅 agent 名含 dailyops/daily 的 Agent;仅 shell_command/shell/remote_shell/remote_command/python_execute 类执行器
- 默认策略:本机执行永远放行;非 dailyops 类 Agent 不强制;其他执行器类型不审核
- 拒绝结果:返回
主机 X 不在允许操作范围(仅安全三机+路由器+本机)
二、致命错误首轮终止
engine.py: is_fatal_llm_error() 识别以下致命错误,首轮即终止任务,避免 200 轮空转白烧:
- 401 / 403 鉴权错误
- 账户欠费(AccountOverdueError)
- 模型不存在 / 无效请求
实测:欠费场景 200 轮空转 → 5 秒内失败,并给出「去控制台换模型」提示。
三、执行证据校验(engine.py,success 分支强制)
按代码注释
执行凭证校验(2026-10-18)四条规则:执行权在 LZ-Agent 手里,模型的自述不可信,以「是否真的产生过执行记录」作为完成凭证。
- 任务确实执行过动作 → 放行(凭证成立)
- 零执行但显式声明「无需执行/纯对话」→ 放行
- 零执行且需求本身需要执行(巡检/查询/检查等)→ 判失败
- final_result 里出现具体命令输出特征(Filesystem/内核版本/容量等)但无任何执行记录 → 判失败(几乎可以确定是编造)
配套函数:requires_execution()(需求是否隐含执行;「不要调用工具/只回复」等免执行声明优先)、claims_execution()(模型是否声称执行过)、looks_like_command_output()(强特征命中 1 个或弱特征 2 个即像命令输出)、ungrounded_values()(挑出 final_result 中在真实 stdout 找不到依据的技术值)。
另有重复动作熔断:同一(执行器, 主机, 命令)连续下发 2 次(_MAX_SAME_ACTION=2)即向模型发出纠正提示。
四、反编造提示词
llm.py 系统提示词「执行机制与真实性红线」节:
- 明确模型无直接执行能力
- 严禁编造系统事实
- result 只能引用 feedback 原文
- 查证类必须先 action 再 success
五、中转站模型不可用于运维执行(重大结论)
中转站(.76:18080)的 Zen-* 模型会编造命令执行结果,禁止用于自动化运维。
实测(多步任务,交叉验证真机数据 .77 根分区 147G/13%、内核 7.0):
| 模型 | 真实执行次数 | 编造行为 |
|---|---|---|
| Zen-big-pickle | 0 | 全部编造:内核报 6.14、磁盘报 25G/67% |
| Zen-mimo-v2.6-flash-free | 3/4 | 第 4 条 df 编造 25G/72%;把 root 说成 lz |
| Zen-longcat-2.5-preview-free | 1/4 | 声称执行 4 条,实际只有 1 条真实 |
| Zen-space-bunny-free | 3/4 | 第 4 条编造 overlay 78% /32%;把 root 说成 lz |
额外证据: 1. 原生 tools/tool_choice 参数传入后,4 个模型均不返回 tool_calls,只回纯文本 2. 给严格 system prompt 时,big-pickle/mimo 会正确输出 JSON action,但 longcat/space-bunny 在带 action 的同时声称「已执行」并编造数据 3. 编造数据具有迷惑性:whoami=lz、date 这类低熵值容易猜对,极易蒙混过关 4. 任务仍会返回 completed,不校验就会产出假报告
建议:运维执行类任务用更强模型;中转站 Zen-* 仅适合「纯文本生成/问答」。
六、Python 沙箱禁令
PythonExecutor 禁止代码含 os.system / subprocess / eval / exec / __import__(除非配置显式放行),防止沙箱逃逸执行系统命令。
七、输出净化
strip_ai_footer():AI 结果落库与推手机前统一剥离脏尾行- 历史问题:Agent system_prompt 中写入固定尾行规则块
<a class="wl wl-missing" href="./LFY_FOOTER_RULE_BEGIN.html">LFY_FOOTER_RULE_BEGIN</a> ... <a class="wl wl-missing" href="./LFY_FOOTER_RULE_END.html">LFY_FOOTER_RULE_END</a>,导致输出末尾反复出现脏话尾行 - 受影响 Agent:
agent_15b0e0d2fbac(LZ-DailyOps)、agent_ac91ba633249(LZ-AI) - 已删除规则块 + 清洗历史数据(tasks / task_logs / iterations / opencode.db part 表)
- 备份:
agent.db.bak-20261022-lfyclean、opencode.db.bak-20261022-lfyclean
八、手动巡检守卫
- AI 巡检自动调度已停用(2026-10-22 起),改为仅手动启动
- 脚本加
--manual守卫:不带--manual直接跳过退出,防止 cron 被误恢复后自动触发 - SecOps 侧总开关
/etc/leon-secops-ai-auto.conf默认AI_AUTO_DISPATCH_ENABLED=0
九、兼容性
旧 provider 名(volcano-ds / doubao / lz-qwen3090)不再报错,一律回落中转站默认模型,保证历史任务记录不失效。
相关链接
本说明书由 Leon 独立整理维护 · 内容以现场实际为准