nonebot-plugin-wyrestorm

将 WyreStorm Product Intelligence 的 DeepSeek 售前 AI 对话和 Qwen 多模态工具接入 NoneBot2。插件负责 OneBot V11 命令、群聊/私聊会话、上下文、单轮附件与 Poster 草稿； 产品目录、Support 资料、培训文件、向量和模型调用仍由私有 WyreStorm 后端处理。

功能

• /wys 售前问答；兼容 /ws、/wyrestorm、/威视问答 旧命令。
• 群聊与私聊均可使用；按“群 + 用户”或私聊用户隔离，最多保存 12 条上下文。
• 保留原系统的 RAG、完整系列查询、产品详情、比较和 Poster 工具调用。
• 支持随命令发送图片、PDF、Office、文本、音频或视频，由 Qwen 工具分析或转写。
• 显示可溯源的知识依据、工具名称和建议追问。
• 会话与 Poster 草稿写入包外 SQLite；同一会话的并发问题串行处理。
• Provider/真实性守门兜底不会写入历史；升级后会自动清理旧的异常轮次。
• 会话默认闲置 24 小时自动过期，NoneBot 重启不会延长旧会话寿命。
• 附件单轮最多 3 个、默认每个 32 MiB，使用后端随机 ID，处理后立即删除。
• 默认拒绝私网/本机附件 URL，降低恶意消息诱导机器人访问内网的风险。
• 后端未启动、超时、限流、配置缺失和数据目录不可写时返回安全提示。

架构与私有数据边界

OneBot V11
    ↓
nonebot-plugin-wyrestorm       可发布：仅 Python 代码、README、测试
    ↓ HTTP
WyreStorm Product Intelligence 私有部署：DeepSeek、RAG、工具 Harness
    ↓
外置知识目录                  不发布：SQLite、PPT、Excel、PDF、图片、向量

插件包不包含知识库。.gitignore 和 Poetry exclude 同时排除：

• data/、knowledge/、sources/、product-images/
• *.sqlite*、*.db
• *.ppt[x]、*.docx、*.xlsx、*.pdf

不要把知识文件放入 nonebot_plugin_wyrestorm/。后续知识库迁移约定见 KNOWLEDGE_MIGRATION.md。

环境要求

• Python 3.10+
• NoneBot2 2.3+
• OneBot V11 适配器
• 可访问的 WyreStorm Product Intelligence 后端

安装

从 PyPI 安装：

nb plugin install nonebot-plugin-wyrestorm
# 或
pip install nonebot-plugin-wyrestorm
# 或
poetry add nonebot-plugin-wyrestorm

然后在 NoneBot 项目的 pyproject.toml 中加载插件：

[tool.nonebot]
plugins = ["nonebot_plugin_wyrestorm"]

参与插件开发时也可以从本地目录安装：

pip install -e /path/to/nonebot-plugin-wyrestorm

配置

在 NoneBot 项目的 .env 中配置：

WYRESTORM_API_BASE=http://127.0.0.1:4173
WYRESTORM_API_TOKEN=
WYRESTORM_REQUEST_TIMEOUT=300
WYRESTORM_HISTORY_LIMIT=12
WYRESTORM_SESSION_TTL_HOURS=24
WYRESTORM_DATA_DIR=data/nonebot_plugin_wyrestorm
WYRESTORM_PUBLIC_BASE_URL=
WYRESTORM_MAX_REPLY_CHARS=2800
WYRESTORM_ATTACHMENT_MAX_BYTES=33554432
WYRESTORM_ATTACHMENT_TIMEOUT=60
WYRESTORM_ATTACHMENT_ALLOW_PRIVATE_URLS=false

DeepSeek API Key 仍在 WyreStorm 后端配置，不写入 NoneBot 插件。

使用方法

示例：

用户：/wys NHD-500-TX v2 的关键参数和限制是什么？
机器人：返回知识库约束的回答、依据与建议追问。

用户：/wys 把这个产品加入 Poster
机器人：调用后端 Poster 草稿工具并保存到当前会话。

用户：/wys 输出当前 Poster
机器人：生成 Poster；配置公开后端地址后同时返回 Word/PDF 链接。

用户：/wys 请读取图中的型号和接口（同时发送图片）
机器人：临时上传图片，调用 Qwen 分析，并结合 RAG 返回结果。

若 OneBot 只返回本地文件标识而没有 url 或 base64://，插件无法跨进程安全读取， 会提示调整适配器配置。可信的同机/内网 OneBot 若只提供私网 URL，可以显式启用 WYRESTORM_ATTACHMENT_ALLOW_PRIVATE_URLS=true；公网机器人不建议开启。

OneBot V11 的群会话 ID 同时包含群号和用户号，因此同一群的不同成员不会共享上下文； 不同群与不同私聊也互不影响。会话会跨 NoneBot 重启保留，但闲置超过 WYRESTORM_SESSION_TTL_HOURS 后自动删除。DeepSeek 协议失败或真实性守门兜底只回复当前轮， 不会进入下一轮上下文。

启动私有后端

在原项目中运行：

npm start
curl http://127.0.0.1:4173/ready

不要把 4173 端口直接暴露到公网。跨机器部署时应使用内网、反向代理、TLS 与访问控制。

原功能迁移对照

开发与测试

poetry install
poetry run python -m compileall nonebot_plugin_wyrestorm
poetry run pytest
poetry run ruff check .
poetry build

构建后应检查 wheel/sdist 内容，确认不存在 SQLite、Office/PDF、图片或知识目录。

许可证

MIT。产品知识、产品图片和原始资料不属于插件发布物，也不随本许可证分发。