前言¶

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