dsh-perm-gate 5.0.4 → 5.1.0

package/CHANGELOG.ja.md

@@ -1,7 +1,5 @@
 # 変更履歴
 
-言語: [English](./CHANGELOG.md) · [日本語](./CHANGELOG.ja.md) · [한국어](./CHANGELOG.ko.md) · [Français](./CHANGELOG.fr.md) · [Deutsch](./CHANGELOG.de.md) · [Italiano](./CHANGELOG.it.md) · [Русский](./CHANGELOG.ru.md) · [Español](./CHANGELOG.es.md)
-
 このプロジェクトの重要な変更はすべてこのファイルに記録されます。
 
 形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に従い、

package/CHANGELOG.ko.md

@@ -1,7 +1,5 @@
 # 변경 로그
 
-언어: [English](./CHANGELOG.md) · [日本語](./CHANGELOG.ja.md) · [한국어](./CHANGELOG.ko.md) · [Français](./CHANGELOG.fr.md) · [Deutsch](./CHANGELOG.de.md) · [Italiano](./CHANGELOG.it.md) · [Русский](./CHANGELOG.ru.md) · [Español](./CHANGELOG.es.md)
-
 이 프로젝트의 중요한 변경 사항은 모두 이 파일에 기록됩니다.
 
 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)을 따르며,

package/CHANGELOG.md

@@ -1,8 +1,10 @@
 # Changelog
 
-Languages: [English](./CHANGELOG.md) · [日本語](./CHANGELOG.ja.md) · [한국어](./CHANGELOG.ko.md) · [Français](./CHANGELOG.fr.md) · [Deutsch](./CHANGELOG.de.md) · [Italiano](./CHANGELOG.it.md) · [Русский](./CHANGELOG.ru.md) · [Español](./CHANGELOG.es.md)
-
 All notable changes to this project will be documented in this file.
+## 统一 15-rc 枚举线：三宿主子包 peer 全量枚举（client-locale/client-ui-renderer/client-ui-settings），内容=保留场验证的 4.3.0-beta.2 同树，版本越过 compat 线 5.0.4。 — 2026-10-05
+
+undefined
+
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/INSTALL.ja.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 `dsh-perm-gate` バージョン **2.4.1**。判定チェーン、ルールファイル形式、自动审查
 ティアについては [日本語 README](./README.ja.md) を参照してください。

package/INSTALL.ko.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 `dsh-perm-gate` 버전 **2.4.1**. 결정 체인, 규칙 파일 형식, 自动审查 티어는
 [한국어 README](./README.ko.md)를 참고하세요.

package/INSTALL.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 `dsh-perm-gate` version **2.4.1**. Continue with the [README](./README.md) for the
 decision chain, the rules file format and the 自动审查 tier.

package/INSTALL.zh.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 `dsh-perm-gate` 版本 **2.4.1**。裁决链、规则文件格式与自动审查档位请见
 [中文 README](./README.zh.md)。

package/README.ja.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 > **互換性に関する注記:** v2.0.0 は `ja` / `ko` 辞書を同梱しますが、公式 DSH の
 > `LocaleRuntime` が公開するのは `zh` / `en` のみです（`LOCALE_IDS = ["zh", "en"]`）。
