pgyer

PGYER（蒲公英）——官方 Skill

PGYER（https://www.pgyer.com）是中国领先的 iOS / Android / HarmonyOS 测试版分发服务。此 Skill 可帮助你上传构建版本、获取安装链接、查看应用元数据，以及将 CI/CD 接入 PGYER。

此 Skill 的结构

此 Skill 优先使用 PGYER 官方 MCP 服务（如果已安装），否则回退到 随附的官方 shell 脚本。两种方式调用的底层 API 相同。

每项任务开始时，检查本次会话中是否列出了 MCP 工具 upload-app、list-my-apps 或 get-app-info-by-shortcut。然后将下方的 能力映射 作为唯一依据，确定每项任务使用哪种方式（MCP / shell / curl），包括 MCP 不足、必须降级处理的情况。原始 HTTP 详细信息见 references/api-cheatsheet.md。

凭据

PGYER 使用从 https://www.pgyer.com/account/api 获取的 API 密钥进行身份验证。

按以下顺序查找密钥（匹配第一项即停止）：

1. $PGYER_API_KEY 环境变量
2. ~/.pgyer/config 中的 api_key=... 行

如果两者都不存在，请让用户设置密钥。建议将其持久保存，以便后续会话使用：

mkdir -p ~/.pgyer && chmod 700 ~/.pgyer
echo 'api_key=<key>' > ~/.pgyer/config && chmod 600 ~/.pgyer/config

切勿在聊天中回显密钥，也不要将其提交到代码仓库。

能力映射

任务	首选方式	回退方式
上传 ipa/apk/hap	MCP upload-app	scripts/pgyer_upload.sh -k $KEY <file>
上传时设置密码 / 有效期 / 安装类型	Shell 脚本（MCP 仅提供 filePath）	—
列出我的应用	MCP list-my-apps	POST /apiv2/app/listMy
根据快捷 URL 获取应用信息	MCP get-app-info-by-shortcut	POST /apiv2/app/getByShortcut
完整应用信息（密码、二维码、有效期、下载次数）	curl（MCP 未提供此功能）	使用 appKey 调用 POST /apiv2/app/view
推送时运行 CI/CD	推荐 pgyer-upload-app-action	参见 examples/（各平台模板）

如果用户想要设置 filePath 之外的任何上传参数（密码、安装类型、有效期、渠道快捷链接、更新说明），MCP upload-app 工具无法满足需求——请改用随附的 shell 脚本。

常见工作流

“将此构建版本上传到 PGYER”

1. 确定文件路径。如果路径不明确，请在 build/、dist/ 或项目根目录下查找最新的 *.ipa、*.apk 或 *.hap。
2. 确认可以找到凭据。
3. 执行上传（如果 MCP 可用则使用 MCP，否则使用 scripts/pgyer_upload.sh）。
4. 返回以下信息：应用名称、版本、构建编号、安装短 URL（https://www.pgyer.com/<buildShortcutUrl>）、二维码 URL，以及已设置的密码。

“PGYER 上目前有哪些内容？”

列出我的应用（使用 MCP list-my-apps 或 POST /apiv2/app/listMy）。以紧凑表格展示：名称、版本（buildVersion / buildVersionNo / buildBuildVersion）、快捷 URL、上传时间。

“介绍一下应用 X”

如果用户提供了 appKey（32 位十六进制值），调用 app/view 获取完整记录（密码、安装规则、二维码、有效期）。 如果用户提供了 buildShortcutUrl（URL 路径段），调用 app/getByShortcut 或 MCP get-app-info-by-shortcut。

"设置 CI，以便每次合并到 main 时发布到 PGYER"

根据**（CI 平台 × 目标 OS）**选择模板。读取 examples/ 中匹配的文件， 并根据用户的项目进行调整（scheme 名称、构建输出路径、分支）。告知用户需要添加哪些密钥/变量。

CI 平台	Android	iOS	HarmonyOS
GitHub Actions	examples/github-actions/android.yml	examples/github-actions/ios.yml	examples/github-actions/harmony.yml
GitLab CI	examples/gitlab-ci/android.yml	examples/gitlab-ci/ios.yml	—（使用 harmony.yml 中的仅上传模式）
fastlane	examples/fastlane/README.md（官方插件）	同上	—
Bitrise / Jenkins / 其他	—（暂无模板；使用 gitlab-ci 中的 shell 脚本模式）	同上	同上

需要密码 / 有效期 / 渠道吗？ PGYER/pgyer-upload-app-action GitHub Action 仅接受 _api_key + appFilePath。如需任何额外参数，请将该 Action 替换为 scripts/pgyer_upload.sh——每个 GitHub Actions 模板都包含一个注释掉的“with password”代码块，展示了如何替换。GitLab CI 模板已直接使用该脚本，而 fastlane 插件原生支持这些标志。

如果用户没有说明，默认询问以下问题：

1. 使用哪个 CI 平台？（如果用户没有说明，默认为 GitHub Actions。）
2. 使用哪种 OS / 包类型？（.apk → android，.ipa → ios，.hap → harmony）
3. 是否需要安装密码 / 有效期 / 渠道？（这决定上传步骤的选择——参见上方说明。）

HarmonyOS 注意事项：GitHub 托管的运行器上没有该 SDK。如果用户没有 自托管运行器，请指引他们使用 harmony.yml 底部的仅上传变体。

报告结果时的约定

• 始终提供安装短链接（https://www.pgyer.com/{buildShortcutUrl}）——这是用户实际会使用的链接。
• 提供 QR 码 URL，供移动端测试人员扫描。
• 如果应用使用密码安装（buildInstallType=2），请注明 buildPassword。
• 适用时注明 appExpiredDate——PGYER 应用若未续期会过期。
• 对于上传，还要提供 buildVersion / buildBuildVersion，以便用户确认成功上传的构建版本。

接下来查看

• references/mcp-tools.md — MCP 工具的准确 schema 和调用示例。
• references/api-cheatsheet.md — 原始 HTTP 端点、参数和响应结构。
• references/troubleshooting.md — 常见错误代码、网络/域名回退及签名问题。
• scripts/pgyer_upload.sh — 随附的官方上传脚本（支持多域名和所有参数）。
• examples/ — 按 <platform>/<os>.yml 组织的 CI/CD 模板。
  • github-actions/{android,ios,harmony}.yml
  • gitlab-ci/{android,ios}.yml
  • fastlane/README.md