nonebot-plugin-hzys 0.2.0__py3-none-any.whl

nonebot_plugin_hzys/__init__.py

@@ -0,0 +1,20 @@
+from nonebot import require
+from nonebot.plugin import PluginMetadata
+
+require("nonebot_plugin_alconna")
+
+from .command import otto_cmd
+from .config import Config
+
+__plugin_meta__ = PluginMetadata(
+    name="otto 活字印刷",
+    description="调用兼容后端生成 otto 活字印刷语音",
+    usage="/ottohzys 大家好啊",
+    type="application",
+    homepage="https://github.com/Misty02600/nonebot-plugin-hzys",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+    extra={"author": "Misty02600 <Misty02600@gmail.com>"},
+)
+
+__all__ = ("__plugin_meta__", "otto_cmd")

nonebot_plugin_hzys/backend.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+import httpx
+
+from .config import Config
+
+
+class OttoBackendError(Exception):
+    """Base exception for remote otto backend failures."""
+
+
+class OttoBackendConfigError(OttoBackendError):
+    """Raised when the plugin is missing required backend configuration."""
+
+
+class OttoBackendRequestError(OttoBackendError):
+    """Raised when the backend request fails or returns an invalid response."""
+
+
+@dataclass(slots=True, frozen=True)
+class OttoSynthesisOptions:
+    is_ysdd: bool = True
+    use_non_ddb_pinyin: bool = True
+    is_sliced: bool = False
+
+
+class OttoBackendClient:
+    def __init__(
+        self,
+        *,
+        base_url: str,
+        api_key: str | None = None,
+        timeout: float = 20.0,
+        transport: httpx.AsyncBaseTransport | None = None,
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key
+        self.timeout = timeout
+        self.transport = transport
+
+    async def synthesize(self, text: str, *, options: OttoSynthesisOptions) -> bytes:
+        payload = {
+            "text": text,
+            "isYsdd": options.is_ysdd,
+            "useNonDdbPinyin": options.use_non_ddb_pinyin,
+            "isSliced": options.is_sliced,
+        }
+        headers = {"Content-Type": "application/json"}
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+
+        try:
+            async with httpx.AsyncClient(
+                base_url=self.base_url,
+                timeout=self.timeout,
+                transport=self.transport,
+            ) as client:
+                response = await client.post(
+                    "/api/text-to-wav", json=payload, headers=headers
+                )
+        except httpx.HTTPError as exc:
+            raise OttoBackendRequestError(f"请求后端失败：{exc}") from exc
+
+        if response.status_code >= 400:
+            detail = _extract_error_detail(response)
+            raise OttoBackendRequestError(
+                f"后端返回错误 {response.status_code}：{detail}"
+            )
+        if not response.content:
+            raise OttoBackendRequestError("后端没有返回音频数据")
+
+        return response.content
+
+    async def health(self) -> bool:
+        try:
+            async with httpx.AsyncClient(
+                base_url=self.base_url,
+                timeout=self.timeout,
+                transport=self.transport,
+            ) as client:
+                response = await client.get("/health")
+        except httpx.HTTPError:
+            return False
+        return response.status_code < 400
+
+
+def build_backend_client(config: Config) -> OttoBackendClient:
+    if not config.otto_hzys_backend_url.strip():
+        raise OttoBackendConfigError("未配置 OTTO_HZYS_BACKEND_URL")
+
+    return OttoBackendClient(
+        base_url=config.otto_hzys_backend_url,
+        api_key=config.otto_hzys_api_key,
+    )
+
+
+def default_synthesis_options(config: Config) -> OttoSynthesisOptions:
+    return OttoSynthesisOptions()
+
+
+def _extract_error_detail(response: httpx.Response) -> str:
+    try:
+        data = response.json()
+    except ValueError:
+        return response.text.strip() or "未知错误"
+
+    if isinstance(data, dict):
+        for key in ("error", "message", "detail"):
+            value = data.get(key)
+            if isinstance(value, str) and value.strip():
+                return value.strip()
+
+    return response.text.strip() or "未知错误"

nonebot_plugin_hzys/command.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from arclet.alconna import Alconna, AllParam, Args
+from nonebot import get_plugin_config
+from nonebot_plugin_alconna import UniMessage, Voice, on_alconna
+
+from .backend import (
+    OttoBackendConfigError,
+    OttoBackendError,
+    build_backend_client,
+    default_synthesis_options,
+)
+from .config import Config
+
+otto_cmd = on_alconna(
+    Alconna("ottohzys", Args["text", AllParam]),
+    aliases={"活字印刷"},
+    use_cmd_start=True,
+    block=True,
+)
+
+
+@otto_cmd.handle()
+async def handle_otto(text: UniMessage) -> None:
+    plain_text = text.extract_plain_text().strip()
+    if not plain_text:
+        await otto_cmd.finish("请输入要转换的文本")
+
+    config = get_plugin_config(Config)
+
+    try:
+        client = build_backend_client(config)
+        audio = await client.synthesize(
+            plain_text,
+            options=default_synthesis_options(config),
+        )
+    except OttoBackendConfigError as exc:
+        await otto_cmd.finish(str(exc))
+    except OttoBackendError as exc:
+        await otto_cmd.finish(f"活字印刷生成失败：{exc}")
+
+    await otto_cmd.finish(UniMessage(Voice(raw=audio, name="otto.wav")))

nonebot_plugin_hzys/config.py

@@ -0,0 +1,14 @@
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class Config(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    otto_hzys_backend_url: str = Field(
+        default="https://otto-hzys-api-backend.vercel.app",
+        description="兼容 otto-hzys API 的后端地址",
+    )
+    otto_hzys_api_key: str | None = Field(
+        default=None,
+        description="兼容后端的 Bearer Token",
+    )

nonebot_plugin_hzys-0.2.0.dist-info/METADATA

@@ -0,0 +1,123 @@
+Metadata-Version: 2.3
+Name: nonebot-plugin-hzys
+Version: 0.2.0
+Summary: 插件描述
+Author: Misty02600
+Author-email: Misty02600 <Misty02600@gmail.com>
+Requires-Dist: httpx>=0.27.0,<1.0.0
+Requires-Dist: nonebot-plugin-alconna>=0.60.0,<1.0.0
+Requires-Dist: nonebot2>=2.4.2,<3.0.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/Misty02600/nonebot-plugin-hzys
+Project-URL: Issues, https://github.com/Misty02600/nonebot-plugin-hzys/issues
+Project-URL: Repository, https://github.com/Misty02600/nonebot-plugin-hzys.git
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <a href="https://v2.nonebot.dev/store">
+    <img src="https://github.com/Misty02600/nonebot-plugin-template/releases/download/assets/NoneBotPlugin.png" width="310" alt="logo"></a>
+
+## ✨ nonebot-plugin-hzys ✨
+[![LICENSE](https://img.shields.io/github/license/Misty02600/nonebot-plugin-hzys.svg)](./LICENSE)
+[![python](https://img.shields.io/badge/python-3.11+-blue.svg?logo=python&logoColor=white)](https://www.python.org)
+[![Adapters](https://img.shields.io/badge/Adapters-OneBot%20v11-blue)](#supported-adapters)
+<br/>
+
+[![uv](https://img.shields.io/badge/package%20manager-uv-black?logo=uv)](https://github.com/astral-sh/uv)
+[![ruff](https://img.shields.io/badge/code%20style-ruff-black?logo=ruff)](https://github.com/astral-sh/ruff)
+
+</div>
+
+## 📖 介绍
+
+由于饼干的 [`nonebot-plugin-ottohzys`](https://github.com/lgc-NB2Dev/nonebot-plugin-ottohzys) 已归档，写了这个插件来跟踪最新上游数据。服务端来自 [`kaixinol/otto-hzys-api-backend`](https://github.com/kaixinol/otto-hzys-api-backend)，上游数据源来自 [`hua-zhi-wan/otto-hzys`](https://github.com/hua-zhi-wan/otto-hzys)。
+
+## 💿 安装
+
+<details open>
+<summary>使用 nb-cli 安装</summary>
+在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
+
+    nb plugin install nonebot-plugin-hzys --upgrade
+使用 **pypi** 源安装
+
+    nb plugin install nonebot-plugin-hzys --upgrade -i "https://pypi.org/simple"
+使用**清华源**安装
+
+    nb plugin install nonebot-plugin-hzys --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+
+</details>
+
+<details>
+<summary>使用包管理器安装</summary>
+在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
+
+<details open>
+<summary>uv</summary>
+
+    uv add nonebot-plugin-hzys
+安装仓库 main 分支
+
+    uv add git+https://github.com/Misty02600/nonebot-plugin-hzys@main
+</details>
+
+<details>
+<summary>pdm</summary>
+
+    pdm add nonebot-plugin-hzys
+安装仓库 main 分支
+
+    pdm add git+https://github.com/Misty02600/nonebot-plugin-hzys@main
+</details>
+<details>
+<summary>poetry</summary>
+
+    poetry add nonebot-plugin-hzys
+安装仓库 main 分支
+
+    poetry add git+https://github.com/Misty02600/nonebot-plugin-hzys@main
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
+
+    plugins = ["nonebot_plugin_hzys"]
+
+</details>
+
+<details>
+<summary>使用 nbr 安装(使用 uv 管理依赖可用)</summary>
+
+[nbr](https://github.com/fllesser/nbr) 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
+
+    nbr plugin install nonebot-plugin-hzys
+使用 **pypi** 源安装
+
+    nbr plugin install nonebot-plugin-hzys -i "https://pypi.org/simple"
+使用**清华源**安装
+
+    nbr plugin install nonebot-plugin-hzys -i "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+</details>
+
+
+## ⚙️ 配置
+
+在 NoneBot 项目的 `.env` 中配置：
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| :-- | :--: | :--: | :-- |
+| `OTTO_HZYS_BACKEND_URL` | 否 | `https://otto-hzys-api-backend.vercel.app` | 后端地址，例如 `http://127.0.0.1:3000` |
+| `OTTO_HZYS_API_KEY` | 否 | 无 | 后端 Token |
+
+示例：
+
+```env
+OTTO_HZYS_BACKEND_URL=http://127.0.0.1:3000
+```
+
+## 🎉 使用
+### 指令表
+| 指令 | 说明 |
+| :-- | :-- |
+| `ottohzys/活字印刷 <文本>` | 生成活字印刷语音 |

nonebot_plugin_hzys-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+nonebot_plugin_hzys/__init__.py,sha256=zJRhyXQWBy9RPHTLKvXcRxPMKFqbX8aFTsPwg4V3vKc,585
+nonebot_plugin_hzys/backend.py,sha256=7Fi9CTE9ugOHxsAkp-NJ4luOJB7gh1ctt4f1SMh4yDU,3498
+nonebot_plugin_hzys/command.py,sha256=aHaSsYYBPPwPwE41WXyEKVvG1Y_F9Z4yJ2_HsvR9wVc,1185
+nonebot_plugin_hzys/config.py,sha256=tR_Amo2mVpwriLngdyAiqSQBK_bUbhIRSYon14DiWao,413
+nonebot_plugin_hzys-0.2.0.dist-info/WHEEL,sha256=s_zqWxHFEH8b58BCtf46hFCqPaISurdB9R1XJ8za6XI,80
+nonebot_plugin_hzys-0.2.0.dist-info/METADATA,sha256=CBPVhYfpWF71IjejbP_-Z8LlQVgeJZBom7HfOyP8I2w,3994
+nonebot_plugin_hzys-0.2.0.dist-info/RECORD,,

nonebot_plugin_hzys-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.6
+Root-Is-Purelib: true
+Tag: py3-none-any