dsh-m 0.9.68 → 0.9.70

package/CHANGELOG.md

@@ -8,6 +8,18 @@ The full release history of dsh-m, maintained bilingually: **Chinese first, Engl
 
 ## 中文
 
+### 0.9.70 修复：拖拽观感与静止态一致——退役拖拽期实心固化（ADR-0017 v2）
+
+- **根因（用户浅色模式双态实拍）**：0.9.69 的拖拽期「计算值固化强制实心」在按住/松手瞬间造成实心↔玻璃的观感跳变，浅色模式下尤为突兀——防透字与观感连续两个目标里，实心方案牺牲了后者。
+- **修复（ADR-0017 决策 3 修订 v2）**：拖拽态与静止态**同玻璃同 blur，外观逐像素一致**——透字防护回归静止态既有不变量（毛玻璃模糊背景自持；透字病灶的成因是「关 blur 还留半透明」，两样都不动即无此病，openbmc 静止态可读性本就由 blur 兜住）。拖拽可供性只剩 grabbing 光标与投影加深；`solidifyColor`/`--dshm-drag-bg`/拖拽态 `!important` 全部退役（清单定长回归 4，`client-lightbox` 断言含「无残留」负向锚）。性能保底手段（pointer capture/手势期监听/rAF 帧内写/translate3d/will-change）全部保留；拖拽期恢复的每帧 backdrop 重滤镜由 GPU 合成承担，弱机若报告掉帧再评估。
+- **验证**：1323 项测试全绿、typecheck 零错误；ADR-0017 修订 v2（Considered Options 翻案记录在案）。
+
+### 0.9.69 功能：还原态面板头部拖拽 + 位置记忆（ADR-0017）
+
+- **方案**：市场面板（`.dshm-panel`）还原态下按住头部（标题/tab 行）即可自由拖拽——头部全域为手柄，tab/全屏/关闭钮点击语义原样（`closest("button")` 门卫 + 多指重入守卫）；双击头部非按钮区切换全屏；释放位置烘焙为视口绝对坐标存 `dshm-panel-pos`，下次打开还原，无记忆首开与旧版 flex 居中渲染逐字节一致。运动范围四周 8px；desktop profile 额外让出壳层标题拖拽带（quota-watch 契约：`data-windows-titlebar` + `--dsh-windows-titlebar-height`，web 无此变量恒 0）——胶囊时代「停进系统按钮区就再也抓不回」的坑由 clamp 机制性杜绝。挂载/全屏往返/resize 三触发源重夹紧，还原 commit 的重夹紧时序由 render 期 latest-ref 镜像保证（执行评审 E1-1 实证修复并以结构锚钉死）。
+- **皮肤免疫（拖拽期 = 最快渲染路径）**：拖拽背景取手势开始时 `getComputedStyle` 的最终色强制 α=1 写入 `--dshm-drag-bg` 并 `!important` 自持——openbmc/uefi 玻璃皮肤（bg-base α=0.55 病类，quota-watch 胶囊拖拽变半透明的同款病例）下按住拖动面板完全实心不透字；同时拖拽期关闭 backdrop-filter，每帧只剩 compositor 平移一层：pointer capture + 手势期才挂 document 监听 + pointermove 只存点、样式帧内写 + 拖拽帧绝不走 React state。静止态玻璃外观、0.9.27 防误关守卫、灯箱/详情 modal 语义全部不动。
+- **验证**：1326 项测试全绿、typecheck 零错误；构建产物含 `dshm-panel--dragging`/`dshm-panel-pos` 逐字锚；`!important` 清单定长 4→7（client-lightbox 断言登记）。实施计划与执行结果经独立评审 Agent 五轮对抗评审全闭环（16 条：13 条修于计划、3 条修于代码/如实申报）。
+
 ### 0.9.68 性能：合并市场物化——同身份免重付 5MB 解析 + 适配 + 合并（ADR-0016）
 
 - **问题（性能架构审查旗舰项，三轮评审闭环）**：领域概念「合并市场（Merged Market）」在 GLOSSARY 有名无主——装配逻辑内联在 `communityOutcome`，每个市场请求（缓存全命中的快路径也在内）都重付磁盘读 5.36MB 社区目录 + JSON.parse（实测 30–55ms）→ 目录适配层重建 4,400 条（30–90ms）→ 合并排序（5–35ms）；且全部是**同步 JS、阻塞宿主事件循环**——市场每翻一页/每提交一次搜索，宿主的 SSE 对话流与工具调用停摆 65–400ms。搜索评分因归一化 WeakMap 跨请求永不命中再加 ~330ms（冷）。
