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 工具的安全更新。此外，执行批量删除或更新操作前务必确认作用域，避免误操作影响生产数据。

核心用法

frappecli 是一款面向 Frappe Framework 与 ERPNext 实例的命令行管理工具，通过 REST API 实现远程站点管理。用户需先配置 ~/.config/frappecli/config.yaml 添加站点认证信息（URL + API Key/Secret），即可执行多维度操作：

• 站点管理：列出 Doctype、查看字段元数据
• 文档 CRUD：支持带过滤器的列表查询、单条获取（可指定字段）、创建、更新与删除
• 文件管理：上传/下载附件，支持私有/公共文件区分，可按业务单据关联
• 报表导出：JSON/CSV 双格式输出，便于数据集成
• RPC 调用：直接调用 Frappe 自定义方法，支持传参
• 多站点切换：通过 --site 参数或配置默认站点灵活切换环境

显著优点

1. 操作闭环完整：覆盖 ERPNext 日常运维的核心场景，无需登录 Web 界面即可完成数据维护
2. 输出格式友好：默认 Table 美化输出，同时支持 JSON/CSV，便于与 jq 等工具链集成
3. 多环境支持：配置化站点管理，适合生产/测试环境隔离的工作流
4. 零侵入设计：纯 CLI 调用，不修改服务端代码，降低部署风险

潜在局限与风险

1. 依赖凭据安全：API Key/Secret 以明文存储于本地 YAML 文件，若权限配置不当存在泄露风险
2. T3 来源可信度：由个人开发者（pasogott）维护，仓库较新，长期维护与功能迭代稳定性待观察
3. 功能边界：仅封装现有 REST API，无法处理服务端未暴露的复杂业务逻辑或事务批量回滚
4. 网络稳定性：大型报表导出或文件传输依赖稳定连接，弱网环境可能中断

适合人群

• ERPNext/Frappe 开发者与实施顾问
• 企业运维工程师（需定期数据维护、批量导入导出）
• 需将 ERP 数据集成至 CI/CD 或数据分析管道的技术团队

常规风险

• 凭据泄露：本地配置文件需设置 600 权限，避免共享环境
• 误操作覆盖：doc update/delete 无二次确认，生产环境建议配合 --site staging 预验证
• API 版本兼容性：Frappe 版本升级可能导致部分 RPC 方法签名变化，需关注变更日志