前言¶

DeepSeek Harness (DSH) 插件生态通过模块化的方式扩展智能体能力。在 Android 开发中，配置 Google Play 商店的自动化部署流程通常涉及密钥管理、服务账户设置以及 GitHub Actions 工作流的编写，这些步骤繁琐且容易出错。xby-hitoshura25-android-playstore-deploy 旨在通过插件化手段，自动生成这些配置文件和脚本，降低部署门槛。

插件介绍¶

这是一个由 xby-skill 维护的 Android 应用商店部署工具。它集成了一整套自动化流程，能够分析 Android 项目、生成签名密钥、配置 Gradle 签名方案、生成 GitHub Actions 工作流以及验证 Play Store 的环境配置。

核心功能¶

插件提供了以下核心能力：

• 密钥与签名管理
  • generate_keystore：生成 Android 签名密钥，支持自定义密钥别名、密码、有效期、密钥大小和证书 DN。
  • generate_signing_config：生成 Gradle 签名配置。配置优先使用环境变量（适合 CI/CD），未设置时回退到 gradle.properties。同时会生成 gradle.properties.template。
• CI/CD 流程构建
  • generate_github_workflow：生成完整的 GitHub Actions 工作流文件。支持配置发布轨道、触发策略、ProGuard 规则、发布说明目录以及 Java 版本。
  • validate_github_secrets：检查 GitHub Secrets 是否存在（仅检查名称，不验证值）。
  • create_github_secrets_guide：生成创建所需 GitHub Secrets 的完整指南。
• Play Store 环境配置
  • setup_service_account_guide：提供设置 Google Play 服务账户的分步指南。
  • validate_play_store_setup：使用服务账户 JSON 文件验证 Play Store 应用和 API 访问权限。
• 项目分析与辅助
  • analyze_android_project：分析 Android 项目配置，识别 Play Store 部署所需的要求。
  • set_xby_apikey：设置 API 密钥。该密钥会自动持久化，重启后依然有效。
  • test_deployment_workflow：在本地测试部署工作流。支持 dry_run 模式，跳过实际 Play Store 上传。

安装与启用¶

使用以下命令安装插件：

dsh plugin --profile web add github:xby_skill/xby-hitoshura25-android-playstore-deploy

典型用法¶

以下是该插件在开发流程中的典型应用方式：

1. 生成工作流：在项目根目录下运行 generate_github_workflow，指定发布轨道（如 production）、触发策略（如 tag）以及 Java 版本。插件会生成支持 ProGuard 和自定义发布说明目录的 GitHub Actions 工作流。
2. 本地测试：在提交代码前，使用 test_deployment_workflow 进行本地验证。开启 dry_run 参数可以跳过真实上传，仅检查构建流程是否正常。
3. 配置签名：对于 CI/CD 环境，使用 generate_signing_config 并指定 env_var_prefix（默认为 “APP_”）。插件会优先读取环境变量中的密钥路径和密码，这避免了在 CI 日志中暴露敏感信息。

适用场景与注意¶

该插件适用于需要频繁发布 Android 应用到 Google Play Store 的开发团队。

• 权限与运行环境：插件运行在当前 DSH 进程的权限下。安装前请检查源码与许可证。
• 验证机制：validate_github_secrets 仅检查密钥名称是否存在，不验证密钥内容是否正确。建议在创建密钥后手动核对。
• 密钥持久化：set_xby_apikey 设置的 API 密钥具有持久化特性，重启终端或进程后依然有效。

结语¶

通过上述功能，开发者可以快速搭建起从本地构建到 Play Store 发布的自动化链路。更多详细信息和源码，请参考插件目录页或 GitHub 仓库。

• 目录页：https://www.skillhub.cn/plugins/xby-skill/xby-hitoshura25-android-playstore-deploy
• GitHub：https://github.com/xby-skill/xby-hitoshura25-android-playstore-deploy