dsh-data-cleaning-agent 0.8.9 → 0.8.10

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件记录 `dsh-data-cleaning-agent` 的版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [Unreleased]
+
+## [0.8.10] - 2026-09-07
+
+### Changed
+- 依据共享 DSH-UX-001 v1.3.0 / UX-39，为自有右侧工作台补充左侧连续拖拽分隔条、方向键和 Home/End 调宽、双击复位、拖动取消、手动宽度恢复；中央会话按实际面板宽度同步让位。
+- 按宿主会话区域实际可用宽度约束上下限，空间不足时全屏降级；关闭、切换或卸载恢复自有布局变量并清理监听，不改变 Host 任务、QCC 调用或发送机制。
+
+### Tests
+- 补充实际拖拽、取消、展开转手动、键盘调宽、关闭重开、宿主区域尺寸变化及让位清理回归；发布前通过 214 项检查测试与 10 组隔离 Chromium UI 回归。
+
 ## [0.8.9] - 2026-09-07
 
 ### Changed

package/README.en.md

@@ -2,9 +2,9 @@
 
 > A data cleaning & completion agent plugin for DeepSeek Harness: local CSV/XLSX/JSON engine plus optional Qichacha (QCC) MCP enterprise-data enrichment. Initiated and maintained by the Qichacha (QCC) team.
 >
-> Current source version / 当前源码版本: **0.8.9** (stable release)
+> Current source version / 当前源码版本: **0.8.10** (stable release)
 
-This release aligns the workbench stage menu with the tender agent: five equal-width columns in one row, line icons above short labels, and a pale-blue selection with a blue underline. Narrow layouts stay within the panel. All 128 fields, existing workflows, and native DSH input and send behavior are preserved.
+This release adds continuous resizing from the workbench's left edge, keeping the native composer clear. Arrow keys, Home/End, double-click reset, and width restoration on reopening are supported. Constrained layouts use a full-screen drawer. All 128 fields, QCC-blue menus, existing workflows, and native DSH input and send behavior are preserved.
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/README.md

@@ -2,9 +2,9 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.8.9**（正式版本）
+> 当前源码版本 / Current source version: **0.8.10**（正式版本）
 
-本版将右侧阶段菜单对齐招投标工作台：单行五个等宽分栏、上图标下短标题，选中项采用浅蓝底和蓝色底线；窄屏不换行、不横向溢出。保留企查查蓝界面、全部 128 个字段和原有工作流，不替换 DSH 原生输入和发送机制。
+本版支持拖动右侧工作台左边缘连续调宽，中央输入区同步让位；支持方向键微调、Home/End 边界、双击恢复默认和关闭重开保留宽度。空间不足时全屏降级。保留企查查蓝菜单、全部 128 个字段和原有工作流，不替换 DSH 原生输入和发送机制。
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/lib/client.js

@@ -77,6 +77,123 @@ window.__ModuleLoader__.load({
         'aria-hidden': true, focusable: false }, h('path', { d: STAGE_ICON_PATHS[kind] }));
     }
 