@@ -77,6 +62,11 @@ DeepSeek Harness 向けの、単一・自己完結・決定論優先・fail-clos
 fail-closed を徹底します：P0 の判定は、grant・ルール・分類器・人間のいずれにも
 上書きされません。
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **対応する DSH ホスト:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2`（0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 の 15 rc）
+- **ランタイム検証済み:** `0.2.0-rc.2`（証跡は `.compat-results/`）
+<!-- host-compat:end -->
+
 ## 背景
 
 DSH の安全まわりのエコシステムでは、この役割が `dsh-permission-rules` /
@@ -119,9 +109,7 @@ dsh plugin --profile web add dsh-perm-gate
 
 インストール・アップグレード・移行・トラブルシューティングの詳細は
 [日本語インストールガイド](./INSTALL.ja.md)（[English](./INSTALL.md) /
-[中文](./INSTALL.zh.md) / [한국어](./INSTALL.ko.md) / [Français](./INSTALL.fr.md) /
-[Deutsch](./INSTALL.de.md) / [Italiano](./INSTALL.it.md) / [Русский](./INSTALL.ru.md) /
-[Español](./INSTALL.es.md)）にあります。
+[中文](./INSTALL.zh.md) / [한국어](./INSTALL.ko.md)）にあります。
 
 ## 設定
 

package/README.ko.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 > **호환성 안내:** v2.0.0은 `ja` / `ko` 사전을 포함하지만, 공식 DSH의 `LocaleRuntime`은
 > `zh` / `en`만 노출합니다(`LOCALE_IDS = ["zh", "en"]`). 기본 DSH에서 `ja` / `ko`를
@@ -75,6 +60,11 @@ DeepSeek Harness용 단일·자족적·결정론 우선·fail-closed 권한 게
 엄격하게 fail-closed입니다: P0 판정은 grant·규칙·분류기·사람 누구에게도
 덮어써지지 않습니다.
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **지원하는 DSH 호스트:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 라인의 15개 rc)
+- **런타임 검증됨:** `0.2.0-rc.2` (증적은 `.compat-results/`)
+<!-- host-compat:end -->
+
 ## 배경
 
 DSH 안전 생태계에서는 이 역할이 `dsh-permission-rules` / `dsh-auto-mode` /
@@ -116,9 +106,7 @@ dsh plugin --profile web add dsh-perm-gate
 
 설치·업그레이드·이전·문제 해결의 전체 절차는
 [한국어 설치 안내](./INSTALL.ko.md)([English](./INSTALL.md) /
-[中文](./INSTALL.zh.md) / [日本語](./INSTALL.ja.md) / [Français](./INSTALL.fr.md) /
-[Deutsch](./INSTALL.de.md) / [Italiano](./INSTALL.it.md) / [Русский](./INSTALL.ru.md) /
-[Español](./INSTALL.es.md))에 있습니다.
+[中文](./INSTALL.zh.md) / [日本語](./INSTALL.ja.md))에 있습니다.
 
 ## 설정
 

package/README.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 > **Compatibility note:** v2.0.0 ships `ja` / `ko` dictionaries, but official DSH exposes
 > only `zh` / `en` through `LocaleRuntime` (`LOCALE_IDS = ["zh", "en"]`). On stock DSH,
@@ -42,7 +27,6 @@
 > | --- | --- | --- | --- |
 > | 0.1.0-rc.7 ~ 0.1.1-rc.x | `legacy` | `1.x` | `@legacy` |
 > | 0.1.2-alpha.1+ (incl. 0.1.5-rc.2) | `main` | `2.x` | `@latest` / `@dsh-0.1.2` (`@2.x` is a range) |
-> | 0.2.0-rc.1 (0.2.0 line) | `compat/0.2.0` | `5.x` | `@dsh-0.2.0` |
 >
 > The series number tracks the **DSH line** (`1.x` = DSH ≤ 0.1.1, `2.x` = DSH 0.1.2+),
 > and the majors fence each other: a `^1.x` install never resolves a `2.x` release and
@@ -74,6 +58,11 @@ A single, self-sufficient, deterministic-first, fail-closed permission gate for
 
 Strictly fail-closed: a P0 decision is never overridden by a grant, a rule, the classifier, or a human.
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Supported DSH hosts:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Runtime-verified:** `0.2.0-rc.2` — evidence in `.compat-results/`
+<!-- host-compat:end -->
+
 ## Why
 
 The DSH safety ecosystem splits this across several plugins (`dsh-permission-rules`,
@@ -130,12 +119,44 @@ dsh plugin --profile web add dsh-perm-gate
 
 Full install, upgrade, migration and troubleshooting steps live in the
 [Installation guide](./INSTALL.md) — also available in
-[中文](./INSTALL.zh.md) / [日本語](./INSTALL.ja.md) / [한국어](./INSTALL.ko.md) /
-[Français](./INSTALL.fr.md) / [Deutsch](./INSTALL.de.md) / [Italiano](./INSTALL.it.md) /
-[Русский](./INSTALL.ru.md) / [Español](./INSTALL.es.md).
+[中文](./INSTALL.zh.md) / [日本語](./INSTALL.ja.md) / [한국어](./INSTALL.ko.md).
 
 ## Configuration
 
+### AppContainer sandbox (Windows; beta)
+
+`dsh-perm-gate` can run gate-allowed shell commands inside a **Windows AppContainer** instead of
+handing them back unconfined. The container token is created with **zero network capabilities**, so
+non-loopback egress is blocked by Windows Firewall (WFP) itself — not by an advisory environment
+variable. The container SID is OS-derived from the fixed name `dsh-perm-gate.ac`, so the one-time
+`CheckNetIsolation LoopbackExempt` (which lets the container reach `127.0.0.1`) is a per-machine
+step, not a per-session one. Egress is therefore possible **only** through the network proxy:
+
+- `sandboxEnabled` (default `false`) — master switch. When on, every **auto-allowed** shell call is
+  rewritten into the launcher invocation; a human-approved call is out of scope (the user approved
+  it consciously). If the launcher cannot be built or the OS rejects the container launch, the call
+  is **denied** (fail-closed) with reason `sandbox: …` — never run unconfined.
+- `sandboxMode` — `workspace-write` (default; workspace gets Modify + private temp FullControl,
+  system dirs stay readable through the stock ALL APPLICATION PACKAGES ACEs) or `read-only`.
+- `sandboxProxy` — **the proxy parameter**: empty (default) follows the builtin filtered proxy's
+  actual `127.0.0.1:<port>` when `networkEnabled`; an explicit URL must be loopback-bound (the
+  container cannot reach anything else) and destination filtering is that proxy's job.
+- `sandboxLoopback` — `exempt` (default; attempt the one-time exemption, warn with the exact
+  elevated command if denied) or `off`.
+
+The launcher is a small C# program shipped as source (`assets/appcontainer-launcher.cs`) and
+compiled on first use by the .NET Framework compiler every Windows carries (`csc.exe`); the plugin
+itself keeps zero native dependencies. Verify a machine end-to-end with:
+
+```
+node scripts/smoke-appcontainer.mjs
+```
+
+Known boundary: on Windows 11 25H2+ builds where the classic AppContainer creation APIs have been
+removed (verified on 26200) and the mxc replacement is not yet exposed (26600+), the launcher fails
+closed at the kernel step; the sandbox then denies sandboxed calls with a clear reason instead of
+running them unconfined. On Windows 10 / 11 ≤ 24H2 the documented classic path applies.
+
 Add the plugin to `cordis.yml`:
 
 ```yaml

