modelstage 0.0.0-stage → 0.5.24

package/src/web/style.css

@@ -0,0 +1,493 @@
+/* ============================================================================
+   ModelStage 本实现 · 布局与基础样式（M1）
+   - 色板为本项目自有令牌（--color-background / --color-card …，五套主题各一份，见 docs/设计/界面与状态.md），
+     目的是"看起来一样"，不是重新设计。
+   - 五个区域的几何值按 1920×1080 实测标定，见 index.html 头注释。
+   - 这个文件只管：变量、基础重置、舞台、五个区域的容器几何。
+     控件外观（按钮、列表、横幅）在 components.css。
+   ========================================================================== */
+
+/* [hidden] 兜底 —— 必须写在所有容器样式之前，且用 !important。
+   原因：`el.hidden = true` 只是加 HTML 属性，UA 的 `[hidden] { display: none }` 会被
+   作者样式里的 `display:` 直接覆盖（两者同为元素选择器权重，作者样式优先），
+   结果是"属性设了、界面照样显示"的静默失效。
+   历史：.stage-hint[hidden] 与 .acc-body[hidden] 都是逐类补过的 —— 加了这条后它们成为冗余
+   （保留无害），但新容器不要再逐类打补丁。
+   为什么用 !important：[hidden] 的语义就是"不显示"，任何作者样式都不该把它变回来。 */
+[hidden] {
+  display: none !important;
+}
+
+:root {
+  /* 主色板（五套主题共用同一批令牌名） */
+  --color-background: #131416;
+  --color-foreground: #e9ebed;
+  --color-card: #1f2326;
+  --color-primary: #1fc0c5;
+  --color-secondary: #2a2f33;
+  --color-muted: #23272a;
+  --color-muted-foreground: #9ca3af;
+  /* 诊断/说明类小字专用文字色（面板四行诊断、只读提示等）。语义独立于 muted-foreground：将来只想调诊断字深浅时改这一处即可。各主题块里都有同名定义。 */
+  --color-text-secondary: #9ca3af;
+  --color-border: #353a3e;
+  --scroll-thumb: #2e2e38;
+  --scroll-thumb-hover: #3e3e48;
+  --color-danger: #e06c75;
+
+  /* 布局尺寸 */
+  --header-h: 3rem;      /* 48px */
+  --left-w: 19rem;       /* 304px */
+  --right-w: 15rem;      /* 240px（176px 太窄：控件名被压成一个字、按钮竖排） */
+  --footer-h: 2.625rem;  /* 42px */
+  --panel-bottom: 4rem;  /* 侧栏底边留 64px（旧 aside bottom:64px） */
+  --radius: 8px;
+}
+
+/* ---------------------------------------------------------------- 基础 */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  height: 100%;
+  margin: 0;
+  padding: 0;
+  /* 锁滚动：舞台铺满视口，页面永不出现滚动条（含横向） */
+  overflow: hidden;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: system-ui, -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif;
+  -webkit-tap-highlight-color: transparent;
+}
+
+/* 字号只设在 body 上：html 保持浏览器默认 16px，
+   否则下面的 rem 尺寸（--header-h 等）会按 13px 折算，整页小一圈 */
+body {
+  font-size: 13px;
+}
+
+button {
+  font: inherit;
+  color: inherit;
+  border: 0;
+  background: transparent;
+  cursor: pointer;
+}
+
+button:disabled {
+  cursor: default;
+  opacity: 0.45;
+}
+
+/* 滚动条：细窄、暗色 */
+::-webkit-scrollbar {
+  width: 5px;
+  height: 5px;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+::-webkit-scrollbar-thumb {
+  background: var(--scroll-thumb);
+  border-radius: 3px;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: var(--scroll-thumb-hover);
+}
+
+/* ------------------------------------------------------------ 舞台（铺满） */
+
+.stage {
+  position: fixed;
+  inset: 0;
+  z-index: 0;
+}
+
+/* 棋盘格：格边长 14px，大屏 24px */
+.checkerboard {
+  --cb: 14px;
+  background-color: #17191b;
+  background-image:
+    linear-gradient(45deg, #1c1f21 25%, transparent 25%),
+    linear-gradient(-45deg, #1c1f21 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, #1c1f21 75%),
+    linear-gradient(-45deg, transparent 75%, #1c1f21 75%);
+  background-size: var(--cb) var(--cb);
+  background-position: 0 0, 0 calc(var(--cb) / 2), calc(var(--cb) / 2) calc(var(--cb) / -2), calc(var(--cb) / -2) 0;
+}
+
+@media (min-width: 1024px) {
+  .checkerboard {
+    --cb: 24px;
+  }
+}
+
+.stage-canvas {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
+/* 舞台状态提示：放左下角小字，不遮挡画面主体。
+   正常的状态文字一律走日志；这里只用于「失败 / 不可用 / 未接入」这类需要用户看见的情况。 */
+.stage-hint {
+  position: absolute;
+  left: 12px;
+  bottom: 12px;
+  transform: none;
+  margin: 0;
+  padding: 4px 10px;
+  max-width: calc(100% - 24px);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius);
+  background: rgba(31, 35, 38, 0.72);
+  color: var(--color-muted-foreground);
+  font-size: 11px;
+  line-height: 1.4;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  pointer-events: none;
+}
+
+.stage-hint[hidden] {
+  display: none;
+}
+
+/* ------------------------------------------------------ 顶栏（top 0，全宽） */
+
+.app-header {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: var(--header-h);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 0 16px;
+  background: var(--color-card);
+  color: var(--color-foreground);
+  z-index: 40;
+}
+
+/* ------------------------------------------------- 侧栏（左/右，浮在舞台上） */
+
+.panel {
+  position: fixed;
+  top: var(--header-h);
+  bottom: var(--panel-bottom);
+  display: flex;
+  flex-direction: column;
+  background: var(--color-card);
+  color: var(--color-foreground);
+  z-index: 30;
+  overflow: hidden;
+  /* 面板显示/隐藏用位移动画，不是 display 切换 */
+  transition: transform 0.2s ease, opacity 0.2s ease;
+}
+
+.panel-left {
+  left: 0;
+  width: var(--left-w);
+  border-radius: 0 var(--radius) var(--radius) 0;
+}
+
+.panel-right {
+  right: 0;
+  width: var(--right-w);
+  border-radius: var(--radius) 0 0 var(--radius);
+}
+
+.panel-left.is-hidden {
+  transform: translateX(-100%);
+  opacity: 0;
+  pointer-events: none;
+}
+
+.panel-head {
+  flex: none;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 6px;
+  height: 41px;
+  padding: 0 12px;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.panel-title {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--color-muted-foreground);
+}
+
+.panel-actions {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.panel-body {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  padding: 8px;
+}
+
+/* ------------------------------------------- 底栏（底部居中浮条，与旧版一致） */
+
+.app-footer {
+  position: fixed;
+  /* 居中用 left/right + margin-inline:auto（不再用 transform）：
+     宽度是 fit-content，transform 与 auto margin 叠着容易算错中心。 */
+  left: 0;
+  right: 0;
+  bottom: 15px;
+  margin-inline: auto;
+  /* 宽度由内容决定：控件全部显示、不裁字、不换行；只有真的放不下时才受视口约束 */
+  width: fit-content;
+  max-width: calc(100vw - 32px);
+  /* 高度不再写死：右块（皮肤/动作/重置/背景）在 720px 浮条里放不下一行会换行，
+     写死 42px 会把换行出来的按钮顶出浮条外。min-height 保证单行时仍是原高度。 */
+  height: auto;
+  min-height: var(--footer-h);
+  /* 三块布局用 grid：左右各 1fr、中间 auto ⇒ 中间块天然落在浮条（=视口）正中。
+     不用 position:absolute：那会脱离文档流，窄屏时压住两侧控件。
+     关键：fr 的隐式最小尺寸是 auto（内容最小宽度），内容一宽列就被撑破、右块向左溢出压住
+     中间块（实测皮肤 picker 压住播放按钮）。所以必须用 minmax(0, 1fr) 允许列收缩到 0。 */
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
+  align-items: center;
+  gap: 8px;
+  padding: 0 9px;
+  background: var(--color-card);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius);
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.35);
+  z-index: 40;
+}
+
+/* ============================================================================
+   影院模式 / 侧栏收起 —— 纯状态类驱动的外观（不含任何 JS）
+
+   状态属性（都挂在 <html> 上，JS 只负责切换值，动画细节全在 CSS）：
+     data-cinema="on"   影院模式：隐藏顶栏与左右侧栏，只留舞台
+     data-idle="on"     与 data-cinema="on" 组合：静止数秒后底部播放条淡出
+     data-left="off"    收起左栏（角色库）
+     data-right="off"   收起右栏（控制面板）
+
+   布局说明：顶栏与左右侧栏都是 position:fixed 的浮层，舞台本来就 inset:0 铺满视口，
+   所以上述状态只做位移/透明度过渡，不触发重排 —— 收起侧栏不会留下空白条。
+   ========================================================================== */
+
+:root {
+  /* 统一进出场时长与缓动：影院/侧栏/播放条共用一套，改一处即全局一致 */
+  --ui-fade: 200ms;
+  --ui-ease: cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+/* 顶栏：滑出视口（用 translateY 而不是改 height，避免过渡期间挤压舞台） */
+.app-header {
+  transition: transform var(--ui-fade) var(--ui-ease), opacity var(--ui-fade) var(--ui-ease);
+}
+
+html[data-cinema="on"] .app-header {
+  transform: translateY(-100%);
+  opacity: 0;
+  pointer-events: none;
+}
+
+/* 布局读回完成前，左右栏不参与首次绘制。
+   为什么需要它：HTML 里左右栏默认是"展开"的，而读回偏好（可能上次是收起的）发生在
+   ES module 的执行期（异步）——中间那几帧用户会看到"显示 → 又被收起"的闪烁。
+   为什么用 visibility 而不是 display:none：前者仍占位，读回后显示不触发重排（不会整页跳）；
+   后者不占位，切回来会重新布局，看起来是"跳一下"。
+   标记由 main.js 在 applyLayout() 之后写入（含异常兜底，不会永久遮住）。
+   还必须关掉过渡：`.panel` 自带 transform/opacity 的 0.2s 过渡，而 applyLayout() 与放行标记
+   在同一个任务里完成 —— visibility 一放开，那条"滑出"过渡就会被真实绘制出来，
+   表现为「先出现、再滑走」。首帧不做过渡，读回落地后的交互照旧有动画。 */
+html:not([data-layout-ready]) #left-panel,
+html:not([data-layout-ready]) #right-panel {
+  visibility: hidden;
+}
+
+/* 启动期（is-booting）左右栏一律不过渡。
+   为什么需要单独一条：applyLayout() 加的隐藏类（transform/opacity 终态）与"放行可见"
+   若落在同一次样式重算里，浏览器看到的新状态 transition 又是 0.2s ⇒
+   那条"从原位滑到隐藏位"的过渡会被真实画出来 =「先出现、再滑走」。
+   仅靠上一条 :not([data-layout-ready]) 里的 transition:none 管不到这一次变化
+   （它只在旧状态生效）。所以启动期用一个独立类把过渡关掉，等隐藏终态落地一帧后再摘掉它。
+   摘掉后：transform 值没变化 ⇒ 不会触发任何过渡；之后的交互切换照旧有 0.2s 动画。 */
+html.is-booting #left-panel,
+html.is-booting #right-panel {
+  transition: none !important;
+}
+
+/* 左右侧栏：影院模式与"单独收起"合并成同一套位移；
+   与既有 .is-hidden（模型库按钮切换的类）结果一致，两者可叠加不冲突。 */
+html[data-cinema="on"] .panel-left,
+html[data-left="off"] .panel-left,
+.panel-left.is-hidden {
+  transform: translateX(-100%);
+  opacity: 0;
+  pointer-events: none;
+}
+
+html[data-cinema="on"] .panel-right,
+html[data-right="off"] .panel-right {
+  transform: translateX(100%);
+  opacity: 0;
+  pointer-events: none;
+}
+
+/* 底部播放条：影院模式下整体淡出；静止态（data-idle）完全隐藏并下沉一点，
+   鼠标移动时由 JS 把 data-idle 切回 off 即可平滑回来。 */
+.app-footer {
+  transition: opacity var(--ui-fade) var(--ui-ease), transform var(--ui-fade) var(--ui-ease);
+}
+
+html[data-cinema="on"][data-idle="on"] .app-footer {
+  opacity: 0;
+  transform: translateY(8px);
+  pointer-events: none;
+}
+
+/* 影院模式 + 静止：隐藏鼠标指针，避免光标压在画面里影响观赏 */
+html[data-cinema="on"][data-idle="on"] body {
+  cursor: none;
+}
+
+/* 影院模式下舞台提示退到最弱，不干扰画面 */
+html[data-cinema="on"] .stage-hint {
+  opacity: 0.55;
+}
+
+/* ============================================================================
+   两个渲染面互斥：Live2D 激活时隐藏 Spine 画布
+   —— 两套渲染栈（Spine WebGL / Live2D 覆盖层）同时可见会叠成一个画面（实测出现过），
+      由 #stage 上的 data-stage-mode 声明当前用哪一面，样式只负责"另一面不可见"。
+
+   为什么用 visibility 而不是 display:none：
+     display:none 会把元素从布局里摘掉，画布的 offsetWidth/clientWidth 立即变 0，
+     依赖尺寸的 ResizeObserver 会先收到一次"尺寸归零"再收到"恢复"，导致 Live2D 覆盖层
+     重算画布尺寸时抖动（闪一下/错位）。visibility:hidden 只改变绘制与命中，
+     布局尺寸、观察器通知都保持不变，切回来时无需重新测量。
+   ========================================================================== */
+#stage[data-stage-mode="live2d"] #stage-canvas {
+  visibility: hidden;
+}
+
+/* 切换中：两个渲染面都遮住，只留中性的加载底色（避免切换瞬间出现两幅模型叠加）。
+   由唯一的切换入口把 data-stage-mode 置为 "loading"，切换完成后再落到 spine / live2d。 */
+#stage[data-stage-mode="loading"] #stage-canvas,
+#stage[data-stage-mode="loading"] #live2d-overlay {
+  visibility: hidden;
+}
+
+/* 兜底：显式处于 spine 模式时，Live2D 覆盖层必须不可见（防止卸载遗漏导致叠加）。
+   用 visibility 而不是 display：保留布局尺寸，避免覆盖层尺寸变化触发 ResizeObserver 抖动。 */
+#stage[data-stage-mode="spine"] #live2d-overlay {
+  visibility: hidden;
+}
+
+/* ---------------- 覆盖层 / 调试 HUD / 调试日志浮层 ----------------
+   契约《禁止内联 CSS 与 JS》：这些元素的定位与配色是**设计决策**（不是运行时算出来的值），
+   一律走类名 + CSS 变量，JS 只负责加/去类，不再写 element.style。 */
+
+/* Live2D 覆盖层：绝对定位铺满舞台，默认隐藏（由 data-stage-mode 或 .is-visible 控制可见性） */
+#live2d-overlay {
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 5;
+  display: none;
+  /* 事件仍落到下面的 Spine 画布，交互层路径完全不变 */
+  pointer-events: none;
+  background: transparent;
+  overflow: hidden;
+}
+#live2d-overlay.is-visible { display: block; }
+#live2d-overlay-canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+/* 渲染诊断 HUD（?diag=1 时才创建） */
+#l2d-diag {
+  position: fixed;
+  right: 8px;
+  bottom: 8px;
+  z-index: 99999;
+  max-width: 480px;
+  padding: 8px 10px;
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  background: var(--color-card);
+  color: var(--color-foreground);
+  font: 11px/1.55 var(--font-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);
+  white-space: pre-wrap;
+  box-shadow: 0 4px 16px rgb(0 0 0 / 45%);
+}
+.l2d-diag-head {
+  cursor: pointer;
+  margin-bottom: 4px;
+  color: var(--color-primary);
+  user-select: none;
+}
+/* 折叠：整体只藏 body，标题行仍可点 */
+#l2d-diag.is-collapsed .l2d-diag-body { display: none; }
+
+/* 调试日志浮层容器（面板内部另有自己的定位） */
+#debug-panel-host {
+  position: fixed;
+  right: 200px;
+  bottom: 100px;
+  z-index: 40;
+  width: 288px;
+}
+
+/* PIXI 画布（Live2D 覆盖层内部）：铺满容器、背景透明 */
+.live2d-pixi-canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+  background: transparent;
+}
+
+/* 资源根管理行（设置 → 资源根）：整行换行布局 */
+.root-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  align-items: center;
+  padding: 4px 0;
+  border-bottom: 1px solid var(--color-border);
+}
+.root-name {
+  flex: 1 1 100%;
+  font-size: 12px;
+}
+.root-path {
+  flex: 1 1 100%;
+  font-size: 11px;
+  word-break: break-all;
+}
+.root-rename-input {
+  flex: 1 1 100%;
+}
+/* 删除确认提示：警示色（不写字面色值，走语义令牌） */
+.root-confirm-ask {
+  font-size: 11px;
+  color: var(--color-danger);   /* 语义令牌：删除/危险提示 */
+}

