dsh-web-search-enhanced 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 记录 `dsh-web-search-enhanced` 的用户可见变化。历史条目描述对应版本，不代表当前行为。
 
+## [Unreleased]
+
+## [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 兼容性
+
+- 最低宿主版本提升至 `0.1.7-rc.2`；DSH peer 依赖下限、精确开发依赖、锁文件及预发布安装白名单同步对齐。
+- 核对动态工具更新、DeepSeek Provider 拆包、模型选择校验、Schedule 与审批变更；插件不调用 selectModel，不依赖被移除的 Schedule API，无需修改搜索运行时代码。
+- 跟随模型仍仅支持可解析的 API Key 路由，不因宿主支持官方账号而自动支持账号 / OAuth 搜索；固定连接及结构化搜索不受模型选择校验影响。
+- 设置格式 version 2、会话 Storage Domain version 1 保持不变；完整边界见 [rc.2 影响评估](docs/upstream-0.1.7-rc.2-assessment.zh-CN.md)。
+
+### 搜索选择器请求优化
+
+- 移除每 2 秒常驻轮询；首次加载、模型实际变化、展开菜单及页面恢复可见/焦点时按需读取，关闭菜单和普通重渲染不请求。
+- 增加按会话隔离的 30 秒客户端缓存与并发请求合并，最多保留 64 个空闲会话项；TTL 到期本身不会触发请求。
+- 写入成功直接复用返回值；手动重试和写入冲突刷新绕过缓存，模型/配置失效发生在请求期间时合并补读，防止旧响应覆盖新状态。
+- 插件配置变化及本插件保存凭据后使缓存失效；连接断开/重建与插件卸载清理缓存并隔离旧请求。
+- 本阶段不增加服务端推送：其他窗口的修改在后续缓存过期的按需刷新时同步，不再保证两秒内自动同步；版本冲突保护保留。
+
 ## [0.1.3] - 2026-09-24
 
 ### 界面细节对齐

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.1%2B-536DFE?style=flat-square)](package.json)
+[![DSH](https://img.shields.io/badge/DSH-0.2.0--rc.1%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,27 +60,27 @@
 
 ### 环境要求
 
-- **DeepSeek Harness**：≥ `0.1.7-rc.1`
+- **DeepSeek Harness**：≥ `0.2.0-rc.1`
 - **Node.js**：`^22.19.0 || >=24.0.0`
 
-本版已对齐 DSH 0.1.7-rc.1 的动态配置、插件设置页和会话 projection 架构，详见[上游适配记录](docs/upstream-0.1.7-adaptation.zh-CN.md)。升级前请备份 profile 和旧设置。
+本版将 DSH 基线提升到 0.2.0-rc.1，保留动态配置、插件设置页和会话 projection 架构，无需新的配置或存储迁移。原生搜索新增的 DeepSeek 账号认证不会自动用于本插件；跟随模型仍要求 API Key。详见[0.2.0-rc.1 影响评估](docs/upstream-0.2.0-rc.1-assessment.zh-CN.md)。升级前请备份 profile 和旧设置。
 
 ### 步骤 1：安装插件
 
 **方式 A：通过 GitHub Release 离线包安装（推荐）**
 
-当前版本为 **0.1.3**，最低支持 **DSH 0.1.7-rc.1**。从 [v0.1.3 Release](https://github.com/Yurzi/dsh-web-search-enhanced/releases/tag/v0.1.3) 下载安装包及 SHA256 校验文件；也可执行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack` 自行构建。使用绝对路径安装：
+当前版本为 **0.1.5**，最低支持 **DSH 0.2.0-rc.1**。发布后可从 [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.3.tgz
+dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.5.tgz
 ```
 
 **方式 B：通过 npm 在线安装**
 
-也可从 npm 直接安装：
+该版本发布到 npm 后，也可直接安装：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.3
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.5
 ```
 
 ### 步骤 2：生效与刷新
@@ -200,7 +200,7 @@ _注：实时抓取可能会稍微增加检索耗时与额度消耗；对于不
 | 文档                                                     | 适合谁读            | 主要内容                                                          |
 | :------------------------------------------------------- | :------------------ | :---------------------------------------------------------------- |
 | 📘 **[配置指南](docs/configuration.zh-CN.md)**           | 所有用户 / 进阶用户 | 完整参数列表、凭据机制、高级 options 白名单、自定义端点与排错字典 |
-| 📙 **[升级指南](docs/migration.zh-CN.md)**               | 从旧版升级的老用户  | 0.1.7 宿主适配、旧版导入指引、升级踩坑预防                        |
+| 📙 **[升级指南](docs/migration.zh-CN.md)**               | 从旧版升级的老用户  | 0.2.0-rc.1 宿主适配、旧版导入指引、升级踩坑预防                        |
 | 📗 **[架构设计说明](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.3 配置参考
+# 0.1.5 配置参考
 
-本指南面向安装版插件。包版本为 **0.1.3**，配置格式的 `version` 为 **2**；两者不是同一版本号。快速开始见 [README](../README.md)，旧版用户先读[升级指南](migration.zh-CN.md)。
+本指南面向安装版插件。包版本为 **0.1.5**，配置格式的 `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.1 的 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.3 当前架构与实现边界
+# 0.1.5 当前架构与实现边界
 
 本文描述已存在的源码契约，不是未来设计提案或历史验收记录。为避免外部链接失效，保留原文件名。用户配置见[配置参考](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.3。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
+当前设置格式为 version 2，包版本为 0.1.5。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
 
 内置结构化连接不能重定向地址或改变 adapter。自定义结构化连接只能使用个人 Key；固定模型总是需要显式信任。校验拒绝任意 headers/body、缓存参数、秘密字段等不受支持的 options。禁用连接也参与配置校验。
 

package/docs/migration.zh-CN.md

@@ -1,10 +1,10 @@
-# 升级到 0.1.3 / DSH 0.1.7-rc.1
+# 升级到 0.1.5 / DSH 0.2.0-rc.1
 
-0.1.3 将最低宿主版本提高为 **0.1.7-rc.1**，对齐 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.3、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
+0.1.5 将最低宿主版本提高为 **0.2.0-rc.1**，沿用 0.1.3 已完成的 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC 适配。从 0.1.3 / 0.1.4 升级不需要新的配置或存储迁移；详见 [0.2.0-rc.1 影响评估](upstream-0.2.0-rc.1-assessment.zh-CN.md)。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.5、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
 
 ## 1. 升级前准备
 
-- 确认 DSH 满足 `>=0.1.7-rc.1`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.1.7-rc.1 契约，不代表对所有未来宿主版本均完成验证。
+- 确认 DSH 满足 `>=0.2.0-rc.1`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.2.0-rc.1 契约，不代表对所有未来宿主版本均完成验证。
 - 备份当前插件版本、Web profile / 插件配置和 DSH 持久存储。凭据使用宿主安全备份方式，不复制到公开 Issue 或仓库。
 - 记录旧 `modelMode`、协议、模型、endpoint、凭据引用，以及希望保留的会话选择。
 - 推荐升级前先将明文 `apiKey` 移到 DSH Credentials 并从配置来源删除。兼容导入仅允许旧格式短暂携带 Key：先验证转换结果，再写 Credentials，最后 CAS 替换 profile 配置。V2 配置仍拒绝明文 Key；已有不同值的同名凭据不会被自动覆盖。
@@ -12,23 +12,23 @@
 
 ## 2. 安装发行包
 
-从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.3 构建包。使用绝对路径交给 DSH 插件管理器：
+从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.5 构建包。使用绝对路径交给 DSH 插件管理器：
 
 ```sh
-dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.3.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.5.tgz
 ```
 
 若该版本已在 npm 发布，也可安装固定版本：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.3
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.5
 ```
 
 发布附件中的构建 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.1.7-rc.2-assessment.zh-CN.md

@@ -0,0 +1,35 @@
+# DSH 0.1.7-rc.2 对插件 0.1.4 的影响评估
+
+## 范围与结论
+
+根据上游 rc.1 → rc.2 版本分析，逐项核对本插件实际调用路径，并将开发依赖切换到发布的 rc.2 包验证。上游范围为 [dsh-v0.1.7-rc.1 … dsh-v0.1.7-rc.2](https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.1.7-rc.1...dsh-v0.1.7-rc.2)。本文不是对上游全部提交的重新审计。
+
+结论：升级风险低，未发现需要修改本插件运行时代码的直接破坏性变更；跟随模型存在原有认证与私有 adapter 兼容边界，不能据此承诺所有 Provider 均可搜索。
+
+- 插件：`0.1.3` → `0.1.4`（patch）。
+- 最低 DSH：`>=0.1.7-rc.2`；DSH peer 范围：`^0.1.7-rc.2`；直接 DSH 开发依赖：精确 `0.1.7-rc.2`。
+- 设置格式仍为 version 2，Storage Domain 仍为 version 1，不重写宿主会话历史。
+- 原 Unreleased 中的选择器按需刷新、缓存与并发合并优化一并归入 0.1.4。
+
+## 逐项影响
+
+| 上游变化 | 插件实际依赖与结论 |
+| --- | --- |
+| 动态工具增删、ToolHistory 与历史投影 | [bridge](../src/dsh/bridge.ts) 只注册 `enhanced-search` Web provider，使用 `agent/request` 和 `tools/execute` 捕获请求上下文；不构造工具增删消息、不重写历史。继续由宿主原生 `web_search` 和 PTC 链执行，无需自行接入投影协议。 |
+| DeepSeek Provider 拆分为 API Key / Account 插件 | 依赖、测试和 [安装补丁](../cordis.patch.yml) 均不把旧 `dsh-llm-deepseek` 作为 Cordis 插件加载。补丁中的 `web-search-deepseek` 是原生搜索插件条目，不是被拆分的 LLM 插件，不能误改成新 Provider 包名。用户自行维护的宿主 profile 仍需按上游规则迁移。 |
+| `selectModel` 严格校验 `listModels` | 插件不调用 `selectModel`，也不通过切换聊天模型执行辅助搜索。[跟随模型](../src/dsh/session-model.ts) 读取实际请求头与公开配置目录；固定模型直接使用显式 binding。因此不是所有固定搜索模型都要注册到宿主。用户切换聊天模型时则须确保模型在宿主目录中，否则会先被宿主拒绝。 |
+| Schedule 存储导出删除、默认禁用 schedule/time-context | 插件不依赖 Schedule 或时间上下文服务。自身选择存储通过 Storage Domain，不涉及计划任务存储；实时性参数是缓存年龄偏好，也不依赖注入时钟。 |
+| `PreToolDecision.displayReason`、Auto Review 调整 | 插件不构造该准入决策，不接管审批；`tools/execute` 钩子继续调用 next，保留宿主授权与审批链。新增可选展示字段无需适配。 |
+| 快捷键中心、代码语言与系统提示词调整 | 插件不导入旧快捷键内部 API、不使用代码语言内部模块、不解析系统提示词。设置页、会话 projection 与插件配置槽的类型和构建由 rc.2 依赖验证；不能以编译通过替代真实 GUI 验收。 |
+
+## 跟随模型边界
+
+[session-model.ts](../src/dsh/session-model.ts) 仍通过 `listConfigurableProviders()` 的 settings namespace/path 获取非秘密路由信息，要求受支持的 HTTP 协议、endpoint 和显式 `apiKeyEnv`。官方账号、OAuth、订阅凭据不会被重建或借用。新官方 API Key Provider 也不能仅因包名包含 API Key 就视为自动兼容，仍须满足这些路由条件。
+
+adapter identity 的 `registration()` 及可选 pi-ai catalog 是原有兼容 shim，并非稳定公共契约；缺失或发生替换时保持 fail-closed，不隐式改用其他连接或凭据。遇到跟随不可用可显式选择内置结构化连接或受支持的固定搜索连接。
+
+## 升级与验收
+
+先升级 DSH，再安装 0.1.4，重新加载服务端插件并刷新 Web 页面。从 0.1.3 升级应保留连接选择、凭据和实时性偏好，无需清空存储。选择器不再常驻两秒轮询；跨窗口修改在后续缓存过期的按需刷新时同步。
+
+本次验证通过：冻结锁文件安装、TypeScript 类型检查、服务端 / 客户端构建、22 个测试文件共 339 项测试，以及 0.1.4 实际打包契约检查。执行命令为 `PNPM_HOME="$PWD/.pnpm-home" pnpm install --frozen-lockfile` 与 `PNPM_HOME="$PWD/.pnpm-home" pnpm run check`；显式设置工作区 PNPM_HOME 是为解决本机默认 pnpm 状态数据库打开失败，不是插件运行要求。自动测试使用模拟网络，不证明外部搜索服务实时可用；本次版本更新不等于 npm/GitHub 发布，也不等于运行中的 DSH 已安装新版本。

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/v2-implementation.zh-CN.md

@@ -1,12 +1,12 @@
-# 0.1.3 开发与验证指南
+# 0.1.5 开发与验证指南
 
 本文件保留原路径以避免断链，内容改为可重复的开发、验证与交付方法。架构见[当前架构](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.1`，源码以 0.1.7-rc.1 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
-- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.3` 与 settings schema 的 `version: 2` 不同。
+- DSH：包要求 `>=0.2.0-rc.1`，源码以 0.2.0-rc.1 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
+- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.5` 与 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.3.tgz` 安装 Release 构建附件。
+3. 用户可用 `dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.5.tgz` 安装 Release 构建附件。
 4. Git 操作、远端分支调整、标签、Release 和 npm 发布分别需要授权与结果核验；不要把本地构建当作已发布。主线为 main，旧代码保留 legacy/v0.0.x，不需要把历史文档反复改成当前成功记录。
 5. 标签触发发布流程后，单独确认 workflow 和 npm registry 的版本 / 包内容，再宣称 npm 可安装。