dsh-web-fetch-enhanced 0.0.7 → 0.0.8

package/README.en.md

@@ -35,7 +35,8 @@ With an empty CIDR allowlist, the security boundary remains equivalent to the na
 
 ## Compatibility & Support Policy
 
-- **Minimum Supported DSH Version**: `0.1.7-rc.1`
+- **Minimum Supported DSH Version**: `0.1.7-rc.2`
+- **v0.0.8 update**: [Compatibility assessment and release notes](docs/releases/0.0.8.md).
 - **Support Policy**: This plugin **only supports DeepSeek Harness RC (Release Candidate) releases and future stable releases**. Compatibility is not maintained for rapid-moving Alpha or development snapshot versions.
 
 ## Quick start

package/README.md

@@ -35,7 +35,8 @@ DeepSeek Harness 原生 HTTP provider 默认拒绝所有非公网地址，这是
 
 ## 版本兼容性与支持策略
 
-- **最低支持的 DSH 版本**：`0.1.7-rc.1`
+- **最低支持的 DSH 版本**：`0.1.7-rc.2`
+- **v0.0.8 更新**：[上游兼容性评估与发布说明](docs/releases/0.0.8.md)。
 - **版本支持策略**：本插件**仅对 DeepSeek Harness 的 RC（Release Candidate）候选发布版本及后续稳定正式版提供支持**。由于 Alpha 或开发快照版本更迭频繁且缺乏稳定的 API 保证，本插件不再对 Alpha 等非 RC 阶段版本进行维护与适配。
 
 ## 快速开始

package/docs/design.zh-CN.md

@@ -138,7 +138,7 @@ Cordis Config schema 提供所有默认值；<code>createProvider()</code> 也
 
 ## 8. 兼容策略
 
-最低支持 DSH `0.1.7-rc.1`，DSH peers 声明 `>=0.1.7-rc.1 <0.2.0`，开发依赖固定为经过验证的 rc.1。使用 web、timeout、http-proxy、system-prompt、Cordis Loader 与客户端插件管理/配置表单的公开导出，不依赖 DSH 包的 `src/*` 深路径。安全 transport 在本包内维护，相关行为通过契约测试固定。
+最低支持 DSH `0.1.7-rc.2`，DSH peers 声明 `>=0.1.7-rc.2 <0.2.0`，开发依赖固定为经过验证的 rc.2。使用 web、timeout、http-proxy、system-prompt、Cordis Loader 与客户端插件管理/配置表单的公开导出，不依赖 DSH 包的 `src/*` 深路径。安全 transport 在本包内维护，相关行为通过契约测试固定。
 
 版本升级时重点回归：
 

package/docs/releases/0.0.8.md

