在QoderWake中调用第三方库需按四类方案：一、用qoder pip安装纯Python库；二、离线whl安装含C扩展库并受权限扫描；三、在skills.yaml声明依赖并隔离加载；四、用SDK@safe_call装饰器实现全链路管控。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在QoderWake中通过Python调用第三方库实现AI自动化办公，例如完成日志分析、API对接、数据清洗或模型推理等任务，则需确保第三方库已正确安装并可在沙盒环境中安全调用。以下是多种兼容QoderWake运行约束的第三方库导入与调用方案：
一、使用qoder pip命令安装并调用纯Python库
该方式适用于无C扩展依赖、纯Python编写的轻量级库（如loguru、pydantic、requests），由QoderWake封装的qoder pip自动绑定沙盒路径，避免系统环境污染，且安装后可立即在Python脚本中import调用。
1、启动Qoder CLI终端，执行qoder env python --version确认Python版本为3.9–3.12。
2、执行qoder env pip list | grep requests验证requests是否已存在；若未安装，执行qoder pip install requests loguru pydantic。
立即学习“Python免费学习笔记（深入）”；
3、在QoderWake AI定时任务中新建Python脚本，输入以下代码发起HTTP请求并记录日志：
import requests
from loguru import logger
logger.add("/output/office_api.log", rotation="1 day")
try:
resp = requests.get("https://api.example.com/v1/tasks", timeout=10)
logger.info("API call succeeded: {}", resp.status_code)
except Exception as e:
logger.error("API call failed: {}", str(e))
二、通过whl离线包安装含C扩展但已预编译的库
当目标库包含C扩展（如cryptography、numpy）且部署环境禁止联网时，必须采用经企业私有PyPI签名的whl文件进行离线安装。QoderWake会在安装后触发权限红线扫描，仅允许白名单内的函数调用，保障生产安全。
1、从企业内部PyPI仓库下载适配当前Python版本与平台架构的whl文件，例如cryptography-41.0.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl。
2、将whl文件上传至QoderWake工作目录下的./deps/子路径。
3、执行qoder pip install ./deps/cryptography-41.0.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl --trusted-host internal-pypi.example.com。
4、安装完成后，系统自动校验调用边界：仅允许cryptography.hazmat.primitives.hashes.SHA256类实例化，禁止直接调用底层openssl接口。
三、在skills.yaml中声明依赖并启用受限动态导入
该方式适用于需跨多个Skill复用同一库、或要求依赖显式声明以满足审计合规的场景。QoderWake在加载Skill时会按skills.yaml中dependencies字段拉取并隔离初始化库，同时对高风险模块（如os、subprocess）实施动态导入拦截。
1、在Skill项目根目录下编辑skills.yaml，添加如下内容：
name: "hr-report-analyzer"
version: "1.0.0"
dependencies:
- "pandas==2.2.2"
- "openpyxl==3.1.2"
2、保存后执行qoder skill build打包，QoderWake将自动解析依赖并注入沙盒环境。
3、在Skill主逻辑中编写Python代码，调用pandas读取Excel报表并生成统计摘要：
import pandas as pd
df = pd.read_excel("/input/hr_data.xlsx")
summary = df.groupby("department")["salary"].mean().round(2)
summary.to_csv("/output/dept_salary_avg.csv")
4、运行时系统拦截所有对pandas.io.sql模块的导入请求：ImportError: Module 'pandas.io.sql' is blocked by QoderWake permission redline。
四、基于QoderWake SDK封装第三方库调用入口
对于需深度集成企业权限体系或定制化审计埋点的场景，可通过QoderWake SDK提供的@safe_call装饰器包装第三方库函数，实现调用前参数校验、调用中行为审计、调用后结果脱敏的全链路管控。
1、在Python脚本中导入SDK模块：from qoderwake.sdk import safe_call。
2、定义被封装函数，例如调用requests.post发送审批通知：
@safe_call(allowed_hosts=["notify.internal.corp"], max_body_size=8192)
def send_approval_notice(url, payload):
return requests.post(url, json=payload, timeout=5)
3、在任务逻辑中调用该函数：
response = send_approval_notice(
"https://notify.internal.corp/v2/approval",
{"task_id": "T20260523001", "status": "approved"}
)
4、若传入非法URL或超大payload，函数立即抛出异常：PermissionError: Host 'evil.com' not in allowed_hosts whitelist。
