# 兼容性 [项目首页](../README.md) · [使用指南](usage.md) · [贡献指南](../CONTRIBUTING.md) 本页列出已验证的版本、平台及功能范围。最低运行版本见 [package.json](../package.json) 的 `engines`。 ## 宿主与平台 ### 0.1.5 验证记录 2026-11-16,`0.1.5` 的生产源码完成以下验证,未因发布文案收尾更换依赖或运行时代码。当日 DSH npm latest 为 `0.2.2-rc.1`;最低 DSH 为 `0.2.0-rc.2`。latest 宿主自身要求 Node.js ≥24.9.0,不能由插件的 Node.js ≥22.19.0 声明推定它支持 Node 22。 | 范围 | 已验证内容 | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 基础检查 | macOS x64、Node 24.20.0:224 项行为、44 项工具测试、类型、格式、构建及 80 文件发布白名单;其中 24 项 Manager 处理器回归覆盖刷新、外部变化、草稿和焦点。生产依赖审计为 0 项漏洞。 | | 跨平台与安装 | [发布前完整 CI](https://github.com/blkpne/dsh-database/actions/runs/43815215399)通过 Linux/Windows Node 22.19/24、macOS Node 24、最低/latest 宿主安装、六库、TLS 与资源回收。相同生产源码的本地 tarball 另通过 DSH `0.2.0-rc.2`、`0.2.2-rc.1`、`0.2.2-rc.2` 的官方 CLI 安装、Host/MCP/Client、写入拒绝、持久化及卸载重载。最终发布提交以对应 [GitHub Actions](https://github.com/blkpne/dsh-database/actions/workflows/publish.yml) 为准。 | | Chrome 增强菜单 | Mac Chrome 157、DSH Web `0.2.2-rc.1`:六类型、菜单与键盘/焦点、短视口滚动、长名称、同 ID 改名、脏稿取消、反馈与刷新位置、空列表、刷新超时恢复,以及浅深色、桌面和 390px/320px 窄视口。最低 DSH `0.2.0-rc.2` 另实测六类型及默认端口、键盘、取消回焦和 320×360 末项选择。 | | Firefox 原生回退 | 独立 Linux 桌面、Firefox ESR `153.7.0`、Node `24.22.1`、DSH `0.2.2-rc.1`:浏览器自然不支持增强选择器,实际原生菜单展开、六类型与默认端口、键盘确认/取消/Tab、动态连接长名称改选、脏稿取消与回焦、安全选择及 SRV 禁用状态通过。真实 200% 浏览器缩放和小窗口末项选择通过;小窗口外框为 640×446,不代表精确 CSS 视口。 | 选择菜单在支持完整可定制原生选择器、主指针精细且支持悬停的环境中增强显示,否则使用平台原生菜单。原生菜单的主题、宽度和长选项显示与增强路径不同,不承诺所有浏览器同等外观。Firefox 验证使用无密码的 localhost 合成连接、访问保持关闭,没有数据库探测或模型调用;不据此扩写真实数据库覆盖。 授权长会话、合成密码保留/替换/显隐/未保存清空,以及连接检查的忙碌/取消/超时/编辑后失效已在较早的同分支页面验证,后续未改对应路径。成功检查结果保留和外部删除恢复有处理器回归,真实外部删除恢复未执行。Safari、真实读屏、物理触摸、强制颜色模式和精确 Firefox 320×360 仍未覆盖;Chrome 未完成真实 200% 缩放,不用 Firefox 结果代替。独立视觉复核不等于用户审美认可。 ### 2026-11-13 主面板迁移验证 本轮将底部弹层入口迁移至官方 `sidebar.panellist` 与同标识的 `main` 插槽,不改 Host、凭据、TLS 或授权策略。分别核对 npm 发布的 DSH `0.2.0-rc.2`、`0.2.2-rc.1`、`0.2.2-rc.2` 配套 layout/sidebar 类型及实现,三版公开契约一致。契约核对不等于三版浏览器验收;以下旧轮次结果也不覆盖此次布局与生命周期变化。 macOS x64、Node 24.20.0:224 项行为测试、25 项工具测试、类型、构建及发布白名单通过;新增 Client 状态与注册/卸载测试在 Node 22.19.0 通过。实际 Manager 处理器另以故障响应回归覆盖网络中断、非 JSON、截断响应、未知提交、错误目标及停用导航后的保护;这类无 DOM 测试不等于真实浏览器故障注入。DSH Web `0.2.2-rc.2` 与 pnpm `10.33.2` 实查主面板、会话/面板切换草稿及临时密码保留、跨页 revision 冲突阻止覆盖、实际停用重载、在途检查取消、PostgreSQL 测试与保存后访问默认关闭。浅深色桌面、390px/320px、容器宽度 620px、键盘确认与窄屏焦点均已检查。恢复草稿时不重复自动聚焦名称,避免滚动恢复后焦点落在屏幕之外。 草稿只在本次插件激活的内存中保留,禁用/卸载后清除;浏览器关闭/刷新提示受原生 beforeunload 限制。自动检查和实页复核不替代用户审美认可。本轮未重新执行完整六库/TLS、在线模型、原生 Windows 或屏幕阅读器矩阵;安全与数据库的历史证据及限制保留如下。 ### 2026-11-13 连接体验验证 本节记录 0.1.4 之后连接体验改动在当日的验证范围,不属于 npm 0.1.4 的能力。当日 npm `@deepseek-ai/dsh@latest` 为 `0.2.2-rc.1`;用户使用的 `0.2.2-rc.2` 单独验证。两版宿主均要求 Node.js ≥24.9.0,插件最低 Node.js 声明不能替代宿主要求。 - macOS x64、Node 22.19.0 / 24.20.0:219 项行为回归、19 项工具测试、类型、构建及包白名单通过。覆盖旧记录 TLS 缺省值、密码保留/替换/清空、持久化失败恢复、授权与默认关闭、首次引导及过期异步结果。 - macOS Node 24.20.0 与隔离 Linux amd64 容器:MySQL 8.4.11、MariaDB 11.4.13、PostgreSQL 17.11、MongoDB 8.0.34 的真实查询、权限、取消、Host/MCP 链路与容器回收通过;MySQL/MariaDB/PostgreSQL 的 27 项真实 TLS 检查及协议夹具检查通过。Docker 容器不等于原生 macOS 数据库。 - DSH Web `0.2.2-rc.2`、pnpm `10.33.2`、隔离 PostgreSQL:真实测试、保存、重入、Host 重启、已存密码保留、默认停用、访问开关、诊断、TLS 不支持错误、首次引导复制、反馈新标签及草稿保护通过。桌面 1440×1000、390×844、320×640、浅/深色和 640×360 短视口已实查;修复窄屏键盘聚焦时外层弹窗被滚走的问题。密码替换、清空、恢复另通过真实 PostgreSQL 与隔离 Host API 验证,没有修改数据库账户。 - 锁文件中的 `hono` 更新为 4.13.18、`@hono/node-server` 更新为 2.1.8;当前生产依赖审计为 0 项漏洞。该结果不代表用户其他 Profile 或旧锁文件已被升级。 安装时 pnpm 可能报告宿主 peer 缺失:独立 Profile 的包管理器图与 DSH 注入的宿主共享模块不是同一层,必须继续核对实际激活和调用,不能仅凭警告或安装退出码判断兼容。本次 rc.2 页面已实际连接和保存数据库;没有通过安装另一份 Cordis 消除警告。文档使用 `--ignore-scripts`,不会执行依赖安装脚本;Oracle 的 Thin 模式不需要 Oracle Client 库,不能据此承诺 Thick 模式或任意平台原生二进制可用。参见 [pnpm 10 构建脚本说明](https://pnpm.io/10.x/cli/approve-builds) 与 [node-oracledb 7 安装说明](https://node-oracledb.readthedocs.io/en/v7.0.1/user_guide/installation.html)。 本轮未运行原生 Windows、Safari/Firefox、屏幕阅读器、真实在线模型或远程 Pages 部署。源码审查和视觉复核不等于用户审美认可,历史 CI 不能替代当前候选的跨平台结果。 同日独立 Linux 候选同步上述锁修正后,通过 Node 22.19.0 / 24.19.0 门禁、pnpm 10.33.2 下三种宿主安装,以及六库真实矩阵。服务版本为 MySQL 8.4.13、MariaDB 11.4.13、PostgreSQL 17.12、MongoDB 8.0.38、SQL Server 16.0.4295.3、Oracle 23.9.0.25.07,与 Mac 缓存镜像分开记录。Node 22.19.0 / 24.22.2 各通过 65 项 TLS 协议检查及 SQL Server/Oracle 真实 TLS 对照;**Node 24.19.0 的 SQL Server 和 Oracle 合法 IPv6 SAN 连接均失败**,应使用已验证修复的 Node 补丁,不能仅升级 Oracle 驱动或关闭证书验证。Oracle 真实 TCPS 错误身份/过期及完整服务端认证前负例仍未覆盖,PG/SQL Server/Oracle 的 TLS 在途取消也未单独重跑。云端不含最终 CSS、文档和截图变化;这些增量由 Mac 构建、页面和包内容检查覆盖。 ### 0.1.4 之后的本地连接体验改动 2026-11-12,基于 0.1.4 的未发布改动在 macOS x64、Node.js 24.20.0、DSH Web `0.2.0-rc.2`、Chrome 与隔离 PostgreSQL 17.11 完成实际页面验收。覆盖新建默认不要求加密、高级安全设置、TLS 失败不回退、已有 TLS 选择保留、原生校验、重名拒绝、测试/保存/取消、密码保留、Host 重启、首次保存提示与复制后保留当前页面、再次进入不重复引导、诊断和调用记录。桌面 1200×636 / 1440×900、390×844 / 320×640 窄屏、深色,以及标签页方向键、确认框和异步操作焦点均已检查。 同日后续表单重排及操作入口、窄屏密度调整,在相同宿主实际检查浅/深色与上述桌面、窄屏尺寸,复核原生校验、错误/未保存反馈、草稿取消、页签键盘导航、授权入口和 SRV 表单约束;没有重做数据库探测或保存持久化验收。 此轮不再提供“返回对话”操作,新建默认仅影响 Web 新草稿,Host/API 缺失字段与旧记录的 TLS 默认不变。MongoDB SRV 继续强制 TLS。基础门禁通过 219 项行为回归、19 项工具脚本测试、类型、构建、文档与发布白名单检查;`dev:web` 构建的本地产物已安装并实际加载。未重跑完整 tarball 兼容矩阵、六库/TLS 证书矩阵、在线模型、其他平台浏览器或屏幕阅读器,以下历史记录不代表本轮重新执行。 ### 0.1.4 验证记录 2026-11-11,`0.1.4` 的生产源码在 macOS x64 和 Linux x64 完成以下验收。最低 DSH、Node.js 要求和依赖版本保持不变;当日 npm `@deepseek-ai/dsh@latest` 为 `0.2.2-rc.1`,该宿主自身要求 Node.js ≥24.9.0,不能由插件的 Node.js ≥22.19.0 声明推定它支持 Node 22。 | 范围 | 已验证内容 | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 基础门禁 | macOS Node 22.19.0 / 24.20.0、Linux Node 22.19.0 / 24.22.2:216 项行为回归、19 项工具脚本检查、类型、构建与发布白名单 | | 隔离安装 | 同一生产源码打包后,在 Node 22.19.0 / 24 下通过锁定宿主组件检查;确切 tarball 在最低 DSH `0.2.0-rc.2` 和 latest `0.2.2-rc.1` 下通过官方 CLI 安装、Host/MCP/Client、写入拒绝、持久化与卸载重载;latest 仅使用 Node 24 | | 六种真实数据库 | MySQL 8.4.11、MariaDB 11.4.13、PostgreSQL 17.11、MongoDB 8.0.34、SQL Server 16.0.4295.3、Oracle 23.9.0.25.07:读取、结构发现、权限、超时与取消等各引擎完整现有矩阵,以及各自的 SIGTERM/SIGKILL 容器回收和实际发现的匿名卷清理;Oracle lite 探针未产生匿名卷 | | Oracle 冷态结构发现 | 全新数据库实例首次外键描述约 5.3 秒,在共享 10 秒限额内完成,未预热元数据;真实 DDL、源/目标撤权、在途取消与连接容量恢复检查通过 | | Web 与真实 Agent | Linux、Node 24.22.2、DSH Web `0.2.2-rc.1`、Chromium 154 与隔离 PostgreSQL:首问结构发现、精确金额汇总 `30.375`、撤权后拒绝继续访问,以及真实宿主进程重启后的连接与对话恢复 | 六库普通矩阵使用 Node 24 和隔离 Linux amd64 容器;macOS 承载的 Docker 容器不代表原生 macOS 数据库。TLS 范围分别为:MySQL/MariaDB/PostgreSQL 的真实证书身份与信任链正反例;MongoDB 的真实 TLS 认证、查询、错误身份、不受信任及自然过期拒绝;SQL Server 的真实 TLS 查询与认证前证书拒绝;Oracle 的 DNS/IPv4/IPv6 真实 TCPS 查询和不受信任 CA 拒绝。SQL Server/Oracle 的 IPv6 使用不终止 TLS 的字节转发。Oracle 真实 TCPS 的错误身份、过期证书和完整服务端认证前负例仍未覆盖,协议夹具证据不能补作这些真实数据库结果。 Web 检查还覆盖显式安全选择、测试不保存、默认关闭访问、复制返回且不覆盖草稿、密码保留/更换、编辑后忽略迟到测试结果、会话选择、草稿保护和删除取消。会话列表的加载/空/失败/迟到场景使用浏览器网络故障注入;成功刷新使用实际宿主数据。实际在线模型为原生 DeepSeek Messages 路由的 `deepseek-flash`,未改用 Chat 路由。 上述数据库和 Web 记录使用版本更新前、与 `0.1.4` 相同的生产源码及依赖;发布版本和文档更新后另行构建和验收新 tarball。此处不将旧 `0.1.3` tarball 当作 `0.1.4` 产物。当前记录不包含 `0.1.4` 的原生 Windows 验收或 npm registry 安装结果;确切发布提交的跨平台检查以对应 [GitHub Actions](https://github.com/blkpne/dsh-database/actions/workflows/check.yml) 结果为准。完整 Node 22 数据库矩阵、集群/故障转移、Windows/Linux 全部浏览器交互、深色主题和屏幕阅读器仍不在本次覆盖范围内。 ### 0.1.3 验证记录 `0.1.3` 的发布验证记录整理于 2026-11-09。最低 DSH、Node.js 要求及依赖版本与 `0.1.2` 相同。以下记录来自发布前的源码与本地 tarball 验证,不包含 npm registry 安装验收。 macOS x64、Node.js 24.20.0 已完成基础检查、生产依赖审计,以及本地 `0.1.3` tarball 在 DSH `0.2.0-rc.2` 和 `0.2.2-rc.1` 下的独立安装、Host/MCP 调用、写入拒绝、持久化、卸载重载与 Client 工厂检查。Client 工厂检查不等于浏览器交互验收。 2026-11-07 的修复候选在 macOS 完成的 65 例 TLS 协议检查、MySQL/MariaDB/PostgreSQL 真实 TLS 检查及 PostgreSQL 真实集成验证继续适用;Linux 上的 SQL Server/Oracle TLS 与在线模型补验见下文。 同日的[候选提交 CI](https://github.com/blkpne/dsh-database/actions/runs/42378133765)已通过 Windows Node 22.19/24、macOS/Linux、最低与 latest 宿主兼容性、六库、TLS 和资源清理检查。本次发布文案收尾未修改生产源码或依赖;最终发布提交的跨平台结果以发布标签对应的 GitHub Actions 记录为准,不由历史 CI 或本地安装结果推定。 ### 0.1.2 验证记录 2026-11-06,macOS x64、Node.js 24.20.0,本地构建的 npm tarball: | DSH 版本 | 已验证功能 | | ---------- | --------------------------------------------------------------------------------------------------------- | | 0.2.0-rc.2 | 官方 CLI 安装、插件激活、MCP 调用、写入拒绝、持久化、卸载重载与 Client 工厂 | | 0.2.2-rc.1 | 同上;使用该宿主的独立原生工具执行器 | | 0.2.1-rc.2 | 锁文件配套组件下的插件激活、MCP 调用、写入拒绝、持久化、卸载重载与 Client 工厂;未在本次单独重测 CLI 安装 | 最低 DSH 与 Node.js 要求保持不变。新增接受 DSH 0.2.2-rc.1 配套的 Cordis 4.1 与 Schemastery 3.19,同时保留原有依赖范围;具体声明见 [package.json](../package.json)。 本次还通过基础回归、类型与构建检查、生产依赖审计和 TLS 协议夹具检查。上述 tarball 验收不等于真实数据库、浏览器交互或在线模型验收;这些项目本次未在本地重测,历史证据与范围见下文。 ### 0.1.1 验证记录 2026-10-21,Windows x64、Node.js 22.19.0,本地构建的 npm tarball: | DSH 版本 | 已验证功能 | | ---------- | ---------------------------------------------------------------------- | | 0.2.0-rc.2 | CLI 安装、插件激活、MCP 调用、写入拒绝、持久化、卸载重载与 Client 入口 | | 0.2.1-rc.2 | 同上 | 数据库、浏览器及在线模型的验证记录来自 0.1.0,详见下文。 ### 0.1.0 历史验收 **人工 Web 验收覆盖 macOS;自动化验收覆盖 Linux、Windows、macOS 及下列数据库版本。** CI 配置、实际运行结果与 npm 安装验收分别记录;发布成功本身不扩大兼容范围。 | 项目 | 验证基线与覆盖范围 | | --------------- | ----------------------------------------------------------------------------------------------------- | | 插件 | 0.1.0 源码与本地构建的 npm tarball;npm registry 安装不在本页验证记录中 | | DSH | Web,`0.2.0-rc.2` | | Node.js | 本地 macOS 22.19 / 24.20;CI 矩阵见下文;最低要求见 [package.json](../package.json) 的 `engines.node` | | macOS | 已验证源码安装、基础检查、tarball 安装、开发脚本及 Web 管理操作 | | Linux / Windows | 已通过下述自动化验收;人工 Web 操作未在这两个平台验收 | | Desktop | 独立 Desktop 运行不在本页验证范围内 | DSH 公共组件按主包发行版配套使用,精确版本见 [源码锁文件](https://github.com/blkpne/dsh-database/blob/main/package-lock.json)。升级时核对整套组件,避免逐个拼装拆分包的 `latest`。 平台验证范围不含 Windows ARM64、32 位、网络共享源码目录及原生数据库服务。开发方式与依赖见 [Windows PowerShell](../CONTRIBUTING.md#windows-powershell)。 ## 自动化验收 以下环境与检查已通过自动化验收,运行结果见 [GitHub Actions 验证记录](https://github.com/blkpne/dsh-database/actions/workflows/check.yml): | 环境 | 已通过的检查 | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | Ubuntu / Windows,Node 22.19.0 和 24;macOS,Node 24 | 安装依赖、文档与类型检查、基础回归、开发脚本、构建、生产依赖审计,以及实际 tarball 的隔离安装与 Host/MCP/Client 产物检查 | | Windows,Node 24 | TLS 协议夹具检查,含带空格与特殊字符的路径 | | Ubuntu 22.04,Node 24 | 六种真实数据库的集成测试、容器清理验证、TLS 协议与数据库 TLS 检查 | 这里记录的是已执行的工作流结果。CI 中的 Client 检查不等于浏览器交互验收;人工 Web 操作、真实在线模型和 TLS 的具体范围见下文。Node 24 是该次工作流的版本选择器,精确补丁版本及 runner 镜像见运行日志。 数据库集成测试固定使用 Ubuntu 22.04 runner,并在日志中记录 Docker 与宿主内核版本。MongoDB 8.0 的内核限制见[上游兼容说明](https://jira.mongodb.org/browse/SERVER-125742);容器镜像版本不能代替宿主内核兼容性检查。 ## 数据库 以下数据库结果来自隔离 Linux 容器中的**真实单节点数据库**,验证时间为 2026-10-11。它们不覆盖所有版本、集群或代理部署。Docker 是测试工具,不是使用插件的前提。 六种引擎均已验证读取、元数据、MCP/Host 调用以及连接资源回收。各引擎的补充范围如下: | 引擎 | 服务端版本 | 补充验证范围 | | ---------- | ------------------------- | ------------------------------------------ | | MySQL | 8.4.11 | 精度、截断、只读权限、超时与取消 | | MariaDB | 11.4.13 | 精度、截断、只读权限、超时与取消 | | PostgreSQL | 17.11 | 权限可见性、超时与取消、恢复 | | MongoDB | 8.0.32 | 服务端取消观测、停用/删除/卸载与恢复 | | SQL Server | 16.0.4295.3(2022 CU27) | 精度、截断、权限、基本超时与客户端取消 | | Oracle | 23.9.0.25.07(23ai Free) | 复合约束、权限可见性、基本超时与客户端取消 | ### TLS Oracle 的 IPv6 TCPS 连接依赖 Node 原生的证书身份检查。Node 24.18/24.19 存在合法 IPv6 IP SAN 被拒绝的上游回归;在 24.19 上,Oracle 驱动 7.0.1 和 26.0.0 均返回 `NJS-506`,没有发送受 TLS 保护的 Oracle 协议数据。仅升级驱动不能解决此问题。[Node 24.20.0](https://nodejs.org/en/blog/release/v24.20.0) 和 [22.23.4](https://nodejs.org/en/blog/release/v22.23.4) 已包含 IPv6 SAN 匹配修复。 2026-11-07,未发布候选在 Linux x64、Node 22.23.4 和 24.22.2 下各通过 65 例协议检查,包含 Oracle 的 IPv6 正反路径;24.22.2 另对照了 Oracle 驱动 7.0.1 与 26.0.0。正确证书允许发送加密协议数据,错误 IP/DNS 身份、过期或不受信任证书在协议数据前拒绝。这些协议监听器不提供 Oracle 数据库认证或查询。 需要 Oracle IPv6 TCPS 时,应使用包含上述修复的 Node 补丁版本,并在目标数据库验证认证与查询。无法升级时,只能改用证书明确覆盖、可实际到达的 DNS 名称或 IPv4 地址;不得关闭证书链或身份检查、替换校验主机名或弱化 DN 匹配。插件整体最低 Node 要求不因此改变,较早版本的 Oracle IPv6 支持不能据此推定。Linux 补验不等同于未发布候选的 Windows/macOS CI。 同日,SQL Server 2022 CU27(16.0.4295.3)、Tedious 20.3.6 在上述两版 Node 完成真实 TLS 登录与精确金额汇总。32 次证书/信任链检查覆盖正确 DNS/IPv4/IPv6 SAN,以及错误身份、过期与不受信任 CA;15 次独立不存在账户的对照结合服务端失败登录日志,验证证书拒绝发生在认证之前。IPv6 使用 `::1` 到所属容器 IPv4 发布端口的透明字节转发,TLS 在数据库终止,客户端仍校验 `::1`;这不代表 Docker IPv6 网络或远程拓扑验收。该补验补充下表的历史 SQL Server TLS 缺口。 Oracle 23.9.0.25.07、驱动 7.0.1 另完成真实 TCPS:Node 24.22.2 的 DNS/IPv4/IPv6 与 22.23.4 的 IPv6 均成功认证并查询合成数据的精确金额 `30.375`;不受信任 CA 被拒绝。相同数据库、钱包与 IPv6 转发路径在 24.19 下返回 `NJS-506`。服务器只启用单向 TLS,客户端保留证书链与身份检查;未测试客户端证书认证。真实 Oracle TCPS 的错误身份/过期证书仍只有上述协议检查证据,不能与 SQL Server 的真实负例矩阵混称。 | 引擎 | 已完成 | 本页不覆盖 | | ---------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------- | | MySQL / MariaDB / PostgreSQL | 真实数据库证书校验;正确 DNS/IP 身份,以及错误身份、过期、不受信任证书的拒绝;失败不降级明文 | 其他版本及部署拓扑 | | MongoDB / Oracle | 真实驱动连接本地 TLS 监听器,验证上述证书身份场景 | 真实数据库上的 TLS 认证与查询 | | SQL Server | 适配器回归检查主机名传递 | 真实 TLS 服务器验证 | MySQL/PG 协议补验完成于 2026-10-12。MongoDB/Oracle 的 TLS 握手检查完成于 2026-10-17,环境为 macOS / Node 24.20;正确证书允许发送加密协议数据,检查未执行数据库认证或查询。 ### 取消与部署范围 - PostgreSQL、MongoDB 已覆盖服务端在途操作终止与恢复。 - SQL Server、Oracle 的记录覆盖客户端取消,不包含一般性的服务端在途终止验收。 - 客户端取消、关闭连接与服务器停止计算是不同结果。具体实现和清理证据见[超时与取消](reference.md#超时与取消)。 - 本页验证范围不包含集群、故障转移和 MongoDB Atlas/SRV;表单支持 SRV 不代表相应部署方式经过验证。 ## Web 与 Agent 2026-11-11,同一基线上的首问引导优化另在隔离 Profile、PostgreSQL 17 与 Web `0.2.0-rc.2` 中实测。覆盖显式安全选择、保存后访问默认关闭、开启后的结构首问复制与返回、已有对话草稿保留、未保存与停用保护、同名保存拒绝、指定会话提示、改名与已存密码保留,以及 1280×720 和 390×844 界面。返回对话使用该版本 `@deepseek-ai/dsh-client-ui-layout` 的公开 `selectPanel(null)`,不创建会话、不预填或发送消息;模型配置采用经界面核实的“设置 → 模型”文字指引,不检测凭据或模型状态。手动发送首问后,未配置模型的宿主返回 `MISSING_CREDENTIAL`;有效模型回答与数据库工具执行未在此次复测验证。剪贴板拒绝与异步取消由确定性回归覆盖,未实际撤销浏览器剪贴板权限。 2026-11-11,基于 `0.1.3` 的本地未发布连接体验改动在 macOS x64、Node 24.20.0、DSH Web `0.2.0-rc.2`、Chrome 与隔离 PostgreSQL 17.11 上完成浏览器验收。覆盖新建时显式选择连接安全、真实 TLS 不支持与认证失败、测试成功/加载/取消/配置更改后失效、密码保留/更换/清空、独立保存、Host 重启恢复、诊断、Agent 访问开关、删除取消/确认及最后一项删除后的空状态。桌面 1440×900、390×844 与 320×640 视口,以及确认框焦点循环、Escape 和标签页方向键均已检查。 该改动保留既有连接和 Host/API 的 TLS 默认语义;MongoDB SRV 仍要求 TLS。基础检查通过 200 项行为回归、19 项工具脚本检查、类型、构建与产物清单校验,另通过 65 例 TLS 协议检查。协议夹具不等于六种真实数据库的 TLS 认证验收;此次未重跑六库矩阵、tarball 安装、在线模型、Windows/Linux 浏览器、深色主题或屏幕阅读器。以下历史验证不自动扩大本地改动的验证范围。 2026-11-07,未发布候选在 Linux x64、Node 24.22.2、DSH Web 0.2.2-rc.1 上补验原生 DeepSeek Messages 与明确 Off:Agent 通过 inspect 发现合成 PostgreSQL 结构,再用 query 返回精确汇总 `30.375`;停用授权后数据库工具从 2 个变为 0,Agent 拒绝继续查询,未使用其他工具替代。没有使用 pi-ai Chat 替代路由,也未修改日常 Profile。 先前的 HTTP 500 曾在不含数据库工具的最小提供方请求中出现,本次官方最小默认/disabled/low 请求及宿主原生 Off 均成功,未复现 500。这支持继续使用当前原生路由,但不能确认服务端内部根因或保证故障不会再次出现;数据库连接器未为此增加供应商配置逻辑。此次未重跑此前全部浏览器交互、六库和在线质量场景。 | 层面 | 已完成 | 本页不覆盖 | | -------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------- | | Web 管理 | 表单、草稿保护、TLS/认证错误、保存、启停、授权、密码保留、页面重载、Host 重启恢复、诊断记录与删除 | 全部响应式尺寸、深色主题、自动 CI 浏览器回归 | | 工具调用 | ToolRuntime、MCP、PTC 与数据库调用链的确定性测试 | 多模型的成功率与性能对比 | | 在线场景 | PostgreSQL 合成电商数据的结构发现、只读汇总、分析绘图及 Web 页面重载后的对话与图片回放 | 其他引擎的在线模型验收、全部结果卡片类型 | Web 操作验证完成于 2026-10-11,配置写入使用 PostgreSQL;其余引擎由后端集成测试覆盖。开发脚本补验完成于 2026-10-12。确定性工具测试与真实模型验收分别记录。 在线场景验证完成于 2026-10-18,使用 macOS、Node 24.20.0、DSH Web 0.2.0-rc.2、PostgreSQL 17.11 与 DeepSeek Flash(`deepseek-official/deepseek-flash`)。Agent 通过插件查询合成订单与退款,生成经营简报,并使用宿主的文件、执行工具及 Python / matplotlib 绘图;主要指标与独立数据库查询结果核对一致。此记录仅覆盖这一场景,不代表模型输出始终正确;示例见[电商经营复盘](usage.md#场景示例电商经营复盘)。 ## 遇到兼容性问题 请按[反馈问题](../CONTRIBUTING.md#反馈问题)提供版本、环境和最小复现。更多信息: - [数据库连接设置](usage.md#数据库连接设置):字段、认证方式和使用限制。 - [测试分层与夹具](../CONTRIBUTING.md#测试分层与夹具):如何复现对应检查。 - [发布指南](releasing.md):发布产物与平台矩阵的验收流程。