+    function workbenchWidthBounds(viewport, available = viewport) {
+      const mobile = viewport <= 760 || available < 740;
+      return { mobile, min: mobile ? viewport : 320, max: mobile ? viewport : Math.max(320, available - 420) };
+    }
+
+    // 自有抽屉的可逆兼容适配；不改 Better Sidebar 或其他插件的面板偏好。
+    function installWorkbenchSizing(drawer, { preferredWidth, expanded, onWidthChange }) {
+      const doc = drawer.ownerDocument;
+      const view = doc.defaultView;
+      const handle = drawer.querySelector('.dcAgentResizeHandle');
+      if (!handle || !view) return () => {};
+      const reservations = new Map();
+      let requested = expanded ? 980 : preferredWidth;
+      let current = 0;
+      let drag = null;
+      const boundsForView = () => workbenchWidthBounds(view.innerWidth,
+        doc.querySelector('[data-conversation-scroll]')?.getBoundingClientRect().width || view.innerWidth);
+      const reserve = () => {
+        const width = boundsForView().mobile ? 0 : drawer.getBoundingClientRect().width;
+        for (const el of doc.querySelectorAll('[data-conversation-scroll]')) {
+          if (!reservations.has(el)) {
+            reservations.set(el, {
+              value: el.style.getPropertyValue('--dc-agent-workbench-reserve'),
+              priority: el.style.getPropertyPriority('--dc-agent-workbench-reserve'),
+            });
+            sizeObserver?.observe(el, { box: 'border-box' });
+          }
+          if (el.style.getPropertyValue('--dc-agent-workbench-reserve') !== `${width}px`) {
+            el.style.setProperty('--dc-agent-workbench-reserve', `${width}px`);
+          }
+        }
+      };
+      const apply = (value) => {
+        const bounds = boundsForView();
+        const fallback = view.innerWidth <= 1040 ? Math.min(420, view.innerWidth * .48) : Math.min(460, view.innerWidth * .42);
+        current = Math.round(Math.min(bounds.max, Math.max(bounds.min, Number.isFinite(value) ? value : fallback)));
+        drawer.dataset.narrow = String(bounds.mobile);
+        drawer.style.setProperty('--dc-agent-panel-width', `${current}px`);
+        handle.setAttribute('aria-valuemin', String(bounds.min));
+        handle.setAttribute('aria-valuemax', String(bounds.max));
+        handle.setAttribute('aria-valuenow', String(current));
+        handle.setAttribute('aria-valuetext', `${current} 像素`);
+        reserve();
+      };
+      const end = (cancel = false) => {
+        if (!drag) return;
+        const previous = drag;
+        drag = null;
+        drawer.classList.remove('is-resizing');
+        if (handle.hasPointerCapture?.(previous.id)) handle.releasePointerCapture(previous.id);
+        if (cancel) apply(requested);
+        else { requested = current; onWidthChange(current); }
+      };
+      const down = (event) => {
+        if (event.button !== 0 || drag || boundsForView().mobile) return;
+        event.preventDefault();
+        handle.focus();
+        drag = { id: event.pointerId, startX: event.clientX, startWidth: current };
+        handle.setPointerCapture(event.pointerId);
+        drawer.classList.add('is-resizing');
+      };
+      const move = (event) => {
+        if (drag?.id !== event.pointerId) return;
+        apply(drag.startWidth + drag.startX - event.clientX);
+      };
+      const up = (event) => { if (drag?.id === event.pointerId) end(); };
+      const cancel = () => end(true);
+      const keydown = (event) => {
+        if (event.key === 'Escape' && drag) {
+          event.preventDefault(); event.stopPropagation(); cancel(); return;
+        }
+        if (drag || boundsForView().mobile) return;
+        const bounds = boundsForView();
+        const delta = event.shiftKey ? 48 : 16;
+        const value = { ArrowLeft: current + delta, ArrowRight: current - delta, Home: bounds.min, End: bounds.max }[event.key];
+        if (value === undefined) return;
+        event.preventDefault(); event.stopPropagation();
+        requested = value; apply(value); onWidthChange(current);
+      };
+      const reset = () => { cancel(); requested = null; apply(null); onWidthChange(null); };
+      const resize = () => { cancel(); apply(requested); };
+      const sizeObserver = typeof view.ResizeObserver === 'function' ? new view.ResizeObserver(resize) : null;
+      handle.addEventListener('pointerdown', down);
+      handle.addEventListener('pointermove', move);
+      handle.addEventListener('pointerup', up);
+      handle.addEventListener('pointercancel', cancel);
+      handle.addEventListener('lostpointercapture', cancel);
+      handle.addEventListener('keydown', keydown);
+      handle.addEventListener('dblclick', reset);
+      view.addEventListener('resize', resize);
+      view.addEventListener('blur', cancel);
+      // 会话挂载点可被宿主替换；只对当前存在的滚动区设置自有让位变量。
+      const observer = typeof view.MutationObserver === 'function' ? new view.MutationObserver(reserve) : null;
+      observer?.observe(doc.body, { childList: true, subtree: true });
+      apply(requested);
+      return () => {
+        cancel();
+        observer?.disconnect();
+        sizeObserver?.disconnect();
+        handle.removeEventListener('pointerdown', down);
+        handle.removeEventListener('pointermove', move);
+        handle.removeEventListener('pointerup', up);
+        handle.removeEventListener('pointercancel', cancel);
+        handle.removeEventListener('lostpointercapture', cancel);
+        handle.removeEventListener('keydown', keydown);
+        handle.removeEventListener('dblclick', reset);
+        view.removeEventListener('resize', resize);
+        view.removeEventListener('blur', cancel);
+        drawer.style.removeProperty('--dc-agent-panel-width');
+        delete drawer.dataset.narrow;
+        for (const [el, previous] of reservations) {
+          if (previous.value) el.style.setProperty('--dc-agent-workbench-reserve', previous.value, previous.priority);
+          else el.style.removeProperty('--dc-agent-workbench-reserve');
+        }
+      };
+    }
+
     // 搜索仅改变可见字段，绝不清除已选字段或改变 Host 的字段目录。
     function visibleCatalogFields(group, query) {
       const needle = String(query || '').trim().toLowerCase();
@@ -166,12 +283,13 @@ window.__ModuleLoader__.load({
 }
 
 .dcAgentWorkbench {
+  position: relative;
   box-sizing: border-box;
   display: flex;
   flex-direction: column;
-  width: min(460px, 42vw);
+  width: var(--dc-agent-panel-width, min(460px, 42vw));
   max-width: calc(100vw - 420px);
-  min-width: 360px;
+  min-width: 320px;
   height: 100vh;
   border: 1px solid var(--dc-border);
   border-radius: 12px 0 0 12px;
@@ -181,7 +299,14 @@ window.__ModuleLoader__.load({
   overflow: hidden;
   pointer-events: auto;
 }
-.dcAgentWorkbench.is-expanded { width: min(980px, calc(100vw - 72px)); }
+.dcAgentWorkbench.is-expanded { width: var(--dc-agent-panel-width, min(980px, calc(100vw - 420px))); }
+.dcAgentResizeHandle { position: absolute; left: 0; top: 0; bottom: 0; width: 8px; z-index: 5; cursor: col-resize; touch-action: none; outline: none; }
+.dcAgentResizeHandle::after { content: ''; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; background: transparent; }
+.dcAgentResizeHandle:hover::after, .dcAgentResizeHandle:focus-visible::after, .is-resizing .dcAgentResizeHandle::after { background: var(--dc-action); }
+.dcAgentWorkbench.is-resizing { user-select: none; }
+.dcAgentWorkbench[data-narrow="true"] { width: 100vw; max-width: none; min-width: 0; border-radius: 0; }
+.dcAgentWorkbench[data-narrow="true"] .dcAgentResizeHandle { display: none; }
+.dcAgentOverlay:has(.dcAgentWorkbench[data-narrow="true"]) { background: rgba(8, 10, 14, 0.22); pointer-events: auto; }
 
 .dcAgentCapabilities {
   display: flex;
@@ -847,24 +972,25 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
 @media (min-width: 1041px) {
   body:has(.dcAgentWorkbench) [data-conversation-scroll] {
     box-sizing: border-box;
-    padding-right: min(460px, 42vw);
+    padding-right: var(--dc-agent-workbench-reserve, min(460px, 42vw));
   }
 }
 @media (min-width: 761px) and (max-width: 1040px) {
   body:has(.dcAgentWorkbench) [data-conversation-scroll] {
     box-sizing: border-box;
-    padding-right: min(420px, 48vw);
+    padding-right: var(--dc-agent-workbench-reserve, min(420px, 48vw));
   }
 }
 @media (min-width: 761px) {
   body:has(.dcAgentWorkbench.is-expanded) [data-conversation-scroll] {
     box-sizing: border-box;
-    padding-right: min(980px, calc(100vw - 420px));
+    padding-right: var(--dc-agent-workbench-reserve, min(980px, calc(100vw - 420px)));
   }
 }
 @media (max-width: 760px) {
   .dcAgentWorkbench, .dcAgentWorkbench.is-expanded { width: 100vw; max-width: none; min-width: 0; border-radius: 0; }
   .dcAgentOverlay { background: rgba(8, 10, 14, 0.22); pointer-events: auto; }
+  .dcAgentResizeHandle { display: none; }
   .dcAgentQccBadge, .dcAgentJobsPill { display: none; }
   .dcAgentCandidate { grid-template-columns: 1fr; }
   .dcAgentCapabilities { justify-content: flex-start; padding-inline: 12px; }
@@ -877,7 +1003,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
   .dcAgentMappingRow > b { display: none; }
 }
 @media (min-width: 761px) and (max-width: 1040px) {
-  .dcAgentWorkbench { width: 420px; max-width: 48vw; min-width: 360px; }
+  .dcAgentWorkbench { width: var(--dc-agent-panel-width, 420px); }
   .dcAgentQccBadge, .dcAgentJobsPill { display: none; }
 }
 @media (max-width: 360px) {
@@ -1487,6 +1613,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         init: () => ({
           open: false,
           expanded: false,
+          preferredWidth: null,
           step: 'upload',
           busy: false,
           error: null,
@@ -1521,6 +1648,10 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           },
           close: (draft) => { draft.open = false; },
           toggleExpanded: (draft) => { draft.expanded = !draft.expanded; },
+          setPreferredWidth: (draft, width) => {
+            draft.preferredWidth = Number.isFinite(width) ? width : null;
+            draft.expanded = false;
+          },
           setStep: (draft, step) => { draft.step = step; },
           setActiveSession: (draft, sessionId) => { draft.activeSessionId = sessionId ?? null; },
           setBusy: (draft, busy) => { draft.busy = busy; },
@@ -2968,6 +3099,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       const open = useStore((state) => state.open);
       const step = useStore((state) => state.step);
       const expanded = useStore((state) => state.expanded);
+      const preferredWidth = useStore((state) => state.preferredWidth);
       const busy = useStore((state) => state.busy);
       const error = useStore((state) => state.error);
       const input = useStore((state) => state.input);
@@ -2993,6 +3125,13 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       const activeSessionId = useStore((state) => state.activeSessionId);
       const [fieldQuery, setFieldQuery] = react.useState('');
 
+      react.useEffect(() => {
+        if (!open || typeof document === 'undefined') return undefined;
+        const drawer = document.querySelector('.dcAgentWorkbench');
+        if (!drawer) return undefined;
+        return installWorkbenchSizing(drawer, { preferredWidth, expanded, onWidthChange: actions.setPreferredWidth });
+      }, [open, expanded, preferredWidth, actions]);
+
       react.useEffect(() => {
         rootWorkbenchActions = actions;
         const handleOpen = (event) => {
@@ -3104,7 +3243,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           view?.removeEventListener?.('resize', align);
           reset();
         };
-      }, [open, expanded]);
+      }, [open, expanded, preferredWidth]);
 
       // DSH 的 useStore 基于 React hooks；所有订阅必须在每次渲染时以相同顺序调用。
       // 把关闭态 guard 放在全部 useStore 之后，避免首次关闭、随后打开时触发
@@ -3979,6 +4118,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           'aria-modal': 'false',
           'aria-label': '数据清洗补全工作台',
           'data-session-id': activeSessionId ?? undefined,
+          id: 'dc-agent-workbench',
           onKeyDown: (event) => {
             if (event.key === 'Escape') {
               event.preventDefault();
@@ -3987,6 +4127,9 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
             }
           },
         },
+          h('div', { className: 'dcAgentResizeHandle', role: 'separator', tabIndex: 0,
+            'aria-label': '调整工作台宽度', 'aria-orientation': 'vertical', 'aria-controls': 'dc-agent-workbench',
+            title: '拖动调整宽度；左右方向键微调，Home/End 最小/最大，双击恢复默认' }),
           h('header', { className: 'dcAgentWbHeader' },
             h('div', { className: 'dcAgentWbTitle' },
               h('span', { className: 'dcAgentWbIcon', 'aria-hidden': 'true' }, h(DatabaseLogo, { size: 22 })),
@@ -4153,6 +4296,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     exports.inject = inject;
     // 测试用纯函数，不构成 Host / DSH 稳定 API。
     exports.__testing = {
+      workbenchWidthBounds,
       DatabaseLogo,
       visibleCatalogFields,
       installCapabilityMount,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "description": "Clean, complete, and profile enterprise name lists in DeepSeek Harness — a data cleaning & completion agent plugin with local CSV/XLSX/JSON engine and optional Qichacha (QCC) MCP enrichment. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",