frappe-app-dev

Frappe 全栈应用构建器

全局规则

• 使用裸命令 bench。不要使用 ./env/bin/bench，也不要使用完整路径。
• 不要运行 which bench、bench --version、bench --help，也不要检查 frappe 版本。不要运行任何探查命令。
• 不要将检测 bench 的工作委派给子 Agent。请自行运行 ls apps/ sites/ Procfile。
• 不要使用 mkdir 创建 DocType 文件夹。Frappe 会通过 bench migrate 创建这些文件夹。
• 仅在后台进程中运行 bench start。
• 运行 bench start 前，检查是否已在现有终端中运行。不要启动第二个实例。
• 始终为 bench 命令显式传入 --site <site>。绝不要直接运行 bench migrate。

流程选择

确定适用的流程，然后只阅读相关文件：

创建全新应用

阅读 new-app.md — 涵盖 bench 设置、应用脚手架搭建、站点创建和安装。

使用现有应用

阅读 existing-app.md — 涵盖查找 bench、定位应用、确认站点和扩展功能。

功能参考

仅加载当前任务所需的参考资料：

主题	加载时机	文件
站点管理	查找、创建或管理站点	site-management.md
DocTypes	创建或修改 DocType、字段和命名	doctypes.md
控制器	文档生命周期、服务器逻辑	controllers.md
白名单 API	REST 端点、@frappe.whitelist()	api.md
数据库与 ORM	frappe.db、查询、原始 SQL	database.md
缓存	Redis、frappe.cache	caching.md
实时功能	WebSocket、publish_realtime	realtime.md
后台任务	frappe.enqueue、计划任务	background-jobs.md
Hooks	hooks.py 模式	hooks.md
权限	角色、DocType 权限、has_permission	permissions.md
测试	编写和运行测试	testing.md
前端与 UI	Desk UI、Vue SPA、门户页面	frontend.md（路由 → 3 个子文件）
Bench CLI	所有 bench 命令参考	bench-operations.md