# 兼容性矩阵

> **归档说明**：本项目已停止维护并归档，最终版本 **`0.1.3-final`**；上游 `dsh-workbuddy-connect` 亦已停维并计划于 2026-10-22 下线。经真机实测，非官方客户端接入 WorkBuddy 模型的方案在 WorkBuddy 2026-10-20 起的限制下**已不可行**，本插件**不声称可用、不推荐继续沿用**；若需接入 WorkBuddy 模型请使用官方客户端。本文件是该版本支持范围与验证状态的**静态记录**，不随上游变化更新，也不承诺未来的可用性。安装、升级或继续使用前，请自行评估风险。

本文件回答一个问题：`dsh-buddy-suite@0.1.3-final` 在什么环境下被验证过、在什么环境下只是「声称支持」、在什么环境下明确不支持。

## 验证状态口径

| 标记 | 含义 |
|---|---|
| ✅ 已验证 | 在真实环境中实际跑过，并作为最终版本的验收依据 |
| ◐ 声称支持 | 按依赖声明或代码路径应当可用，但最终版本未再逐项复测 |
| ⚠️ 历史验证（现已不可行） | 最终版本之前验证过，但受 WorkBuddy 2026-10-20 起的限制，该接入方案当前已不可行，不声称可用 |
| ❌ 不支持 | 明确不在支持范围，装上后可能安装失败或运行时出错 |

## DeepSeek Harness（DSH）

| DSH 版本 | 状态 | 说明 |
|---|---|---|
| `0.2.1-rc.1` | ✅ 已验证 | 早期实机验证；同款适配已由维护者 PR #156 合入上游 `dsh-workbuddy-connect` v0.7.8 |
| `0.2.1-rc.2` | ✅ 已验证 | `peerDependencies` 精确锁定在此版本，是最终版本的验收基线 |
| 其他 `0.2.x` | ◐ 声称支持 | 内核 API 在 rc 之间可能有变动，未逐版复测；锁死 peer 版本是为了避免装上后崩溃 |
| `0.1.x` | ❌ 不支持 | 插件 API 与内核结构不同，安装会被拒绝或运行时失败 |

## Node.js

| Node 版本 | 状态 | 说明 |
|---|---|---|
| `22.19+`（22.x LTS） | ✅ 已验证 | CI 与本地验收使用的版本 |
| `24+` | ✅ 已验证 | 在 `engines` 声明范围内 |
| `18` / `20` | ❌ 不支持 | 无法运行 `es2024` 编译产物；`npm` 只给 `EBADENGINE` 警告、不阻断安装，表现为运行时报错 |
| `23.x` | ❌ 不支持 | 非 LTS 奇数版本，刻意排除在 `engines` 之外 |

声明位置：`package.json` → `engines.node` = `^22.19.0 || >=24.0.0`。

## WorkBuddy 桌面端

| 版本 | 状态 | 说明 |
|---|---|---|
| 国内版（WorkBuddy） | ⚠️ 历史验证，现已不可行 | 最终版本之前曾在 Windows 实机验证模型接入与签到；但 2026-10-20 起 WorkBuddy 限制非官方客户端，实测该接入方案**已不可行**；构建号未逐一记录，也不再补验证 |
| 国际版（WorkBuddy AI） | ⚠️ 历史验证，现已不可行 | 代码路径已实现（独立 provider 与路由），但从未用真实国际账号完整跑通；同样受 2026-10-20 限制影响，不声称可用 |

**构建号不补验证**：本项目归档后无法再获取或安装 WorkBuddy 的新构建，因此本表不列具体构建号，也不对 2026-10-20 之后发布的构建作任何兼容性声明。**本表是历史验证记录，不构成「该方案仍可用」的承诺**；若需接入 WorkBuddy 模型，请使用官方客户端。

## 操作系统与其他环境

| 环境 | 状态 | 说明 |
|---|---|---|
| Windows（已登录 WorkBuddy） | ✅ 已验证 | 最终版本的验收环境 |
| macOS | ◐ 未验证 | 实现了默认路径发现与 Electron 定位，但未在真机验证 |
| Linux | ◐ 未验证 | 需显式指定 `WORKBUDDY_ELECTRON_BIN`，未在真机验证 |
| 受限沙箱（禁止 spawn 子进程） | ❌ 不支持 | 签到需要 spawn `reg.exe` 与 Electron 取密钥，受限环境返回 `EPERM`；属环境限制而非代码缺陷 |

## 使用边界

- 本项目依赖 WorkBuddy 桌面端的私有接口，WorkBuddy 客户端更新可能导致兼容性失效；最终版本不会再有适配。
- 兼容性问题由使用者自行承担，详见 README 的「免责声明」。
- 已知缺陷与未验证项见 [`KNOWN-ISSUES.md`](./KNOWN-ISSUES.md)；主动放弃的功能见 [`NON-GOALS.md`](./NON-GOALS.md)。
- 本矩阵随 `0.1.3-final` 冻结，记录时间为 2026-10-21。