docs(plugin): document auto-release workflow and zh README scaffold (SDK #68)

This commit is contained in:
RockChinQ
2026-06-09 07:39:20 -04:00
parent fbd0b2ebed
commit 8326d3f313
6 changed files with 63 additions and 3 deletions
+15
View File
@@ -20,6 +20,21 @@ lbp build
<img width="600" src="/images/zh/plugin/dev/dist/github_release.png" />
## Releaseの自動作成(GitHub Actions)
`lbp init` で作成されたプラグインには、GitHub Actions ワークフロー(`.github/workflows/release.yml`)が組み込まれているため、手動でビルドしてアップロードする必要はありません。
プラグインリポジトリを GitHub にプッシュした後、`manifest.yaml` の `version` フィールドを変更して `main` または `master` ブランチにプッシュするたびに、ワークフローが自動的に以下を実行します:
1. `lbp` CLI をインストールし、`lbp build` を実行してプラグインをパッケージ化;
2. `v<version>` をタグとして GitHub Release を作成し、生成された `.lbpkg` ファイルをアップロード。
該当バージョンの Release が既に存在する場合、ワークフローはスキップして重複公開を回避します。リポジトリの Actions ページから手動でトリガーすることもできます(`workflow_dispatch`)。
<Info title="">
このワークフローはリポジトリのデフォルトの `GITHUB_TOKEN` に依存し、`contents: write` 権限が必要です(テンプレートで宣言済み)。リポジトリの Actions が有効になっていること、`manifest.yaml` の `metadata.author`、`metadata.name`、`metadata.version` フィールドが正しく入力されていることを確認してください。Release 名と成果物のファイル名はこれらのフィールドから構成されます(`<author>-<name>-<version>.lbpkg`)。
</Info>
## プラグインのインストール
LangBotのプラグイン管理ページで、右上隅をクリックしてGitHubインストール方法を選択します。
+6 -1
View File
@@ -38,7 +38,12 @@ Plugin Runtimeは、インストールされた各プラグインを自動的に
├── main.py # プラグインメインプログラム、プラグインライフサイクルをリッスン
├── manifest.yaml # プラグインマニフェストファイル、プラグインメタデータを記述
├── README.md # プラグインドキュメントファイル、プラグイン機能と使用方法を記述、プラグインマーケットプレイスページに表示
└── requirements.txt # プラグイン依存関係ファイル
├── readme
│ └── README_zh_Hans.md # 簡体字中国語ドキュメント、多言語ドキュメント用
├── requirements.txt # プラグイン依存関係ファイル
└── .github
└── workflows
└── release.yml # GitHub Actions ワークフロー、バージョン変更をプッシュすると自動的にビルドして Release を公開
```
main.pyのプラグインクラスは各プラグインの共通コードで、プラグイン起動時に初期化され、コンテキスト情報(設定など)が渡されます。ここでプラグインの初期化とシャットダウンロジックを実装できます。プラグインクラスは`langbot_plugin.api.definition.plugin.BasePlugin`を継承し、[LangBotグローバルAPI](/en/plugin/dev/apis/common)を提供します。