@iasiv5/dsh-obmc-web 0.1.4 → 0.1.6

package/README.md

@@ -1,7 +1,7 @@
 # @iasiv5/dsh-obmc-web
 
 在 DSH GUI 里使用 **BMC Web UI**（OpenBMC / bmcweb，AST2700 EVB 实测；
-插件本体于 DSH Web `0.1.7-rc.2` 实测）。
+插件本体于 DSH Web `0.1.7-rc.2` 与 `0.2.1-rc.2` 实测）。
 host 半身在 DSH web 服务器的 GUI origin 上注册一组同源代理路由，经
 `obmc-web-relay.service`（SSH 本地转发，仅绑 `127.0.0.1`，端口默认
 18443、被占自动顺延）抵达 BMC；client 半身仿照 dsh-surf，在「设置」
@@ -44,6 +44,20 @@ hash 模式，因此挂在 `/bmc` 前缀下不会与 SPA 内部导航冲突。DS
 按「精确表优先、前缀最长者胜」分发，GUI 自身的路由永远优先；重复注册只
 跳过、不会让插件失败。
 
+## 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/registerUpgrade`（exact/prefix、
+  最长前缀分发）、客户端 `settings.section` slot、`slots` 客户端服务、
+  `window.__ModuleLoader__` 启动契约。配置走自有 `/bmc-config` 路由持久化，
+  不触宿主 settings/credentials。
+- **失效模式**：契约若在后续宿主版本变更，症状为设置面板消失（客户端 console
+  报错）或路由 404，不会损坏宿主、不会无声改写数据。
+
 ## 安装
 
 ```bash
@@ -157,3 +171,12 @@ bootstrap），地址仍会写入配置并提示下一步去点「安装并启
 ## License
 
 [MIT](./LICENSE)
+
+## Trademarks
+
+`icon.svg` 复用 OpenBMC 项目的官方 logo（圆形徽记，去除字标）。OpenBMC 及其
+logo 版权归 OpenBMC community 所有，以
+[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 发布（来源：
+[openbmc/webui-vue](https://github.com/openbmc/webui-vue)）。此处使用仅用于
+标识与本插件所对接的 OpenBMC 生态的兼容性，不构成 OpenBMC 项目对本插件的
+背书；OpenBMC 相关名称与标识的权利归属其各自所有者。

package/icon.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="12.2 -25.4 215 215" role="img" aria-label="dsh-obmc-web">
+  <!-- dsh-obmc-web：直接复用 OpenBMC 官方 logo 的圆形徽记本体（去除字标与注册商标符号）。
+       来源：https://github.com/openbmc/webui-vue (docs/.vuepress/public/openbmc-logo.svg)
+       Copyright © OpenBMC community，Apache License 2.0（https://www.apache.org/licenses/LICENSE-2.0）。
+       路径与渐变未做任何修改；仅通过 viewBox 留白把徽记视觉直径校准到 ≈27.5/36，
+       与 onetree-log（27.1）、quota-watch（26.6）等圆形图标一致。原版全量存档：./reference/openbmc-logo.svg -->
+  <title>OpenBMC</title>
+  <defs>
+    <style>.cls-2{fill:url(#linear-gradient);}.cls-3{fill:url(#linear-gradient-2);}.cls-4{fill:url(#linear-gradient-3);}.cls-5{fill:url(#linear-gradient-4);}</style>
+    <linearGradient id="linear-gradient" x1="82.9" y1="11.55" x2="82.9" y2="154.54" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#00b0da"/><stop offset="1" stop-color="#008abf"/></linearGradient>
+    <linearGradient id="linear-gradient-2" x1="81.55" y1="27.55" x2="81.55" y2="158.66" xlink:href="#linear-gradient"/>
+    <linearGradient id="linear-gradient-3" x1="156.66" y1="51.54" x2="156.66" y2="154.8" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#a5d440"/><stop offset="1" stop-color="#8cce3f"/></linearGradient>
+    <linearGradient id="linear-gradient-4" x1="158.41" y1="51.54" x2="158.41" y2="154.8" xlink:href="#linear-gradient-3"/>
+  </defs>
+  <path class="cls-2" d="M65.85,81.86a53.68,53.68,0,0,0,11.61,33.41c-.1.29-.15.6-.22.9a10.81,10.81,0,0,0-.34,2.57,11,11,0,1,0,11-11,10.75,10.75,0,0,0-1.2.07c-.31,0-.61.08-.91.13A42.82,42.82,0,0,1,99.95,43.86h0V2.07l-.77.21q-3.63.94-7.12,2.2c-1.29.47-2.58,1-3.84,1.48h0V38.19l-.13.1A53.79,53.79,0,0,0,65.85,81.86Z"/>
+  <path class="cls-3" d="M120.28,96.58a14.54,14.54,0,0,1-14.55-14.37H93.59v0a26.29,26.29,0,0,0,21,25.65v45.35A71.13,71.13,0,0,1,63.9,38.1c.31.06.63.1,1,.13s.64,0,1,0a10.83,10.83,0,1,0-10.25-7.41,82.23,82.23,0,0,0,64.18,133.6c1.41,0,2.81-.06,4.2-.14l1.63-.09h0V95.57A14.47,14.47,0,0,1,120.28,96.58Z"/>
+  <path class="cls-4" d="M171.95,68.54a53.78,53.78,0,0,0-9.85-19.71,11.31,11.31,0,0,0,.32-1.3,10.78,10.78,0,0,0,.24-2.17,11,11,0,1,0-8.89,10.8,42.83,42.83,0,0,1-14.17,64.08V162c1.08-.27,2.14-.56,3.2-.87a82.35,82.35,0,0,0,8.53-3V125.91a53.91,53.91,0,0,0,20.6-57.37Z"/>
+  <path class="cls-5" d="M184.63,132.75A82.21,82.21,0,0,0,119.79,0c-1.64,0-3.26.06-4.87.16h-.11V68.55h0A14.53,14.53,0,0,1,120,67.48h.27A14.56,14.56,0,0,1,134.87,82s0,.07,0,.11,0,.08,0,.13h11.08A26.21,26.21,0,0,0,125.81,56.8V11.3A71.14,71.14,0,0,1,176,125.83h-.07a11,11,0,0,0-12.58,10.88,11,11,0,0,0,11,11h0a11,11,0,0,0,10.54-14.13C184.82,133.3,184.73,133,184.63,132.75Z"/>
+</svg>

package/lib/index.js

@@ -59,7 +59,7 @@ import os from 'node:os'
 import path from 'node:path'
 
 export const name = '@iasiv5/dsh-obmc-web'
-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 UP_HOST = '127.0.0.1'
 const DEFAULT_RELAY_PORT = 18443
@@ -731,7 +731,7 @@ export function apply(ctx) {
   if (createdTemplate) ctx.logger?.info?.(`[dsh-obmc-web] first start: wrote a commented config template to ${ENV_FILE} — configure it in Settings → BMC 控制台`)
   Object.assign(envConfig, readEnvConfig())
   bmcState.target = envConfig.bmcTarget
-  /* 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": "@iasiv5/dsh-obmc-web",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "OpenBMC 控制台入口：设置一级菜单「BMC 控制台」面板一键在顶层标签页打开 BMC Web UI，同源代理经 SSH 本地转发 relay（obmc-web-relay）抵达 BMC，BMC IP 变化自动探测并重定向隧道；需 SSH 跳板机可达 BMC。",
+  "icon": "./icon.svg",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -14,7 +15,8 @@
     "cordis.patch.yml",
     "deploy/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "icon.svg"
   ],
   "license": "MIT",
   "author": "iasiv5",