zf3d-agent // 第一部分 // 01 / 05

客户端审计

代码质量、仓库卫生、Git 历史泄露、12 条攻击链

1.1 代码质量

规模与结构

  • 单体巨型文件普遍:server/routes/api_dispatch_post.py 2,249 行、根目录 ai_proxy.py 1,637 行、api_dispatch_get.py 1,424 行
  • 无包结构,路由用 mixin 类拼接,隐式依赖严重
  • 根目录 ai_proxy.py 与 server/ 目录职责重叠,位置错误

危险编码模式统计

模式 次数 评价
except Exception: pass 895 最高危:错误被系统性吞掉,故障不可观测
print( 调试输出 1,197 无日志分级
subprocess 238 其中 shell=True 20 处
exec( 9 动态执行
eval( 3 同上
verify=False 3 TLS 校验关闭残留
TODO / FIXME / HACK 17 技术债标注极少

工程基线缺失

  • 无 CI:仓库没有 .github 目录
  • 无测试体系:仅 6 个 test 文件,其中 2 个位于 server/zf-trash 垃圾目录
  • 无依赖锁定:只有 server/requirements.txt,没有版本号;根目录无依赖声明
  • 无 lint 配置:无 flake8 / eslint / prettier

一个具体案例

server/routes/mixin_fps_guard.py:81-89:

conn.execute(
    "INSERT INTO app_data(category, key, value) VALUES (?,?,?)",
    ('fps_crive' if False else 'fps_crime', 'fps_%d' % int(fps), line),
)
conn.commit()
# ...
except Exception:
    pass

commit() 外面套 except: pass,没有 rollback()。异常发生后事务保持打开状态,其他连接写入时会遇到 database table is locked。这就是 issue #35 报告的问题。第 83 行还残留着 'fps_crive' if False else 'fps_crime' —— 一个常量拼错后的死代码。


1.2 仓库卫生

体积分布

区域 文件数 体积 备注
tools/ 398 58.85 MB 几乎全是 LuckyLillia.zip 分卷(17 个,约 55 MB)
.git/ — 171.77 MB 历史大对象
public/ + server/public 577+ 14.30 MB 含 mp4 宣传片、819 张 webp
server/ 1,814 13.80 MB 业务代码
data/ 3 4.87 MB game_saves.db

.gitignore 的漏洞

.gitignore 写了 60 行,规则详细,但漏了关键几项:

  • 忽略了 server/data/*.db,但漏掉 data/game_saves.db、server/agent.db、server/memory.db、server/zf3d_chat.db
  • 忽略了 *.bak 系列,但没管 *.new —— 6 个 .new 备份文件 20.7 MB 在库里
  • 没有 *.part* / *.zip 规则 —— 分卷压缩包被当源码提交

运行态垃圾入库

路径 性质
server/%DST% PowerShell 变量未展开写出的错误文件,13 KB
server/a1_out.txt / a2_out.txt 命令输出重定向残留,60 KB
server/pl_progress.txt / _branches.txt / _vv_out.txt 调试输出
server/_sentinel_fails.txt / _sentinel_last.txt 哨兵状态文件
*.removed(2 个) 删文件时改成后缀却没删
agent.db-shm / -wal、memory.db-shm / -wal SQLite 临时文件
server/录屏诊断.jsonl、data/traces/*.jsonl 运行日志与执行 trace

提交历史

236 次提交中,绝大多数是:

chore: 会话开始快照(用户提问) @ 2026-11-04 12:39:31
chore: 会话结束快照 @ 2026-11-04 12:24:54

把 AI 对话过程自动提交到公开仓库。这导致提交历史不可读、无法 bisect,且把开发过程的中间态全部暴露。


1.3 敏感文件与历史泄露

已确认:Git 历史中的完整 Chromium 用户配置

当前工作树已删除 server/browser_plugin/data/,但 Git 对象仍可完整提取:

历史路径 类型 大小
.../profiles/wb_c_cb2-.../Default/Login Data SQLite 40 KB
同一 profile /Network/Cookies SQLite 28 KB
同一 profile /Web Data SQLite 157 KB
同一 profile /History SQLite 229 KB
同一 profile /Local State JSON 含 Chromium 加密密钥
_trash_tmp/_privacy_bak_20261101_131549/ 下另一套完整 profile 整套 Login Data / Cookies / Web Data / History / Local State

实测内容(提取 blob 后检查):

  • Login Data 的 logins 表:0 行 —— 该 profile 没有保存任何密码
  • Cookies:21 条,域名分布 .bilibili.com 11、.github.com 6、.google.com 3、www.zf3d.com 1
  • History:29 个 URL、42 次访问,域名 github.com 16、cdn.jsdelivr.net 5、google.com 2、bilibili 2

需要准确说明:Cookie 的 encrypted_value 是 Chromium v10 格式,绑定原机 Windows DPAPI,跨机器一般无法解密。但 host_key / 路径 / 过期时间 / 浏览历史是明文可读的,足以构成画像风险;且 Git 历史不重写就会永久存在。

private/ 目录曾入过库

  • private/用户设置/user_settings.json(71 KB):泄露本机绝对路径 F:/朱峰社区智能体无限_新版本/朱峰社区智能体无限_5.7.0、E:/work/web、D:/ComfyUI-H3,以及聊天 ID、面板布局
  • private/roles_db.json:全部角色系统提示词原文
  • private/path_whitelist.json、network_guard.json、沙箱配置.json:本机安全策略

密钥扫描结果

对 1,883 个文本文件做正则扫描(sk- / ghp_ / AKIA / AIza / PEM 私钥 / JWT):0 命中。

低熵凭据扫描(password= / api_key= 等赋值):3 处命中,均为无害(占位符 __AGENT_API_KEY_ROTATED__、变量名 $baiduMima、测试串 sk-selftest-abc123xyz)。

public/config/models.json(8 个模型条目)不含 api_key 字段。

zf3d_heartbeat.py 的默认密钥从 private/heartbeat_key.json 读取,缺省返回空串并跳过上报,无硬编码。

结论:仓库中不存在可用密钥。真正需要处理的是浏览器 profile 与 private/ 配置,不是 API Key。


1.4 客户端攻击面

攻击链总览

编号 投递方式 攻击方式 入口 后果
A 浏览器 CSRF 打 pyconsole POST /api/pyconsole/exec 本机 RCE
B 供应链 更新通道投毒 updater.py → git reset --hard 全部客户端 RCE
C 浏览器 GET 侧写 /api/app/quit 等 143 个 GET 杀进程 / 导出配置
D 本机 明文密码落盘 mixin_zf3d.py 诊断日志 账号凭据泄漏
E 内容 提示注入 → shell 模型工具 console.exec 本机 RCE(零交互)
F 历史资产 Git 历史里的 cookie / 路径 一次 clone 定向社工
G 浏览器 免令牌烧额度 POST 127.0.0.1:8574/v1/chat/completions 无限调用付费模型
H 浏览器 审批代签 POST /api/approval/<id> 危险操作被放行
I 本机/远程 白名单放解释器 ws_server.py 手机控电脑 本机任意代码
J 浏览器 MCP 配置后门 POST /api/config/import 重启后自动执行
K 浏览器 XSS → 同源权限 74 处未转义拼接 + 无 CSP 全部接口权限
L 信息 配置泄露本机画像 mcp_servers.json 定向钓鱼素材

链路 A:CSRF → 本机任意命令执行

三道防线逐一失效:

# server/handler_base.py:80-90
def _check_origin(self):
    origin = (self.headers.get('Origin') or '').strip()
    if not origin:
        return True                                    # ① 无 Origin 直接放行
    host = (self.headers.get('Host') or '').strip()
    if host and origin.rstrip('/') == f'http://{host}':
        return True
    if origin.startswith('http://127.0.0.1') or origin.startswith('http://localhost'):
        return True                                    # ② 前缀匹配:127.0.0.1.evil.com 通过
    self._send_json({'ok': False, 'error': 'Forbidden'}, 403)
    return False
# server/routes/mixin_pyconsole.py:92-102
def _pyconsole_allowed(self):
    ip = self.client_address[0] if self.client_address else ''
    if ip not in ('127.0.0.1', '::1', 'localhost'):
        return False                                   # ③ 浏览器 CSRF 源 IP 就是 127.0.0.1
    return True, ''
# server/routes/mixin_pyconsole.py:136-148
tok, strict = self._pyconsole_token_state()
given = str(data.get('_token') or '').strip()
if given != tok:
    if strict:
        self._send_json({'ok': False, ...}, 403)
        return
    print('[PyConsole] WARN exec without valid token (warn mode)')   # ④ 默认 warn,只打印
# 继续执行
r = pyconsole_exec_direct(code, wd, kind='user')     # → subprocess.run(code, shell=True)

利用条件:受害者点开一个攻击者控制的页面。浏览器以 no-cors 简单请求(Content-Type: text/plain)发送即可,不触发预检,不依赖 Access-Control-Allow-Origin。

链路 E:提示注入直达 shell(零交互)

# server/brain/main_brain_llm_tools.py:254-260
from routes.mixin_pyconsole import pyconsole_exec_direct
...
r = pyconsole_exec_direct(args.get('code'), base, kind='agent')

模型工具直接调用执行通道,不经过 HTTP、不查 token、只看 ZF_PYCONSOLE 开关(默认 on)。该产品的主要功能就是让智能体浏览网页、读文档、处理上传文件——攻击面是整条信息输入链。

链路 G:AI 代理免令牌

# ai_proxy.py:431-448
def _local_free_user():
    ra = request.remote_addr or ''
    if ra in ('127.0.0.1', '::1', 'localhost'):
        return {'user_id': 0, 'username': 'local_free', 'balance': 1, 'free': True}
    return None

def _require_user():
    ...
    if not user:
        user = _local_free_user()    # token 无效时回落到「本机免费」

该代理监听 8574,内部持有上游模型的真实密钥。任意网页用 no-cors 向它发 POST 即可免费调用。

链路 B:更新通道无签名

updater.py 的更新流程:从 raw.githubusercontent.com 拉 private/version.json 比较版本,然后 git fetch + reset --hard origin/main。全程无签名校验、无哈希校验、无证书固定。reset --hard 还会覆盖本地未推送的修改。