package/README.zh.md

@@ -4,28 +4,13 @@
 - [中文 README](./README.zh.md)
 - [日本語 README](./README.ja.md)
 - [한국어 README](./README.ko.md)
-- [Français README](./README.fr.md)
-- [Deutsch README](./README.de.md)
-- [Italiano README](./README.it.md)
-- [Русский README](./README.ru.md)
-- [Español README](./README.es.md)
 - [Installation guide](./INSTALL.md)
 - [中文安装指南](./INSTALL.zh.md)
 - [日本語インストールガイド](./INSTALL.ja.md)
 - [한국어 설치 안내](./INSTALL.ko.md)
-- [Guide d'installation](./INSTALL.fr.md)
-- [Installationsanleitung](./INSTALL.de.md)
-- [Guida all'installazione](./INSTALL.it.md)
-- [Руководство по установке](./INSTALL.ru.md)
-- [Guía de instalación](./INSTALL.es.md)
 - [Changelog](./CHANGELOG.md)
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
-- [Français changelog](./CHANGELOG.fr.md)
-- [Deutsch changelog](./CHANGELOG.de.md)
-- [Italiano changelog](./CHANGELOG.it.md)
-- [Русский changelog](./CHANGELOG.ru.md)
-- [Español changelog](./CHANGELOG.es.md)
 
 > **兼容性说明：** v2.0.0 自带 `ja` / `ko` 字典，但官方 DSH 的 `LocaleRuntime`
 > 只暴露 `zh` / `en`（`LOCALE_IDS = ["zh", "en"]`）。在原版 DSH 上选择 `ja` / `ko`
@@ -70,6 +55,11 @@
 
 严格 fail-closed：P0 永不因 grant / 规则 / 分类器 / 人工而放行。
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **支持的 DSH 宿主：** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2`（覆盖 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 六条线共 15 个 rc）
+- **运行时已验证：** `0.2.0-rc.2`（证据见 `.compat-results/`）
+<!-- host-compat:end -->
+
 ## 特性
 
 - **命令白/黑名单** — 基于 **argv 分解**匹配（非裸字符串），递归下钻 `sh -c`/`bash -c`、识别管道、重定向目标、递归/强制（`rm -rf`）。
@@ -89,12 +79,38 @@ dsh plugin --profile web add dsh-perm-gate
 ```
 
 完整的安装、升级、迁移与排查步骤见[中文安装指南](./INSTALL.zh.md)（另有
-[English](./INSTALL.md) / [日本語](./INSTALL.ja.md) / [한국어](./INSTALL.ko.md) /
-[Français](./INSTALL.fr.md) / [Deutsch](./INSTALL.de.md) / [Italiano](./INSTALL.it.md) /
-[Русский](./INSTALL.ru.md) / [Español](./INSTALL.es.md)）。
+[English](./INSTALL.md) / [日本語](./INSTALL.ja.md) / [한국어](./INSTALL.ko.md)）。
 
 ## 配置
 
+### AppContainer 沙盒（Windows；beta）
+
+`dsh-perm-gate` 可以把门控放行的 shell 命令放进 **Windows AppContainer** 里执行，而不是裸交还
+宿主。容器 token **不带任何网络能力**，非回环出网被 Windows 防火墙（WFP）直接封死——不是环境
+变量那种可绕过的软约束。容器 SID 由 OS 从固定名 `dsh-perm-gate.ac` 派生，因此
+`CheckNetIsolation LoopbackExempt`（放行容器访问 `127.0.0.1`）是**每台机器一次**的步骤，不是每次
+会话都要做出网因此**只能**走网络代理：
+
+- `sandboxEnabled`（默认 `false`）——总开关。开启后每条**自动放行**的 shell 调用会被重写成启动器
+  调用；人工批准的调用不在沙盒范围（用户已明确知情）。启动器无法编译、或 OS 拒绝容器启动时，
+  该调用被**拒绝**（fail-closed），理由带 `sandbox: …` 前缀——绝不退回裸执行。
+- `sandboxMode`——`workspace-write`（默认：工作区 Modify + 私有 temp FullControl，系统目录靠
+  ALL APPLICATION PACKAGES 默认 ACE 保持可读）或 `read-only`。
+- `sandboxProxy`——**代理参数**：空（默认）跟随内置过滤代理实际绑定的 `127.0.0.1:<port>`（需
+  `networkEnabled`）；显式 URL 必须绑定回环（容器只可达回环），出网对象的过滤由该代理完成。
+- `sandboxLoopback`——`exempt`（默认：尝试一次性豁免，被拒时给出精确提权命令）或 `off`。
+
+启动器是一小段 C# 源码（`assets/appcontainer-launcher.cs`），首次使用时由 Windows 全系自带的
+.NET Framework 编译器（`csc.exe`）按需编译；插件本体保持零原生依赖。真机端到端验证：
+
+```
+node scripts/smoke-appcontainer.mjs
+```
+
+已知边界：在经典 AppContainer 创建 API 已被移除的 Windows 11 25H2+ 新构建上（26200 实测），
+mxc 替代尚未暴露（26600+），启动器在内核步 fail-closed；此时沙盒调用一律明确拒绝，不裸跑。
+Windows 10 / 11 ≤ 24H2 走文档化的经典路径。
+
 `cordis.yml`：
 
 ```yaml