koishi-plugin-anime-convention-lizard-vincentzyu-fork

anime-convention-lizard-vincentzyu-fork 是一款针对漫展查询与订阅的 Koishi 插件。对接 无差别同人站 (www.allcpp.cn)，通过简单的指令快速查询城市或主题相关的漫展，并提供订阅与管理功能。

上游仓库：https://github.com/lizard0126/anime-convention-lizard

✨ 特性

• 🔍 多维查询：支持按城市名或漫展主题关键词进行搜索。
• 📅 订阅系统：订阅感兴趣的关键词，一键获取所有关注城市的漫展动态。
• 🖼️ 精美渲染：支持通过 Puppeteer 将查询结果渲染为精美图片（可选）。
• 🔤 自定义字体：支持加载本地字体文件，让图片渲染更符合你的审美。
• 🚀 自托管后端：支持配置自定义后端 API，稳定可靠。

🔍 预览

📦 安装

在 Koishi webui的插件市场中搜索插件名anime-convention-lizard-vincentzyu-fork 并安装。

或者 Koishi webui的依赖管理中搜索npm包名koishi-plugin-anime-convention-lizard-vincentzyu-fork 并安装。

或者使用 npm/yarn：

npm install koishi-plugin-anime-convention-lizard-vincentzyu-fork
yarn add koishi-plugin-anime-convention-lizard-vincentzyu-fork

🛠️ 前置依赖

• 必须依赖：database (用于存储订阅信息)
• 可选依赖：puppeteer (用于图片渲染功能)
  • 推荐安装：koishi-plugin-puppeteer 或 @shangxueink/koishi-plugin-puppeteer-without-canvas

⚙️ 配置说明

🔗 后端 API 配置

本插件默认使用作者提供的公共 API。如果你希望自托管后端以获取更稳定的服务，可以前往 allcpp-search-go 下载二进制文件直接运行，或者从源码自行编译。

📡 三种请求模式详解：

🔄 Proxy 模式（远程中转）

• 工作原理：通过远程中转服务器转发请求到 allcpp.cn
• 适用场景：不想自托管后端，直接使用作者提供的公共服务
• 配置示例：

  priorityMode: 'proxy'
  apiUrl: 'http://xwl.vincentzyu233.cn:51225/search'  // 作者提供的公共API

🏠 Local 模式（本地直连）

• 工作原理：直接请求 allcpp.cn 官网，不经过任何中间层
• 适用场景：追求最直接的访问方式，无需额外部署
• 注意：此模式为实验性功能，可能受 allcpp.cn 反爬策略影响
• 配置示例：

  priorityMode: 'local'
  // 无需配置 apiUrl

🌍 Distributed 模式（分布式本地后端）

• 工作原理：插件内置基于 Fastify 的本地 HTTP 服务器，启动后自动监听配置的地址和端口，代理请求 allcpp.cn
• 适用场景：希望在本机部署代理服务以获得更稳定的访问和更好的性能
• 依赖：需要安装 fastify 和 @fastify/cors（运行 yarn add fastify @fastify/cors 或 npm install fastify @fastify/cors）
• 配置示例：

  priorityMode: 'distributed'
  localServerHost: '0.0.0.0'  // 本地Fastify服务器监听地址
  localServerPort: 60407       // 本地Fastify服务器监听端口（自动构建URL，无需配置apiUrl）

💡 模式推荐：Local 模式 > Distributed 模式 > Proxy 模式

• Local 模式和 Distributed 模式均可在 Koishi 内直接完成，无需额外部署
• Proxy 模式依赖外部中转 API（如 Go 后端），适合无法直连 allcpp.cn 的网络环境

🔤 字体设置

你可以手动下载字体文件，并在插件配置项中填写字体的绝对路径。

推荐字体：

• 落霞孤鹜文楷 LXGW WenKai Mono → (https://gitee.com/vincent-zyu/koishi-plugin-onebot-info-image/releases/download/font/LXGWWenKaiMono-Regular.ttf)
• 思源宋体 Source Han Serif SC → (https://gitee.com/vincent-zyu/koishi-plugin-onebot-info-image/releases/download/font/SourceHanSerifSC-Medium.otf)

💡 提示：如未填写或路径无效，将自动回退为系统默认字体。

📖 使用方法

🔍 漫展查询

| 指令 | 说明 | 示例 | | :--- | :--- | :--- | | 漫展 查询 <关键词> | 查询指定城市或主题的漫展 | 漫展 查询 南京 | | 漫展 一键查询 | 查询所有已订阅关键词的漫展 | 漫展 一键查询 | | 漫展 图片查询 <关键词> | 以图片形式展示查询结果 | 漫展 图片查询 东方 | | 漫展 一键图片查询 | 以图片形式展示所有订阅结果 | 漫展 一键图片查询 |

📌 订阅管理

| 指令 | 说明 | 示例 | | :--- | :--- | :--- | | 漫展 订阅 <关键词> | 订阅指定关键词 | 漫展 订阅 上海 | | 漫展 取消订阅 <关键词> | 取消订阅指定关键词 | 漫展 取消订阅 上海 | | 漫展 取消订阅 | 清空所有订阅 | 漫展 取消订阅 | | 漫展 订阅列表 | 查看当前订阅的关键词 | 漫展 订阅列表 |

☕ 原作者留下的

如果这个插件对你有帮助，可以请我喝杯可乐🥤 (https://ifdian.net/a/lizard0126)