Back to list
j4xie

debug-assistant

by j4xie

0🍴 1📅 Jan 23, 2026

SKILL.md


name: debug-assistant description: 调试辅助工具。快速诊断后端、前端和数据库问题。适用于 API 失败、日志分析、服务健康检查等场景。 allowed-tools:

  • Bash
  • Read
  • Grep
  • Glob

调试辅助 Skill

服务架构

服务端口日志位置健康检查
Cretas Backend10010/www/wwwroot/cretas/cretas-backend.log/api/mobile/health
AI Service8085/www/wwwroot/cretas/ai-service/ai-service.log/health
Mall Backend7500/www/wwwroot/mall-admin/mall-admin.log/actuator/health
React Native3010Metro bundler 控制台N/A

快速诊断命令

服务状态检查

# 检查端口
nc -zv 139.196.165.140 10010

# 健康检查
curl -s http://139.196.165.140:10010/api/mobile/health
curl -s http://139.196.165.140:8085/health
curl -s http://139.196.165.140:7500/actuator/health

查看日志

# Cretas 后端日志
ssh root@139.196.165.140 "tail -100 /www/wwwroot/cretas/cretas-backend.log"

# 过滤 ERROR
ssh root@139.196.165.140 "tail -500 /www/wwwroot/cretas/cretas-backend.log | grep -A5 'ERROR'"

# AI 服务日志
ssh root@139.196.165.140 "tail -100 /www/wwwroot/cretas/ai-service/ai-service.log"

数据库检查

ssh root@139.196.165.140 "mysql -u root -p cretas_db -e 'SELECT 1'"

常见错误速查

错误检查命令常见原因
500 Errorgrep ERROR backend.logEntity字段缺失、NPE、JSON错误
401 Unauthorizedecho TOKEN | cut -d'.' -f2 | base64 -dToken过期/格式错误/权限不足
网络失败nc -zv 139.196.165.140 10010端口未开放/防火墙
RN 白屏npx expo start --clearMetro 编译错误

JWT Token 调试

# 解码 JWT payload
echo "YOUR_TOKEN" | cut -d'.' -f2 | base64 -d 2>/dev/null | jq

React Native 调试

cd frontend/CretasFoodTrace
npx expo start --clear          # 清除缓存启动
npx expo doctor                 # 检查环境

参考文档

  • references/common-errors.md - 完整错误速查表

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon