如果环境可能安装过agent-framework 1.26.1或1.26.2,应先停止使用并隔离相关工作负载,从可信环境读取安装记录,再重建干净运行环境和处置暴露凭据。不要先在可疑环境里直接运行pip list或pip uninstall:它们会启动python,可能先执行恶意.pth钩子。下面的离线检查只读文件,不导入目标环境的软件包,也不执行钩子内容。

包管理入口本身也会启动Python,清理顺序需要注意。
停止工作负载,保留安装证据
暂停相关CI任务、应用和自托管runner,按自己的事件响应流程隔离网络与保留日志。不要向仍可能受影响的主机注入新密钥。以下脚本在可信Python工具环境中运行,目标site-packages以只读证据目录提供;不要从不可信项目目录加载同名工具脚本或模块。
# inspect_agent_framework.py
from pathlib import Path
import json, re, sys
if len(sys.argv) != 2:
raise SystemExit('用法:inspect_agent_framework.py <site-packages>')
base = Path(sys.argv[1]).resolve(strict=True)
if not base.is_dir():
raise SystemExit('请指定实际site-packages目录')
versions = []
for metadata in base.glob('agent_framework-*.dist-info/METADATA'):
text = metadata.read_text(encoding='utf-8', errors='replace')
match = re.search(r'^Version:\s*(.+)$', text, re.MULTILINE)
if match:
versions.append(match.group(1).strip())
hooks = ['agent_framework_meta.pth', 'af_runtime_diag.pth',
'af_runtime_diag.py', 'agent_framework_meta/_telemetry.py']
result = {
'metadata_versions': versions,
'known_malicious_version_found': bool({'1.26.1', '1.26.2'} & set(versions)),
'known_hook_paths_present': [name for name in hooks if (base / name).is_file()],
'conclusion': '文件线索仅供排查;未发现不能排除曾经暴露或文件被修改',
}
print(json.dumps(result, ensure_ascii=False, indent=2))python3 -I -S inspect_agent_framework.py /evidence/project/.venv/lib/python3.12/site-packages
-I隔离用户路径和环境影响,-S跳过site初始化。这里应使用可信的工具解释器和脚本,而不是在目标site-packages中执行Python。Windows虚拟环境常见目录为.venv/Lib/site-packages,实际路径应从文件系统确认。输出只包含包版本和已知文件线索,不读取或打印环境变量、凭据或钩子代码。

从PyPI移除发行版,不会自动清除下游缓存和已构建镜像。
在干净主机或重新部署的runner中恢复
先核对项目锁文件与内部包仓库,阻止再次解析到1.26.1或1.26.2。当前PyPI公开发行元数据为1.26.0;可在干净环境中以该已核对版本恢复测试,后续版本则重新审查来源。下面的命令只在新目录、可信主机执行,不是对受感染主机的一键修复。
test ! -e .venv-clean || exit 1 python3 -m venv .venv-clean .venv-clean/bin/python -m pip install --no-cache-dir "agent-framework==1.26.0" .venv-clean/bin/python -m pip check
随后安装项目已审阅的其他依赖并运行测试,确认使用干净的锁文件、包缓存和容器基础层。Windows使用对应Scripts/python.exe路径。pip check检查依赖关系,不验证攻击残留或云凭据是否已撤销;不能将它通过作为安全事件结束条件。

静态密钥、缓存会话、托管身份和OIDC令牌需要分别评估。
完成身份处置和持续观察
轮换可被读取的静态密钥、处理用户缓存会话及云角色,核对托管身份和OIDC令牌的实际有效期,审计相关访问日志。清除内部镜像或包缓存中的恶意产物时按自己的证据保留流程操作,并重新构建受影响容器或runner。曾经安装过的版本不能仅凭当前元数据消失就排除暴露;同样,.pyc存在也不能单独证明载荷已运行,因为安装阶段也可能生成字节码。


















