koishi-plugin-zssm

这是什么？问一下！回复一条消息发送 zssm，或直接发送 zssm <内容>，插件会调用兼容 OpenAI Chat Completions 的模型解释文本、图片、PDF、网页和小红书图文内容。

本地开发

npm install
npm test
npm run build
npm run dev -- "zssm 什么是 MCP"

npm run dev 是本地流程测试入口，不连接真实 Koishi 机器人。默认使用 mock AI 输出；设置 ZSSM_REAL_AI=1 并提供 API key 后可调用真实模型。

完整流程模式会调用真实 handleZssm()，可能访问网络、网页、PDF、小红书和 LLM：

ZSSM_LOCAL_FULL=1 \
ZSSM_AI_TEXT_TOKEN="你的文本模型 key" \
ZSSM_AI_TEXT_ENDPOINT="https://api.deepseek.com/v1" \
ZSSM_AI_TEXT_MODEL="deepseek-chat" \
npm run dev -- "zssm 什么是 MCP"

如果要验证小红书图片识别，再补充视觉模型配置：

ZSSM_LOCAL_FULL=1 \
ZSSM_AI_TEXT_TOKEN="deepseek-key" \
ZSSM_AI_VL_TOKEN="siliconflow-key" \
ZSSM_XHS_MAX_IMAGES=3 \
npm run dev -- "zssm https://www.xiaohongshu.com/explore/..."

ZSSM_XHS_MAX_IMAGES 控制小红书笔记最多识别前几张图片；Koishi 插件配置中对应 xhsMaxImages。 ZSSM_XHS_ENABLE_AD_ANALYSIS=0 可关闭小红书广告判断；ZSSM_XHS_SHOW_AD_SCORE=1 可在最终回复中显示广告置信度数字。 ZSSM_SHOW_DEBUG=1 可在本地完整流程的最终回复后追加调试信息，包括执行时间、文本模型名与 token、视觉模型名与 token。若供应商未返回 usage，token 会显示为 -。

Puppeteer

普通网页解析依赖 Koishi 的 puppeteer 服务。请在 Koishi 中安装并启用 koishi-plugin-puppeteer，并确保运行环境中有可用的 Chrome / Edge / Firefox。

插件内部通过 ctx.puppeteer.page() 创建页面，不再直接依赖 Playwright。