koishi-plugin-kardsman (示例骨架)

这是一个基于参考仓库 nonebot_plugin_kardsman 与 KardsDeckBuilder 的 Koishi 插件骨架示例。

主要命令（已初步实现为占位/数据查询）：

• kards.search <卡名>: 查卡（本地 data/cards.json）
• kards.random: 随机抽一张卡
• kards.deck <卡组代码>: 接收卡组代码（目前为占位，后续实现图像合成）
• kards.guess: 猜卡小游戏占位

如何开始（Windows PowerShell）

1. 进入插件目录：

cd d:\VS\kards2\koishi-kardsman

2. 安装依赖（示例，仅 dev 依赖，实际运行需在 Koishi 项目中作为插件引入）：

npm install

3. 开发时可使用 ts-node 直接运行（需在 Koishi 环境中加载该插件）：

npm run dev

集成到你的 Koishi Bot

• 推荐在已有的 Koishi 项目中，将此包作为本地插件引入（如 npm link 或在主项目中直接 require('./path/to/koishi-kardsman/dist')）。
• 生成卡牌图像通常需要：
  • 卡牌素材（纹理、框架、图案）存放在 data/images/ 或远程图床。
  • 使用 canvas（node-canvas）或外部服务对卡牌进行合成。注意：在 Windows 上安装 node-canvas 可能需要额外的系统依赖。

接下来要做的工作（我可以继续完成）

• 完整实现卡组代码解析与图像合成（参考 KardsDeckBuilder 的编码/渲染逻辑）。
• 将图片资源从参考仓库导入或支持远程图床链接，并实现合成预览（合成可用 canvas/sharp/外部 API）。
• 实现猜卡小游戏逻辑与群聊交互状态管理。

如果你希望我现在继续：

• 请告诉我你要在什么平台上运行 Koishi（例如：OneBot / cqhttp / mcp / Telegram），我会为该适配器调整图片发送实现；
• 或者允许我接着实现卡组解析与图像合成的初始实现（我会把合成方案做成可选的本地 canvas 实现或调用外部图像服务）。