समस्या निवारण

जब कुछ काम नहीं कर रहा हो तो यहाँ से शुरू करें। चरणों का क्रम में पालन करें।

पहले कदम

1. जाँचें कि daemon चल रहा है या नहीं

triggerfish status

यदि daemon नहीं चल रहा है, तो इसे शुरू करें:

triggerfish start

2. Logs जाँचें

triggerfish logs

यह log फ़ाइल को real time में tail करता है। शोर कम करने के लिए level filter का उपयोग करें:

triggerfish logs --level ERROR
triggerfish logs --level WARN

3. Diagnostics चलाएँ

triggerfish patrol

Patrol जाँचता है कि gateway पहुँच योग्य है, LLM provider प्रतिक्रिया दे रहा है, channels जुड़े हैं, policy rules loaded हैं, और skills discovered हैं। CRITICAL या WARNING चिह्नित कोई भी जाँच आपको बताती है कि कहाँ ध्यान देना है।

4. अपना config validate करें

triggerfish config validate

यह triggerfish.yaml को parse करता है, आवश्यक fields की जाँच करता है, classification levels को validate करता है, और secret references को resolve करता है।

क्षेत्र के अनुसार समस्या निवारण

यदि ऊपर के पहले कदम आपको समस्या की ओर नहीं ले गए, तो अपने लक्षणों से मेल खाने वाला क्षेत्र चुनें:

• स्थापना - install script विफलताएँ, source से build की समस्याएँ, platform समस्याएँ
• Daemon - service शुरू नहीं होगी, port conflicts, "already running" errors
• कॉन्फ़िगरेशन - YAML parse errors, missing fields, secret resolution विफलताएँ
• Channels - bot प्रतिक्रिया नहीं दे रहा, auth विफलताएँ, संदेश वितरण समस्याएँ
• LLM Providers - API errors, model not found, streaming विफलताएँ
• Integrations - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP servers
• Browser Automation - Chrome नहीं मिला, launch विफलताएँ, navigation blocked
• Security और Classification - write-down blocks, taint समस्याएँ, SSRF, policy denials
• Secrets और Credentials - keychain errors, encrypted file store, अनुमति समस्याएँ

अभी भी अटके हुए हैं?

यदि ऊपर की कोई भी गाइड आपकी समस्या का समाधान नहीं कर सकी:

1. एक log bundle एकत्र करें
2. Issues दर्ज करने की गाइड पढ़ें
3. GitHub पर एक issue खोलें