ErisPulse-GovReport 0.1.0__tar.gz

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: ErisPulse-GovReport
+Version: 0.1.0
+Summary: 治理观测模块：采集命令执行与事件拦截记录，输出统计报表与配额消耗
+Author: wsu2059q
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21; extra == "test"
+Requires-Dist: ErisPulse-Testing; extra == "test"
+Dynamic: license-file
+
+<div align="center">
+
+<img src=".github/assets/ErisPulseLogo.png" width="180" alt="ErisPulse GovReport" />
+
+# ErisPulse GovReport
+
+**治理观测模块 —— 命令执行、事件拦截与配额消耗的统计报表。**
+
+基于 ErisPulse 2.9 命令治理与生命周期事件的观测模块，使用内置 ORM 持久化记录，报表经 Takumi 渲染为卡片。
+
+<p>
+  <a href="https://pypi.org/project/ErisPulse-GovReport/"><img src="https://img.shields.io/pypi/v/ErisPulse-GovReport?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-GovReport/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse-GovReport"><img src="https://img.shields.io/github/stars/ErisPulse/ErisPulse-GovReport?style=for-the-badge&logo=github&color=brightgreen" alt="Stars"></a>
+  <a href="https://pepy.tech/project/ErisPulse-GovReport"><img src="https://img.shields.io/pepy/dt/ErisPulse-GovReport?style=for-the-badge&color=blue" alt="Downloads"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse"><img src="https://img.shields.io/badge/Powered_by-ErisPulse-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white" alt="ErisPulse"></a>
+</p>
+
+<p>
+  <a href="./README.md">简体中文</a> | <a href="./README.en.md">English</a>
+</p>
+
+</div>
+
+---
+
+## 简介
+
+GovReport 是基于 [ErisPulse](https://github.com/ErisPulse/ErisPulse/) 架构开发的治理观测模块：
+
+- 采集 `command.executed` 命令执行记录（成功/失败/废弃）
+- 采集 `adapter.event.blocked`（中间件否决）与 `scope.blocked`（作用域拦截）记录
+- 读取 `usage_limit` 配额计数（`erispulse.usage` 存储键），对照声明上限展示消耗
+- 枚举全部命令的治理声明（cooldown / rate_limit / usage_limit / deprecated）
+- 记录用内置 ORM（`Model` / `Field`）持久化，按保留天数自动清理
+- 报表经 Takumi 渲染为图片卡片，不可用时降级文本
+
+要求 ErisPulse >= 2.9.0。
+
+---
+
+## 效果展示
+
+| `/gov stats` | `/gov blocked` |
+|:---:|:---:|
+| ![stats](.github/assets/demo/stats-light.png) | ![blocked](.github/assets/demo/blocked-light.png) |
+
+| `/gov usage` | `/gov list` |
+|:---:|:---:|
+| ![usage](.github/assets/demo/usage-light.png) | ![list](.github/assets/demo/list-light.png) |
+
+---
+
+
+---
+
+## 安装
+
+```bash
+epsdk install ErisPulse-GovReport
+```
+
+---
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/gov` | 显示用法 |
+| `/gov stats [窗口]` | 命令执行统计（调用 Top / 成功率 / 废弃使用），窗口如 `24h`、`7d`，默认 `24h` |
+| `/gov user <用户ID> [窗口]` | 单用户调用统计 |
+| `/gov blocked [窗口]` | 拦截统计（中间件否决 / 作用域拦截） |
+| `/gov usage` | 配额消耗报表（used/limit + 周期 + 作用域） |
+| `/gov list [命令]` | 治理声明清单（可按命令名过滤） |
+| `/gov purge <天数>` | 清理指定天数之前的记录 |
+
+全部命令需要框架主人权限。
+
+---
+
+## 使用示例
+
+```toml
+# 给命令声明治理规则（本模块负责观测这些规则的运行效果）
+[ErisPulse.event.command]
+prefix = "/"
+
+# Python 侧
+# @command("translate", usage_limit="100/day", usage_limit_key="user")
+```
+
+```python
+from ErisPulse.Core.Event import command
+
+@command("translate", cooldown="30s", rate_limit="5/minute",
+         usage_limit="100/day", usage_limit_key="user", help="翻译")
+async def translate_handler(event):
+    await event.reply("结果")
+
+@command("oldcmd", deprecated="请用 /translate", deprecated_reject=True)
+async def old_handler(event):
+    ...
+```
+
+---
+
+## 配置说明
+
+```toml
+[GovReport]
+enabled = true                  # 是否启用模块
+collect_command_calls = true    # 采集命令执行记录
+collect_blocked = true          # 采集拦截记录
+retention_days = 30             # 记录保留天数（0 永久保留）
+top_n = 10                      # 报表单次展示条目数
+render_card = true              # 报表用 Takumi 渲染为卡片
+theme = "auto"                  # 卡片配色 (auto/light/dark)
+```
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `enabled` | bool | `true` | 是否启用模块 |
+| `collect_command_calls` | bool | `true` | 采集 `command.executed` |
+| `collect_blocked` | bool | `true` | 采集中间件否决与作用域拦截 |
+| `retention_days` | int | `30` | 保留天数（0 永久，启动与每日清理） |
+| `top_n` | int | `10` | 报表单次展示条目数 |
+| `render_card` | bool | `true` | 报表渲染为图片卡片 |
+| `theme` | str | `auto` | 卡片配色 |
+
+---
+
+## 注意事项
+
+1. 配额消耗读取自治理系统的存储键（`erispulse.usage`），重启不丢
+2. 冷却/限流命中默认静默，不在采集范围内（可用 ErisPulse-Testing 的 DispatchTrace 排查单条命令）
+3. 记录写入框架存储后端（SQLite / MySQL / PostgreSQL 由存储配置决定）
+
+---
+
+## 参考链接
+
+- [ErisPulse 主库](https://github.com/ErisPulse/ErisPulse/)
+- [命令治理文档](https://github.com/ErisPulse/ErisPulse/tree/main/docs/zh-CN/getting-started/event-handling.md)
+- [ORM 文档](https://github.com/ErisPulse/ErisPulse/tree/main/docs/zh-CN/developer-guide/orm.md)

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+pyproject.toml
+ErisPulse_GovReport.egg-info/PKG-INFO
+ErisPulse_GovReport.egg-info/SOURCES.txt
+ErisPulse_GovReport.egg-info/dependency_links.txt
+ErisPulse_GovReport.egg-info/entry_points.txt
+ErisPulse_GovReport.egg-info/requires.txt
+ErisPulse_GovReport.egg-info/top_level.txt
+GovReport/Config.py
+GovReport/Core.py
+GovReport/I18n.py
+GovReport/Models.py
+GovReport/Stats.py
+GovReport/Visualizer.py
+GovReport/__init__.py
+tests/test_collector.py
+tests/test_commands.py
+tests/test_visual.py

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[erispulse.module]
+GovReport = GovReport:Main

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[test]
+pytest>=7.0
+pytest-asyncio>=0.21
+ErisPulse-Testing

erispulse_govreport-0.1.0/ErisPulse_GovReport.egg-info/top_level.txt

@@ -0,0 +1 @@
+GovReport

erispulse_govreport-0.1.0/GovReport/Config.py

@@ -0,0 +1,62 @@
+from dataclasses import dataclass, field
+
+from ErisPulse.Core.Bases import BaseConfig
+
+
+@dataclass
+class GovReportConfig(BaseConfig):
+
+    enabled: bool = field(
+        default=True,
+        metadata={
+            "description": {"i18n": "GovReport.enabled", "default": "是否启用模块"},
+            "ui": {"widget": "switch", "group": "basic", "order": 1},
+        },
+    )
+    collect_command_calls: bool = field(
+        default=True,
+        metadata={
+            "description": {"i18n": "GovReport.collect_command_calls", "default": "采集命令执行记录（command.executed）"},
+            "ui": {"widget": "switch", "group": "collect", "order": 2},
+        },
+    )
+    collect_blocked: bool = field(
+        default=True,
+        metadata={
+            "description": {"i18n": "GovReport.collect_blocked", "default": "采集事件拦截记录（中间件否决 / 作用域拦截）"},
+            "ui": {"widget": "switch", "group": "collect", "order": 3},
+        },
+    )
+    retention_days: int = field(
+        default=30,
+        metadata={
+            "description": {"i18n": "GovReport.retention_days", "default": "记录保留天数（0 永久保留，启动与每日清理）"},
+            "ui": {"widget": "number", "group": "collect", "order": 4},
+        },
+    )
+    top_n: int = field(
+        default=10,
+        metadata={
+            "description": {"i18n": "GovReport.top_n", "default": "统计报表单次展示的最大条目数"},
+            "ui": {"widget": "number", "group": "report", "order": 5},
+        },
+    )
+    render_card: bool = field(
+        default=True,
+        metadata={
+            "description": {"i18n": "GovReport.render_card", "default": "报表用 Takumi 渲染为卡片（不可用时降级文本）"},
+            "ui": {"widget": "switch", "group": "render", "order": 6},
+        },
+    )
+    theme: str = field(
+        default="auto",
+        metadata={
+            "description": {"i18n": "GovReport.theme", "default": "卡片配色 (auto=按时间自动切深浅色)"},
+            "ui": {
+                "widget": "select",
+                "options": ["auto", "light", "dark"],
+                "group": "render",
+                "order": 7,
+            },
+        },
+    )

erispulse_govreport-0.1.0/GovReport/Core.py

@@ -0,0 +1,209 @@
+import asyncio
+import time
+
+from ErisPulse import i18n, sdk
+from ErisPulse.Core import Depends
+from ErisPulse.Core.Bases import BaseModule, ModuleMeta
+from ErisPulse.Core.Event import command
+from ErisPulse.loaders import ModuleLoadStrategy
+
+from .Config import GovReportConfig
+from .I18n import GovReportI18n
+from .Models import BlockEvent, CommandCall
+from .Stats import GovStatsService, parse_window
+from .Visualizer import CardVisualizer
+
+
+def get_stats_service(event):
+    from ErisPulse import module as module_mgr
+
+    inst = module_mgr.get("GovReport")
+    if inst is None:
+        raise RuntimeError("GovReport not loaded")
+    return inst._stats
+
+
+class Main(BaseModule):
+
+    ConfigClass = GovReportConfig
+    I18nClass = GovReportI18n
+
+    def __init__(self):
+        self.sdk = sdk
+        self.logger = sdk.logger.get_child("GovReport")
+        self._stats = GovStatsService(self.logger)
+        self._viz = CardVisualizer(sdk, self.logger)
+        self._daily_task = None
+
+    @staticmethod
+    def get_load_strategy() -> ModuleLoadStrategy:
+        return ModuleLoadStrategy(lazy_load=False, priority=20)
+
+    @staticmethod
+    def get_meta() -> ModuleMeta:
+        return ModuleMeta(
+            name="GovReport",
+            description="治理观测模块：采集命令执行与事件拦截记录，输出统计报表与配额消耗",
+            version="0.1.0",
+            author="ErisPulse-devs",
+            group="运维",
+            tags=["治理", "统计", "ORM", "观测"],
+            min_sdk_version="2.9.0",
+        )
+
+    async def on_load(self, event: dict) -> bool:
+        if not self.cfg.enabled:
+            self.logger.info("治理观测未启用（enabled=false）")
+            return True
+
+        await CommandCall.create_table()
+        await BlockEvent.create_table()
+        await self._stats.purge_expired(self.cfg.retention_days)
+
+        self._register_collectors()
+        self._register_commands()
+        self._daily_task = self.spawn(self._daily_purge_loop())
+        self.logger.info(i18n.t("GovReport.module_loaded", event=event))
+        return True
+
+    async def on_unload(self, event: dict) -> bool:
+        if self._daily_task is not None:
+            self._daily_task.cancel()
+            await asyncio.gather(self._daily_task, return_exceptions=True)
+            self._daily_task = None
+        self.logger.info(i18n.t("GovReport.module_unloaded", event=event))
+        return True
+
+    async def _daily_purge_loop(self):
+        while True:
+            await asyncio.sleep(86400)
+            try:
+                await self._stats.purge_expired(self.cfg.retention_days)
+            except Exception as e:
+                self.logger.warning(f"每日清理失败: {e}")
+
+    def _register_collectors(self):
+        @sdk.lifecycle.on("command.executed")
+        async def _on_command_executed(data):
+            if not self.cfg.collect_command_calls:
+                return
+            try:
+                await CommandCall.create(
+                    ts=time.time(),
+                    command=str(data.get("command", ""))[:128],
+                    platform=str(data.get("platform", ""))[:64],
+                    user_id=str(data.get("user_id", ""))[:128],
+                    success=bool(data.get("success")),
+                    error=str(data.get("error", "") or "")[:255],
+                )
+            except Exception as e:
+                self.logger.warning(f"记录命令执行失败: {e}")
+
+        @sdk.lifecycle.on("adapter.event.blocked")
+        async def _on_event_blocked(data):
+            if not self.cfg.collect_blocked:
+                return
+            raw = data.get("event") or {}
+            try:
+                await BlockEvent.create(
+                    ts=time.time(),
+                    source="middleware",
+                    middleware=str(data.get("middleware", ""))[:128],
+                    platform=str(data.get("platform", ""))[:64],
+                    detail_type=str(data.get("detail_type", ""))[:64],
+                    user_id=str(raw.get("user_id", "") or "")[:128],
+                )
+            except Exception as e:
+                self.logger.warning(f"记录拦截事件失败: {e}")
+
+        @sdk.lifecycle.on("scope.blocked")
+        async def _on_scope_blocked(data):
+            if not self.cfg.collect_blocked:
+                return
+            try:
+                await BlockEvent.create(
+                    ts=time.time(),
+                    source="scope",
+                    dimension=str(data.get("dimension", ""))[:16],
+                    module=str(data.get("module", "") or "")[:128],
+                    platform=str(data.get("platform", ""))[:64],
+                    user_id=str(data.get("user_id", "") or "")[:128],
+                    session_id=str(data.get("session_id", "") or "")[:128],
+                )
+            except Exception as e:
+                self.logger.warning(f"记录作用域拦截失败: {e}")
+
+    async def _reply_card(self, event, html, fallback_text: str):
+        if self.cfg.render_card:
+            png = await self._viz.render(html, theme=self.cfg.theme)
+            if png is not None:
+                try:
+                    await event.reply(png, method="Image")
+                    return
+                except Exception as e:
+                    self.logger.warning(f"图片回复失败，降级文本: {e}")
+        await event.reply(fallback_text)
+
+    def _register_commands(self):
+        @command("gov", master=True, help="治理观测")
+        async def gov_handler(event):
+            await event.reply(
+                "用法: /gov stats [窗口] | /gov user <用户ID> [窗口] | /gov blocked [窗口] | "
+                "/gov usage | /gov list [命令] | /gov purge <天数>"
+            )
+
+        @command("gov stats", master=True, help="命令执行统计", args="[window:str=24h]")
+        async def gov_stats_handler(event, window: str = "24h", stats=Depends(get_stats_service)):
+            secs = parse_window(window)
+            if secs is None:
+                await event.reply(i18n.t("GovReport.invalid_window", window=window))
+                return
+            await self._reply_card(
+                event,
+                await stats.command_stats_card(window, self.cfg.top_n, self._viz),
+                await stats.command_stats(secs, window, self.cfg.top_n),
+            )
+
+        @command("gov user", master=True, help="单用户统计", args="<user_id:str> [window:str=24h]")
+        async def gov_user_handler(event, user_id: str, window: str = "24h"):
+            secs = parse_window(window)
+            if secs is None:
+                await event.reply(i18n.t("GovReport.invalid_window", window=window))
+                return
+            await event.reply(await self._stats.user_stats(user_id, secs, window, self.cfg.top_n))
+
+        @command("gov blocked", master=True, help="拦截统计", args="[window:str=24h]")
+        async def gov_blocked_handler(event, window: str = "24h"):
+            secs = parse_window(window)
+            if secs is None:
+                await event.reply(i18n.t("GovReport.invalid_window", window=window))
+                return
+            await self._reply_card(
+                event,
+                await self._stats.blocked_stats_card(window, self.cfg.top_n, self._viz),
+                await self._stats.blocked_stats(secs, window, self.cfg.top_n),
+            )
+
+        @command("gov usage", master=True, help="配额消耗报表")
+        async def gov_usage_handler(event):
+            await self._reply_card(
+                event,
+                await self._stats.usage_report_card(self._viz),
+                await self._stats.usage_report(),
+            )
+
+        @command("gov list", master=True, help="治理声明清单", args="[cmd:str]")
+        async def gov_list_handler(event, cmd: str = ""):
+            await self._reply_card(
+                event,
+                self._stats.governance_list_card(cmd or None, self._viz),
+                self._stats.governance_list(cmd or None),
+            )
+
+        @command("gov purge", master=True, help="清理旧记录", args="<days:int>")
+        async def gov_purge_handler(event, days: int):
+            if days <= 0:
+                await event.reply(i18n.t("GovReport.invalid_window", window=str(days)))
+                return
+            calls, blocks = await self._stats.purge(days)
+            await event.reply(i18n.t("GovReport.purge_done", calls=calls, blocks=blocks, days=days))

erispulse_govreport-0.1.0/GovReport/I18n.py

@@ -0,0 +1,173 @@
+from ErisPulse.Core.Bases import BaseI18n, I18nKey
+
+
+class GovReportI18n(BaseI18n):
+
+    enabled: I18nKey = I18nKey(
+        default="Enable module",
+        zh_CN="是否启用模块",
+        zh_TW="是否啟用模組",
+        en="Enable module",
+        ja="モジュールを有効化",
+        ru="Включить модуль",
+    )
+    collect_command_calls: I18nKey = I18nKey(
+        default="Collect command execution records",
+        zh_CN="采集命令执行记录（command.executed）",
+        zh_TW="採集命令執行記錄（command.executed）",
+        en="Collect command execution records",
+        ja="コマンド実行記録を収集",
+        ru="Собирать записи выполнения команд",
+    )
+    collect_blocked: I18nKey = I18nKey(
+        default="Collect blocked event records (middleware veto / scope)",
+        zh_CN="采集事件拦截记录（中间件否决 / 作用域拦截）",
+        zh_TW="採集事件攔截記錄（中介軟體否決 / 作用域攔截）",
+        en="Collect blocked event records (middleware veto / scope)",
+        ja="ブロック記録を収集（ミドルウェア拒否 / スコープ）",
+        ru="Собирать записи блокировки событий",
+    )
+    retention_days: I18nKey = I18nKey(
+        default="Retention days (0 = keep forever)",
+        zh_CN="记录保留天数（0 永久保留，启动与每日清理）",
+        zh_TW="記錄保留天數（0 永久保留，啟動與每日清理）",
+        en="Retention days (0 = keep forever)",
+        ja="保持日数（0 で無期限保持）",
+        ru="Срок хранения в днях (0 = бессрочно)",
+    )
+    top_n: I18nKey = I18nKey(
+        default="Max entries shown in one report",
+        zh_CN="统计报表单次展示的最大条目数",
+        zh_TW="統計報表單次展示的最大條目數",
+        en="Max entries shown in one report",
+        ja="レポート1回の最大表示件数",
+        ru="Максимум записей в одном отчёте",
+    )
+    render_card: I18nKey = I18nKey(
+        default="Render reports as image cards via Takumi (fallback to text)",
+        zh_CN="报表用 Takumi 渲染为卡片（不可用时降级文本）",
+        zh_TW="報表用 Takumi 渲染為卡片（不可用時降級文本）",
+        en="Render reports as image cards via Takumi (fallback to text)",
+        ja="レポートを Takumi でカード画像化（不可時はテキスト）",
+        ru="Рендер отчётов в карточки через Takumi (иначе текст)",
+    )
+    theme: I18nKey = I18nKey(
+        default="Card color theme (auto = light/dark by time)",
+        zh_CN="卡片配色 (auto=按时间自动切深浅色)",
+        zh_TW="卡片配色 (auto=按時間自動切深淺色)",
+        en="Card color theme (auto = light/dark by time)",
+        ja="カード配色（auto=時間で自動切替）",
+        ru="Тема карточек (auto = светлая/тёмная по времени)",
+    )
+    module_loaded: I18nKey = I18nKey(
+        default="GovReport loaded: {event}",
+        zh_CN="治理观测已加载: {event}",
+        zh_TW="治理觀測已載入: {event}",
+        en="GovReport loaded: {event}",
+        ja="GovReport を読み込みました: {event}",
+        ru="GovReport загружен: {event}",
+    )
+    module_unloaded: I18nKey = I18nKey(
+        default="GovReport unloaded: {event}",
+        zh_CN="治理观测已卸载: {event}",
+        zh_TW="治理觀測已卸載: {event}",
+        en="GovReport unloaded: {event}",
+        ja="GovReport を解除しました: {event}",
+        ru="GovReport выгружен: {event}",
+    )
+    stats_header: I18nKey = I18nKey(
+        default="Command stats in last {window}: total {total}, success {ok}, failed {failed}, deprecated uses {dep}",
+        zh_CN="近 {window} 命令统计：共 {total} 次，成功 {ok}，失败 {failed}，废弃命令使用 {dep} 次",
+        zh_TW="近 {window} 命令統計：共 {total} 次，成功 {ok}，失敗 {failed}，廢棄命令使用 {dep} 次",
+        en="Command stats in last {window}: total {total}, success {ok}, failed {failed}, deprecated uses {dep}",
+        ja="直近 {window} のコマンド統計：合計 {total}、成功 {ok}、失敗 {failed}、非推奨使用 {dep}",
+        ru="Статистика команд за {window}: всего {total}, успешно {ok}, ошибок {failed}, устаревших {dep}",
+    )
+    stats_empty: I18nKey = I18nKey(
+        default="No command records in window {window}",
+        zh_CN="窗口 {window} 内没有命令记录",
+        zh_TW="視窗 {window} 內沒有命令記錄",
+        en="No command records in window {window}",
+        ja="期間 {window} にコマンド記録がありません",
+        ru="За период {window} записей команд нет",
+    )
+    user_header: I18nKey = I18nKey(
+        default="User {user} in last {window}: total {total}, success {ok}, failed {failed}",
+        zh_CN="用户 {user} 近 {window}：共 {total} 次，成功 {ok}，失败 {failed}",
+        zh_TW="用戶 {user} 近 {window}：共 {total} 次，成功 {ok}，失敗 {failed}",
+        en="User {user} in last {window}: total {total}, success {ok}, failed {failed}",
+        ja="ユーザー {user} 直近 {window}：合計 {total}、成功 {ok}、失敗 {failed}",
+        ru="Пользователь {user} за {window}: всего {total}, успешно {ok}, ошибок {failed}",
+    )
+    user_empty: I18nKey = I18nKey(
+        default="User {user} has no records in window {window}",
+        zh_CN="用户 {user} 在窗口 {window} 内没有记录",
+        zh_TW="用戶 {user} 在視窗 {window} 內沒有記錄",
+        en="User {user} has no records in window {window}",
+        ja="ユーザー {user} は期間 {window} に記録がありません",
+        ru="У пользователя {user} нет записей за {window}",
+    )
+    blocked_header: I18nKey = I18nKey(
+        default="Blocked events in last {window}: total {total}",
+        zh_CN="近 {window} 拦截统计：共 {total} 次",
+        zh_TW="近 {window} 攔截統計：共 {total} 次",
+        en="Blocked events in last {window}: total {total}",
+        ja="直近 {window} のブロック統計：合計 {total}",
+        ru="Блокировки за {window}: всего {total}",
+    )
+    blocked_empty: I18nKey = I18nKey(
+        default="No blocked events in window {window}",
+        zh_CN="窗口 {window} 内没有拦截记录",
+        zh_TW="視窗 {window} 內沒有攔截記錄",
+        en="No blocked events in window {window}",
+        ja="期間 {window} にブロック記録がありません",
+        ru="За период {window} блокировок нет",
+    )
+    usage_header: I18nKey = I18nKey(
+        default="Usage quota consumption ({count} active key(s)):",
+        zh_CN="配额消耗（活跃键 {count} 个）：",
+        zh_TW="配額消耗（活躍鍵 {count} 個）：",
+        en="Usage quota consumption ({count} active key(s)):",
+        ja="クォータ消費（アクティブキー {count} 件）：",
+        ru="Потребление квот (активных ключей: {count}):",
+    )
+    usage_empty: I18nKey = I18nKey(
+        default="No usage quota records",
+        zh_CN="没有配额消耗记录",
+        zh_TW="沒有配額消耗記錄",
+        en="No usage quota records",
+        ja="クォータ消費記録がありません",
+        ru="Нет записей потребления квот",
+    )
+    gov_list_empty: I18nKey = I18nKey(
+        default="No command has governance declarations",
+        zh_CN="没有任何命令声明治理规则",
+        zh_TW="沒有任何命令聲明治理規則",
+        en="No command has governance declarations",
+        ja="治理宣言を持つコマンドはありません",
+        ru="Нет команд с правилами управления",
+    )
+    gov_list_header: I18nKey = I18nKey(
+        default="Governance declarations ({count} command(s)):",
+        zh_CN="治理声明清单（{count} 个命令）：",
+        zh_TW="治理聲明清單（{count} 個命令）：",
+        en="Governance declarations ({count} command(s)):",
+        ja="治理宣言一覧（{count} 件）：",
+        ru="Объявления управления ({count} команд):",
+    )
+    purge_done: I18nKey = I18nKey(
+        default="Purged {calls} call record(s) and {blocks} block record(s) older than {days} day(s)",
+        zh_CN="已清理 {days} 天前的记录：命令 {calls} 条，拦截 {blocks} 条",
+        zh_TW="已清理 {days} 天前的記錄：命令 {calls} 條，攔截 {blocks} 條",
+        en="Purged {calls} call record(s) and {blocks} block record(s) older than {days} day(s)",
+        ja="{days} 日より前の記録を削除：コマンド {calls} 件、ブロック {blocks} 件",
+        ru="Удалено записей старше {days} дн.: команд {calls}, блокировок {blocks}",
+    )
+    invalid_window: I18nKey = I18nKey(
+        default="Invalid window: {window} (examples: 30m / 24h / 7d)",
+        zh_CN="无效的时间窗口: {window}（示例: 30m / 24h / 7d）",
+        zh_TW="無效的時間視窗: {window}（示例: 30m / 24h / 7d）",
+        en="Invalid window: {window} (examples: 30m / 24h / 7d)",
+        ja="無効な期間指定: {window}（例: 30m / 24h / 7d）",
+        ru="Неверный период: {window} (примеры: 30m / 24h / 7d)",
+    )

erispulse_govreport-0.1.0/GovReport/Models.py

@@ -0,0 +1,30 @@
+from ErisPulse.Core.Bases import Field, Model
+
+
+class CommandCall(Model):
+
+    __tablename__ = "gov_command_calls"
+
+    id: int = Field(primary_key=True, autoincrement=True)
+    ts: float = Field(index=True)
+    command: str = Field(max_length=128, index=True)
+    platform: str = Field(max_length=64, default="")
+    user_id: str = Field(max_length=128, default="", index=True)
+    success: bool = Field(default=True)
+    error: str = Field(max_length=255, default="")
+
+
+class BlockEvent(Model):
+
+    __tablename__ = "gov_block_events"
+
+    id: int = Field(primary_key=True, autoincrement=True)
+    ts: float = Field(index=True)
+    source: str = Field(max_length=16, choices=["middleware", "scope"], index=True)
+    middleware: str = Field(max_length=128, default="")
+    dimension: str = Field(max_length=16, default="")
+    module: str = Field(max_length=128, default="")
+    platform: str = Field(max_length=64, default="")
+    detail_type: str = Field(max_length=64, default="")
+    user_id: str = Field(max_length=128, default="")
+    session_id: str = Field(max_length=128, default="")