dsh-web-search-enhanced 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -4,6 +4,29 @@
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-09-30
+
+### DSH 0.2.0-rc.2 兼容性
+
+- 最低宿主版本提升至 `0.2.0-rc.2`；所有 DSH peer 依赖下限改为 `^0.2.0-rc.2`，直接开发依赖固定到 rc.2，同步更新锁文件和预发布白名单。
+- Zod 最低版本保持与上游一致的 `^4.4.3`，开发依赖树统一锁定 `4.4.3`，增加跨包 schema 类型一致性和发行包契约检查，避免依赖漂移被误判为 API 破坏。Cordis / Schemastery 的上游版本未变。
+- 增加 pi-ai 新 DeepSeek Flash ID 的跟随模型回归，验证被移除的目录 ID 不会被自动改名，显式私有路由保持原模型 ID。新增 [rc.2 影响评估](docs/upstream-0.2.0-rc.2-assessment.zh-CN.md)。
+- 配置 version 2、会话 Storage Domain version 1 保持不变，无需新增迁移；升级指南明确先卸载旧插件再安装，并重载服务端、刷新 Web 页面。CI 和发布均显式使用冻结锁文件。
+
+### 会话搜索选择器
+
+- 新增“关闭”选项，按会话禁用 `web_search`；恢复连接后重新启用，不影响 `web_fetch`。
+- 对齐宿主输入区模型选择器的响应式边界，保留关闭搜索、连接选择和实时性控制的既有回归测试。
+
+## [0.1.5] - 2026-09-29
+
+### DSH 0.2.0-rc.1 兼容性
+
+- 最低宿主版本提升至 `0.2.0-rc.1`；所有 DSH peer 依赖同步改为 `^0.2.0-rc.1`，直接开发依赖固定到该版本，更新锁文件、预发布白名单和发布包契约断言。
+- 核对搜索 Provider、设置 / 插槽、会话与工具恢复、Schedule 拆包、原生命令和遥测变更；无需修改搜索业务代码或安装补丁。新增真实宿主配置继承、修改、重启及恢复默认的回归测试。
+- 明确原生 DeepSeek 搜索新增的账号认证不会自动用于本插件：跟随模型仍要求可解析的 API Key 路由，结构化与固定连接保持独立。
+- 设置格式 version 2、会话 Storage Domain version 1 不变；从 0.1.4 升级无需新迁移，重载服务端后刷新 Web 页面。详见 [0.2.0-rc.1 影响评估](docs/upstream-0.2.0-rc.1-assessment.zh-CN.md)。
+
 ## [0.1.4] - 2026-09-24
 
 ### DSH 0.1.7-rc.2 兼容性

package/README.md

