SuperAPI AI 工具集

frappe-agent-debugger

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:系统化诊断 Frappe/ERPNext 问题,通过错误分类、机制识别、定位代码、套用对应诊断清单、给出修复方案五步流程,减少试错式调试。适用于 Python 回溯、JavaScript 控制台错误、静默失败、定时或后台任务失败、构建与静态资源错误、迁移后错误等场景。

主要能力:将错误分为 Python、JavaScript、数据库、权限、Hook、Scheduler、Build 七类,并映射到 Controller、Server Script、Client Script、Hook、Scheduler、API 等机制;提供 Frappe 文件路径约定(如 apps/{app}/{app}/{module}/{doctype}/{doctype}.py、hooks.py、tasks.py、templates/、patches/)用于定位源码;内置常见错误模式与修复对照表,例如 AttributeError 的 NoneType、ImportError(Server Script 不能 import)、LinkValidationError、TimestampMismatchError、DuplicateEntryException、OperationalError 1054/1146、IntegrityError 1062/1452、frappe.PermissionError、403、frm.X is not a function、cur_frm 未定义等;并规定按 Debug Report 格式输出错误分类、机制、根因、证据、修复与验证步骤。

使用方式:按决策树判断有无回溯与错误发生时机,优先阅读回溯最后一行;结合日志文件位置排查,如 sites/{site}/logs/frappe.log、worker.log、scheduler.log、自定义 frappe.logger 日志、~/.bench/logs/bench.log、/var/log/supervisor/、/var/log/nginx/,以及 Desk 中的 Error Log。必要时使用 bench 命令,例如 bench --site {site} console、bench --site {site} mariadb、bench doctor、bench build --verbose,并可在 console 中执行 frappe.get_doc、frappe.db.sql、frappe.get_hooks、frappe.get_all 等检查语句。

适用与限制:适合 Frappe/ERPNext 项目开发、运维与排障人员配合 Claude 技能使用;资料未提供安装方式、价格、平台支持范围与具体版本兼容要求,这些事实暂未提供。