aboutsummaryrefslogtreecommitdiff
path: root/docs/preview/website/src
diff options
context:
space:
mode:
authorkangal-bot <285672167+kangal-bot@users.noreply.github.com>2026-08-18 19:56:53 +0000
committerkangal-bot <285672167+kangal-bot@users.noreply.github.com>2026-08-18 19:56:53 +0000
commitc05f026ca9fe346a2206b63e0e90011f3244c830 (patch)
tree145b9ec73e944b8434c733c9f41b193bf8f775c9 /docs/preview/website/src
parent9fac51722653fa0b0b6a5786166fb18c763424e0 (diff)
docs: publish preview documentation
Diffstat (limited to 'docs/preview/website/src')
-rw-r--r--docs/preview/website/src/content/docs/cli-reference.mdx2
-rw-r--r--docs/preview/website/src/content/docs/install.mdx29
-rw-r--r--docs/preview/website/src/content/docs/ja/cli-reference.mdx2
-rw-r--r--docs/preview/website/src/content/docs/ja/install.mdx29
-rw-r--r--docs/preview/website/src/content/docs/ja/persistence-remote.mdx2
-rw-r--r--docs/preview/website/src/content/docs/ja/troubleshooting.mdx2
-rw-r--r--docs/preview/website/src/content/docs/ja/windows-beta.mdx94
-rw-r--r--docs/preview/website/src/content/docs/persistence-remote.mdx2
-rw-r--r--docs/preview/website/src/content/docs/troubleshooting.mdx2
-rw-r--r--docs/preview/website/src/content/docs/windows-beta.mdx92
-rw-r--r--docs/preview/website/src/content/docs/zh-cn/cli-reference.mdx2
-rw-r--r--docs/preview/website/src/content/docs/zh-cn/install.mdx29
-rw-r--r--docs/preview/website/src/content/docs/zh-cn/persistence-remote.mdx2
-rw-r--r--docs/preview/website/src/content/docs/zh-cn/troubleshooting.mdx2
-rw-r--r--docs/preview/website/src/content/docs/zh-cn/windows-beta.mdx94
-rw-r--r--docs/preview/website/src/data/config-reference.json4
16 files changed, 214 insertions, 175 deletions
diff --git a/docs/preview/website/src/content/docs/cli-reference.mdx b/docs/preview/website/src/content/docs/cli-reference.mdx
index 6c0cf6bf..a0abc541 100644
--- a/docs/preview/website/src/content/docs/cli-reference.mdx
+++ b/docs/preview/website/src/content/docs/cli-reference.mdx
@@ -22,7 +22,7 @@ herdr update --handoff # opt into live handoff for supported running serv
herdr completion zsh # generate a zsh completion script
herdr channel show # print stable or preview
herdr channel set preview # opt into preview builds
-herdr channel set stable # return Linux/macOS direct installs to stable
+herdr channel set stable # return a direct install to stable
herdr --version # print version
```
diff --git a/docs/preview/website/src/content/docs/install.mdx b/docs/preview/website/src/content/docs/install.mdx
index e5a786c3..c69cdd7a 100644
--- a/docs/preview/website/src/content/docs/install.mdx
+++ b/docs/preview/website/src/content/docs/install.mdx
@@ -1,9 +1,9 @@
---
title: Install Herdr
-description: Install, update, and verify Herdr on Linux, macOS, and Windows beta.
+description: Install, update, and verify Herdr on Linux, macOS, and Windows.
---
-Herdr ships stable binaries for Linux and macOS. Native Windows support is preview-only beta.
+Herdr publishes stable-channel binaries for Linux, macOS, and Windows. Windows is generally available, with documented platform-specific limitations and ongoing fixes.
## Install
@@ -13,13 +13,13 @@ On Linux or macOS, run:
curl -fsSL https://herdr.dev/install.sh | sh
```
-On Windows preview beta, install the preview channel:
+On Windows, run:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-The installer downloads the release binary for your platform and installs it in a directory on your PATH. Herdr defaults to preview on Windows without changing your config. The installer uses versioned install folders and updates a `current` junction, so updates do not need to overwrite a running `herdr.exe`.
+The installer downloads the release binary for your platform and places it on your PATH. New direct installs use the stable update channel. Existing Windows preview installs stay on preview until you switch them with `herdr channel set stable`. The Windows installer uses versioned install folders and updates a `current` junction, so updates do not need to overwrite a running `herdr.exe`.
## Install with Homebrew
@@ -82,6 +82,7 @@ Choose the asset that matches your system:
| Linux aarch64 | `herdr-linux-aarch64` |
| macOS Intel | `herdr-macos-x86_64` |
| macOS Apple silicon | `herdr-macos-aarch64` |
+| Windows x86_64 | `herdr-windows-x86_64.zip` |
On Linux or macOS, make it executable and move it somewhere on your PATH.
@@ -90,15 +91,9 @@ chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr
```
-### Windows beta downloads
+### Windows archive
-Windows binaries are published only on preview releases while native Windows support is in beta. Use the preview installer above for normal testing, or download the Windows asset from a preview GitHub prerelease:
-
-| System | Asset |
-| --- | --- |
-| Windows x86_64 beta | `herdr-windows-x86_64.zip` |
-
-The archive contains `herdr.exe` and its app-local ConPTY runtime. Keep the extracted directory together; do not copy only `herdr.exe`.
+Stable releases and preview prereleases both include `herdr-windows-x86_64.zip`. The archive contains `herdr.exe` and its app-local ConPTY runtime. Keep the extracted directory together; do not copy only `herdr.exe`.
## Verify
@@ -120,13 +115,13 @@ herdr update
Use `herdr update` only for installs managed by Herdr's own installer. Update Homebrew, mise, and Nix installs through those package managers instead.
-On Linux and macOS, Herdr uses the stable update channel by default. To opt into preview builds from `master`, set the channel:
+Direct installs on Linux, macOS, and Windows use the stable update channel by default. To opt into preview builds from `master`, set the channel:
```bash
herdr channel set preview
```
-Switch Linux and macOS direct installs back to stable the same way:
+Switch a direct install back to stable the same way:
```bash
herdr channel set stable
@@ -134,9 +129,9 @@ herdr channel set stable
For direct installs, changing channels checks the selected channel and installs its latest binary. If that update fails, run `herdr update` to retry from the configured channel.
-Preview builds are manually published GitHub prereleases from the current development branch. They are useful when you want fixes before the next stable release, but they can regress. Homebrew, mise, and Nix installs do not use the preview channel.
+Preview builds are regularly published GitHub prereleases from the current development branch. They are useful when you want fixes before the next stable release, but they can regress. Homebrew, mise, and Nix installs do not use the preview channel.
-Windows beta builds are preview-only for now. `herdr channel set stable` is rejected on Windows until stable Windows releases are available.
+Stable is the recommended channel for normal Windows use. Preview receives fixes sooner but can regress, so opt in only when you want that tradeoff. Existing Windows preview installs remain on preview until you switch them explicitly. If an older preview build rejects `herdr channel set stable`, run `herdr update` once on preview, then retry the channel switch.
By default, `herdr update` installs the new binary and leaves compatible running sessions alone. If an update changes Herdr's client/server protocol, Herdr asks whether to stop the old server after installing. Stop the old server to use the new version. Stopping the server exits its pane processes. For the default session, run `herdr server stop`, then run `herdr` again. For a named session, run `herdr session stop <name>`, then run `herdr session attach <name>` again.
@@ -150,4 +145,4 @@ Live handoff does not apply to Homebrew, mise, or Nix package-manager updates. F
## Requirements
-Stable Herdr releases support Linux and macOS. Native Windows builds are preview-only beta releases; see [Windows beta](/docs/windows-beta/) for supported workflows and known limitations.
+Stable-channel binaries are available for Linux, macOS, and Windows x86_64. See [Windows support](/docs/windows-beta/) for supported workflows and known limitations. Windows ARM64 runs the x86_64 build under Windows emulation.
diff --git a/docs/preview/website/src/content/docs/ja/cli-reference.mdx b/docs/preview/website/src/content/docs/ja/cli-reference.mdx
index a1a115ce..9c14c6d6 100644
--- a/docs/preview/website/src/content/docs/ja/cli-reference.mdx
+++ b/docs/preview/website/src/content/docs/ja/cli-reference.mdx
@@ -22,7 +22,7 @@ herdr update --handoff # 対応する実行中サーバーでライブハ
herdr completion zsh # zsh 補完スクリプトを生成
herdr channel show # stable または preview を表示
herdr channel set preview # プレビュービルドにオプトイン
-herdr channel set stable # Linux/macOS の直接インストールを安定版に戻す
+herdr channel set stable # 直接インストールを安定版に戻す
herdr --version # バージョンを表示
```
diff --git a/docs/preview/website/src/content/docs/ja/install.mdx b/docs/preview/website/src/content/docs/ja/install.mdx
index b894c132..3fe29f40 100644
--- a/docs/preview/website/src/content/docs/ja/install.mdx
+++ b/docs/preview/website/src/content/docs/ja/install.mdx
@@ -1,9 +1,9 @@
---
title: Herdr のインストール
-description: Linux、macOS、Windows ベータでの Herdr のインストール、アップデート、動作確認。
+description: Linux、macOS、Windows での Herdr のインストール、アップデート、動作確認。
---
-Herdr は Linux と macOS 向けに安定版バイナリを提供しています。ネイティブ Windows 対応はプレビュー限定のベータです。
+Herdr は Linux、macOS、Windows 向けに安定版チャンネルのバイナリを提供しています。Windows 対応は正式提供されており、プラットフォーム固有の既知の制限と継続的な修正があります。
## インストール
@@ -13,13 +13,13 @@ Linux または macOS では次を実行します:
curl -fsSL https://herdr.dev/install.sh | sh
```
-Windows プレビューベータでは、プレビューチャンネルをインストールします:
+Windows では次を実行します:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-インストーラーはプラットフォームに合ったリリースバイナリをダウンロードして PATH 上に配置します。Windows では Herdr が設定を変更せずにデフォルトでプレビューを使います。インストーラーはバージョン付きインストールフォルダーを使い、`current` ジャンクションを更新します。そのため、アップデート時に実行中の `herdr.exe` を上書きする必要がありません。
+インストーラーはプラットフォームに合ったリリースバイナリをダウンロードして PATH 上に配置します。新しい直接インストールは安定版アップデートチャンネルを使います。既存の Windows プレビューインストールは、`herdr channel set stable` で切り替えるまでプレビューに残ります。Windows インストーラーはバージョン付きインストールフォルダーを使い、`current` ジャンクションを更新します。そのため、アップデート時に実行中の `herdr.exe` を上書きする必要がありません。
## Homebrew でインストール
@@ -82,6 +82,7 @@ nix flake update herdr
| Linux aarch64 | `herdr-linux-aarch64` |
| macOS Intel | `herdr-macos-x86_64` |
| macOS Apple silicon | `herdr-macos-aarch64` |
+| Windows x86_64 | `herdr-windows-x86_64.zip` |
Linux または macOS では、実行可能にして PATH 上のどこかに移動します。
@@ -90,15 +91,9 @@ chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr
```
-### Windows ベータのダウンロード
+### Windows アーカイブ
-ネイティブ Windows 対応がベータの間、Windows バイナリはプレビューリリースでのみ公開されます。通常のテストには上記のプレビューインストーラーを使うか、プレビューの GitHub プレリリースから Windows アセットをダウンロードしてください:
-
-| システム | アセット |
-| --- | --- |
-| Windows x86_64 ベータ | `herdr-windows-x86_64.zip` |
-
-アーカイブには `herdr.exe` とアプリローカルの ConPTY ランタイムが含まれます。展開したディレクトリをまとめて保持し、`herdr.exe` だけをコピーしないでください。
+安定版リリースとプレビュープレリリースの両方に `herdr-windows-x86_64.zip` が含まれます。アーカイブには `herdr.exe` とアプリローカルの ConPTY ランタイムが含まれます。展開したディレクトリをまとめて保持し、`herdr.exe` だけをコピーしないでください。
## 動作確認
@@ -120,13 +115,13 @@ herdr update
`herdr update` は Herdr 自身のインストーラーで管理されているインストール向けです。Homebrew、mise、Nix のインストールは、それぞれのパッケージマネージャーでアップデートしてください。
-Linux と macOS では、Herdr はデフォルトで安定版アップデートチャンネルを使います。`master` からのプレビュービルドにオプトインするには、チャンネルを設定します:
+Linux、macOS、Windows の直接インストールは、デフォルトで安定版アップデートチャンネルを使います。`master` からのプレビュービルドにオプトインするには、チャンネルを設定します:
```bash
herdr channel set preview
```
-Linux と macOS の直接インストールを安定版に戻すのも同じ方法です:
+直接インストールを安定版に戻すのも同じ方法です:
```bash
herdr channel set stable
@@ -134,9 +129,9 @@ herdr channel set stable
直接インストールの場合、チャンネルの変更はそのチャンネルをチェックして最新バイナリをインストールします。そのアップデートが失敗した場合は、`herdr update` を実行して設定済みチャンネルから再試行してください。
-プレビュービルドは、現在の開発ブランチから手動で公開される GitHub プレリリースです。次の安定版リリースより前に修正が欲しいときに便利ですが、リグレッションの可能性があります。Homebrew、mise、Nix のインストールはプレビューチャンネルを使いません。
+プレビュービルドは、現在の開発ブランチから定期的に公開される GitHub プレリリースです。次の安定版リリースより前に修正が欲しいときに便利ですが、リグレッションの可能性があります。Homebrew、mise、Nix のインストールはプレビューチャンネルを使いません。
-Windows ベータビルドは今のところプレビュー限定です。安定版の Windows リリースが提供されるまで、Windows では `herdr channel set stable` は拒否されます。
+Windows の通常利用には安定版を推奨します。プレビューでは修正をより早く受け取れますが、リグレッションの可能性があるため、そのトレードオフを望む場合に限りオプトインしてください。既存の Windows プレビューインストールは、明示的に切り替えるまでプレビューに残ります。古いプレビュービルドで `herdr channel set stable` が拒否される場合は、プレビューのまま一度 `herdr update` を実行してから、チャンネル切り替えを再試行してください。
デフォルトでは、`herdr update` は新しいバイナリをインストールし、互換性のある実行中セッションには手を付けません。アップデートが Herdr のクライアント/サーバープロトコルを変更する場合、Herdr はインストール後に古いサーバーを停止するか尋ねます。新しいバージョンを使うには古いサーバーを停止してください。停止するとペインのプロセスは終了します。デフォルトセッションでは `herdr server stop` を実行してから再度 `herdr` を実行します。名前付きセッションでは `herdr session stop <name>` を実行してから再度 `herdr session attach <name>` を実行します。
@@ -150,4 +145,4 @@ herdr update --handoff
## 動作要件
-Herdr の安定版リリースは Linux と macOS をサポートします。ネイティブ Windows ビルドはプレビュー限定のベータリリースです。サポートされるワークフローと既知の制限は [Windows ベータ](/ja/docs/windows-beta/)を参照してください。
+安定版チャンネルのバイナリは Linux、macOS、Windows x86_64 で利用できます。サポートされるワークフローと既知の制限は [Windows サポート](/ja/docs/windows-beta/)を参照してください。Windows ARM64 では x86_64 ビルドが Windows のエミュレーション上で動作します。
diff --git a/docs/preview/website/src/content/docs/ja/persistence-remote.mdx b/docs/preview/website/src/content/docs/ja/persistence-remote.mdx
index 6788dd06..266d407b 100644
--- a/docs/preview/website/src/content/docs/ja/persistence-remote.mdx
+++ b/docs/preview/website/src/content/docs/ja/persistence-remote.mdx
@@ -95,7 +95,7 @@ herdr --remote workbox --session agents
完全な Herdr アタッチはワークスペース UI 全体を開きます。ダイレクトアタッチは、サーバーが所有するターミナルをひとつだけ、現在のターミナルに開きます。
-ダイレクトターミナルアタッチは Windows ベータでは Unix 専用です。
+ダイレクトターミナルアタッチは Windows では Unix 専用です。
エージェントターゲットでアタッチ:
diff --git a/docs/preview/website/src/content/docs/ja/troubleshooting.mdx b/docs/preview/website/src/content/docs/ja/troubleshooting.mdx
index a5b64361..21320dd0 100644
--- a/docs/preview/website/src/content/docs/ja/troubleshooting.mdx
+++ b/docs/preview/website/src/content/docs/ja/troubleshooting.mdx
@@ -23,7 +23,7 @@ IME の変換中テキストや候補ウィンドウが誤った位置に表示ã
host_cursor = "native"
```
-ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソル表示が乱れることがあります。視覚的に安定したカーソルへ戻すには `host_cursor = "drawn"` を設定するか、設定を削除して Windows のデフォルトを使ってください。現在の制限については [Windows ベータ](/ja/docs/windows-beta/) を参照してください。
+ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソル表示が乱れることがあります。視覚的に安定したカーソルへ戻すには `host_cursor = "drawn"` を設定するか、設定を削除して Windows のデフォルトを使ってください。現在の制限については [Windows サポート](/ja/docs/windows-beta/) を参照してください。
## Enter、Tab、Backspace が 2 回入力される
diff --git a/docs/preview/website/src/content/docs/ja/windows-beta.mdx b/docs/preview/website/src/content/docs/ja/windows-beta.mdx
index 8edbf7e0..97d500fe 100644
--- a/docs/preview/website/src/content/docs/ja/windows-beta.mdx
+++ b/docs/preview/website/src/content/docs/ja/windows-beta.mdx
@@ -1,45 +1,51 @@
---
-title: Windows ベータ
-description: ネイティブ Windows 対応の状況、サポートされるワークフロー、既知の制限。
+title: Windows サポート
+description: ネイティブ Windows 対応、サポートされるワークフロー、既知の制限。
---
-ネイティブ Windows 対応は実験的ベータです。
+ネイティブ Windows 対応は正式に提供されています。
-Windows 上の Herdr は、Herdr が本来前提としていた Unix の PTY モデルではなく、ConPTY と Windows のプロセス/ランタイム挙動を使います。Herdr の機能には Windows にきれいに対応付くものもあれば、そうでないものもあります。このプレビューは、すべての Linux/macOS 機能が Windows で完全にサポートされることを約束するものではありません。
+Windows 上の Herdr は、Herdr が本来前提としていた Unix の PTY モデルではなく、ConPTY と Windows のプロセス/ランタイム挙動を使います。主要なワークフローの多くはサポートされていますが、一部の機能は Linux/macOS と異なるか、プラットフォームに依存します。残っている差を埋める間、Windows 固有の修正がより多く提供されることがあります。
-ベータの目的は実際の使用から学ぶことです: インストールの成功率、ペインの信頼性、エージェントのワークフロー、バグの量、不足している機能、そして Windows ユーザーが Herdr から十分な価値を得られているかどうか。そのフィードバックに基づき、Windows 対応は安定版に昇格するか、成熟するまでプレビュー限定のままか、メンテナンスコストに見合わなければ縮小される可能性があります。
-
-ネイティブ Windows ベータビルドは PowerShell でインストールします:
+Windows に Herdr をネイティブインストールするには PowerShell を使います:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-Windows ベータビルドはプレビューチャンネルでのみ提供されます。Windows では Herdr が設定を変更せずにデフォルトでプレビューを使います。インストーラーはリリースを `%USERPROFILE%\.herdr\packages\standalone\releases` に保存し、`%LOCALAPPDATA%\Programs\Herdr\bin` を現在のリリースに向け、実行中のプロセスがアップデートを妨げないよう少数の古いリリースを保持します。
+Windows ビルドは安定版とプレビューの両方のアップデートチャンネルで提供されます。新規インストールはデフォルトで安定版を使い、通常の利用には安定版を推奨します。既存のプレビューインストールは、`herdr channel set stable` を実行するまでプレビューに残ります。古いプレビュービルドでこのコマンドが拒否される場合は、プレビューのまま一度 `herdr update` を実行してから再試行してください。プレビューでは `master` からの新しく検証の少ない修正を受け取れますが、リグレッションが起きる可能性があります。そのトレードオフを望む場合に限り、`herdr channel set preview` でオプトインしてください。
+
+インストーラーはリリースを `%USERPROFILE%\.herdr\packages\standalone\releases` に保存し、`%LOCALAPPDATA%\Programs\Herdr\bin` を現在のリリースに向け、実行中のプロセスがアップデートを妨げないよう少数の古いリリースを保持します。
-内部ベータテスト向けに、`HERDR_MANIFEST_URL` でインストーラーを Herdr の安定版/プレビューマニフェストではなくカスタムマニフェストに向けられます。
+内部テスト向けに、`HERDR_MANIFEST_URL` でインストーラーを Herdr の安定版/プレビューマニフェストではなくカスタムマニフェストに向けられます。カスタムプレビューマニフェストでは `HERDR_CHANNEL=preview` も設定してください。
-## ベータでサポート
+## Windows でサポート
| 機能 | 状況 |
| --- | --- |
-| ローカル永続セッション | ベータ |
-| ConPTY によるネイティブペイン | ベータ |
-| Windows Terminal / PowerShell アプリからのアタッチ | ベータ |
-| Linux/macOS ホストへの `herdr --remote` | ベータ |
-| リモートクリップボード画像と画像ファイルのドロップ | ベータ |
-| `cmd.exe` ペイン | ベータ |
-| 起動時 cwd とワークスペースラベル | ベータ |
-| ペイン起動時の cwd | ベータ |
-| エージェントコマンドの発見 | ベータ |
-| エージェントのセルフレポートインテグレーション | ベータ |
-| エージェントのプロセスツリー検出 | ベータ |
-| 既知の cwd からの Git/worktree 検出 | ベータ |
+| ローカル永続セッション | サポート済み |
+| ConPTY によるネイティブペイン | サポート済み |
+| Windows Terminal / PowerShell アプリからのアタッチ | サポート済み |
+| Linux/macOS ホストへの `herdr --remote` | サポート済み |
+| リモートクリップボード画像と画像ファイルのドロップ | サポート済み |
+| `cmd.exe` ペイン | サポート済み |
+| ネイティブのキーボード/マウス入力 | サポート済み |
+| 起動時 cwd とワークスペースラベル | サポート済み |
+| ペイン起動時の cwd | サポート済み |
+| エージェントコマンドの発見 | サポート済み |
+| 対応済みエージェントのセルフレポートインテグレーション | サポート済み |
+| エージェントのプロセスツリー検出 | サポート済み |
+| 既知の cwd からの Git/worktree 検出 | サポート済み |
+| システム通知と MP3 サウンド | サポート済み |
| プラグイン | プレビュー |
-| ペイン画面履歴 | ベータ |
-| ネストされた起動のオーバーライド | ベータ |
+| ペイン画面履歴 | サポート済み |
+| ネストされた起動のオーバーライド | サポート済み |
+
+ローカル永続セッションは、クライアントをデタッチした後やターミナルウィンドウを閉じた後も動作し続けます。Windows OpenSSH から起動したサーバーとペインプロセスもログアウト後に存続します。再接続するには `herdr` をもう一度実行してください。
-Windows のエージェントプロセス検出は、ペインのシェルの子孫プロセスをスキャンし、直接のエージェントと一般的なコマンドラッパーを認識します。Codex、Claude などのエージェントには有用ですが、Unix のフォアグラウンドプロセスグループ検出と同じものではありません。
+Windows のエージェントプロセス検出は、ペインのシェルの子孫プロセスをスキャンし、npm/Node や Git Bash のプロセスチェーンを含む直接のエージェントと一般的なコマンドラッパーを認識します。Git Bash から起動したエージェントはエミュレートされた `exec` 境界を越えて追跡されますが、Unix のフォアグラウンドプロセスグループ検出と同じものではありません。
+
+Windows でインテグレーションをインストールできるのは、現在 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI、Antigravity CLI です。利用可能な対象は Unix より少なく、インストール形式が Windows で未対応のインテグレーションは表示されないか拒否されます。
プラグインは、プレビューとしてマニフェストのプラットフォームに `windows` をサポートします。GitHub インストール、ローカルリンク、ビルドコマンド、アクション、イベント、プラグインペインは Windows ではベストエフォートです。コマンドは argv 形式で Windows 互換である必要があります。`npm`、`bun`、`node` のような Node パッケージの shim は `PATH` にあれば動作するはずですが、`sh` や Bash を使う Unix 専用の例には Windows 向けの代替が必要です。プラットフォームフィルターは、未サポートのビルドコマンドをスキップし、未サポートのアクションやペインには `platform_unsupported` を返します。
@@ -48,17 +54,29 @@ Windows のエージェントプロセス検出は、ペインのシェルの子
| 機能 | 状況 |
| --- | --- |
| シェルで `cd` した後のライブ cwd | 部分的 |
-| シェルインテグレーション/OSC7 によるライブ cwd | ベータ |
-| ローカルペインのエージェントへのクリップボード画像貼り付け | 未検証 |
+| シェルインテグレーション/OSC7 によるライブ cwd | サポート済み |
+| ローカルペインのエージェントへのクリップボード画像貼り付け | ターミナル/エージェント依存 |
| CJK IME の変換候補位置 | 部分的 |
-| Kitty graphics のレンダリング | 未検証 |
+| プレフィックス入力ソース切り替え (韓国語 IME) | 部分的 |
+| Kitty graphics のレンダリング | ターミナル依存 |
| ホストカーソル描画 | 部分的 |
Herdr はペインを正しいディレクトリで起動でき、Herdr を起動したディレクトリから最初のワークスペースを作成できます。起動後の PowerShell のディレクトリ変更は別問題です: Herdr が調べられるプロセスのフィールドは、その後の論理的な `cd` の変化を確実には追跡しません。ライブ cwd の報告には Herdr インテグレーションかプロンプトのシェルインテグレーションを使ってください。
-`herdr --remote` では、設定されたリモート画像貼り付けキーが Windows のクリップボード画像を読み取り、リモートホストへ転送します。Windows Terminal にローカル画像ファイルをひとつドロップした場合も、そのファイルを転送してリモート側のパスを貼り付けます。ローカルのネイティブ Windows ペインへのクリップボード画像貼り付けは、引き続き未検証です。
+`herdr --remote` では、設定されたリモート画像貼り付けキーが Windows のクリップボード画像を読み取り、リモートホストへ転送します。Windows Terminal にローカル画像ファイルをひとつドロップした場合も、そのファイルを転送してリモート側のパスを貼り付けます。
+
+プレフィックス入力ソース切り替えは、韓国語 IME 向けのオプトイン実験機能として利用できます。プレフィックスコマンドが有効な間はハングル入力を英語に切り替え、終了後に以前のモードへ戻します:
+
+```toml
+[experimental]
+switch_ascii_input_source_in_prefix = true
+```
+
+その他の Windows IME はまだこのオプションに対応していません。[設定](/ja/docs/configuration/#プレフィックス入力ソースの切り替え)を参照してください。
+
+Windows 上の一部のエージェントは `ctrl+v` を受け取り、クリップボード画像を直接読み取れます。Herdr 自身のクリップボード画像リーダーはローカルのネイティブ Windows ペインには配線されていないため、エージェント自身による画像貼り付けはターミナルとエージェントに依存します。`alt+v` などエージェントの画像貼り付けショートカットによって、Herdr が管理するローカルクリップボードブリッジが追加されるわけではありません。リモートクリップボード画像ブリッジは、Linux/macOS ホストへの `herdr --remote` で別途サポートされます。
-Kitty graphics は実験的なままで、まだ Windows でのサポートを謳っていません。Windows Terminal での画像レンダリングを特にテストしているのでない限り、`experimental.kitty_graphics = false` のままにしてください。
+Kitty graphics は実験的機能で、外側のターミナルに依存します。`experimental.kitty_graphics = true` の場合、Herdr は他のプラットフォームと同様に Windows でも Kitty graphics protocol の出力を送ります。この経路は Windows の WezTerm から WSL 内の Herdr をホストする構成で動作確認されていますが、ネイティブ Windows のターミナルと ConPTY の組み合わせはすべて検証済みではありません。Windows Terminal は Herdr が使う Kitty graphics 経路を提供しません。外側のターミナルが Kitty graphics に対応しており、その組み合わせをテストする場合を除いて、このオプションは無効のままにしてください。
## 既知の注意点
@@ -75,30 +93,30 @@ Herdr はネイティブ Windows のペインに ConPTY を使用します。現
host_cursor = "native"
```
-ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソルのちらつき、ジャンプ、古い位置の残像が再び発生することがあります。これは現在の Windows ベータにおける互換性上のトレードオフです。
+ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソルのちらつき、ジャンプ、古い位置の残像が再び発生することがあります。これは現在の Windows 対応における互換性上のトレードオフです。
### キーボードとマウス
-Windows のターミナルは、修飾キー付きのキーをすべて同じ形で報告するわけではありません。Herdr は Windows Terminal と Windows 上の Alacritty ではマウス報告と `ctrl+j` を保持しますが、`shift+enter` は外側ターミナルが修飾付き Enter として区別して報告する場合にだけ動作します。Windows またはターミナルがそれを通常の Enter として報告する場合、Herdr は通常の Enter を転送します。
+Windows のターミナルは、修飾キー付きのキーをすべて同じ形で報告するわけではありません。Herdr は Windows Terminal と Windows 上の Alacritty でマウス報告と `ctrl+j` を保持します。ネイティブ Windows の入力経路では、物理キーの押下、リピート、解放、単独の Escape、`shift+enter` もデフォルトの ConPTY ペインまで保持されます。ただし修飾キーは、外側のターミナルが区別可能なキーイベントとして報告する必要があります。`shift+enter` が通常の Enter として報告された場合、Herdr が転送できるのも通常の Enter だけです。
-古い Windows 10 ビルドのシステム ConPTY は、Kimi や Pi などのエージェントが使用する Kitty キーボードプロトコルのシーケンスを失うため、プレビューパッケージには Microsoft の最新のアプリローカル ConPTY ランタイムが含まれます。バンドル版ランタイムとの互換性問題を診断する場合に限り、Herdr を起動する前に `HERDR_WINDOWS_CONPTY=system` を設定してください。
+古い Windows 10 ビルドのシステム ConPTY は、Kimi や Pi などのエージェントが使用する Kitty キーボードプロトコルのシーケンスを失うため、Windows パッケージには Microsoft の最新のアプリローカル ConPTY ランタイムが含まれます。バンドル版ランタイムとの互換性問題を診断する場合に限り、Herdr を起動する前に `HERDR_WINDOWS_CONPTY=system` を設定してください。
## コピーと貼り付け
-Herdr のペインテキストコピーは Windows ベータで動作します。ペイン内でテキストをドラッグ選択すると Herdr 経由でコピーされます。
+Herdr のペインテキストコピーは Windows で動作します。ペイン内でテキストをドラッグ選択すると Herdr 経由でコピーされます。
テキストの貼り付けには Windows Terminal で `ctrl+shift+v` を使ってください。複数行テキストの貼り付けはブラケット付きなので、シェルやエージェントのプロンプトは各行を個別に送信せず、ひとつの貼り付けとして受け取ります。`shift` を押しながら右クリックすると、クリックを Herdr に送らずに外側ターミナルの貼り付けアクションを使えます。
-## Windows ベータで未サポート
+## Windows で未サポート
| 機能 | 状況 |
| --- | --- |
-| ダイレクトターミナルアタッチ | 未サポート |
+| ダイレクトターミナルアタッチ (`herdr terminal attach`) | 未サポート |
| `herdr --remote` の接続先としての Windows | 未サポート |
| ライブサーバーハンドオフ | 未サポート |
| Unix ファイルディスクリプタのハンドオフ | 未サポート |
| Unix フォアグラウンドプロセスグループ | 未サポート |
-| プレフィックスによる入力ソース切り替え | 未サポート |
+| ローカルのネイティブペインでの Herdr クリップボード画像ブリッジ | 未サポート |
| 署名済みバイナリ / SmartScreen 回避 | 未サポート |
Windows Terminal からは、Linux や macOS と同じリモートコマンドを使います:
@@ -111,7 +129,7 @@ herdr --remote workbox
Windows のアップデートは Windows インストーラー経由で行われ、バージョン付きインストールジャンクションを更新します。アップデート後は実行中の Herdr セッションを再起動してください。ライブハンドオフは Unix 専用です。
-## Windows ベータの問題を報告する
+## Windows の問題を報告する
以下を含めてください:
diff --git a/docs/preview/website/src/content/docs/persistence-remote.mdx b/docs/preview/website/src/content/docs/persistence-remote.mdx
index 1847a0a5..5044c66d 100644
--- a/docs/preview/website/src/content/docs/persistence-remote.mdx
+++ b/docs/preview/website/src/content/docs/persistence-remote.mdx
@@ -104,7 +104,7 @@ herdr --remote workbox --session agents
Full Herdr attach opens the whole workspace UI. Direct attach opens one server-owned terminal in your current terminal.
-Direct terminal attach is Unix-only in the Windows beta.
+Direct terminal attach is Unix-only on Windows.
Attach by agent target:
diff --git a/docs/preview/website/src/content/docs/troubleshooting.mdx b/docs/preview/website/src/content/docs/troubleshooting.mdx
index e908057e..7ad2f786 100644
--- a/docs/preview/website/src/content/docs/troubleshooting.mdx
+++ b/docs/preview/website/src/content/docs/troubleshooting.mdx
@@ -23,7 +23,7 @@ If the IME composition or candidate window appears at the wrong location, enable
host_cursor = "native"
```
-Native mode restores the IME anchor but may reintroduce occasional cursor movement artifacts during active output. Return to the visually stable cursor with `host_cursor = "drawn"`, or remove the setting to use the Windows default. See [Windows beta](/docs/windows-beta/) for the current limitation.
+Native mode restores the IME anchor but may reintroduce occasional cursor movement artifacts during active output. Return to the visually stable cursor with `host_cursor = "drawn"`, or remove the setting to use the Windows default. See [Windows support](/docs/windows-beta/) for the current limitation.
## Enter, Tab, or Backspace fires twice
diff --git a/docs/preview/website/src/content/docs/windows-beta.mdx b/docs/preview/website/src/content/docs/windows-beta.mdx
index 54c9441f..61e46938 100644
--- a/docs/preview/website/src/content/docs/windows-beta.mdx
+++ b/docs/preview/website/src/content/docs/windows-beta.mdx
@@ -1,45 +1,51 @@
---
-title: Windows beta
-description: Native Windows support status, supported workflows, and known limitations.
+title: Windows support
+description: Native Windows support, workflows, and known limitations.
---
-Native Windows support is an experimental beta.
+Native Windows support is generally available.
-Herdr on Windows uses ConPTY and Windows process/runtime behavior instead of the Unix PTY model Herdr was built around, so feature support varies. This preview is not a commitment that every Linux/macOS feature will become fully supported on Windows.
+Herdr on Windows uses ConPTY and Windows process/runtime behavior instead of the Unix PTY model Herdr was originally built around. Most core workflows are supported, but some capabilities differ from Linux and macOS or remain platform-dependent. Windows may receive more platform-specific fixes as those remaining gaps close.
-The beta gathers feedback from real use: install success, pane reliability, agent workflows, bug volume, missing features, and whether Windows users get enough value from Herdr. Based on that feedback, Windows support may graduate to stable, stay preview-only while it matures, or be reduced if the maintenance cost is not justified.
-
-Install native Windows beta builds with PowerShell:
+Install Herdr natively on Windows with PowerShell:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-Windows beta builds ship only through the preview channel. Herdr defaults to preview on Windows without changing your config. The installer stores releases under `%USERPROFILE%\.herdr\packages\standalone\releases`, points `%LOCALAPPDATA%\Programs\Herdr\bin` at the current release, and keeps a small number of older releases so running processes do not block updates.
+Windows builds are available through both stable and preview update channels. New installs use stable by default, and stable is recommended for normal use. Existing preview installs stay on preview until you run `herdr channel set stable`. If an older preview build rejects that command, run `herdr update` once on preview and retry. Preview provides newer, less-tested fixes from `master` and may regress; opt in with `herdr channel set preview` only when you want that tradeoff.
+
+The installer stores releases under `%USERPROFILE%\.herdr\packages\standalone\releases`, points `%LOCALAPPDATA%\Programs\Herdr\bin` at the current release, and keeps a small number of older releases so running processes do not block updates.
-For internal beta testing, `HERDR_MANIFEST_URL` can point the installer at a custom manifest instead of Herdr's stable or preview manifest.
+For internal testing, `HERDR_MANIFEST_URL` can point the installer at a custom manifest instead of Herdr's stable or preview manifest. Set `HERDR_CHANNEL=preview` with a custom preview manifest.
-## Supported in beta
+## Supported on Windows
| Capability | Status |
| --- | --- |
-| Local persistent sessions | beta |
-| Native panes through ConPTY | beta |
-| Windows Terminal / PowerShell app attach | beta |
-| `herdr --remote` to Linux/macOS hosts | beta |
-| Remote clipboard images and image-file drops | beta |
-| `cmd.exe` panes | beta |
-| Startup cwd and workspace labels | beta |
-| Pane launch cwd | beta |
-| Agent command discovery | beta |
-| Agent self-report integrations | beta |
-| Agent process-tree detection | beta |
-| Git/worktree detection from known cwd | beta |
+| Local persistent sessions | supported |
+| Native panes through ConPTY | supported |
+| Windows Terminal / PowerShell app attach | supported |
+| `herdr --remote` to Linux/macOS hosts | supported |
+| Remote clipboard images and image-file drops | supported |
+| `cmd.exe` panes | supported |
+| Native keyboard and mouse input | supported |
+| Startup cwd and workspace labels | supported |
+| Pane launch cwd | supported |
+| Agent command discovery | supported |
+| Supported agent self-report integrations | supported |
+| Agent process-tree detection | supported |
+| Git/worktree detection from known cwd | supported |
+| System notifications and MP3 sounds | supported |
| Plugins | preview |
-| Pane screen history | beta |
-| Nested launch override | beta |
+| Pane screen history | supported |
+| Nested launch override | supported |
+
+Local persistent sessions continue running after the client detaches or its terminal window closes. Servers and pane processes launched through Windows OpenSSH also survive logout; run `herdr` again to reconnect.
-Windows agent process detection scans descendants of the pane shell and recognizes direct agents plus common command wrappers. It is useful for Codex, Claude, and similar agents, but it is not the same as Unix foreground process-group detection.
+Windows agent process detection scans descendants of the pane shell and recognizes direct agents plus common command wrappers, including npm/Node and Git Bash process chains. It follows Git Bash-launched agents across emulated `exec` boundaries, but it is not the same as Unix foreground process-group detection.
+
+Windows integration installation currently supports Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, OpenCode, Kilo Code CLI, Droid, Kimi Code CLI, Qoder CLI, and Antigravity CLI. Availability is narrower than on Unix; Herdr hides or rejects integrations whose install format is not supported on Windows.
Plugins support `windows` as a manifest platform in preview. GitHub install, local link, build commands, actions, events, and plugin panes are best-effort on Windows. Commands are argv commands and must be Windows-compatible; Node package shims such as `npm`, `bun`, and `node` are expected to work when they are on `PATH`, while Unix-only examples using `sh` or Bash need Windows-specific alternatives. Platform filters skip unsupported build commands and return `platform_unsupported` for unsupported actions or panes.
@@ -48,17 +54,29 @@ Plugins support `windows` as a manifest platform in preview. GitHub install, loc
| Capability | Status |
| --- | --- |
| Live cwd after shell `cd` | partial |
-| Live cwd via shell integration/OSC7 | beta |
-| Clipboard image paste to agents in local panes | unverified |
+| Live cwd via shell integration/OSC7 | supported |
+| Clipboard image paste to agents in local panes | terminal/agent dependent |
| CJK IME composition anchoring | partial |
-| Kitty graphics rendering | unverified |
+| Prefix input-source switching (Korean IME) | partial |
+| Kitty graphics rendering | terminal dependent |
| Host cursor rendering | partial |
Herdr can launch panes in the right directory and create the initial workspace from the directory where you started Herdr. After startup, the process field Herdr can inspect does not reliably track later logical `cd` changes in PowerShell. Use Herdr integrations or prompt shell integration for live cwd reporting.
-During `herdr --remote`, the configured remote image paste key reads a Windows clipboard image and transfers it to the remote host. Dropping one local image file into Windows Terminal also transfers that file and pastes its remote path. Clipboard image paste into a local native Windows pane remains unverified.
+During `herdr --remote`, the configured remote image paste key reads a Windows clipboard image and transfers it to the remote host. Dropping one local image file into Windows Terminal also transfers that file and pastes its remote path.
+
+Prefix input-source switching is available as an opt-in experiment for the Korean IME. It switches Hangul input to English while prefix commands are active and restores the previous mode afterward:
+
+```toml
+[experimental]
+switch_ascii_input_source_in_prefix = true
+```
+
+Other Windows IMEs are not supported by this option yet. See [Configuration](/docs/configuration/#prefix-input-source-switching).
+
+Some Windows agents can receive `ctrl+v` and read clipboard images directly. Herdr's own clipboard-image reader is not wired into local native Windows panes, so agent-native image paste remains dependent on the terminal and agent. Agent image-paste shortcuts such as `alt+v` do not add a Herdr-managed local clipboard bridge. Remote clipboard image bridging is supported separately through `herdr --remote` to Linux and macOS hosts.
-Kitty graphics remains experimental and is not claimed as Windows-supported yet. Leave `experimental.kitty_graphics = false` unless you are specifically testing image rendering in Windows Terminal.
+Kitty graphics is experimental and depends on the outer terminal. When `experimental.kitty_graphics = true`, Herdr emits Kitty graphics protocol output on Windows as it does on other platforms. This path has been exercised with Windows WezTerm hosting Herdr through WSL, but native Windows terminal and ConPTY combinations are not all verified. Windows Terminal does not expose the Kitty graphics path Herdr uses. Leave the option disabled unless the outer terminal supports Kitty graphics and you are testing that combination.
## Known caveats
@@ -79,26 +97,26 @@ Native mode restores the IME anchor, but it can reintroduce occasional cursor fl
### Keyboard and mouse
-Windows terminals do not all report modified keys in the same shape. Herdr preserves mouse reporting and `ctrl+j` in Windows Terminal and Alacritty on Windows, but `shift+enter` only works when the outer terminal reports it as a distinct modified Enter key. If Windows or the terminal reports it as plain Enter, Herdr forwards plain Enter.
+Windows terminals do not all report modified keys in the same shape. Herdr preserves mouse reporting and `ctrl+j` in Windows Terminal and Alacritty on Windows. The native Windows input path also preserves physical key presses, repeats, releases, standalone Escape, and `shift+enter` through default ConPTY panes. Modified keys still depend on the outer terminal reporting a distinct key event; if it reports `shift+enter` as plain Enter, Herdr can only forward plain Enter.
-Preview packages include Microsoft's current app-local ConPTY runtime because the system ConPTY on older Windows 10 builds drops Kitty keyboard protocol sequences used by agents such as Kimi and Pi. Set `HERDR_WINDOWS_CONPTY=system` before starting Herdr only when diagnosing a compatibility problem with the bundled runtime.
+Windows packages include Microsoft's current app-local ConPTY runtime because the system ConPTY on older Windows 10 builds drops Kitty keyboard protocol sequences used by agents such as Kimi and Pi. Set `HERDR_WINDOWS_CONPTY=system` before starting Herdr only when diagnosing a compatibility problem with the bundled runtime.
## Copy and paste
-Herdr's pane text copy works on Windows beta. Drag-select text inside a pane to copy through Herdr.
+Herdr's pane text copy works on Windows. Drag-select text inside a pane to copy through Herdr.
For text paste, use `ctrl+shift+v` in Windows Terminal. Multiline text paste is bracketed so shells and agent prompts receive it as one paste instead of submitting each line separately. Hold `shift` and right-click to use the outer terminal paste action instead of sending the click through Herdr.
-## Not supported on Windows beta
+## Not supported on Windows
| Capability | Status |
| --- | --- |
-| Direct terminal attach | unsupported |
+| Direct terminal attach (`herdr terminal attach`) | unsupported |
| Windows as a `herdr --remote` target host | unsupported |
| Live server handoff | unsupported |
| Unix file-descriptor handoff | unsupported |
| Unix foreground process groups | unsupported |
-| Prefix input-source switching | unsupported |
+| Herdr clipboard image bridge in local native panes | unsupported |
| Signed binary / SmartScreen avoidance | unsupported |
From Windows Terminal, use the same remote command as Linux and macOS:
@@ -111,7 +129,7 @@ The target host must run Linux or macOS. Herdr uses the installed Windows OpenSS
Windows updates run through the Windows installer and update the versioned install junction. Restart running Herdr sessions after updating. Live handoff is Unix-only.
-## Reporting Windows beta issues
+## Reporting Windows issues
Include:
diff --git a/docs/preview/website/src/content/docs/zh-cn/cli-reference.mdx b/docs/preview/website/src/content/docs/zh-cn/cli-reference.mdx
index dfb777a6..496f4a6a 100644
--- a/docs/preview/website/src/content/docs/zh-cn/cli-reference.mdx
+++ b/docs/preview/website/src/content/docs/zh-cn/cli-reference.mdx
@@ -22,7 +22,7 @@ herdr update --handoff # 对受支持的运行中服务器启用实时交
herdr completion zsh # 生成 zsh 补全脚本
herdr channel show # 打印 stable 或 preview
herdr channel set preview # 启用预览构建
-herdr channel set stable # 把 Linux/macOS 直接安装切回稳定版
+herdr channel set stable # 把直接安装切回稳定版
herdr --version # 打印版本
```
diff --git a/docs/preview/website/src/content/docs/zh-cn/install.mdx b/docs/preview/website/src/content/docs/zh-cn/install.mdx
index 8305fd7a..9f8ef5a5 100644
--- a/docs/preview/website/src/content/docs/zh-cn/install.mdx
+++ b/docs/preview/website/src/content/docs/zh-cn/install.mdx
@@ -1,9 +1,9 @@
---
title: 安装 Herdr
-description: 在 Linux、macOS 和 Windows 测试版上安装、更新和验证 Herdr。
+description: 在 Linux、macOS 和 Windows 上安装、更新和验证 Herdr。
---
-Herdr 为 Linux 和 macOS 提供稳定版二进制文件。Windows 原生支持是仅限预览版的测试版。
+Herdr 为 Linux、macOS 和 Windows 提供稳定通道二进制文件。Windows 支持已正式发布,并记录了平台专用的已知限制和持续修复。
## 安装
@@ -13,13 +13,13 @@ Herdr 为 Linux 和 macOS 提供稳定版二进制文件。Windows 原生支持æ
curl -fsSL https://herdr.dev/install.sh | sh
```
-在 Windows 预览测试版上,安装预览通道:
+在 Windows 上运行:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-安装器会下载适合你平台的发布二进制文件并放到 PATH 上。在 Windows 上,Herdr 默认使用预览通道,且不会修改你的配置。安装器使用带版本号的安装文件夹,并更新一个 `current` 联接点,因此更新时不需要覆盖正在运行的 `herdr.exe`。
+安装器会下载适合你平台的发布二进制文件并放到 PATH 上。新的直接安装默认使用稳定更新通道。现有的 Windows 预览安装会继续留在预览通道,直到你运行 `herdr channel set stable`。Windows 安装器使用带版本号的安装文件夹,并更新一个 `current` 联接点,因此更新时不需要覆盖正在运行的 `herdr.exe`。
## 用 Homebrew 安装
@@ -82,6 +82,7 @@ nix flake update herdr
| Linux aarch64 | `herdr-linux-aarch64` |
| macOS Intel | `herdr-macos-x86_64` |
| macOS Apple silicon | `herdr-macos-aarch64` |
+| Windows x86_64 | `herdr-windows-x86_64.zip` |
在 Linux 或 macOS 上,赋予可执行权限并移动到 PATH 上的某个位置。
@@ -90,15 +91,9 @@ chmod +x herdr-linux-x86_64
mv herdr-linux-x86_64 ~/.local/bin/herdr
```
-### Windows 测试版下载
+### Windows 压缩包
-在 Windows 原生支持处于测试阶段期间,Windows 二进制文件只在预览版发布中提供。常规测试请使用上面的预览安装器,或从预览的 GitHub 预发布中下载 Windows 产物:
-
-| 系统 | 产物 |
-| --- | --- |
-| Windows x86_64 测试版 | `herdr-windows-x86_64.zip` |
-
-压缩包包含 `herdr.exe` 及其应用本地 ConPTY 运行时。请保留完整的解压目录,不要只复制 `herdr.exe`。
+稳定版发布和预览版预发布都会包含 `herdr-windows-x86_64.zip`。压缩包包含 `herdr.exe` 及其应用本地 ConPTY 运行时。请保留完整的解压目录,不要只复制 `herdr.exe`。
## 验证
@@ -120,13 +115,13 @@ herdr update
`herdr update` 适用于由 Herdr 自带安装器管理的安装。Homebrew、mise 和 Nix 安装请改用那些包管理器更新。
-在 Linux 和 macOS 上,Herdr 默认使用稳定更新通道。要启用来自 `master` 的预览构建,设置通道:
+Linux、macOS 和 Windows 的直接安装默认使用稳定更新通道。要启用来自 `master` 的预览构建,设置通道:
```bash
herdr channel set preview
```
-用同样的方式把 Linux 和 macOS 的直接安装切回稳定版:
+用同样的方式把直接安装切回稳定版:
```bash
herdr channel set stable
@@ -134,9 +129,9 @@ herdr channel set stable
对于直接安装,切换通道时也会检查该通道并安装其最新二进制文件。如果该更新失败,运行 `herdr update` 从配置的通道重试。
-预览构建是从当前开发分支手动发布的 GitHub 预发布。当你想在下一个稳定版之前拿到修复时很有用,但它们可能出现回归。Homebrew、mise 和 Nix 安装不使用预览通道。
+预览构建是从当前开发分支定期发布的 GitHub 预发布。当你想在下一个稳定版之前拿到修复时很有用,但它们可能出现回归。Homebrew、mise 和 Nix 安装不使用预览通道。
-Windows 测试版构建目前仅限预览通道。在稳定的 Windows 发布可用之前,Windows 上的 `herdr channel set stable` 会被拒绝。
+Windows 的常规使用建议选择稳定版。预览版能更早获得修复,但可能出现回归,因此只有在接受这一取舍时才应主动启用。现有的 Windows 预览安装会继续留在预览通道,直到你明确切换。如果旧预览构建拒绝 `herdr channel set stable`,请先在预览通道运行一次 `herdr update`,再重试切换通道。
默认情况下,`herdr update` 安装新二进制文件,并不打扰兼容的运行中会话。如果某次更新改变了 Herdr 的客户端/服务器协议,Herdr 会在安装后询问是否停止旧服务器。要使用新版本,请停止旧服务器。停止会退出窗格进程。对于默认会话,运行 `herdr server stop`,再运行 `herdr`。对于命名会话,运行 `herdr session stop <name>`,再运行 `herdr session attach <name>`。
@@ -150,4 +145,4 @@ herdr update --handoff
## 系统要求
-Herdr 稳定版支持 Linux 和 macOS。Windows 原生构建是仅限预览版的测试版发布;受支持的工作流和已知限制见 [Windows 测试版](/zh-cn/docs/windows-beta/)。
+Linux、macOS 和 Windows x86_64 都提供稳定通道二进制文件。受支持的工作流和已知限制见 [Windows 支持](/zh-cn/docs/windows-beta/)。Windows ARM64 通过 Windows 模拟运行 x86_64 构建。
diff --git a/docs/preview/website/src/content/docs/zh-cn/persistence-remote.mdx b/docs/preview/website/src/content/docs/zh-cn/persistence-remote.mdx
index f2b9fb70..ba50130e 100644
--- a/docs/preview/website/src/content/docs/zh-cn/persistence-remote.mdx
+++ b/docs/preview/website/src/content/docs/zh-cn/persistence-remote.mdx
@@ -95,7 +95,7 @@ herdr --remote workbox --session agents
完整的 Herdr 连接会打开整个工作区 UI。直接附加则在你当前的终端中打开一个由服务器拥有的终端。
-在 Windows 测试版中,直接终端附加仅限 Unix。
+在 Windows 上,直接终端附加仅限 Unix。
按智能体目标附加:
diff --git a/docs/preview/website/src/content/docs/zh-cn/troubleshooting.mdx b/docs/preview/website/src/content/docs/zh-cn/troubleshooting.mdx
index 3560dd3d..caf5ed80 100644
--- a/docs/preview/website/src/content/docs/zh-cn/troubleshooting.mdx
+++ b/docs/preview/website/src/content/docs/zh-cn/troubleshooting.mdx
@@ -23,7 +23,7 @@ Herdr 在原生 Windows 和 WSL 上默认使用单元格绘制光标,因为 ConP
host_cursor = "native"
```
-原生模式会恢复输入法定位,但在持续输出期间可能再次出现偶发的光标移动异常。要恢复视觉稳定的光标,请设置 `host_cursor = "drawn"`,或删除该设置以使用 Windows 默认值。当前限制详见 [Windows 测试版](/zh-cn/docs/windows-beta/)。
+原生模式会恢复输入法定位,但在持续输出期间可能再次出现偶发的光标移动异常。要恢复视觉稳定的光标,请设置 `host_cursor = "drawn"`,或删除该设置以使用 Windows 默认值。当前限制详见 [Windows 支持](/zh-cn/docs/windows-beta/)。
## Enter、Tab 或 Backspace 触发两次
diff --git a/docs/preview/website/src/content/docs/zh-cn/windows-beta.mdx b/docs/preview/website/src/content/docs/zh-cn/windows-beta.mdx
index d5c7b7bc..4d971a1d 100644
--- a/docs/preview/website/src/content/docs/zh-cn/windows-beta.mdx
+++ b/docs/preview/website/src/content/docs/zh-cn/windows-beta.mdx
@@ -1,45 +1,51 @@
---
-title: Windows 测试版
-description: Windows 原生支持的现状、受支持的工作流和已知限制。
+title: Windows 支持
+description: Windows 原生支持、受支持的工作流和已知限制。
---
-Windows 原生支持是实验性的测试版。
+Windows 原生支持已正式发布。
-Windows 上的 Herdr 使用 ConPTY 和 Windows 的进程/运行时行为,而不是 Herdr 最初围绕构建的 Unix PTY 模型。有些 Herdr 功能可以干净地映射到 Windows,有些则不行。这个预览并不承诺每个 Linux/macOS 功能都会在 Windows 上得到完整支持。
+Windows 上的 Herdr 使用 ConPTY 和 Windows 的进程/运行时行为,而不是 Herdr 最初围绕构建的 Unix PTY 模型。大多数核心工作流已受支持,但部分能力与 Linux/macOS 不同或取决于平台。随着这些剩余差距逐步缩小,Windows 可能会收到更多平台专用修复。
-测试版的目标是从真实使用中学习: 安装成功率、窗格可靠性、智能体工作流、bug 数量、缺失的功能,以及 Windows 用户是否从 Herdr 获得了足够的价值。基于这些反馈,Windows 支持可能升级为稳定版,可能在成熟前保持仅预览,也可能在维护成本不合理时被缩减。
-
-用 PowerShell 安装 Windows 原生测试版构建:
+使用 PowerShell 在 Windows 上原生安装 Herdr:
```powershell
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
```
-Windows 测试版构建只通过预览通道发布。在 Windows 上,Herdr 默认使用预览通道,且不会修改你的配置。安装器将发布版本保存在 `%USERPROFILE%\.herdr\packages\standalone\releases` 下,让 `%LOCALAPPDATA%\Programs\Herdr\bin` 指向当前版本,并保留少量旧版本,以免运行中的进程阻塞更新。
+Windows 构建同时通过稳定版和预览版更新通道提供。新安装默认使用稳定版,常规使用也建议选择稳定版。现有预览安装会继续留在预览通道,直到你运行 `herdr channel set stable`。如果旧预览构建拒绝该命令,请先在预览通道运行一次 `herdr update`,再重试。预览版会提供来自 `master` 的更新、测试较少的修复,也可能出现回归;只有在接受这一取舍时,才应通过 `herdr channel set preview` 主动启用。
+
+安装器将发布版本保存在 `%USERPROFILE%\.herdr\packages\standalone\releases` 下,让 `%LOCALAPPDATA%\Programs\Herdr\bin` 指向当前版本,并保留少量旧版本,以免运行中的进程阻塞更新。
-对于内部测试,`HERDR_MANIFEST_URL` 可以让安装器指向自定义清单,而不是 Herdr 的稳定或预览清单。
+对于内部测试,`HERDR_MANIFEST_URL` 可以让安装器指向自定义清单,而不是 Herdr 的稳定或预览清单。使用自定义预览清单时还应设置 `HERDR_CHANNEL=preview`。
-## 测试版支持
+## Windows 支持
| 能力 | 状态 |
| --- | --- |
-| 本地持久会话 | 测试版 |
-| 通过 ConPTY 的原生窗格 | 测试版 |
-| Windows Terminal / PowerShell 应用连接 | 测试版 |
-| 连接 Linux/macOS 主机的 `herdr --remote` | 测试版 |
-| 远程剪贴板图像和图像文件拖放 | 测试版 |
-| `cmd.exe` 窗格 | 测试版 |
-| 启动 cwd 和工作区标签 | 测试版 |
-| 窗格启动 cwd | 测试版 |
-| 智能体命令发现 | 测试版 |
-| 智能体自报告集成 | 测试版 |
-| 智能体进程树检测 | 测试版 |
-| 从已知 cwd 检测 Git/worktree | 测试版 |
+| 本地持久会话 | 已支持 |
+| 通过 ConPTY 的原生窗格 | 已支持 |
+| Windows Terminal / PowerShell 应用连接 | 已支持 |
+| 连接 Linux/macOS 主机的 `herdr --remote` | 已支持 |
+| 远程剪贴板图像和图像文件拖放 | 已支持 |
+| `cmd.exe` 窗格 | 已支持 |
+| 原生键盘和鼠标输入 | 已支持 |
+| 启动 cwd 和工作区标签 | 已支持 |
+| 窗格启动 cwd | 已支持 |
+| 智能体命令发现 | 已支持 |
+| 已支持智能体的自报告集成 | 已支持 |
+| 智能体进程树检测 | 已支持 |
+| 从已知 cwd 检测 Git/worktree | 已支持 |
+| 系统通知和 MP3 声音 | 已支持 |
| 插件 | 预览 |
-| 窗格屏幕历史 | 测试版 |
-| 嵌套启动覆盖 | 测试版 |
+| 窗格屏幕历史 | 已支持 |
+| 嵌套启动覆盖 | 已支持 |
+
+本地持久会话会在客户端分离或终端窗口关闭后继续运行。通过 Windows OpenSSH 启动的服务器和窗格进程也会在注销后继续运行;再次运行 `herdr` 即可重新连接。
-Windows 智能体进程检测会扫描窗格 shell 的后代进程,识别直接运行的智能体和常见的命令包装器。它对 Codex、Claude 等智能体很有用,但和 Unix 前台进程组检测不是一回事。
+Windows 智能体进程检测会扫描窗格 shell 的后代进程,识别直接运行的智能体和常见的命令包装器,包括 npm/Node 和 Git Bash 进程链。它会跨越模拟的 `exec` 边界跟踪从 Git Bash 启动的智能体,但这和 Unix 前台进程组检测不是一回事。
+
+Windows 目前支持安装 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、OpenCode、Kilo Code CLI、Droid、Kimi Code CLI、Qoder CLI 和 Antigravity CLI 集成。可用范围比 Unix 更窄;安装格式不受 Windows 支持的集成会被隐藏或拒绝。
插件以预览状态支持在清单中声明 `windows` 平台。GitHub 安装、本地链接、构建命令、动作、事件和插件窗格在 Windows 上尽力而为。命令是 argv 命令,必须兼容 Windows;`npm`、`bun`、`node` 之类的 Node 包 shim 只要在 `PATH` 上就应该能用,而使用 `sh` 或 Bash 的 Unix 专用示例需要 Windows 专用的替代方案。平台过滤器会跳过不支持的构建命令,并对不支持的动作或窗格返回 `platform_unsupported`。
@@ -48,17 +54,29 @@ Windows 智能体进程检测会扫描窗格 shell 的后代进程,识别直接è
| 能力 | 状态 |
| --- | --- |
| shell `cd` 之后的实时 cwd | 部分支持 |
-| 通过 shell 集成/OSC7 的实时 cwd | 测试版 |
-| 向本地窗格中的智能体粘贴剪贴板图像 | 未验证 |
+| 通过 shell 集成/OSC7 的实时 cwd | 已支持 |
+| 向本地窗格中的智能体粘贴剪贴板图像 | 取决于终端/智能体 |
| CJK 输入法候选窗口定位 | 部分支持 |
-| Kitty graphics 渲染 | 未验证 |
+| 前缀输入源切换 (韩语输入法) | 部分支持 |
+| Kitty graphics 渲染 | 取决于终端 |
| 主机光标渲染 | 部分支持 |
Herdr 可以在正确的目录中启动窗格,并能从你启动 Herdr 的目录创建初始工作区。启动之后 PowerShell 的目录变化则不同: Herdr 能检查的进程字段无法可靠跟踪后续的逻辑 `cd` 变化。实时 cwd 上报请使用 Herdr 集成或提示符 shell 集成。
-使用 `herdr --remote` 时,配置的远程图像粘贴键会读取 Windows 剪贴板图像并传输到远程主机。把一个本地图像文件拖入 Windows Terminal 也会传输该文件并粘贴远程路径。向本地原生 Windows 窗格粘贴剪贴板图像仍未验证。
+使用 `herdr --remote` 时,配置的远程图像粘贴键会读取 Windows 剪贴板图像并传输到远程主机。把一个本地图像文件拖入 Windows Terminal 也会传输该文件并粘贴远程路径。
+
+前缀输入源切换可作为针对韩语输入法的选择性实验功能使用。前缀命令处于活动状态时,它会把韩文输入切换为英文,之后再恢复先前的模式:
+
+```toml
+[experimental]
+switch_ascii_input_source_in_prefix = true
+```
+
+此选项暂不支持其他 Windows 输入法。参见[配置](/zh-cn/docs/configuration/#前缀输入源切换)。
+
+Windows 上的部分智能体可以接收 `ctrl+v` 并直接读取剪贴板图像。Herdr 自己的剪贴板图像读取器尚未接入本地原生 Windows 窗格,因此智能体原生图像粘贴仍取决于终端和智能体。`alt+v` 等智能体图像粘贴快捷键不会增加由 Herdr 管理的本地剪贴板桥。远程剪贴板图像桥通过连接 Linux/macOS 主机的 `herdr --remote` 单独受支持。
-Kitty graphics 仍是实验性功能,尚未宣称支持 Windows。除非你专门在 Windows Terminal 中测试图像渲染,否则保持 `experimental.kitty_graphics = false`。
+Kitty graphics 是实验性功能,并取决于外层终端。设置 `experimental.kitty_graphics = true` 后,Herdr 会像在其他平台上一样在 Windows 上输出 Kitty graphics protocol。这个路径已在 Windows WezTerm 托管 WSL 中 Herdr 的配置下得到验证,但原生 Windows 的各种终端与 ConPTY 组合尚未全部验证。Windows Terminal 不提供 Herdr 使用的 Kitty graphics 路径。除非外层终端支持 Kitty graphics 且你正在测试该组合,否则请保持此选项禁用。
## 已知注意事项
@@ -75,30 +93,30 @@ Herdr 的原生 Windows 窗格依赖 ConPTY。当前 Windows 终端的光标处ç
host_cursor = "native"
```
-原生模式会恢复输入法定位,但在持续输出期间可能再次出现偶发的光标闪烁、跳动或旧位置残影。这是当前 Windows 测试版中的兼容性取舍。
+原生模式会恢复输入法定位,但在持续输出期间可能再次出现偶发的光标闪烁、跳动或旧位置残影。这是当前 Windows 支持中的兼容性取舍。
### 键盘和鼠标
-Windows 终端并不都以相同形式报告带修饰键的按键。Herdr 在 Windows Terminal 和 Windows 上的 Alacritty 中保留鼠标报告和 `ctrl+j`,但 `shift+enter` 只有在外层终端把它报告为独立的修饰 Enter 键时才有效。如果 Windows 或终端把它报告为普通 Enter,Herdr 会转发普通 Enter。
+Windows 终端并不都以相同形式报告带修饰键的按键。Herdr 在 Windows Terminal 和 Windows 上的 Alacritty 中保留鼠标报告和 `ctrl+j`。原生 Windows 输入路径还会通过默认 ConPTY 窗格保留物理按键的按下、重复、释放、独立 Escape 和 `shift+enter`。带修饰键的输入仍依赖外层终端报告可区分的按键事件;如果它把 `shift+enter` 报告为普通 Enter,Herdr 也只能转发普通 Enter。
-旧版 Windows 10 的系统 ConPTY 会丢弃 Kimi 和 Pi 等智能体使用的 Kitty 键盘协议序列,因此预览包包含 Microsoft 当前的应用本地 ConPTY 运行时。仅在诊断捆绑运行时的兼容性问题时,才应在启动 Herdr 前设置 `HERDR_WINDOWS_CONPTY=system`。
+旧版 Windows 10 的系统 ConPTY 会丢弃 Kimi 和 Pi 等智能体使用的 Kitty 键盘协议序列,因此 Windows 包包含 Microsoft 当前的应用本地 ConPTY 运行时。仅在诊断捆绑运行时的兼容性问题时,才应在启动 Herdr 前设置 `HERDR_WINDOWS_CONPTY=system`。
## 复制与粘贴
-Herdr 的窗格文本复制在 Windows 测试版上可用。在窗格内拖选文本即可通过 Herdr 复制。
+Herdr 的窗格文本复制在 Windows 上可用。在窗格内拖选文本即可通过 Herdr 复制。
文本粘贴请在 Windows Terminal 中使用 `ctrl+shift+v`。多行文本粘贴是带括号的 (bracketed),因此 shell 和智能体提示符会把它作为一次粘贴接收,而不是逐行提交。按住 `shift` 再右键,可以使用外层终端的粘贴操作,而不把点击发给 Herdr。
-## Windows 测试版不支持
+## Windows 不支持
| 能力 | 状态 |
| --- | --- |
-| 直接终端附加 | 不支持 |
+| 直接终端附加 (`herdr terminal attach`) | 不支持 |
| Windows 作为 `herdr --remote` 的目标主机 | 不支持 |
| 实时服务器交接 | 不支持 |
| Unix 文件描述符交接 | 不支持 |
| Unix 前台进程组 | 不支持 |
-| 前缀输入法切换 | 不支持 |
+| 本地原生窗格中的 Herdr 剪贴板图像桥 | 不支持 |
| 签名二进制 / 规避 SmartScreen | 不支持 |
在 Windows Terminal 中,使用与 Linux 和 macOS 相同的远程命令:
@@ -111,7 +129,7 @@ herdr --remote workbox
Windows 更新通过 Windows 安装器进行,并更新带版本号的安装联接点。更新后请重启运行中的 Herdr 会话。实时交接仅限 Unix。
-## 报告 Windows 测试版问题
+## 报告 Windows 问题
请包含:
diff --git a/docs/preview/website/src/data/config-reference.json b/docs/preview/website/src/data/config-reference.json
index aa5b7ed0..1765c10f 100644
--- a/docs/preview/website/src/data/config-reference.json
+++ b/docs/preview/website/src/data/config-reference.json
@@ -216,8 +216,8 @@
{
"key": "update.channel",
"type": "enum",
- "default": "\"stable\" (\"preview\" on Windows)",
- "description": "Update channel used by background version checks and herdr update. Homebrew, mise, and Nix installs ignore the preview channel.",
+ "default": "\"stable\" (\"preview\" for Windows preview builds)",
+ "description": "Update channel used by background version checks and herdr update. Stable Windows builds default to stable; existing Windows preview installs stay on preview until explicitly switched. Homebrew, mise, and Nix installs ignore the preview channel.",
"values": [
"stable",
"preview"