qoderwake通过白名单机制防范恶意代码风险，具体包括三步：一、在agent_config.json中配置codewhitelist字段限定允许的函数与模块；二、启用ast静态分析拦截白名单外调用；三、绑定沙盒化python子进程执行环境实现纵深防御。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake执行代码任务时，发现其可能调用未经验证的函数或访问敏感系统模块，则存在恶意代码运行风险。以下是通过白名单机制防止此类风险的具体操作步骤：
一、配置代码执行白名单规则
白名单机制通过显式声明允许调用的函数与模块，从源头阻断未授权代码执行。QoderWake的白名单需在身份与技能初始化阶段注入，确保所有工具调用均受控于预设安全边界。
1、打开QoderWake部署目录下的agent_config.json文件。
2、在"security"节点下新增"codeWhitelist"字段，填入明确允许的函数名与模块路径。
3、示例配置中仅允许基础数据处理与绘图功能："pd.read_csv", "plt.figure", "json.loads", "re.search"。
4、保存文件后重启QoderWake服务以加载新策略。
二、启用AST级代码静态分析拦截
该方法在代码实际执行前解析抽象语法树（AST），识别出白名单外的函数调用、导入语句及危险表达式，避免字符串拼接绕过文本匹配检测。
1、确认QoderWake运行环境已安装ast标准库（Python 3.8+默认包含）。
2、修改skills/code_executor.py中的execute_safe函数，在exec()调用前插入AST遍历逻辑。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、对每个Call节点检查func.id或func.attr是否属于config.codeWhitelist集合。
4、对每个Import和ImportFrom节点校验模块名是否在许可列表内，否则抛出SecurityViolationError异常。
5、将异常捕获逻辑接入QoderWake的统一错误响应通道，前端显示“调用被安全策略拒绝：函数不在执行白名单中”。
三、绑定沙盒化Python子进程执行环境
即使白名单逻辑被绕过，沙盒子进程也能确保恶意代码无法逃逸至宿主系统。该方案利用独立进程空间与受限系统调用实现纵深防御。
1、在skills/目录下创建sandboxed_python.py，使用subprocess.Popen启动带参数限制的Python解释器。
2、传入-E（忽略环境变量）、-I（隔离模式）、-s（禁用用户站点包）等标志。
3、通过preexec_fn=os.setsid建立新会话，并配合resource.setrlimit限制CPU时间与内存使用。
4、将待执行代码写入临时文件，路径限定在/tmp/qoderwake_sandbox_XXXXXX/内，该目录由mktemp -d生成且权限设为0o700。
5、子进程仅能访问该临时目录及其子路径，任何向上跳转（如../etc/passwd）或跨挂载点访问均被内核拒绝。