@@ -10,7 +10,7 @@
 
 [![Release](https://img.shields.io/github/v/release/Yurzi/dsh-web-search-enhanced?style=flat-square)](https://github.com/Yurzi/dsh-web-search-enhanced/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
-[![DSH](https://img.shields.io/badge/DSH-0.1.7--rc.2%2B-536DFE?style=flat-square)](package.json)
+[![DSH](https://img.shields.io/badge/DSH-0.2.0--rc.2%2B-536DFE?style=flat-square)](package.json)
 [![Node.js](https://img.shields.io/badge/Node.js-22.19%2B%20%7C%2024%2B-green?style=flat-square)](package.json)
 
 [🚀 快速上手](#-快速上手) · [✨ 核心特性](#-核心特性) · [🔍 搜索引擎推荐](#-选哪种搜索服务) · [⚙️ 进阶配置](#️-进阶配置与个人-key) · [❓ 常见问题](#-常见问题-faq) · [📖 详细文档](#-想了解更多)
@@ -60,19 +60,19 @@
 
 ### 环境要求
 
-- **DeepSeek Harness**：≥ `0.1.7-rc.2`
+- **DeepSeek Harness**：≥ `0.2.0-rc.2`
 - **Node.js**：`^22.19.0 || >=24.0.0`
 
-本版将 DSH 基线提升到 0.1.7-rc.2，保留动态配置、插件设置页和会话 projection 架构，详见[rc.2 影响评估](docs/upstream-0.1.7-rc.2-assessment.zh-CN.md)。升级前请备份 profile 和旧设置。
+本版将 DSH 基线提升到 0.2.0-rc.2，保留动态配置、插件设置页和会话 projection 架构，无需新的配置或存储迁移。跟随模型仍要求 API Key；使用 pi-ai 内置 DeepSeek 目录时，请重新选择 `deepseek-flash` 并检查旧模型 overrides，本插件不会自动改名。详见[0.2.0-rc.2 影响评估](docs/upstream-0.2.0-rc.2-assessment.zh-CN.md)。升级前请备份 profile 和旧设置。
 
 ### 步骤 1：安装插件
 
 **方式 A：通过 GitHub Release 离线包安装（推荐）**
 
-当前版本为 **0.1.4**，最低支持 **DSH 0.1.7-rc.2**。发布后可从 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 下载对应版本安装包及 SHA256 校验文件；也可执行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack` 自行构建。使用绝对路径安装：
+当前版本为 **0.1.6**，最低支持 **DSH 0.2.0-rc.2**。发布后可从 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 下载对应版本安装包及 SHA256 校验文件；也可执行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack` 自行构建。使用绝对路径安装：
 
 ```sh
-dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.4.tgz
+dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.6.tgz
 ```
 
 **方式 B：通过 npm 在线安装**
@@ -80,9 +80,11 @@ dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.4.tgz
 该版本发布到 npm 后，也可直接安装：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.4
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.6
 ```
 
+已安装旧版时，DSH rc.2 不支持直接自动升级：先备份配置和存储，再通过插件管理器移除旧版并安装 0.1.6，核对 profile 补丁与会话选择。Desktop profile 需先启动过一次桌面端。完整步骤见[升级指南](docs/migration.zh-CN.md)。
+
 ### 步骤 2：生效与刷新
 
 1. 重载插件或重启 DSH 服务端。
@@ -200,7 +202,7 @@ _注：实时抓取可能会稍微增加检索耗时与额度消耗；对于不
 | 文档                                                     | 适合谁读            | 主要内容                                                          |
 | :------------------------------------------------------- | :------------------ | :---------------------------------------------------------------- |
 | 📘 **[配置指南](docs/configuration.zh-CN.md)**           | 所有用户 / 进阶用户 | 完整参数列表、凭据机制、高级 options 白名单、自定义端点与排错字典 |
-| 📙 **[升级指南](docs/migration.zh-CN.md)**               | 从旧版升级的老用户  | 0.1.7 宿主适配、旧版导入指引、升级踩坑预防                        |
+| 📙 **[升级指南](docs/migration.zh-CN.md)**               | 从旧版升级的老用户  | 0.2.0-rc.2 宿主适配、旧版导入指引、升级踩坑预防                        |
 | 📗 **[架构设计说明](docs/design-v2.converged.zh-CN.md)** | 开发者 / 架构爱好者 | 会话状态隔离、请求快照机制、多适配器与安全性设计                  |
 | 🛠️ **[开发与验证文档](docs/v2-implementation.zh-CN.md)** | 插件二次开发者      | 本地构建、单元测试、浏览器环境验证与打包发布                      |
 | 📝 **[更新日志](CHANGELOG.md)**                          | 所有人              | 版本演进记录与历史变更                                            |

package/docs/configuration.zh-CN.md

@@ -1,12 +1,12 @@
-# 0.1.4 配置参考
+# 0.1.6 配置参考
 
-本指南面向安装版插件。包版本为 **0.1.4**，配置格式的 `version` 为 **2**；两者不是同一版本号。快速开始见 [README](../README.md)，旧版用户先读[升级指南](migration.zh-CN.md)。
+本指南面向安装版插件。包版本为 **0.1.6**，配置格式的 `version` 为 **2**；两者不是同一版本号。快速开始见 [README](../README.md)，旧版用户先读[升级指南](migration.zh-CN.md)。
 
 ## 配置入口与作用范围
 
 在 DSH 设置的 Web Search Enhanced 卡片管理搜索连接、凭据引用与新会话默认值，在已有会话输入区选择搜索连接和内容实时性。搜索连接独立于对话模型。设置按宿主 ConfigForms / ConfigForm 保存 profile 稀疏覆盖，不复制整个内置目录；恢复继承设置、删除用户连接覆盖均不删除 Credentials。继承层中的连接在移除用户覆盖后仍可能存在。
 
-以下 YAML 均为 DSH 0.1.7 的 profile patch 条目，`id: web-search-enhanced` 是安装补丁的固定条目 ID，字段置于 `config` 下。旧 `settings.yaml` 由宿主导入后不再作为实时配置源；优先使用插件管理器中的配置页，避免覆盖其他插件设置。专属客户端配置页绑定默认条目 ID，不支持任意改名或多个搜索插件实例。
+以下 YAML 均为 DSH 0.2.0-rc.2 的 profile patch 条目，`id: web-search-enhanced` 是安装补丁的固定条目 ID，字段置于 `config` 下。旧 `settings.yaml` 由宿主导入后不再作为实时配置源；优先使用插件管理器中的配置页，避免覆盖其他插件设置。专属客户端配置页绑定默认条目 ID，不支持任意改名或多个搜索插件实例。
 
 ```yaml
 - id: web-search-enhanced

package/docs/design-v2.converged.zh-CN.md

@@ -1,4 +1,4 @@
-# 0.1.4 当前架构与实现边界
+# 0.1.6 当前架构与实现边界
 
 本文描述已存在的源码契约，不是未来设计提案或历史验收记录。为避免外部链接失效，保留原文件名。用户配置见[配置参考](configuration.zh-CN.md)，验证方法见[开发验证指南](v2-implementation.zh-CN.md)。
 
@@ -46,7 +46,7 @@ tools/execute 的 exec.agent → 私有 AsyncLocalStorage → enhanced-search
 
 ## 3. 配置和秘密分离
 
-当前设置格式为 version 2，包版本为 0.1.4。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
+当前设置格式为 version 2，包版本为 0.1.6。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
 
 内置结构化连接不能重定向地址或改变 adapter。自定义结构化连接只能使用个人 Key；固定模型总是需要显式信任。校验拒绝任意 headers/body、缓存参数、秘密字段等不受支持的 options。禁用连接也参与配置校验。
 

package/docs/migration.zh-CN.md

@@ -1,10 +1,10 @@
-# 升级到 0.1.4 / DSH 0.1.7-rc.2
+# 升级到 0.1.6 / DSH 0.2.0-rc.2
 
-0.1.4 将最低宿主版本提高为 **0.1.7-rc.2**，沿用 0.1.3 已完成的 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC 适配。从 0.1.3 升级不需要新的配置或存储迁移；详见 [rc.2 影响评估](upstream-0.1.7-rc.2-assessment.zh-CN.md)。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.4、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
+0.1.6 将最低宿主版本提高为 **0.2.0-rc.2**，沿用 0.1.3 已完成的 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC 适配。从 0.1.3 / 0.1.4 / 0.1.5 升级不需要新的配置或存储迁移；详见 [0.2.0-rc.2 影响评估](upstream-0.2.0-rc.2-assessment.zh-CN.md)。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.6、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
 
 ## 1. 升级前准备
 
-- 确认 DSH 满足 `>=0.1.7-rc.2`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.1.7-rc.2 契约，不代表对所有未来宿主版本均完成验证。
+- 确认 DSH 满足 `>=0.2.0-rc.2`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.2.0-rc.2 契约，不代表对所有未来宿主版本均完成验证。
 - 备份当前插件版本、Web profile / 插件配置和 DSH 持久存储。凭据使用宿主安全备份方式，不复制到公开 Issue 或仓库。
 - 记录旧 `modelMode`、协议、模型、endpoint、凭据引用，以及希望保留的会话选择。
 - 推荐升级前先将明文 `apiKey` 移到 DSH Credentials 并从配置来源删除。兼容导入仅允许旧格式短暂携带 Key：先验证转换结果，再写 Credentials，最后 CAS 替换 profile 配置。V2 配置仍拒绝明文 Key；已有不同值的同名凭据不会被自动覆盖。
@@ -12,23 +12,27 @@
 
 ## 2. 安装发行包
 
-从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.4 构建包。使用绝对路径交给 DSH 插件管理器：
+DSH rc.2 对已安装插件不支持直接自动升级。先完成备份、停止相关任务，通过插件管理器卸载旧插件（CLI 使用 `dsh plugin --profile web remove dsh-web-search-enhanced`），再安装下述固定版本；卸载可能改变 profile 补丁，安装后核对原设置、凭据引用和会话选择，不要清空持久存储。使用 `--profile desktop` 时须先启动过一次 Desktop 初始化 profile，并完全退出 Desktop 后执行 CLI。
+
+若跟随 pi-ai 内置 DeepSeek 目录，升级宿主后重新选择 `deepseek-flash`，检查旧 `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp` 及其 overrides、默认模型和子代理设置。只针对这条目录路由，不机械替换私有端点的 ID；本插件不会改写用户模型配置。
+
+从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.6 构建包。使用绝对路径交给 DSH 插件管理器：
 
 ```sh
-dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.4.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.6.tgz
 ```
 
 若该版本已在 npm 发布，也可安装固定版本：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.4
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.6
 ```
 
 发布附件中的构建 tgz 与 GitHub 自动生成的 Source code archive 不同：后者是源码，不能假定含 `lib/` 构建产物。npm 可用性须以 registry 实际发布结果为准，GitHub 标签 / Release 存在不代表 npm 已完成。
 
 安装补丁选择 enhanced-search、禁用默认 web-search-deepseek，并明确将新会话默认设为 Exa；不改 fetchProvider。已有部署请审阅插件管理器反馈和 Web profile，避免重复注册条目，不要用整份示例覆盖所有宿主配置。
 
-升级含服务端与客户端契约变更。重新加载插件或重启 DSH，**然后刷新 Web 页面**；只刷新浏览器不足以更新服务端。此操作可能影响运行中任务，应在合适时机进行。
+本次未改变插件前后端业务契约，但宿主依赖与构建产物已更新。重新加载插件或重启 DSH，**然后刷新 Web 页面**；只刷新浏览器不足以更新服务端。此操作可能影响运行中任务，应在合适时机进行。
 
 ## 3. 启动时自动迁移旧配置
 

package/docs/upstream-0.2.0-rc.1-assessment.zh-CN.md

@@ -0,0 +1,50 @@
+# DSH 0.2.0-rc.1 对插件 0.1.5 的影响评估
+
+## 范围与结论
+
+对照本地上游源码的 `dsh-v0.1.7-rc.2` → `dsh-v0.2.0-rc.1` 差异，目标提交为 `4878cdabd87d4041bdaff61d04c966883b9fd07a`。重点核对插件实际使用的服务、事件和客户端插槽，不将上游版本摘要直接等同于插件兼容性结论。上游完整范围见[版本比较](https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.1.7-rc.2...dsh-v0.2.0-rc.1)。
+
+**结论：必须更新依赖约束与构建基线；本次核对未发现必须修改搜索业务代码的接口破坏。** DeepSeek 账号搜索是原生 provider 的新能力，不会自动传递给本插件。
+
+- 插件：`0.1.4` → `0.1.5`（延续本项目兼容性更新的 patch 版本惯例）。
+- 最低宿主：`engines.dsh >=0.2.0-rc.1`。这是用户所指 `0.2.0rc.1` 的上游规范版本号。
+- 所有直接 DSH peer：`^0.2.0-rc.1`；所有直接 DSH 开发依赖：精确 `0.2.0-rc.1`。同步更新锁文件、预发布安装白名单、版本断言和安装文档。
+- 设置格式仍为 version 2，会话 Storage Domain 仍为 version 1；不增加配置迁移或改写宿主 Session 日志。
+
+## 逐项影响
+
+| 上游变更 / 核对点 | 对本插件的影响与处理 |
+| --- | --- |
+| `0.1.x` → `0.2.x` 版本范围 | 旧 peer `^0.1.7-rc.2` 不接受 `0.2.0-rc.1`。不能只修改 engines 或简单放宽上界，必须显式纳入目标 prerelease；本次同步提升 peer 下限和开发基线。 |
+| [WebSearchProvider / WebError](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/web/web/src/types.ts)、WebRuntime、tool-web | 对应源码在两 tag 间未变化。继续通过 `registerSearchProvider` 服务原生 `web_search`，请求 / 来源 / 取消接口不变，也不接管 `web_fetch`。 |
+| [默认 bundle 的 web 条目](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/bundle/base/cordis.patch.yml) | `web`、`web-search-deepseek` 仍存在，本插件补丁不需要改 ID，仍选择 enhanced-search 并禁用原生搜索，不设置 fetchProvider。 |
+| [原生 DeepSeek 搜索账号认证](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/web/web-search-deepseek/src/index.ts) | 原生 provider 根据当前会话 requestContext 的 deepseek-account 路由解析受端点限制的账号 token。本插件没有调用这条认证链；结构化 / 固定 API Key 连接继续独立工作，跟随模式仍拒绝无法解析为显式 apiKeyEnv 的账号 / OAuth 路由。本次不隐式借用账号 token，也不自动切换 provider。 |
+| [ConfigEditor 继承配置计算修复](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/boot/config-editor/src/index.ts) | 宿主区分有无用户 config 覆盖，并使用组合后的继承配置；影响设置继承值的正确呈现，而非插件字段协议。继续使用 SettingsForms / ConfigForms 和 revision CAS，遵循 Cordis 的 config 对象替换语义；修改单字段时宿主可能携带继承字段，恢复到完整继承值后删除用户 config 覆盖。 |
+| SettingsForms / ConfigForms、Typert、会话 projection、存储 | 插件使用的核心契约和 plugins.bundle.config 插槽未变化；api-remotes 新增 product analytics contribution，不改变插件 `$mount` 顺序或连接失效处理。会话 fork 新增可选 onCreated 回调，不影响插件的 seeded fork 选择继承。 |
+| [AgentLoop 工具结果恢复](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/core/agent-loop/src/agent.ts) / [ToolCallRecovery](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.0-rc.1/packages/core/session/src/repair.ts) | 失败步骤会补齐尚无已提交结果的调用。插件只经过 agent/request、tools/execute 和 provider 返回结果，不自行写 tool/call、tool/result 或 surfaceOp，因此无需补造事件或重试搜索。调用是否已完成仍以宿主恢复语义为准。 |
+| Schedule / time-context / ui-schedule 从 Web 默认组合抽离 | 插件补丁和服务注入不引用这些 ID / API；无需新增实验 bundle。用户自己的 profile 如引用旧条目，应独立迁移。 |
+| runNativeCommand 新增必填 window 参数 | 插件不直接调用该 API；升级后的传递依赖由上游负责适配，无需增加 native-command 依赖。 |
+| OTel 服务集中化、Desktop 产品埋点、日志上传设置 | 插件未注入 otel，也不新增遥测调用；不因本次升级添加上传行为。但搜索工具结果仍属于宿主会话内容，是否上传由宿主日志 / 隐私设置决定，不能据插件无遥测推断宿主完全不上传。 |
+| 默认 detailed 视图、运行状态动画、插件管理器交互及主题细节 | 插件不替换 transcript 或 composer，只追加 conversation.input.right 和插件配置槽。未发现槽契约破坏；实际运行实例的视觉验收仍需安装新版后刷新页面。 |
+
+跟随模式仍保留受限的非公开 adapter identity / catalog 兼容层（见 [session-model.ts](../src/dsh/session-model.ts)）；相关 LLM 源码在本次 tag 差异中未改变，不代表未来版本保证兼容。形状不匹配时继续 fail-closed，可改用显式固定连接。
+
+### SemVer 注意
+
+`0.2.0-rc.1` 在版本排序上小于 `0.2.0`，但默认 npm SemVer 范围匹配另有 prerelease 排除规则。因此 `>=0.1.7-rc.2 <0.3.0` 也不能仅靠放宽上界就接受 `0.2.0-rc.1`。本次使用 `^0.2.0-rc.1` 明确纳入目标预发布，同时将 peer 上界限制在 `<0.3.0-0`。该范围不代表自动支持所有未来小版本的预发布，也不代表所有 0.2.x 已经测试。
+
+## 升级与验证
+
+先升级 DSH，再安装插件 0.1.5，重载服务端插件并刷新 Web 页面。保留现有凭据、搜索连接、会话选择和实时性偏好，不需要清空存储。需要 DeepSeek 账号搜索时不能把“宿主账号能聊天”等同于“本插件跟随模式能搜索”；应继续使用支持的独立连接，或明确恢复原生 provider 和对应 profile 选择。
+
+本轮验证（2026-09-29）：
+
+- `PNPM_HOME="$PWD/.pnpm-home" pnpm install --frozen-lockfile --offline`：通过，锁文件可复现本次已缓存的依赖安装。
+- `PNPM_HOME="$PWD/.pnpm-home" pnpm run check`：退出 0；TypeScript 类型检查、服务端 / 客户端构建、22 个测试文件共 340 项测试、0.1.5 实际打包 / 解包契约检查全部通过。
+- 新增真实 Loader / ConfigEditor 回归用例，覆盖继承默认值、单字段修改、重启恢复和 unset 恢复默认；按宿主 config 对象替换语义验证，未修改业务源码。
+- 20 项 DSH peer、32 项直接 DSH 开发依赖、72 个锁定 DSH 包和预发布白名单已核对一致；锁文件中不残留旧 DSH 版本或镜像 tarball 地址。
+- `git diff --check`：通过。
+
+安装环境说明：npm 官方 registry 本次发生 TLS / ECONNRESET 连接错误，依赖更新改用一次性的 `--registry=https://registry.npmmirror.com` 完成，并通过 pnpm supply-chain 检查；没有修改默认 registry 或关闭校验。随后以离线冻结安装和完整 check 验证。工作区 PNPM_HOME 仅为本机缓存 / pnpm 状态目录配置，不是插件运行要求。
+
+自动测试使用模拟网络，不证明搜索供应商实时在线；本次未进行运行实例的浏览器视觉验收或安装 / 重载，也未发布 npm/GitHub Release。打包契约检查使用临时包并在完成后清理，不提供持久发行附件。

package/docs/upstream-0.2.0-rc.2-assessment.zh-CN.md

@@ -0,0 +1,37 @@
+# DSH 0.2.0-rc.2 插件适配评估
+
+## 版本与范围
+
+本次对照上游标签 `dsh-v0.2.0-rc.1` 与 `dsh-v0.2.0-rc.2`（提交 `639ed015397290b3745d163aafe02ffee4aa3f84`），结合两份升级评估核查 Web Search Enhanced。插件发布版本为 **0.1.6**，最低宿主 **0.2.0-rc.2**。
+
+- engines.dsh：`>=0.2.0-rc.2`；全部 DSH peer：`^0.2.0-rc.2`；直接开发依赖精确固定 rc.2。
+- 更新 pnpm 锁文件与仅针对审阅版本的预发布白名单。开发安装统一 Zod **4.4.3**，运行依赖下限继续为 `^4.4.3`，与上游 rc.2 锁文件一致；不以类型断言规避跨包 schema 类型冲突。
+- Cordis **4.0.4**、Include **1.0.9**、Loader **1.0.5**、Schemastery **3.18.4** 在上游未变，不盲目升级。Node 下限保持 `^22.19.0 || >=24.0.0`。
+- pnpm overrides 只控制本仓库开发/CI 依赖树，不会强制修改已安装宿主的其他插件依赖。部署应整套对齐 DSH 包，不混装 rc.1 和 rc.2。
+
+## API 与行为结论
+
+| 上游变化 | 本插件影响 / 处理 |
+| --- | --- |
+| Tools、Web、Settings、LLM 核心实现 | 两标签间只有包版本变化；沿用 Provider、动态配置、会话 projection 与冻结请求快照。 |
+| pi-ai 0.87.1 模型目录 | 内置 DeepSeek 目录使用 deepseek-flash，旧 deepseek-v4-flash / deepseek-v4-flash-vision-exp 被移除。跟随目录模式要求当前 ID；回归验证缺失 ID 不自动重写，显式私有路由保留原 ID。 |
+| ui-commands 模糊搜索、分组、PopupState 必填字段 | 本插件不手工构造 PopupState，也不替换内置弹窗；现有会话搜索选择器无需新增 props。 |
+| TypertGateway.hasLiveClient() | 不实现自定义 Gateway；集成测试使用 rc.2 原生 Gateway，避免旧实现混装。 |
+| timed ask_user_question 与迟到回答 | 不提供问答替代 UI/answerer，不把 pending 当授权；无需改变搜索业务。 |
+| 定时消息 framing | 本插件不创建提醒或向其嵌入外部搜索结果；无需修改。 |
+| OpenInAppAction、侧栏、Client inspect、Shell/ACL | 不调用这些变化接口或脚本，不受直接影响。 |
+| 插件升级和 Desktop profile | 已安装插件先卸载再安装；Desktop 先启动一次初始化 profile，并完全退出后执行 CLI。 |
+
+**不自动改写模型配置。** 上游 pi-ai 内置目录的 ID 变化不是所有 Provider 的全局改名。用户需检查默认模型、会话模型、modelOverrides 和子代理配置；私有端点应显式声明实际模型。能聊天不代表搜索连接可用：跟随模式仍需要 API Key 引用，不自动透传 OAuth/账号认证。
+
+## 配置与部署
+
+设置格式仍为 version 2，会话 Storage Domain 仍为 version 1；从 0.1.3–0.1.5 无需新增迁移。不重写宿主 Session 日志，不清空已有凭据或会话搜索选择。备份后先移除旧插件，再安装固定版本，审阅 profile 补丁，重载服务端并刷新 Web 页面。详见[升级指南](migration.zh-CN.md)。
+
+## 验证范围
+
+发布检查使用冻结锁文件，执行 TypeScript Host/Client 类型检查、两端构建、完整 Vitest 测试与真实 tarball 契约校验。新增断言覆盖全部锁定 DSH 包版本、跨包 Zod 解析一致性和 Flash ID 边界；既有集成测试覆盖原生/PTC 请求、Gateway/SessionController、搜索关闭/恢复、设置持久化、fork 与会话隔离。
+
+本次本地执行 `pnpm install --frozen-lockfile && pnpm run check` 退出 0：类型检查、两端构建、21 个测试文件 / 336 项测试和真实安装包契约全部通过。测试使用模拟网络及目录 fixture，不宣称已运行真实 pi-ai 模型或供应商请求。
+
+这些验证不代表升级了用户正在运行的 DSH 实例，也不等于对真实供应商联网、付费认证或 Desktop 原生环境完成验收。上游报告中的 Fetch/Undici 问题属于其他插件，本插件不新增 Undici 依赖。

package/docs/v2-implementation.zh-CN.md

@@ -1,12 +1,12 @@
-# 0.1.4 开发与验证指南
+# 0.1.6 开发与验证指南
 
 本文件保留原路径以避免断链，内容改为可重复的开发、验证与交付方法。架构见[当前架构](design-v2.converged.zh-CN.md)，用户使用见[配置参考](configuration.zh-CN.md)，版本升级见[升级指南](migration.zh-CN.md)。测试存在、测试通过、供应商在线可用、运行实例完成部署是四种不同结论，不能互相替代。
 
 ## 环境与开发入口
 
 - Node.js：`^22.19.0 || >=24.0.0`；pnpm：按 packageManager 使用 `11.7.0`。
-- DSH：包要求 `>=0.1.7-rc.2`，源码以 0.1.7-rc.2 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
-- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.4` 与 settings schema 的 `version: 2` 不同。
+- DSH：包要求 `>=0.2.0-rc.2`，源码以 0.2.0-rc.2 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
+- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.6` 与 settings schema 的 `version: 2` 不同。
 
 在仓库根执行：
 
@@ -56,7 +56,7 @@ node scripts/verify-package.mjs
 | [keyless-access.spec.ts](../tests/keyless-access.spec.ts) | 显式匿名 / 个人模式、官方地址限制、匿名不读 Key、拒绝不转付费 |
 | [protocols.spec.ts](../tests/protocols.spec.ts)、[provider.spec.ts](../tests/provider.spec.ts) | 三种模型协议、固定 provider 兼容辅助接口 |
 | [plugin.spec.ts](../tests/plugin.spec.ts)、[bundle.spec.ts](../tests/bundle.spec.ts)、[egress.spec.ts](../tests/egress.spec.ts) | 插件导出、bundle / patch 契约、fetchProvider 不受干扰、出站 transport |
-| [v2-client.spec.ts](../tests/v2-client.spec.ts)、[client-settings.spec.ts](../tests/client-settings.spec.ts) | 当前与兼容设置辅助逻辑、稀疏写入、凭据独立操作 |
+| [v2-client.spec.ts](../tests/v2-client.spec.ts) | 当前设置辅助逻辑、稀疏写入、凭据独立操作与多语言对齐 |
 | [settings-render.spec.ts](../tests/settings-render.spec.ts)、[selector-render.spec.ts](../tests/selector-render.spec.ts) | SSR 结构、折叠态、紧凑选择器、不可用项与状态 |
 | [client-injection.spec.ts](../tests/client-injection.spec.ts) | Remote 命名空间注入顺序和生命周期 |
 
@@ -101,7 +101,7 @@ preview-ui 写 `.dsh-smoke-home/settings-preview.html`，不会启动第二个 D
 
 1. 对最终待发提交运行 check 和所需浏览器 / 网络验证，记录版本与退出状态。
 2. 使用 `pnpm pack` 生成构建包；检查包版本、入口、声明、patch、README 与 docs 完整性。GitHub 自动 Source code archive 不是含 lib 的发行 tgz。
-3. 用户可用 `dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.4.tgz` 安装 Release 构建附件。
+3. 用户可用 `dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.6.tgz` 安装 Release 构建附件。
 4. Git 操作、远端分支调整、标签、Release 和 npm 发布分别需要授权与结果核验；不要把本地构建当作已发布。主线为 main，旧代码保留 legacy/v0.0.x，不需要把历史文档反复改成当前成功记录。
 5. 标签触发发布流程后，单独确认 workflow 和 npm registry 的版本 / 包内容，再宣称 npm 可安装。
 

package/lib/client.js

@@ -6217,7 +6217,7 @@ window.__ModuleLoader__.load({
 		const selectorCss = `
 /* Match DSH ModelSelect trigger/menu metrics and semantic theme tokens. */
 .v2s-selector { display:inline-flex; align-items:center; flex:none; min-width:0; font:inherit; }
-.v2s-search-trigger { display:flex; align-items:center; gap:4px; min-width:0; max-width:min(280px,45cqw); height:28px; padding:0 4px 0 8px; border:none; border-radius:24px; outline:none; background:transparent; color:var(--dsw-alias-label-secondary); font:inherit; font-size:13px; font-weight:500; line-height:20px; cursor:pointer; white-space:nowrap; }
+.v2s-search-trigger { display:flex; align-items:center; gap:4px; min-width:0; max-width:220px; max-width:min(360px,45cqw); height:28px; padding:0 4px 0 8px; border:none; border-radius:24px; outline:none; background:transparent; color:var(--dsw-alias-label-secondary); font:inherit; font-size:13px; font-weight:500; line-height:20px; cursor:pointer; white-space:nowrap; }
 .v2s-search-trigger:hover,.v2s-search-trigger[aria-expanded=true] { background:var(--dsw-alias-interactive-bg-hover); }
 .v2s-search-trigger:focus-visible { box-shadow:0 0 0 2px var(--dsw-alias-border-l3); }
 .v2s-search-trigger svg { flex:none; }
@@ -6230,8 +6230,19 @@ window.__ModuleLoader__.load({
 .v2s-search-busy { animation:v2s-search-pulse 1s ease-in-out infinite alternate; }
 @keyframes v2s-search-pulse { to { opacity:.35; } }
 @media(prefers-reduced-motion:reduce) { .v2s-search-busy { animation:none; } .v2s-search-chevron { transition:none; } }
+/* Match DSH conversation.input.model content-driven collapse via row variables on desktop. */
+.v2s-search-label,.v2s-search-mode { display:var(--dsh-composer-model-text-display,block); }
+:where([data-model-compact]) .v2s-search-label,:where([data-model-compact]) .v2s-search-mode { display:none; }
+/* Responsive auto-scaling for narrow containers and mobile viewports. */
 @container(width<=420px) { .v2s-search-mode { display:none; } }
 @container(width<=360px) { .v2s-search-label { display:none; } }
+@media (max-width:420px) { .v2s-search-mode { display:none; } }
+@media (max-width:360px) { .v2s-search-label { display:none; } }
+/* Auto-scaling adaptation under dsh-mobile grid layout. */
+:where([data-dsh-mobile-composer-row]) .v2s-selector,:where([data-dsh-mobile-composer-trailing]) .v2s-selector { flex:0 1 auto; min-width:0; max-width:min(100%,180px); }
+:where([data-dsh-mobile-composer-row]) .v2s-search-trigger,:where([data-dsh-mobile-composer-trailing]) .v2s-search-trigger { min-width:0; max-width:100%; }
+:where([data-dsh-mobile-composer-row]) .v2s-search-mode,:where([data-dsh-mobile-composer-trailing]) .v2s-search-mode { display:none; }
+:where([data-dsh-mobile-composer-row]) .v2s-search-label,:where([data-dsh-mobile-composer-trailing]) .v2s-search-label { min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
 .v2s-search-sr { position:absolute; width:1px; height:1px; padding:0; margin:-1px; overflow:hidden; clip-path:inset(50%); white-space:nowrap; border:0; }
 .v2s-selector-panel { position:fixed; inset:auto; margin:0; box-sizing:border-box; max-width:calc(100vw - 32px); padding:3px; overflow:auto; overscroll-behavior:contain; border:0; border-radius:16px; background:var(--dsw-specific-menu); backdrop-filter:var(--dsw-menu-backdrop-filter); color:var(--dsw-alias-label-primary); --dsw-elevation-stroke-color:var(--dsw-alias-border-l1); box-shadow:var(--dsw-elevation-prominent); --dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2); --dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2); font-family:inherit; font-size:13px; line-height:20px; }
 .v2s-selector-panel:not(:popover-open) { display:none; }
@@ -6425,7 +6436,7 @@ window.__ModuleLoader__.load({
 			const [open, setOpen] = (0, react.useState)(false);
 			const selected = value?.selection.connectionId;
 			const current = connections.find((c) => c.id === selected);
-			const label = !value ? t("search") : current?.id === "builtin:session-model" ? t("followModel") : current?.label ?? (selected ? t("connectionUnavailable") : t("selectSearch"));
+			const label = !value ? t("search") : selected === null ? t("searchOff") : current?.id === "builtin:session-model" ? t("followModel") : current?.label ?? (selected ? t("connectionUnavailable") : t("selectSearch"));
 			(0, react.useEffect)(() => {
 				const node = panel.current;
 				if (!node) return;
@@ -6472,7 +6483,7 @@ window.__ModuleLoader__.load({
 						"aria-expanded": open,
 						"aria-controls": id,
 						"data-state": error ? "error" : pending ? "saving" : notice ? "saved" : "ready",
-						title: error || (pending ? t("saving") : notice || t("searchConnection") + (current?.label ?? t("notSelected"))),
+						title: error || (pending ? t("saving") : notice || (selected === null ? t("searchConnection") + t("searchOff") : t("searchConnection") + (current?.label ?? t("notSelected")))),
 						onClick: toggle,
 						children: [
 							(0, react_jsx_runtime.jsxs)("svg", {
@@ -6494,7 +6505,7 @@ window.__ModuleLoader__.load({
 								className: "v2s-search-label",
 								children: label
 							}),
-							value ? (0, react_jsx_runtime.jsx)("span", {
+							value && selected !== null ? (0, react_jsx_runtime.jsx)("span", {
 								className: "v2s-search-mode",
 								children: t(value.freshness === "auto" ? "freshnessAuto" : value.freshness === "fresh" ? "freshnessFreshShort" : "freshnessRealtimeShort")
 							}) : null,
@@ -6552,6 +6563,24 @@ window.__ModuleLoader__.load({
 							items[event.key === "Home" ? 0 : event.key === "End" ? items.length - 1 : (index + (event.key === "ArrowUp" ? -1 : 1) + items.length) % items.length]?.focus();
 						},
 						children: [
+							(0, react_jsx_runtime.jsx)("div", {
+								role: "group",
+								"aria-label": t("searchOff"),
+								children: (0, react_jsx_runtime.jsxs)("button", {
+									type: "button",
+									className: "v2s-search-option",
+									disabled: !value || pending,
+									"aria-pressed": selected === null,
+									onClick: () => {
+										if (selected !== null) onSelect(null);
+									},
+									children: [(0, react_jsx_runtime.jsx)("span", { children: t("searchOff") }), (0, react_jsx_runtime.jsx)("span", {
+										className: "v2s-search-option-check",
+										"aria-hidden": "true",
+										children: selected === null ? "✓" : ""
+									})]
+								})
+							}),
 							["model", "structured"].filter((kind) => connections.some((c) => c.kind === kind && c.configured)).map((kind) => (0, react_jsx_runtime.jsxs)("div", {
 								role: "group",
 								"aria-label": t(kind === "model" ? "modelSearch" : "searchServices"),
@@ -6589,7 +6618,7 @@ window.__ModuleLoader__.load({
 									].map((mode) => (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
 										"aria-pressed": value?.freshness === mode,
-										disabled: !value || pending,
+										disabled: !value || pending || selected === null,
 										onClick: () => {
 											if (value?.freshness !== mode) onFreshness(mode);
 										},
@@ -12444,6 +12473,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			followModel: "Follow model",
 			connectionUnavailable: "Connection unavailable",
 			selectSearch: "Select search",
+			searchOff: "Off",
 			searchConnection: "Search connection: ",
 			notSelected: "Not selected",
 			sessionSearchSettings: "Current session search settings",
@@ -12527,6 +12557,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			followModel: "跟随模型",
 			connectionUnavailable: "连接失效",
 			selectSearch: "选择搜索",
+			searchOff: "关闭",
 			searchConnection: "搜索连接：",
 			notSelected: "未选择",
 			sessionSearchSettings: "当前会话搜索设置",