OpenWebUI开发效率增强包

OpenWebUI开发效率包是在 Open WebUI v0.12.5 上完成的一套开发效率增强配置，目标是让日常开发、排障和 Homelab 运维更顺手。它把常用操作集中到聊天入口：内置 12 个开发提示词模板，覆盖 review、refactor、debug、commit、test、sql、regex 等场景；接入 8 份 Homelab 运维手册文档作为知识库，并已完成嵌入；配置 5 个 MCP 工具服务器，共 38 个工具，覆盖文件系统、git、网页抓取、长期记忆和实时库文档查询；新增 homelab_status 自定义工具，可查询服务器状态、备份状态和单服务状态。任务模型切换为 deepseek-flash，降低标题、标签、追问生成成本；联网搜索切换为自建 SearXNG，保留博查 key 以便切回；Pipelines 容器已就绪并注册为 OpenAI 连接。资料显示真实对话已验证工具调用、MCP 文件读取、SearXNG 搜索和知识库检索，当前组件已加入异地备份脚本。

功能

• 12 个开发提示词模板：/review、/refactor、/debug、/commit、/test、/sql、/regex、/doc、/explain、/deploy、/gateway、/backup
• 8 份 Homelab 运维手册文档已嵌入知识库，支持 RAG 检索
• 5 个 MCP 工具服务器、38 个工具：filesystem、git、fetch、memory、context7
• homelab_status 自定义工具，提供服务器状态、备份状态和单服务查询
• 任务模型切换 deepseek-flash，联网搜索切换自建 SearXNG，Pipelines 已注册
• 权限默认仅 admin 可用，文件系统和 git MCP 限定目录

技术栈

使用 / 部署教程

以下步骤基于资料中已完成的 Open WebUI v0.12.5 环境；新增组件已就绪，重点说明日常使用与权限检查。

1. 确认环境：Open WebUI 为 v0.12.5，MCP 服务、homelab-status、Pipelines 容器已按资料部署。
2. 使用提示词：在聊天输入框输入 /，选择 /review、/debug、/deploy 等 12 个模板之一，再补充任务内容。
3. 启用知识库：对话时点击输入框上方的「知识库」图标，勾选「Homelab 运维手册」，用于检索 8 份已嵌入文档。
4. 选择工具：点击输入框工具图标，按需勾选 MCP 工具或 Homelab 状态工具；Context7 可在提问时要求“查一下 xx 库最新文档”自动调用。
5. 联网搜索：直接提问实时问题，默认使用 SearXNG；如需博查，在管理设置中切回 bocha。
6. Pipelines：社区 pipeline 文件放入 /opt/pipelines/ 可自动加载；容器地址为 172.17.0.1:9099，已注册为 OpenAI 连接。
7. 权限检查：MCP 连接未配置 access_grants，默认仅 admin 可用；homelab_status 已显式仅授权 admin。不要给家人账号开放 filesystem/git 写操作工具。
8. 回滚准备：如需停用，资料提供 systemctl disable --now 停 MCP 与 homelab-status、docker rm -f pipelines，并用备份数据库恢复 Open WebUI。

常见问题