# 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
```