frappecli

frappecli 是一款专为 Frappe Framework 和 ERPNext 设计的命令行管理工具 Skill，旨在通过标准化接口简化企业资源管理系统的日常运维与开发工作。

核心用法
该 Skill 提供了完整的 CLI 文档指南，涵盖从安装配置到高级操作的全流程。用户需先通过 Homebrew 或源码安装 frappecli 工具，并配置 ~/.config/frappecli/config.yaml 文件以设置站点凭证。支持多站点环境（生产/预发布），可执行文档 CRUD 操作（创建、读取、更新、删除）、文件上传下载、报表生成及自定义 RPC 方法调用。输出格式灵活，支持 Table、JSON、CSV 三种格式，便于与 jq 等工具链集成进行数据处理。

显著优点
首先，多站点管理能力强，支持快速切换不同环境，适合复杂的部署架构。其次，操作覆盖面广，从基础的 Doctype 查询到复杂的批量数据导出均可胜任。第三，与标准 Unix 工具链兼容性佳，JSON 输出可直接管道传递给 jq 进行筛选统计，极大提升数据处理效率。此外，文件管理功能完善，支持公私文件区分及关联文档的文件操作，满足企业文档管理需求。

潜在缺点与局限性
作为 T3 级个人开发者项目，长期维护稳定性和社区支持强度存在不确定性。该 Skill 本质为文档型指导，实际执行依赖外部 CLI 工具，若目标环境未正确安装 frappecli 或 Python 环境不兼容将导致功能失效。此外，当前仅支持 REST API 通信模式，对于需要直接数据库操作或 Server Script 执行的高级场景覆盖有限。

适合的目标群体
主要面向 ERPNext 系统管理员、Frappe 框架开发者及 DevOps 工程师。适合需要频繁进行数据维护、批量导入导出、跨站点同步或自动化报表生成的技术团队。对于熟悉命令行操作、追求效率而非图形界面的专业用户尤为适用。

使用风险
需申请 bash 工具权限以执行命令，存在潜在的命令注入风险（尽管 Skill 本身仅为文档）。API 密钥和 Secret 以明文形式存储在本地 YAML 配置文件中，若权限设置不当可能导致凭证泄露。由于来源为个人开发者，建议在生产环境使用前进行充分测试，并关注上游 CLI 工具的安全更新。此外，执行批量删除或更新操作前务必确认作用域，避免误操作影响生产数据。