package/tool/lib/bundle-probe-node.mjs

@@ -0,0 +1,121 @@
+// ============================================================================
+// tool/lib/bundle-probe-node.mjs —— 在 Node 里跑插件的「装载前预检」
+//
+// 为什么要这一层：预检实现只有一份（plugins/unity-live2d-bundle/lib/bundle-probe.js），
+//   浏览器由插件 index.js 用，服务端由本文件把同一份 js 读进 vm 沙箱执行。
+//   这样 /api/bundle/probe 与页面里的 probe 结论必然一致，不存在两份解析逻辑。
+//
+// 只加载**数据层**需要的库（不加载 index.js / 渲染相关），首次调用时建沙箱并缓存。
+// ============================================================================
+
+import fs from 'node:fs';
+import path from 'node:path';
+import vm from 'node:vm';
+import { fileURLToPath } from 'node:url';
+// 依赖包判据与文案（与前端 plugin-host 共用一份，见 src/shared/bundle-shape.mjs）
+import { histogramFromObjects, isAssetDependencyHistogram, dependencyReason } from '../../src/shared/bundle-shape.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, '..', '..');
+
+/** 预检用哪个插件的 lib（预检实现只有 unity-live2d-bundle 这一份，spine 复用它） */
+const PROBE_PLUGIN_ID = 'unity-live2d-bundle';
+
+/**
+ * 取某插件的 lib 目录。
+ * @param {string} [pluginId]
+ * @returns {string}
+ */
+function libDirFor(pluginId = PROBE_PLUGIN_ID) {
+  return path.join(ROOT, 'plugins', pluginId, 'lib');
+}
+
+/**
+ * 从插件的 `plugin.json` 派生「预检要加载的 lib 文件清单」——**唯一真相是 manifest**。
+ *
+ * 为什么必须派生：这份清单曾经是手写的，与 plugin.json 的 files[] 构成"同一事实的两处表达"。
+ *   漏一边的表现极难定位：**浏览器能跑（按 files[] 加载）、服务端预检报缺依赖（按手写清单加载）**。
+ *   所以这里不再保留任何文件名常量，只做一件事：按 files[] 顺序取出 `lib/` 前缀项并去掉前缀。
+ *
+ * 顺序也来自 manifest：files[] 本身就是依赖顺序（errors 最先、bundle-probe 在后），
+ *   派生时**原样保留**，不重排（重排就等于又引入一处人工判断）。
+ *
+ * @param {string} [pluginId]
+ * @returns {string[]} 形如 ['errors.js', 'bytes.js', ...]
+ */
+export function libOrderFor(pluginId = PROBE_PLUGIN_ID) {
+  const manifestPath = path.join(ROOT, 'plugins', pluginId, 'plugin.json');
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  const files = Array.isArray(manifest.files) ? manifest.files : [];
+  return files
+    .filter((f) => typeof f === 'string' && f.startsWith('lib/'))
+    .map((f) => f.slice('lib/'.length));
+}
+
+let sandbox = null;
+
+/** 建（或取缓存的）库沙箱。首次调用才读文件 + 执行。 */
+function getSandbox() {
+  if (sandbox) return sandbox;
+  const ctx = {
+    console: { log() {}, info() {}, warn() {}, error() {}, debug() {} },
+    TextDecoder,
+    TextEncoder,
+    setTimeout,
+    clearTimeout,
+  };
+  ctx.globalThis = ctx;
+  ctx.window = ctx;
+  ctx.self = ctx;
+  vm.createContext(ctx);
+  // 清单在**运行时**从 plugin.json 派生（不是模块加载时算一次）：
+  //   这样新增 lib 文件后无需改这里，也不会因进程长期驻留而用上过期清单。
+  const libDir = libDirFor(PROBE_PLUGIN_ID);
+  for (const rel of libOrderFor(PROBE_PLUGIN_ID)) {
+    const abs = path.join(libDir, rel);
+    // 报错要能自己说清"该看哪两个地方"：manifest 声明了但磁盘上没有
+    if (!fs.existsSync(abs)) throw new Error(`预检依赖缺失：plugins/${PROBE_PLUGIN_ID}/lib/${rel}（plugin.json 的 files[] 里有它，但磁盘上没有）`);
+    // 用 vm 执行而非 import：这些库是浏览器风格的脚本（挂 globalThis.__ULB__），不是 ESM
+    vm.runInContext(fs.readFileSync(abs, 'utf8'), ctx, { filename: `ulb-lib/${rel}` });
+  }
+  sandbox = ctx;
+  return sandbox;
+}
+
+/**
+ * 预检一个资源包字节流。
+ * @param {Uint8Array} bytes
+ * @returns {object} 与插件内 probe 同源的结论 + 包内类型构成（依赖包判定用）
+ */
+export function probeBundleBytes(bytes) {
+  const ctx = getSandbox();
+  const NS = ctx.__ULB__;
+  const bp = NS && NS.bundleProbe;
+  const res = (bp && typeof bp.run === 'function') ? bp.run(bytes) : null;
+
+  // 附加：包内 className 构成 + 是否"美术依赖包"。
+  //   判据与文案来自 src/shared/bundle-shape.mjs —— 与前端 plugin-host 用的是同一份，
+  //   保证"页面点开"与"直接调 /api/unpack"对同一个包给同一个答案。
+  //   这里再解析一次（诊断路径、不进热路径），因为 run() 不暴露对象表。
+  let shape = null;
+  try {
+    const parsed = NS.unityfs.parse(bytes);
+    const cab = (parsed.nodes || []).find((n) => /^CAB-/.test(n.path));
+    if (cab) {
+      const sf = NS.serialized.parse(NS.unityfs.nodeBytes(parsed, cab.path));
+      const histogram = histogramFromObjects(sf);
+      shape = {
+        objectCount: (sf.objects || []).length,
+        histogram,
+        assetDependency: isAssetDependencyHistogram(histogram),
+      };
+      if (shape.assetDependency) shape.dependencyReason = dependencyReason(histogram);
+    }
+  } catch { /* 形态探测失败不影响主结论（探不到就不下依赖包结论） */ }
+
+  return Object.assign({}, res || {}, shape || {});
+}
+
+// 路径与清单都**不再导出成常量**（常量会诱使别人继续手写第二份）；
+//   需要自查清单时调 libOrderFor(pluginId) 现取。
+export const PROBE_PATHS = { ROOT, libDirFor, libOrderFor };