菜单
Troubleshooting guide for Renfield. Debug intent recognition, WebSocket issues, voice input, Home Assistant, satellites, and MCP connections. Triggers on "debug", "troubleshoot", "Fehler", "funktioniert nicht", "Problem", "broken", "Intent falsch", "WebSocket error".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | debug-renfield |
| description | Troubleshooting guide for Renfield. Debug intent recognition, WebSocket issues, voice input, Home Assistant, satellites, and MCP connections. Triggers on "debug", "troubleshoot", "Fehler", "funktioniert nicht", "Problem", "broken", "Intent falsch", "WebSocket error". |
# Test intent recognition
curl -X POST "http://localhost:8000/debug/intent?message=YOUR_MESSAGE"
# Refresh HA keywords
curl -X POST "http://localhost:8000/admin/refresh-keywords"
# Re-embed all vectors (after changing embedding model)
curl -X POST "http://localhost:8000/admin/reembed"
# Check Ollama models
docker exec -it renfield-ollama ollama list
# Backend logs
docker compose logs -f backend
# Prometheus metrics (if enabled)
curl http://localhost:8000/metrics
| Problem | First Check |
|---|---|
| Wrong intent | debug/intent endpoint, refresh HA keywords |
| WebSocket fails | CORS in main.py, VITE_WS_URL match, backend logs |
| Voice not working | Whisper loads lazily (check logs), audio format (WAV/MP3/OGG) |
| HA integration | Token valid? Container network? Use IP not localhost |
| Satellite lost | Zeroconf: docker compose logs backend | grep zeroconf |
| MCP tool fails | Check server enabled in .env, docker compose logs backend |
references/intent-debug.md — Intent recognition deep-divereferences/common-issues.md — All known issues with fixesreferences/admin-endpoints.md — Admin/debug API endpointsProduction deployment guide for Renfield. Build box .159, Harbor registry, private k8s cluster. Triggers on "deploy", "Deployment", "production", "Produktion", "satellite deploy", "kubectl apply", "rsync", "registry.treehouse".
Guide for creating new frontend pages in Renfield. Covers page creation, routing, navigation, dark mode styling, i18n translations, and WebSocket integration. Triggers on "add page", "neue Seite", "Frontend-Seite erstellen", "add route", "neue Route", "add admin page".
Guide for extending Renfield via the async hook system. Create plugins that inject LLM context, post-process messages, add routes, or register agent tools. Triggers on "add hook", "Hook erstellen", "Plugin schreiben", "extend Renfield", "register_hook", "PLUGIN_MODULE".
Guide for adding a new MCP server integration to Renfield. Covers YAML configuration, transport types, permission setup, prompt filtering, and notification polling. Triggers on "add integration", "neue Integration", "MCP server hinzufuegen", "new service", "neuen Service einbinden".
Git workflow rules for Renfield. Commit message format, issue numbering, branch naming, PR creation, documentation updates before push. Triggers on "commit", "push", "PR erstellen", "pull request", "branch", "git", "merge".