@@ -0,0 +1,37 @@
+# v0.0.8
+
+## 兼容性与版本要求
+
+- 最低支持 DeepSeek Harness **0.1.7-rc.2**，`engines.dsh` 与全部 DSH peer 范围统一为 `>=0.1.7-rc.2 <0.2.0`。
+- DSH 开发依赖固定为 `0.1.7-rc.2`，同步更新 pnpm 锁文件与精确版本的 minimumReleaseAgeExclude。
+- 版本门槛测试在默认 semver 语义和 `includePrerelease: true` 下均拒绝 rc.1，接受 rc.2、同一版本的后续 RC 和 0.1.7 正式版。
+
+## 上游 rc.1 → rc.2 影响评估
+
+以版本更新分析为线索，核对上游 `dsh-v0.1.7-rc.1` → `dsh-v0.1.7-rc.2`（`477b4f4205`）相关源码差异及本插件实际使用的接口。结论：**未发现需要修改本插件业务代码的破坏性变更，升级风险较低**；这不等于对所有部署场景作零风险保证。
+
+| 上游变化 / 集成点 | 对本插件的影响 |
+| --- | --- |
+| `web`、原生 HTTP provider、`http-proxy`、`timeout` | 相关源码未变；`WebFetchProvider`、`WebFetchResult`、`WebError`、代理路由与超时接口无需迁移。自维护的 SSRF、DNS 固定、重定向和资源限制逻辑保持不变。 |
+| 动态工具更新与历史投影 | 本插件不自行注册模型工具或修改工具历史，只通过 `ctx.web.registerFetchProvider` 为现有 `web_fetch` 提供实现；无需接入新的工具历史 API。 |
+| 系统提示词精简 | 上游 `web_fetch` 提示文案缩短，仍保留外部内容不可信的边界。`system-prompt` 源码未变，本插件的授权 section 与 `system-prompt/change` 通知无需修改。 |
+| 插件管理页导航重构 | 上游新增导航服务和 `layout` 依赖，但保留 `plugins.bundle.config` 槽位；本插件不直接实例化上游页面，使用的 `configForms` 与表单接口无需迁移。自定义最小 Host 组合仍需满足上游插件自身依赖。 |
+| 设置页、快捷键及样式调整 | 设置启动器的新增属性不属于本插件使用的表单契约；本插件不接入快捷键服务。无需修改配置表单。 |
+| DeepSeek Provider 拆包、schedule 重写、模型选择校验、审批扩展 | 本插件未使用旧 LLM 插件、schedule API、`selectModel` 或 `PreToolDecision`，无直接迁移工作。 |
+| schedule / time-context 默认状态调整 | 本插件不依赖这些服务，不影响抓取和白名单配置。 |
+
+## 升级方式
+
+1. 先将 Host 升级至兼容的 DSH `0.1.7-rc.2` 或更高版本，再升级插件至 v0.0.8。
+2. 从 v0.0.7 升级无需迁移配置；现有 Profile 白名单和资源限制继续生效。更早版本的全局配置仍需按[历史迁移说明](../migration-0.1.7-rc.1.zh-CN.md)处理，但目标 Host 须满足本次新门槛。
+3. 升级后重启 Host 并刷新 Web 页面。日常白名单保存仍无需重启。
+
+## 验证结果
+
+使用 rc.2 npm 依赖运行 `pnpm run check`，退出码为 0：类型检查通过，lint 为 0 警告 / 0 错误，Host / Client 构建成功，13 个测试文件、100 项测试全部通过。
+
+`publint` 完成，但提示 client 导出在 ESM 包内使用 CJS 格式。这源于现有 DSH `window.__ModuleLoader__` factory 包装，非本次版本更新引入；构建产物的 ModuleLoader 注册测试通过，本次未更改打包契约。未对真实浏览器页面执行端到端验收，也未重启或修改运行中的用户 Profile。
+
+## English
+
+v0.0.8 raises the minimum DSH version to **0.1.7-rc.2**, with engine and DSH peer ranges set to `>=0.1.7-rc.2 <0.2.0` and development dependencies pinned to rc.2. Reviewing the upstream release diff found no breaking change requiring plugin implementation changes: fetch/proxy/timeout and system-prompt interfaces remain compatible, and the plugin configuration slot survives the navigation refactor. The plugin does not use the changed LLM, schedule, model-selection, or admission APIs. No configuration migration is required from v0.0.7. Upgrade DSH first, then restart the Host and refresh the browser after upgrading the plugin.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-web-fetch-enhanced",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Configurable non-public address allowlists for DeepSeek Harness web_fetch",
   "type": "module",
   "main": "./lib/index.js",
@@ -66,20 +66,20 @@
   },
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.7-rc.1 <0.2.0"
+    "dsh": ">=0.1.7-rc.2 <0.2.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-http-proxy": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-timeout": ">=0.1.7-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-web": ">=0.1.7-rc.1 <0.2.0"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-http-proxy": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-timeout": ">=0.1.7-rc.2 <0.2.0",
+    "@deepseek-ai/dsh-web": ">=0.1.7-rc.2 <0.2.0"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
@@ -89,15 +89,15 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-http-proxy": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-timeout": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-web": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-http-proxy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-web": "0.1.7-rc.2",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.19.13",
     "@types/react": "~18.3.1",