用途:为在开发环境中使用 Frappe bench CLI 提供分类命令参考,从建站到恢复生产备份均有涉及。
主要能力(按功能分区,详见对应 references 文件):站点管理(创建、删除并自动备份、重装、配置);应用管理(安装/卸载、从仓库获取、多应用管理);应用开发(新建应用、remote 与分支、依赖校验);备份与恢复(全量或仅数据库备份、恢复生产备份、加密密钥处理);数据库操作(迁移、执行指定 patch、数据库控制台、MariaDB 运行时配置与性能调优);数据库维护(清理已删 DocType 的表列、分析与索引、优化);开发操作(启停开发服务器、构建资源、监听变更、清缓存、开发者模式);测试与调试(测试套件/单测、Python 控制台、执行 Python 代码、覆盖率);任务队列(worker、scheduler、待处理任务、队列诊断);翻译流程(POT/PO/MO、CSV 转 PO、编译、多语言);实用工具(读写配置、调度器、RQ 队列清理、重载 doctype、重置密码、版本检查、诊断);更多命令(用户管理、导入导出、搜索索引、生产设置、NGINX 与 SSL 等)。另含常见工作流:全新安装、从生产恢复、快速重装、大数据库恢复。
使用方式:先判断请求类别,再引用对应 references 小节,给出带正确环境常量的命令,并附前提或副作用说明。环境常量:站点 development.localhost、数据库 root 密码 123、管理员密码 admin、bench 路径 /workspace/development/frappe-bench。关键原则:多数命令需 --site development.localhost;需数据库 root 时加 --db-root-password 123;开发启用 bench --site development.localhost set-config developer_mode 1;改动后 bench clear-cache,安装或更新应用后 bench --site development.localhost migrate。
限制与注意:备份默认生成于 ./sites/development.localhost/private/backups/;MariaDB 运行时设置(内存限制)在容器重启后丢失,需写入 docker-compose.yml;数据库用户在 MariaDB 容器重启后丢失,出现 “Access denied” 时需重建用户;重建站点时须先设置备份中的 encryption_key;开发期迁移可用 --skip-search-index 加速。示例代码与具体命令清单以各 references 文件为准,此处不展开。