@inventec/dsh-onetree-log 0.1.4 → 0.1.6

package/README.md

@@ -81,6 +81,22 @@ node scripts/e2e.mjs           # 宿主半身端到端
 无构建步骤：`lib/` 即发布产物（与 dsh-surf / dsh-obmc-web 一致的薄插件风格）。
 宿主半身需要 Node ≥22.15（zlib 原生 zstd；旧版本自动回退系统 `zstd -dc`）。
 
+## DSH 版本兼容
+
+- **版本门槛**：`0.2.1` 及以上宿主需 **≥0.1.4**——0.2.1 起宿主移除 `webRuntime`
+  服务（改名 `webStartup`），0.1.0–0.1.3 在其上会静默失效（插件 pending、路由
+  404）。≥0.1.4 采用非抛双服务解析（`webStartup` → `webRuntime` → `[]`），在
+  `0.1.x`–`0.2.1-rc.x` 宿主全线可用。本包不声明 `@deepseek-ai/dsh` 家族 peer，
+  宿主版本守卫对其不设门槛，兼容范围以本节与市场文案为准。
+- **依赖的宿主契约面**：`webServer.register`（prefix 路由）、客户端
+  `settings.section` slot、`slots` 客户端服务、`window.__ModuleLoader__` 启动
+  契约。数据自持在插件自有目录（`ONETREE_LOG_DIR` 可覆盖），不触宿主
+  settings/credentials。
+- **失效模式**：契约若在后续宿主版本变更，症状为设置面板消失（客户端 console
+  报错）或路由 404，不会损坏宿主、不会波及已落盘的 dumps 数据。
+- **实测口径**：DSH `0.2.1-rc.2` web 实例 link 装机即线上，`GET /onetree-log/dumps`
+  200（2026-10-19 复核）；源码级适配审计对照 `0.2.1-rc.2` 宿主逐点核证。
+
 ## 发版
 
 npm 包走 GitHub Actions OIDC Trusted Publishing（无静态 token，自带 provenance）：

package/icon.svg

@@ -0,0 +1,20 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="dsh-onetree-log">
+  <!-- dsh-onetree-log：原木横截面年轮（log 双关 = 日志），
+       三圈年轮蓝青相间 + 轮上木结 = OneTree dump 日志剖析 -->
+  <circle cx="18" cy="18" r="12.2" stroke="url(#b)" stroke-width="2.7" fill="none"/>
+  <circle cx="18" cy="18" r="7.9" stroke="url(#t)" stroke-width="2.4" fill="none" opacity="0.9"/>
+  <circle cx="18" cy="18" r="3.6" stroke="url(#b)" stroke-width="2.2" fill="none" opacity="0.95"/>
+  <circle cx="18" cy="18" r="1.2" fill="url(#t)"/>
+  <circle cx="21.8" cy="10.6" r="1.25" fill="url(#t)"/>
+  <path d="M24.6 11.4L28.6 7.4" stroke="url(#b)" stroke-width="2.4" stroke-linecap="round"/>
+  <defs>
+    <linearGradient id="b" x1="5.8" y1="5.8" x2="30.2" y2="30.2" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#69B9FF"/>
+      <stop offset="1" stop-color="#324DE2"/>
+    </linearGradient>
+    <linearGradient id="t" x1="10.1" y1="10.1" x2="25.9" y2="25.9" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#45E7A4"/>
+      <stop offset="1" stop-color="#05909D"/>
+    </linearGradient>
+  </defs>
+</svg>

package/lib/index.js

@@ -23,7 +23,7 @@ import { pipeline } from 'node:stream/promises'
 import { DumpStore } from './store.js'
 
 export const name = '@inventec/dsh-onetree-log'
-export const inject = ['webServer'] /* LOCAL-PATCH 2026-10-18 (know-how 035): 0.2.1 host removed webRuntime (→webStartup); trusted-hosts now resolved per-request via non-throwing dual-service fallback */
+export const inject = ['webServer'] /* compat (know-how 035, shipped since 0.1.4): 0.2.1 host removed webRuntime (→webStartup); trusted-hosts now resolved per-request via non-throwing dual-service fallback */
 
 const MAX_UPLOAD_BYTES = 512 * 1024 * 1024
 const PREVIEW_BYTES = 256 * 1024
@@ -247,7 +247,7 @@ export function apply(ctx) {
   store = new DumpStore()
   ctx.logger?.info?.(`[dsh-onetree-log] store at ${store.dumpsDir}，已登记 ${store.list().length} 个 dump`)
 
-  /* LOCAL-PATCH 2026-10-18 (know-how 035): was `ctx.webRuntime?.trustedHosts` (0.2.1 host removed webRuntime; cordis Local throws on un-injected property access, `?.` cannot protect). 034 pattern: non-throwing ctx.get lookup, webStartup (0.2.1+) → webRuntime (≤0.2.0) → []. */
+  /* compat (know-how 035, shipped since 0.1.4): was `ctx.webRuntime?.trustedHosts` (0.2.1 host removed webRuntime; cordis Local throws on un-injected property access, `?.` cannot protect). 034 pattern: non-throwing ctx.get lookup, webStartup (0.2.1+) → webRuntime (≤0.2.0) → []. */
   const resolveTrustedHosts = () => {
     let startup, runtime
     try { startup = ctx?.get?.('webStartup') } catch {}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@inventec/dsh-onetree-log",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "AMI MegaRAC OneTree 一键日志（OpenBMC dreport dump）上传与分析框架：设置面板「OneTree 日志」上传压缩包或登记服务器本地路径，安全解包、自动探测 dump 根、文件清单分类，为第二阶段逐域解析提供内核。",
+  "icon": "./icon.svg",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -13,7 +14,8 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "icon.svg"
   ],
   "license": "MIT",
   "author": "iasiv5",