scriptoriumadmin/skillhub
1
0
Fork 0
mirror of https://github.com/iflytek/skillhub.git synced 2026-08-28 11:25:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3
skillhub/document/i18n/en/docusaurus-plugin-content-docs/current/05-reference/troubleshooting.md
tww 19329480c8 feat(docs): complete Docusaurus website with bilingual support 
Add complete bilingual (Chinese/English) documentation website:
- Chinese documentation in docs/
- English documentation in i18n/en/
- iFlytek blue theme customization
- Role-based navigation structure
- ToB enterprise value-focused content
2026-03-15 18:36:59 +08:00

1.2 KiB
Raw Permalink Blame History

title sidebar_position description
Troubleshooting 2 Common problem diagnosis and solutions

Troubleshooting

Service Cannot Start

Checklist

  1. Check container status: docker compose ps
  2. View service logs: docker compose logs <service>
  3. Verify environment variables: Check .env.release configuration
  4. Check port occupancy: netstat -tlnp

Common Causes

  • Port occupied
  • Database connection failed
  • Redis connection failed
  • Environment variables missing

Upload Failed

Skill Package Upload Failed

  1. Check file size
  2. Check file type
  3. Check SKILL.md format
  4. View server logs

Authentication Issues

Cannot Login

  1. Check OAuth configuration
  2. Check callback URL configuration
  3. Check SKILLHUB_PUBLIC_BASE_URL configuration

Performance Issues

Slow Search

  1. Check PostgreSQL full-text index
  2. Consider upgrading to Elasticsearch (future version)

Slow Download

  1. Check object storage configuration
  2. Check network bandwidth

Get Help

If above solutions cannot resolve the issue:

  1. View logs
  2. Submit Issue
  3. Contact technical support

Next Steps