# Compatibility Matrix / 兼容性矩阵

Status: `0.1.1` Stable. The matrix records evidence for the current repository state; it is not a promise that every future DSH build is compatible.

状态：`0.1.0` Public Preview。本文件记录当前仓库状态的验证证据，不代表未来所有 DSH 构建都自动兼容。

| Surface / 环境 | Version / 版本 | Result / 结果 | Evidence / 证据 |
| --- | --- | --- | --- |
| Node.js on Windows | 22.19.0 | Passed / 通过 | typecheck, 55 tests, build, package check, Chromium Smoke |
| Node.js on Ubuntu | 22.x | Passed / 通过 | GitHub Actions: typecheck, 55 tests, build, package check, audit, Chromium Smoke |
| Node.js on Ubuntu | 24.x | Passed / 通过 | GitHub Actions: typecheck, 55 tests, build, package check |
| Git executable | Windows `git.exe` and POSIX `git` | Passed / 通过 | Real Git integration suite and platform-specific executable selection |
| DSH Host | `>= 0.1.1-rc.1` declared | Declared / 已声明 | Package manifest declares the minimum host version; this row is not a claim that every future DSH build is compatible |
| DSH Desktop | `2.0.2.0`, profile `desktop` | Passed / 通过 | Local-link profile: sidebar mount, branch switching, first-parent `7 → 3 → 7`, detail/Diff and refresh verified |
| DSH Desktop fixed package profile | `2.0.2.0`, `gitchain-test`, `v0.1.0` lifecycle candidate | Passed / 通过 | Test-only `0.1.0-preview.1` → `0.1.0` upgrade, uninstall with zero dependency/bundle/lock/node_modules residue, reinstall recovery, Desktop restart, single entry, and UI `7 → 3 → 7` verified |
| DSH Desktop stable package profile | `2.0.2.0`, `gitchain-test`, `v0.1.1` | Passed / 通过 | Stable artifact installed after the lifecycle test; Desktop restart and UI full graph `7/3`, first-parent `3/2`, and recovery to `7/3` verified |
| Fixed-package Chromium fallback | Extracted `v0.1.1` stable tarball | Passed / 通过 | Smoke loaded `lib/client.js` from the extracted stable tarball via `GIT_CHAIN_PACKAGE_ROOT`; chip/overlay, graph, detail/Diff, filter, branch menu, responsive and first-parent assertions passed |

## Supported baseline / 支持基线

- Node.js `^22.19.0 || >=24.0.0`
- pnpm `10.14.0`
- Git available on `PATH`
- DSH `>= 0.1.1-rc.1` as declared by the package manifest

The automated rows and the fixed-package rows above are release-gate evidence for the recorded combinations only. They do not guarantee compatibility with an untested DSH build or operating system.

上面的自动化和固定包行只对已记录的组合提供发布门禁证据，不代表未经测试的 DSH 构建或操作系统版本自动兼容。

## Reproducing the automated checks / 重现自动化检查

```sh
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run build
pnpm run check:package
pnpm run smoke
```

The browser smoke command uses Playwright Chromium. Set `PLAYWRIGHT_EXECUTABLE_PATH` when the browser is installed outside the default Playwright cache.

浏览器 Smoke 使用 Playwright Chromium；如果浏览器不在默认缓存位置，可设置 `PLAYWRIGHT_EXECUTABLE_PATH`。

## DSH acceptance record / DSH 验收记录

Before each stable release, record the DSH version, profile name, OS, install source, restart result, screenshots, and uninstall result here. Unlisted DSH builds remain outside the verified compatibility boundary.

每次稳定版发布前，都应在这里记录 DSH 版本、profile 名称、操作系统、安装来源、重启结果、截图和卸载结果。未列出的 DSH 构建仍不在已验证兼容范围内。

### Current verification snapshot / 当前验证快照

- Date / 日期: 2026-08-27
- OS: Windows 11 Pro `10.0.26200`
- DSH Desktop: `2.0.2.0`
- Active profile / 当前 profile: `desktop`
- Local-link source / 本地来源: `<local checkout>`
- Fixed-package profile / 固定包 profile: `gitchain-test`
- Fixed package / 固定包: `dsh-git-chain-0.1.0.tgz` lifecycle candidate (`sha512-Lu3QHIwgqCXB6/CRo9vaxOQd8BqIJSzN2rX1Hr3Os1FqIhXs8Q+ZCRK7HEThkVxH2T7gJZFj1sMFnsEfcx711w==`); stable `v0.1.1` asset hash is recorded in its Release notes.
- Stable package / 稳定包: [`dsh-git-chain-0.1.1.tgz`](https://github.com/ShinonomeAya/dsh-git-chain/releases/tag/v0.1.1)；SHA-512 以 Release notes 为准。
- Test-only old baseline / 仅测试旧基线: `dsh-git-chain-0.1.0-preview.1.tgz` (`sha256-947086A74BFB354AEE3BA5E9687FBD380CA04350FDF11E51B9A777F4AB29F227`)
- First-parent: PASS / 通过（local-link and fixed-package UI both verified as `7 → 3 → 7`，当前分支保持 `master`）
- Detail and Diff: PASS / 通过
- Refresh: PASS / 通过
- Fixed-package Desktop lifecycle: PASS / 通过（旧版 baseline → `0.1.0` 升级、卸载清理、重装恢复、启动/重启、单入口和 UI first-parent `7 → 3 → 7` 均通过；直接 pnpm 操作后按官方 DSH manifest/bundle 语义核对并同步 bundle 列表）
- Fixed-package fallback: PASS / 通过（从固定 tarball 解包读取 `lib/client.js` 的 Chromium smoke；fallback chip/overlay 及错误状态相关自动化断言通过，未将 harness 结果冒充 DSH Desktop 缺失 Host 场景）
- Directory eligibility / 目录结构：`GO candidate`；公开仓库、根目录 manifest、`dsh.bundle.patch`、补丁文件、分类、事实描述和单行安装命令均已准备。
- Directory submission / 目录申请：[dsh-plugin-directory#218](https://github.com/alexchenzl/dsh-plugin-directory/issues/218)，状态 `OPEN`，已进入 `plugin-submission` 校验流程。
- Product release decision / 产品发布判定：`GO` for the recorded `Windows 11 + DSH Desktop 2.0.2.0` combination; stable [v0.1.1 Release](https://github.com/ShinonomeAya/dsh-git-chain/releases/tag/v0.1.1) is published after the fixed-package lifecycle and fallback gates passed. Other DSH/OS combinations remain unverified; the directory listing itself is not a runtime test, security audit, or official endorsement.