# Python 扩展与 Layout API

2026-09-24 · 1.17.0-20260924065820

历史版本说明，内容对应当时的发布。

## 创建 Python 分析操作

“设置 → Python 扩展”提供注册、创建示例、应用内编辑、执行和取消。要求 Python 3.9 以上，当时界面支持日语和英语。

## 邮件分析 API

访问保留的邮件事件、发件人、收件人、IP、Postfix 与中继主机、队列 ID、认证状态，以及国家和主机汇总。投递率按事件计算，包含重试。国家来自注册信息或国家代码域名推测，保留推测、待查询和未知状态。

## 创建自定义窗口

api.window() 与 api.show() 支持嵌套行列、指标卡、文本、表格、柱状图和操作按钮，无需安装 Python GUI 包。按钮调用清单中注册的操作，获取新的快照，可刷新或导出 CSV/JSON。更新示例包含分析仪表板；旧示例需在新文件夹重新创建。

## 执行与范围

手动执行时使用当前保留快照；保留数为 0 时没有分析记录，动画不变。API 不包含原始日志、邮件正文或 SSH 秘密。执行上限 60 秒，面板输出 1 MiB。Python 使用当前用户权限，并非安全沙箱，只运行可信代码。

## Layout API v1 限制

界面在独立扩展窗口打开，不包括替换主仪表板、输入表单或定时刷新。最多 200 个控件、8 层嵌套；表格最多 20 列、1000 行，柱状图最多 50 根柱。

## 验证与公开

macOS 与 Kali Linux 2026.3 amd64 构建成功，八项自动测试通过。GUI 探针覆盖执行、取消、布局、按钮回调和非法输入，Kali 使用 Xvfb。签名 APT 元数据与公开包哈希已核验。SHA-256：7eb9b14d804fbb7fb2941696d0cf79a78a4d4103a1acc31459e3cf803d79e8d2。

## 更新

在已配置仓库的 Kali 客户端上运行，完成后重启应用。

```bash
sudo apt update
sudo apt install --only-upgrade loggraphic
```