PCO CLI - Planning Center Services

用于 Planning Center Services API 的命令行工具。用于 Shadow 的教会工作（FBC Gulfport）。

代码仓库

https://github.com/rubysworld/pco-cli

文件位置

/Users/ruby/Projects/pco-cli/pco.ts

运行方式

tsx /Users/ruby/Projects/pco-cli/pco.ts <命令>

或创建别名：

alias pco="tsx /Users/ruby/Projects/pco-cli/pco.ts"

身份验证

凭据存储在 ~/.config/pco-cli/config.json

# 检查认证状态
pco auth status

# 设置（交互式）
pco auth setup

# 登出
pco auth logout

全局选项

所有列表命令均支持：
- --json - 以 JSON 格式输出（默认）
- --table - 以表格形式输出
- --quiet - 仅输出 ID
- --limit <n> - 限制结果数量（默认：25）
- --offset <n> - 结果偏移量
- --all - 获取所有分页

命令列表

组织

pco org get                    # 获取组织信息

服务类型

pco service-types list         # 列出所有服务类型
pco st list                    # 别名
pco service-types get <id>     # 获取特定服务类型

计划

# 列出计划（必须指定服务类型）
pco plans list --service-type <id>
pco plans list --service-type <id> --filter future
pco plans list --service-type <id> --filter past

# 获取特定计划
pco plans get <planId> --service-type <id>
pco plans get <planId> --service-type <id> --include items,team_members

过滤器：future, past, after, before, no_dates

计划项目

pco items list --service-type <id> --plan <planId>
pco items get <itemId> --service-type <id> --plan <planId>

排班人员（团队成员）

pco scheduled list --service-type <id> --plan <planId>

人员

pco people list
pco people list --search "John Doe"
pco people get <id>

团队

pco teams list --service-type <id>
pco teams get <teamId> --service-type <id>

歌曲

pco songs list
pco songs list --search "Amazing Grace"
pco songs get <id>
pco songs arrangements <songId>

媒体

pco media list
pco media get <id>

文件夹

pco folders list
pco folders get <id>

系列

pco series list
pco series get <id>

标签组

pco tag-groups list
pco tag-groups tags <groupId>

邮件模板

pco email-templates list

附件类型

pco attachment-types list

报告模板

pco report-templates list

原始 API 调用

# 直接访问 API
pco api GET /service_types
pco api POST /endpoint --data '{"key": "value"}'
pco api PATCH /endpoint --file data.json
pco api DELETE /endpoint

常用工作流

获取本周日崇拜计划

# 1. 查找服务类型 ID
pco st list --table

# 2. 获取未来计划
pco plans list --service-type <id> --filter future --limit 1

# 3. 获取包含详细信息的计划
pco plans get <planId> --service-type <id> --include items,team_members

本周谁被排班？

pco scheduled list --service-type <id> --plan <planId> --table

搜索歌曲

pco songs list --search "Great Are You Lord"

注意事项

• 此工具仅适用于 PCO Services（不适用于 People、Giving 等其他模块）
• API 文档：https://developer.planning.center/docs/#/apps/services
• 使用场景：仅限教会工作——请勿与 Buape 相关事务混用

最后更新：2026-01-08