@@ -505,6 +517,18 @@ The full release history of dsh-m, maintained bilingually: **Chinese first, Engl
 
 ## English
 
+### Fix in 0.9.70 — drag appearance matches the resting state: drag-time solidification retired (ADR-0017 v2)
+
+- **Root cause (user side-by-side capture in light mode)**: the 0.9.69 drag-time "computed-value solidification" made the panel jump between solid and glass at grab/release - jarring in light mode. Of the two goals (no see-through, visual continuity), the solid approach sacrificed continuity.
+- **Fix (ADR-0017 decision 3 revised to v2)**: the drag state now shares the resting state's exact glass and blur - pixel-identical appearance. See-through protection returns to the resting invariant (frosted blur holds the background; the disease class was "blur off while still translucent" - leave both untouched and it cannot occur, exactly how openbmc's resting readability is already held). Drag affordance reduces to the grabbing cursor and a deeper shadow; `solidifyColor` / `--dshm-drag-bg` / drag-time `!important` are all retired (inventory back to a pinned 4, with a no-residue negative anchor in `client-lightbox`). The performance toolbox (pointer capture / gesture-scoped listeners / rAF-frame writes / translate3d / will-change) is fully retained; the restored per-frame backdrop re-filter is carried by GPU compositing - revisit only if weak-GPU jank is reported.
+- **Verification**: 1323 tests green, typecheck clean; ADR-0017 revised to v2 (Considered Options overruling recorded).
+
+### Feature in 0.9.69 — drag the marketplace panel by its header in restore state, with position memory (ADR-0017)
+
+- **Design**: hold the panel header (title/tab row) in restore state to drag the marketplace panel freely - the whole header is the handle while tab / fullscreen / close buttons keep their click semantics (`closest("button")` gate + multi-pointer re-entry guard); double-click on a non-button header area toggles fullscreen; on release the position is baked into absolute viewport coordinates and stored under `dshm-panel-pos`, restored on next open - with no stored position the first render stays byte-identical to the old flex-centered layout. The motion range is clamped 8px on all sides; the desktop profile additionally yields the shell titlebar drag band (quota-watch contract: `data-windows-titlebar` + `--dsh-windows-titlebar-height`; web without the variable is always 0) - the capsule-era trap of parking inside the system button zone and never being grabbable again is eliminated by construction. Mount, fullscreen round-trips and window resize all re-clamp; the restore-commit re-clamp is ordered by render-phase latest-ref mirrors (execution review E1-1, reproduced, fixed, and pinned by structural anchors).
+- **Skin immunity (drag = fastest render path)**: the drag background is captured at gesture start from `getComputedStyle` with alpha forced to 1 into `--dshm-drag-bg`, self-held by `!important` - on glass skins (openbmc/uefi, bg-base alpha 0.55 disease class - the same case that made the quota-watch capsule translucent while dragged) the panel stays fully opaque with zero see-through. backdrop-filter is disabled for the gesture, so each frame is a single compositor translation: pointer capture + document-level listeners only during the gesture + pointermove stores the point only (styles written inside rAF) + drag frames never touch React state. Resting glass looks, the 0.9.27 mis-close guard, lightbox and detail-modal semantics are all untouched.
+- **Verification**: 1326 tests green, typecheck clean; bundle carries literal anchors `dshm-panel--dragging` / `dshm-panel-pos`; the `!important` inventory is length-pinned 4→7 (registered in client-lightbox assertions). Plan and execution were adversarially reviewed by an independent reviewer agent across five rounds - 16 findings, all closed (13 fixed in the plan, 3 fixed in code / honestly declared).
+
 ### Performance in 0.9.68 — materialized merged market: skip the 5MB parse + adapt + merge for repeat identities (ADR-0016)
 
 - **Problem (flagship item of the performance architecture review, closed over three review rounds)**: the domain concept "Merged Market" existed in the GLOSSARY without an owning module - assembly logic lived inline in `communityOutcome`, so every market request (including fully cache-hit fast paths) re-paid a 5.36MB community catalog disk read + JSON.parse (measured 30-55ms) → adapter rebuild of 4,400 entries (30-90ms) → merge + sort (5-35ms). All of it is **synchronous JS blocking the host event loop** - every page turn / committed search froze the host's SSE streams and tool calls for 65-400ms. Search scoring added ~330ms cold because the normalization WeakMap never survived across requests.

