smmcat-economy：通用交易市场服务

smmcat · 2024 年12 月 28 日 17:28

koishi-plugin-smmcat-economy

通用道具交易市场

提供商品上架和买卖记录的操作，可对接其他插件。充当交易市场：

卖东西

通过 await ctx.economy.sellMarketSomeItem(session, upValue) 提交商品
但具体道具数据的移除操作由调用该服务的插件作者控制，插件只是起到提交作用

买东西

通过事件 ctx.economy.on(‘buying’, async (event: Economy_EventData<Economy_BuyEventData>) => {},by)
获取用户购买的 event.upValue 数据信息，但具体道具数据的添加、扣款操作、获款操作由调用该服务的插件作者在自己插件实现
插件只是起到采集和提交商品交易成功的媒介

买成功后，请记得修改 event.upValue.isBuy 为 true

下架回收

超过上架时效的商品，会暂时以已下架状态存留，不显示在商店列表中，并且呈现可回收状态

需要各个插件作者通过调用 await ctx.economy.recycleProduct(session, 标识by, callback)
在回调函数 callback 中接收 event 事件，类型为 Economy_DelistData 数据，当操作完成时，需要将 event.isRecycle 改为 true
但具体去道具数据的返还操作由其他插件作者自行实现和控制，插件只是起到采集和删除店铺下架商品的作用

0.1.0 版本也给了对应事件
ctx.economy.on(‘recycle’, (event: Economy_EventData<Economy_RecycleData>)=>{},by) 供用户监听回收数据进行操作

委托指向

由于多个插件有自己操作数据的逻辑，为了不影响其他插件得接收。通过设置 by 属性，为自己插件添加标识。当事件的参数3 中设置了 by 标识时，将只会在 by 同名的商品购买时传递事件给该插件。

演示插件

为了方便大家理解使用。提供了演示插件；该插件调用了 economy 交易市场服务

演示代码

import { Context, Schema, Session, h } from 'koishi'
import { } from 'koishi-plugin-smmcat-economy'
import { Economy_BuyEventData, Economy_DelistData, Economy_EventData } from 'koishi-plugin-smmcat-economy/lib/type'

export const name = 'smmcat-trydemo'

export interface Config { }
export const inject = ['economy']
export const Config: Schema<Config> = Schema.object({})

export function apply(ctx: Context, config: Config) {

  ctx.economy.on('buying', async (event: Economy_EventData<Economy_BuyEventData>) => {
    console.log("收到事件");

    await event.session.send(
      `${h.image(event.upValue.pic)}` +
      `商品名:${event.upValue.name}\n` +
      `下单数量:${event.upValue.quantity}\n` +
      `总价:${event.upValue.total}\n` +
      '请在20秒内决定购买.\n如若购买请发 "是"')

    const res = await event.session.prompt(20000)
    if (res === undefined) {
      await event.session.send('超时结束...')
      return
    }

    // 操作扣款、到账、道具获得等操作

    if (res.trim() === "是") {
      // 如购买完成 请修改 isBuy 为 true
      event.upValue.isBuy = true
      await event.session.send('购买完成...')
    }
  }, 'ceshi')

  ctx
    .command('测试上架 <name>')
    .action(async ({ session }, name) => {
      await session.send('20秒内请提交商品')
      const res = await session.prompt(20000)
      if (res == undefined) return

      // 操作道具扣除等操作
      // 巴拉巴拉巴拉
      
      const upValue = {
        pic: 'https://smmcat.cn/wp-content/uploads/2024/12/DFC65DB8218C6820BD5E1BF181D545CD.jpg',
        name: res,
        total: 10,
        price: 1,
        by: 'ceshi',
        type: 0,
        isSell: true
      }
      // 调用上传商品方法
      await ctx.economy.sellMarketSomeItem(session, upValue)
      await session.send('上架完成...')
    })

  ctx
    .command('店铺回收')
    .action(async ({ session }) => {
      // 获取并操作商品回收数据
      ctx.economy.recycleProduct(session, 'ceshi', async (event: Economy_DelistData) => {
        event.upValue.forEach((item) => {
      // 操作每个数据退回到用户仓库
      // 巴拉巴拉巴拉 操作完成
    })
        event.isRecycle = true
      })
    })

  // 监听商品回收事件
  ctx.economy.on('recycle', async (event: Economy_EventData<Economy_RecycleData>) => {
    event.upValue.forEach((item) => {
      // 操作每个数据退回到用户仓库
      // 巴拉巴拉巴拉 操作完成
    })
    // 操作完成后，通知服务
    event.isOver = true
  }, 'ceshi')
}

配置项

未来todo:

是否允许用户购买自己商品
用户交易市场允许同时上架商品数量
商店打折优惠、交易市场打折优惠
搜索、排序、筛选