anime-convention-lizard-vincentzyu-fork,漫展查询,可以生图,提供自建api,且可以自托管api

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

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

:speech_balloon: 反馈与交流

  • QQ 交流群:259248174

:tada: 开箱即用的漫展查询插件

npm

npm-download

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


:sparkles: 特性

  • :mag: 多维查询:支持按城市名或漫展主题关键词进行搜索。

  • :date: 订阅系统:订阅感兴趣的关键词,一键获取所有关注城市的漫展动态。

  • :framed_picture: 精美渲染:支持通过 Puppeteer 将查询结果渲染为精美图片(可选)。

  • :abc: 自定义字体:支持加载本地字体文件,让图片渲染更符合你的审美。

  • :rocket: 自托管后端:支持配置自定义后端 API,稳定可靠。

:mag: 预览

https://gitee.com/vincent-zyu/koishi-plugin-anime-convention-lizard-vincentzyu-fork/releases/download/preview2/list-preview.png

https://gitee.com/vincent-zyu/koishi-plugin-anime-convention-lizard-vincentzyu-fork/releases/download/preview2/detail-preview.png


:package: 安装

在 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

:hammer_and_wrench: 前置依赖

  • 必须依赖database (用于存储订阅信息)

  • 可选依赖puppeteer (用于图片渲染功能)

  • 推荐安装:koishi-plugin-puppeteer@shangxueink/koishi-plugin-puppeteer-without-canvas


:gear: 配置说明

:link: 后端 API

本插件默认使用作者提供的公共 API。


// 默认配置

apiUrl: Schema.string()

.default('http://xwl.vincentzyu233.cn:51225/search')

.description('后端api地址'),

如果你希望自托管后端,可以前往 https://github.com/VincentZyu233/allcpp-search-go 下载二进制文件直接运行。或者你自己用源码go build一份也行( 这个后端他就是直接请求www.allcpp.cn的接口的

:abc: 字体设置

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

推荐字体:

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


:open_book: 使用方法

:mag: 漫展查询

| 指令 | 说明 | 示例 |

| :— | :— | :— |

| 漫展 查询 <关键词> | 查询指定城市或主题的漫展 | 漫展 查询 南京 |

| 漫展 一键查询 | 查询所有已订阅关键词的漫展 | 漫展 一键查询 |

| 漫展 图片查询 <关键词> | 以图片形式展示查询结果 | 漫展 图片查询 东方 |

| 漫展 一键图片查询 | 以图片形式展示所有订阅结果 | 漫展 一键图片查询 |

:pushpin: 订阅管理

| 指令 | 说明 | 示例 |

| :— | :— | :— |

| 漫展 订阅 <关键词> | 订阅指定关键词 | 漫展 订阅 上海 |

| 漫展 取消订阅 <关键词> | 取消订阅指定关键词 | 漫展 取消订阅 上海 |

| 漫展 取消订阅 | 清空所有订阅 | 漫展 取消订阅 |

| 漫展 订阅列表 | 查看当前订阅的关键词 | 漫展 订阅列表 |


:coffee: 原作者留下的

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

2 个赞

koishi插件:

https://gitee.com/vincent-zyu/koishi-plugin-anime-convention-lizard-vincentzyu-fork

https://www.npmjs.com/package/koishi-plugin-anime-convention-lizard-vincentzyu-fork


go后端:

1 个赞

QQ_1775571930530
有道理哦!这就更新:

github diff:✨🦎 feat: enhance emoji decorations & add puppeteer retry mechanism (v… · VincentZyuApps/koishi-plugin-anime-convention-lizard-vincentzyu-fork@b60221e · GitHub

local是本地直接请求allcpp

proxy 就是原先的请求 apiUrl

distributed是 请求 apiUrl 并且本地起一个http服务器 (所以apiUrl在distributed模式下可以填本地的)

1 个赞

图片

1 个赞

:gear: 配置说明

:link: 后端 API 配置

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

:satellite: 三种请求模式详解

:arrows_counterclockwise: Proxy 模式(远程中转)

  • 工作原理:通过远程中转服务器转发请求到 allcpp.cn
  • 适用场景:不想自托管后端,直接使用作者提供的公共服务
  • 配置示例
    priorityMode: 'proxy'
    apiUrl: 'http://xwl.vincentzyu233.cn:51225/search'  // 作者提供的公共API
    

:house: Local 模式(本地直连)

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

:earth_africa: Distributed 模式(分布式本地后端)

  • 工作原理:插件内置基于 Fastify 的本地 HTTP 服务器,启动后自动监听配置的地址和端口,代理请求 allcpp.cn
  • 适用场景:希望在本机部署代理服务以获得更稳定的访问和更好的性能
  • 依赖:需要安装 fastify@fastify/cors(运行 yarn add fastify @fastify/corsnpm install fastify @fastify/cors
  • 配置示例
    priorityMode: 'distributed'
    localServerHost: '0.0.0.0'  // 本地Fastify服务器监听地址
    localServerPort: 60407       // 本地Fastify服务器监听端口(自动构建URL,无需配置apiUrl)
    

:bulb: 模式推荐Local 模式 > Distributed 模式 > Proxy 模式

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