package/lib/client.js

@@ -494,6 +494,94 @@ var init_lightbox = __esm({
   }
 });
 
+// src/client/window-drag.js
+var window_drag_exports = {};
+__export(window_drag_exports, {
+  DRAG_SLOP_MOUSE: () => DRAG_SLOP_MOUSE,
+  DRAG_SLOP_TOUCH: () => DRAG_SLOP_TOUCH,
+  PANEL_MARGIN: () => PANEL_MARGIN,
+  POS_KEY: () => POS_KEY,
+  clampPoint: () => clampPoint,
+  dragSlop: () => dragSlop,
+  grabOffset: () => grabOffset,
+  isDragTarget: () => isDragTarget,
+  loadPanelPos: () => loadPanelPos,
+  savePanelPos: () => savePanelPos,
+  titlebarTopInset: () => titlebarTopInset
+});
+function dragSlop(pointerType) {
+  return pointerType === "touch" || pointerType === "pen" ? DRAG_SLOP_TOUCH : DRAG_SLOP_MOUSE;
+}
+function grabOffset(point, rect) {
+  return { dx: point.x - rect.left, dy: point.y - rect.top };
+}
+function titlebarTopInset({ titlebar = false, fullscreen = false, height } = {}) {
+  if (!titlebar || fullscreen) return 0;
+  const value = Number.parseFloat(height);
+  return Number.isFinite(value) && value > 0 ? value : 0;
+}
+function normalizeSize(size) {
+  if (typeof size === "number") return { width: size, height: size };
+  const width = typeof size?.width === "number" ? size.width : 0;
+  const height = typeof size?.height === "number" ? size.height : 0;
+  return { width, height };
+}
+function finiteInset(v) {
+  return Number.isFinite(v) ? v : 0;
+}
+function clampPoint(point, viewport, size = 0, insets = ZERO_INSETS) {
+  const { width, height } = normalizeSize(size);
+  const insetLeft = finiteInset(insets?.left);
+  const insetRight = finiteInset(insets?.right);
+  const insetTop = finiteInset(insets?.top);
+  const insetBottom = finiteInset(insets?.bottom);
+  const minX = PANEL_MARGIN + insetLeft;
+  const minY = PANEL_MARGIN + insetTop;
+  const maxX = Math.max(minX, viewport.width - insetRight - PANEL_MARGIN - width);
+  const maxY = Math.max(minY, viewport.height - insetBottom - PANEL_MARGIN - height);
+  return {
+    x: Math.min(Math.max(point.x, minX), maxX),
+    y: Math.min(Math.max(point.y, minY), maxY)
+  };
+}
+function loadPanelPos(storage) {
+  if (!storage || typeof storage.getItem !== "function") return null;
+  try {
+    const raw = storage.getItem(POS_KEY);
+    if (typeof raw !== "string" || raw === "") return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== "object" || parsed === null || !Number.isFinite(parsed.x) || !Number.isFinite(parsed.y)) {
+      return null;
+    }
+    return { x: parsed.x, y: parsed.y };
+  } catch {
+    return null;
+  }
+}
+function savePanelPos(storage, point) {
+  if (typeof point !== "object" || point === null || !Number.isFinite(point.x) || !Number.isFinite(point.y)) {
+    throw new TypeError(`invalid panel position: ${JSON.stringify(point)}`);
+  }
+  try {
+    storage.setItem(POS_KEY, JSON.stringify({ x: point.x, y: point.y }));
+  } catch {
+  }
+}
+function isDragTarget(el) {
+  return Boolean(el?.closest?.("button"));
+}
+var POS_KEY, PANEL_MARGIN, DRAG_SLOP_MOUSE, DRAG_SLOP_TOUCH, ZERO_INSETS;
+var init_window_drag = __esm({
+  "src/client/window-drag.js"() {
+    "use strict";
+    POS_KEY = "dshm-panel-pos";
+    PANEL_MARGIN = 8;
+    DRAG_SLOP_MOUSE = 6;
+    DRAG_SLOP_TOUCH = 10;
+    ZERO_INSETS = { left: 0, right: 0, top: 0, bottom: 0 };
+  }
+});
+
 // src/client/img-chain.js
 var img_chain_exports = {};
 __export(img_chain_exports, {
@@ -1668,6 +1756,7 @@ var { DEFAULT_PAGE_SIZE: DEFAULT_PAGE_SIZE2, MARKET_PAGE_SIZES: MARKET_PAGE_SIZE
 var { readMarketSnapshot: readMarketSnapshot2, writeMarketSnapshot: writeMarketSnapshot2, isDefaultFirstPageQuery: isDefaultFirstPageQuery2 } = (init_market_snapshot(), __toCommonJS(market_snapshot_exports));
 var { backdropCloseHandlers: backdropCloseHandlers2 } = (init_backdrop(), __toCommonJS(backdrop_exports));
 var { lbStep: lbStep2, lbNeighbors: lbNeighbors2, swipeDir: swipeDir2 } = (init_lightbox(), __toCommonJS(lightbox_exports));
+var { dragSlop: dragSlop2, grabOffset: grabOffset2, titlebarTopInset: titlebarTopInset2, clampPoint: clampPoint2, loadPanelPos: loadPanelPos2, savePanelPos: savePanelPos2, isDragTarget: isDragTarget2 } = (init_window_drag(), __toCommonJS(window_drag_exports));
 var { WESERV_TIMEOUT_MS: WESERV_TIMEOUT_MS2, weservUrl: weservUrl2, serviceBucketOf: serviceBucketOf2, tierOrder: tierOrder2, nextTier: nextTier2, needsTimeout: needsTimeout2, preferredTier: preferredTier2, rememberSuccess: rememberSuccess2 } = (init_img_chain(), __toCommonJS(img_chain_exports));
 var { createMarkdown: createMarkdown2 } = (init_markdown(), __toCommonJS(markdown_exports));
 var { ExtLink, MdImg, renderMarkdown } = createMarkdown2(h);
@@ -1845,6 +1934,7 @@ var ZH = {
   "pager.jump.ph": "\u9875\u53F7",
   "panel.fullscreen": "\u5168\u5C4F",
   "panel.restore": "\u8FD8\u539F",
+  "panel.dragHint": "\u62D6\u62FD\u79FB\u52A8 \xB7 \u53CC\u51FB\u5207\u6362\u5168\u5C4F",
   "lb.title": "\u63D2\u4EF6\u622A\u56FE\u9884\u89C8",
   "lb.prev": "\u4E0A\u4E00\u5F20\uFF08\u2190\uFF09",
   "lb.next": "\u4E0B\u4E00\u5F20\uFF08\u2192\uFF09",
@@ -2131,6 +2221,7 @@ var EN = {
   "pager.jump.ph": "Page",
   "panel.fullscreen": "Fullscreen",
   "panel.restore": "Restore",
+  "panel.dragHint": "Drag to move \xB7 Double-click to toggle fullscreen",
   "lb.title": "Plugin screenshot preview",
   "lb.prev": "Previous (\u2190)",
   "lb.next": "Next (\u2192)",
@@ -2275,6 +2366,23 @@ function communityLabels(data) {
 var CSS = `
 .dshm-overlay{position:fixed;inset:0;z-index:2147483000;background:var(--dsw-alias-bg-mask-3,rgba(15,23,42,.48));display:flex;align-items:center;justify-content:center;padding:max(24px,var(--dsh-windows-titlebar-height,0px)) 16px 24px;box-sizing:border-box}
 .dshm-panel{width:min(920px,100%);height:min(680px,86vh);display:flex;flex-direction:column;background:var(--dsw-alias-bg-elevated,var(--dsw-alias-bg-base,#fff));background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 86%,transparent);backdrop-filter:blur(14px) saturate(1.3);-webkit-backdrop-filter:blur(14px) saturate(1.3);border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:14px;box-shadow:0 18px 48px rgba(2,6,23,.25);overflow:hidden;font-family:inherit;color:var(--dsw-alias-label-primary,inherit)}
+/* 0.9.70 \u8FD8\u539F\u6001\u62D6\u62FD\uFF1A.abs = \u6709\u4F4D\u7F6E\u8BB0\u5FC6\u65F6\u7684\u7EDD\u5BF9\u5B9A\u4F4D\u5F62\u6001\uFF08overlay \u4E3A inset:0 fixed\uFF0C
+   \u7EDD\u5BF9\u5B9A\u4F4D\u5750\u6807\u5373\u89C6\u53E3\u5750\u6807\uFF09\uFF1B\u65E0\u8BB0\u5F55\u65F6\u9762\u677F\u4ECD\u8D70 overlay flex \u5C45\u4E2D\uFF0C\u6E32\u67D3\u8DEF\u5F84\u4E0E\u65E7\u7248\u9010\u5B57\u8282\u4E00\u81F4\u3002
+   \u62D6\u62FD\u89C2\u611F\u4E0D\u53D8\u91CF\uFF080.9.70 \u4FEE\u8BA2\uFF0CADR-0017 v2\uFF09\uFF1A\u62D6\u62FD\u6001\u4E0E\u9759\u6B62\u6001\u540C\u73BB\u7483\u540C blur\uFF0C\u5916\u89C2\u9010\u50CF\u7D20\u4E00\u81F4
+   \u2014\u2014\u7528\u6237\u53CC\u6001\u5B9E\u62CD\u88C1\u51B3\uFF1A0.9.69 \u7684\u62D6\u62FD\u671F\u5B9E\u5FC3\u56FA\u5316\u5728\u6D45\u8272\u6A21\u5F0F\u4E0B\u5B9E/\u73BB\u7483\u8DF3\u53D8\u89C2\u611F\u7A81\u5140\uFF0C\u9000\u5F79\uFF1B
+   \u900F\u5B57\u9632\u62A4\u56DE\u5F52\u9759\u6B62\u6001\u65E2\u6709\u4E0D\u53D8\u91CF\uFF08\u6BDB\u73BB\u7483\u6A21\u7CCA\u80CC\u666F\u81EA\u6301\u2014\u2014\u900F\u5B57\u75C5\u7076\u7684\u6210\u56E0\u662F\u300C\u5173 blur \u8FD8\u7559
+   \u534A\u900F\u660E\u300D\uFF0C\u4E24\u6837\u90FD\u4E0D\u52A8\u5373\u65E0\u6B64\u75C5\uFF09\u3002\u62D6\u62FD\u53EF\u4F9B\u6027\u53EA\u5269 grabbing \u5149\u6807\u4E0E\u6295\u5F71\u52A0\u6DF1\uFF1B\u4EE3\u4EF7\u662F\u62D6\u62FD\u671F
+   \u6062\u590D\u6BCF\u5E27 backdrop \u91CD\u6EE4\u955C\uFF08GPU \u5408\u6210\u627F\u62C5\uFF0C\u5F31\u673A\u82E5\u62A5\u544A\u6389\u5E27\u518D\u8BC4\u4F30\uFF09\uFF0C\u5E27\u5185\u5199/capture/
+   \u624B\u52BF\u671F\u76D1\u542C\u7B49\u5176\u4F59\u6027\u80FD\u624B\u6BB5\u5168\u90E8\u4FDD\u7559\u3002 */
+.dshm-panel.abs{position:absolute;margin:0}
+.dshm-panel--dragging{cursor:grabbing;box-shadow:0 24px 64px rgba(2,6,23,.38)}
+/* 0.9.69 \u62D6\u62FD\u624B\u67C4\uFF1Auser-select/touch-action/tap-highlight \u65E0\u6761\u4EF6\u751F\u6548\uFF08\u5168\u5C4F\u53CC\u51FB\u5207\u6362\u65F6
+   \u6807\u9898\u4E0D\u51FA\u73B0\u9009\u4E2D\u95EA\u73B0\uFF09\uFF1Bgrab \u5149\u6807\u4EC5\u5728\u300C\u8FD8\u539F\u6001\u4E14\u975E\u62D6\u62FD\u4E2D\u300D\u76F4\u63A5\u547D\u4E2D head\u2014\u2014\u62D6\u62FD\u4E2D head
+   \u65E0\u81EA\u6709 cursor \u58F0\u660E\uFF0C\u81EA\u7136\u7EE7\u627F\u9762\u677F\u6839 .dshm-panel--dragging \u7684 grabbing\uFF08cursor \u6309
+   \u300C\u5143\u7D20\u81EA\u6709\u58F0\u660E > \u7EE7\u627F\u300D\u89E3\u6790\uFF1Agrab \u82E5\u5728\u62D6\u62FD\u4E2D\u4ECD\u76F4\u63A5\u547D\u4E2D head\uFF0Cgrabbing \u6C38\u8FDC\u7EE7\u627F\u4E0D\u8FDB
+   \u6210\u4E3A\u6B7B\u4EE3\u7801\u2014\u2014\u8BC4\u5BA1 R2-2\uFF09\u3002\u5168\u5C4F\u7981\u62D6\uFF08\u786C\u6027\u8981\u6C42\u2462\uFF09\uFF0C\u5149\u6807\u4E0D\u8BEF\u5BFC\uFF08\u8BC4\u5BA1 R1-6\uFF09\u3002 */
+.dshm-head{user-select:none;touch-action:none;-webkit-tap-highlight-color:transparent}
+.dshm-panel:not(.full):not(.dshm-panel--dragging) .dshm-head{cursor:grab}
 /* 0.9.4 Windows Desktop \u5168\u5C4F\u4FEE\u590D\uFF1A\u58F3\u5728 html \u4E0A\u8BBE --dsh-windows-titlebar-height\uFF0840px\uFF0C
    titleBarStyle:hidden + titleBarOverlay:42 \u7CFB\u7EDF\u7ED8\u5236 \u2014 \u25A1 \u2715\uFF09\uFF0C\u5176\u4E0A\u8FD8\u6709\u5168\u5BBD
    -webkit-app-region:drag \u62D6\u62FD\u5E26\u2014\u2014\u8BE5\u5E26\u6309\u5E03\u5C40\u53C2\u4E0E\u62D6\u62FD\u5224\u5B9A\u3001\u65E0\u89C6 z-index/\u7ED8\u5236\u987A\u5E8F\uFF0C
@@ -4666,6 +4774,27 @@ function FsIcon({ full }) {
     h("path", { d: "M9 4H4v5M15 4h5v5M9 20H4v-5M15 20h5v-5", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" })
   );
 }
+function readTitlebarInsets() {
+  if (typeof document === "undefined" || !document.documentElement) {
+    return { left: 0, right: 0, top: 0, bottom: 0 };
+  }
+  const htmlEl = document.documentElement;
+  let height = "";
+  try {
+    height = window.getComputedStyle(htmlEl).getPropertyValue("--dsh-windows-titlebar-height");
+  } catch {
+  }
+  return {
+    left: 0,
+    right: 0,
+    top: titlebarTopInset2({
+      titlebar: htmlEl.hasAttribute("data-windows-titlebar"),
+      fullscreen: htmlEl.hasAttribute("data-fullscreen"),
+      height
+    }),
+    bottom: 0
+  };
+}
 function MarketPanel({ onClose }) {
   const [tab, setTab] = useState("market");
   const FS_KEY = "dshm-panel-fullscreen";
@@ -4686,6 +4815,157 @@ function MarketPanel({ onClose }) {
       return next;
     });
   }, []);
+  const panelRef = useRef(null);
+  const headRef = useRef(null);
+  const draggingRef = useRef(false);
+  const suppressClickRef = useRef(false);
+  const [pos, setPos] = useState(() => {
+    try {
+      return loadPanelPos2(typeof window !== "undefined" && window.localStorage ? window.localStorage : null);
+    } catch {
+      return null;
+    }
+  });
+  const fullRef = useRef(full);
+  fullRef.current = full;
+  const posRef = useRef(pos);
+  posRef.current = pos;
+  const reclamp = useCallback(() => {
+    if (fullRef.current || draggingRef.current || !panelRef.current || typeof window === "undefined") return;
+    const prev = posRef.current;
+    if (!prev) return;
+    const rect = panelRef.current.getBoundingClientRect();
+    const next = clampPoint2(
+      { x: prev.x, y: prev.y },
+      { width: window.innerWidth, height: window.innerHeight },
+      { width: rect.width, height: rect.height },
+      readTitlebarInsets()
+    );
+    if (next.x !== prev.x || next.y !== prev.y) setPos(next);
+  }, []);
+  useLayoutEffect(() => {
+    reclamp();
+  }, [full, reclamp]);
+  useEffect(() => {
+    window.addEventListener("resize", reclamp);
+    return () => window.removeEventListener("resize", reclamp);
+  }, [reclamp]);
+  useEffect(() => {
+    const headEl = headRef.current;
+    if (!headEl) return void 0;
+    let dragging = false;
+    let moved = false;
+    let slop = 6;
+    let originX = 0;
+    let originY = 0;
+    let grab = { dx: 0, dy: 0 };
+    let rest = { x: 0, y: 0 };
+    let size = { width: 0, height: 0 };
+    let lastPoint = null;
+    const bindGesture = () => {
+      document.addEventListener("pointermove", onPointerMove);
+      document.addEventListener("pointerup", onPointerUp);
+      document.addEventListener("pointercancel", onPointerCancel);
+    };
+    const unbindGesture = () => {
+      document.removeEventListener("pointermove", onPointerMove);
+      document.removeEventListener("pointerup", onPointerUp);
+      document.removeEventListener("pointercancel", onPointerCancel);
+    };
+    const frameStep = () => {
+      if (!dragging || !lastPoint || !panelRef.current) return;
+      const topLeft = clampPoint2(
+        { x: lastPoint.x - grab.dx, y: lastPoint.y - grab.dy },
+        { width: window.innerWidth, height: window.innerHeight },
+        size,
+        readTitlebarInsets()
+      );
+      panelRef.current.style.transform = `translate3d(${Math.round(topLeft.x - rest.x)}px, ${Math.round(topLeft.y - rest.y)}px, 0)`;
+    };
+    const onPointerMove = (event) => {
+      if (!dragging) return;
+      if (!moved) {
+        if (Math.hypot(event.clientX - originX, event.clientY - originY) < slop) return;
+        moved = true;
+        document.body.style.userSelect = "none";
+        panelRef.current.classList.add("dshm-panel--dragging");
+        panelRef.current.style.willChange = "transform";
+      }
+      lastPoint = { x: event.clientX, y: event.clientY };
+      if (typeof window.requestAnimationFrame === "function") window.requestAnimationFrame(frameStep);
+      else frameStep();
+    };
+    const bakeFinal = (event) => {
+      const panel = panelRef.current;
+      const final = clampPoint2(
+        { x: event.clientX - grab.dx, y: event.clientY - grab.dy },
+        { width: window.innerWidth, height: window.innerHeight },
+        size,
+        readTitlebarInsets()
+      );
+      panel.style.left = `${final.x}px`;
+      panel.style.top = `${final.y}px`;
+      panel.classList.remove("dshm-panel--dragging");
+      panel.style.willChange = "";
+      panel.style.transform = "";
+      try {
+        savePanelPos2(window.localStorage, final);
+      } catch {
+      }
+      suppressClickRef.current = true;
+      setPos(final);
+    };
+    const onPointerUp = (event) => {
+      if (!dragging) return;
+      dragging = false;
+      draggingRef.current = false;
+      unbindGesture();
+      document.body.style.userSelect = "";
+      if (!moved) return;
+      bakeFinal(event);
+    };
+    const onPointerCancel = () => {
+      if (!dragging) return;
+      dragging = false;
+      draggingRef.current = false;
+      unbindGesture();
+      document.body.style.userSelect = "";
+      const panel = panelRef.current;
+      panel.classList.remove("dshm-panel--dragging");
+      panel.style.willChange = "";
+      panel.style.transform = "";
+    };
+    const onPointerDown = (event) => {
+      if (dragging) return;
+      if (fullRef.current || event.button !== 0 || isDragTarget2(event.target)) return;
+      const panel = panelRef.current;
+      if (!panel) return;
+      dragging = true;
+      draggingRef.current = true;
+      moved = false;
+      lastPoint = null;
+      originX = event.clientX;
+      originY = event.clientY;
+      slop = dragSlop2(event.pointerType);
+      const rect = panel.getBoundingClientRect();
+      grab = grabOffset2({ x: event.clientX, y: event.clientY }, rect);
+      rest = { x: rect.left, y: rect.top };
+      size = { width: rect.width, height: rect.height };
+      if (headEl.setPointerCapture) {
+        try {
+          headEl.setPointerCapture(event.pointerId);
+        } catch {
+        }
+      }
+      bindGesture();
+    };
+    headEl.addEventListener("pointerdown", onPointerDown);
+    return () => {
+      headEl.removeEventListener("pointerdown", onPointerDown);
+      unbindGesture();
+      document.body.style.userSelect = "";
+    };
+  }, []);
   const marketCommunity = useMarketData("community");
   const marketPrimary = useMarketData("primary");
   const markets = { community: marketCommunity, primary: marketPrimary };
@@ -4841,10 +5121,29 @@ function MarketPanel({ onClose }) {
     { className: full ? "dshm-overlay full" : "dshm-overlay", ...backdropCloseHandlers2(onClose) },
     h(
       "div",
-      { className: full ? "dshm-panel full" : "dshm-panel", onClick: (e) => e.stopPropagation() },
+      {
+        className: ["dshm-panel", full && "full", !full && pos && "abs"].filter(Boolean).join(" "),
+        style: !full && pos ? { left: `${pos.x}px`, top: `${pos.y}px` } : void 0,
+        ref: panelRef,
+        onClick: (e) => e.stopPropagation()
+      },
       h(
         "div",
-        { className: "dshm-head" },
+        {
+          className: "dshm-head",
+          title: full ? void 0 : lookup("panel.dragHint"),
+          ref: headRef,
+          onDoubleClick: (e) => {
+            if (isDragTarget2(e.target)) return;
+            toggleFull();
+          },
+          onClickCapture: (e) => {
+            if (!suppressClickRef.current) return;
+            suppressClickRef.current = false;
+            e.stopPropagation();
+            e.preventDefault();
+          }
+        },
         h("span", { className: "dshm-title" }, lookup("title.full")),
         h("span", { className: "dshm-head-divider", "aria-hidden": "true" }),
         h(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-m",
-  "version": "0.9.68",
+  "version": "0.9.70",
   "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
   "license": "MIT",
   "type": "module",