dsh-vscode-mode 0.1.47 → 0.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/addToConversation.ts

@@ -15,6 +15,21 @@ export interface RefRange {
 /** 引用动作的返回状态。 */
 export type AddOutcome = 'ok' | 'busy' | 'unavailable'
 
+/** 引用外观类型：文件/文件夹（DSH reference source 均支持）。 */
+export type RefAppearance = 'file' | 'folder'
+
+/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
+ * @author ddj 2026年09月03号
+ * @param outcome 追加结果状态
+ * @param okText 成功文案（如「已添加文件引用」/「已添加文件夹引用」）
+ * @returns 状态栏/通知用文案
+ */
+export function statusOfAdd(outcome: AddOutcome, okText: string): string {
+  if (outcome === 'ok') return okText
+  if (outcome === 'busy') return okText + '（输入框忙，已降级纯文本）'
+  return '无法添加到对话（无会话或输入框不可用）'
+}
+
 /** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
 const REF_SOURCE = 'reference'
 
@@ -61,11 +76,17 @@ export function refOf(mention: string, range: RefRange | undefined): string {
     : `${mention} L${range.startLine}-${range.endLine}`
 }
 
-/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。 */
+/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。
+ * @param path 目标路径（相对 cwd 或绝对）
+ * @param cwd 会话工作区目录（可选）
+ * @param range 行区间（可选）
+ * @param appearance 引用外观：'file'（默认）| 'folder'
+ */
 export function buildFileRef(
   path: string,
   cwd: string | undefined,
   range?: RefRange,
+  appearance: RefAppearance = 'file',
 ): { reference: ReferenceInsertLike; mention: string } {
   const mention = mentionOf(path, cwd)
   return {
@@ -74,7 +95,7 @@ export function buildFileRef(
       source: REF_SOURCE,
       ref: refOf(mention, range),
       label: labelOf(path, range),
-      appearance: 'file',
+      appearance,
       clipboardText: mention,
     },
   }
@@ -85,7 +106,6 @@ export interface InputLike {
   state: { getSnapshot: () => { draft: string; draftRev: number } }
   insertReference: (ref: ReferenceInsertLike, span: TokenSpanLike) => boolean
   setDraft: (text: string) => void
-  notify: (level: 'info' | 'error', text: string) => void
 }
 
 /** ReferenceInsert 结构形状（与 dsh-client-ui-input-trigger 类型一致）。 */
@@ -111,8 +131,13 @@ export interface CtxLike {
 
 /** 注入器产物：给 EditorView 用的动作集合。 */
 export interface AddToConversation {
-  /** 追加文件引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
-  appendReference(sessionId: string | undefined, path: string, range?: RefRange): Promise<AddOutcome>
+  /** 追加文件/文件夹引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
+  appendReference(
+    sessionId: string | undefined,
+    path: string,
+    range?: RefRange,
+    appearance?: RefAppearance,
+  ): Promise<AddOutcome>
 }
 
 /**
@@ -161,16 +186,6 @@ function cwdOf(ctx: CtxLike, sessionId: string | undefined): string | undefined
   }
 }
 
-/** 写入成功后的 composer 内联提示（门面可用时；失败静默）。
- * @author ddj 2026年08月25号 */
-function notify(input: InputLike, text: string): void {
-  try {
-    input.notify?.('info', text)
-  } catch {
-    /* 提示失败忽略 */
-  }
-}
-
 /** 输入门面插入引用（拦截异常视作未应用，走降级）。
  * @author ddj 2026年08月25号 */
 function safeInsert(input: InputLike, reference: ReferenceInsertLike, span: TokenSpanLike): boolean {
@@ -188,22 +203,20 @@ function safeInsert(input: InputLike, reference: ReferenceInsertLike, span: Toke
  * @returns 动作集
  */
 export function createAddToConversation(ctx: CtxLike): AddToConversation {
-  const appendReference: AddToConversation['appendReference'] = async (sessionId, path, range) => {
+  const appendReference: AddToConversation['appendReference'] = async (sessionId, path, range, appearance) => {
     const input = inputFor(ctx, sessionId)
     if (!input) return 'unavailable'
     const cur = draftCursor(input)
     if (!cur) return 'unavailable'
-    const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range)
+    const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range, appearance)
     const span: TokenSpanLike = { start: cur.draft.length, end: cur.draft.length, draftRev: cur.draftRev }
     const ok = safeInsert(input, reference, span)
     if (!ok) {
       // 忙态（adjudicating/submitting）或 CAS 失败：降级纯文本追加，保证动作有落点。
       const gap = cur.draft.length > 0 && !/\s$/.test(cur.draft) ? ' ' : ''
       input.setDraft(cur.draft + gap + mention + ' ')
-      notify(input, '已添加文件引用 ' + mention)
       return 'busy'
     }
-    notify(input, '已添加文件引用 ' + mention)
     return 'ok'
   }
 

package/src/client/compat.ts

@@ -11,7 +11,7 @@ export const SIDEBAR_PLUGIN = 'dsh-better-sidebar'
 
 /** 设置 scope 的跨组件上下文形状（与官方 settingsScope 绑定的最小面）。 */
 export interface SettingsScopeLike {
-  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown; keybindings?: Record<string, string> }; writable?: boolean }
+  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown; keybindings?: Record<string, string>; sidebarMinWidth?: unknown }; writable?: boolean }
   subscribe: (listener: () => void) => () => void
   set: (field: string, value: unknown) => Promise<void>
 }

package/src/client/index.ts

@@ -33,12 +33,14 @@ import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
 import { createSearchPanel } from './sidebar/panels/index.js'
+import { createRulesPanel } from './sidebar/panels/index.js'
 import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
 import { createDefaultFileMenuItems } from './sidebar/menuItems.js'
 import { createOutlinePanel } from './outline/index.js'
 import { createOutlineSourceRegistry, registerBuiltinOutlineSources } from './outline/sources.js'
 import { createLspOutlineSource } from './outline/lspSource.js'
 import { keybindingsApply } from './keybindings.js'
+import { sidebarMinApply } from './sidebarMin.js'
 import { setupLsp, setSession } from './monaco/lsp/index.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
@@ -114,6 +116,8 @@ export function apply(ctx: any): void {
   ctx.effect(() => sidebarPanels.register(createFilePanel()), 'vscode-mode: sidebar panel')
   // 搜索面板：活动栏「搜索」页签（Ctrl+Shift+F 唤起，VSCode 搜索视图形态）
   ctx.effect(() => sidebarPanels.register(createSearchPanel()), 'vscode-mode: sidebar panel search')
+  // 规则面板：活动栏「规则」页签（Codebuddy 规则管理形态：用户/项目规则 + 启用开关，host 注入生效）
+  ctx.effect(() => sidebarPanels.register(createRulesPanel()), 'vscode-mode: sidebar panel rules')
   // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
   const fileMenuItems = createTreeMenuRegistry()
   ctx.provide('edrvFileContextMenuItems', fileMenuItems)
@@ -147,12 +151,15 @@ export function apply(ctx: any): void {
     return settings.subscribe(sync)
   }, 'vscode-mode: file opener setting sync')
   // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
+  // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
   ctx.effect(() => {
     if (!settings) return undefined
     const sync = (): void => {
       const snapshot = settings.getSnapshot()
       if (snapshot.status === 'loading') return
       keybindingsApply(snapshot.value?.keybindings)
+      const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
+      window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
     }
     sync()
     return settings.subscribe(sync)
@@ -181,7 +188,7 @@ export function apply(ctx: any): void {
       order: 5,
       label: '文件编辑',
       inject: (sessionId: string) => ({ sessionId }),
-    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })))
+    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })))
   }
 
   // 侧边栏/中央页签两形态互斥切换：sideDisposer（侧边栏 Tab）与 legacyDisposer（中央页签）只保留其一。
@@ -197,7 +204,7 @@ export function apply(ctx: any): void {
       if (legacyDisposer !== null) { legacyDisposer(); legacyDisposer = null }
       sideDisposer = ctx.effect(() => installSideEditor({
         service: sideService as NonNullable<typeof sideService>,
-        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })),
+        renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })),
         activeSession: () => {
           const snapshot = sessions?.list?.getSnapshot?.() as { current?: string; byId?: Record<string, { cwd?: string }> } | undefined
           const sessionId = snapshot?.current

package/src/client/paths.ts

@@ -24,6 +24,8 @@ export const CACHE_KEY = {
   sideHint: 'edrv.side-hint-dismissed',
   /** 「性能优化」页工作区栏目展开状态（workspaceFoldCache v1，全局不按会话）。 */
   workspaceFold: 'edrv.ws-fold.v1.',
+  /** 规则面板 UI 状态（RulesPanel v1：Tab 与项目工作区选择，全局不按会话）。 */
+  rules: 'edrv.rules.v1.',
 } as const
 
 /** 按前缀拼会话键（侧边栏/编辑器等需要布局段时自行拼接后传入）。 */

package/src/client/sidebar/SidebarView.ts

@@ -1,15 +1,22 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — 侧边栏容器（活动栏 + 面板区 + 拖拽调宽）。
- * 面板列表来自注册表（活动栏图标/徽标/激活态），渲染当前激活面板的 render(ctx)；
- * 右侧手柄拖拽调宽（clamp 180–560），底部按钮收起侧边栏。
- * 作者 ddj 2026-08-26
+ * dsh-vscode-mode client — 侧边栏容器（活动栏常显 + 可隐藏面板区 + 拖拽调宽）。
+ * 面板列表来自注册表（活动栏图标/徽标/激活态）；最左侧图标列（活动栏）常显，
+ * 右侧详情面板区可拖拽调宽/隐藏：visible=false 时仅保留图标列（宽 = 图标列宽），
+ * 点击任一图标重新展开面板（onShow），底部按钮在 ◀ 收起 / ▶ 展开间切换。
+ * 拖拽调宽下限 = minWidth prop（通用设置 sidebarMinWidth，默认 300），低于下限直接收起面板区。
+ * 作者 ddj 2026-08-26 / 2026-09-04
  */
 import React from 'react'
 import type { SidebarCtx } from './types.js'
 
-const W_MIN = 180
 const W_MAX = 560
+/** 面板区隐藏时容器的宽度（= 图标列宽，与 editor.css .edrv-rail 对齐）。 */
+const RAIL_ONLY_W = 44
+/** 隐藏态接缝拖拽条宽度（与 editor.css .edrv-side-resize 对齐）。 */
+const SEAM_W = 5
+/** 隐藏态拖出面板区的触发阈值（px，拖过即展开并继续实时调宽）。 */
+const PULL_OUT_THRESHOLD = 12
 
 /**
  * 侧边栏容器。
@@ -17,18 +24,24 @@ const W_MAX = 560
  * @param props.ctx 面板共享上下文
  * @param props.activePanel 当前激活面板 id
  * @param props.onActive 激活面板变化回调
+ * @param props.visible 面板区是否可见（false = 只显示活动栏）
+ * @param props.onShow 重新展开面板区回调（活动栏图标点击/底部按钮）
  * @param props.width 面板区宽度
  * @param props.onWidth 宽度变化回调
- * @param props.onHide 收起侧边栏回调
+ * @param props.onHide 收起面板区回调
+ * @param props.minWidth 最小宽度（通用设置 sidebarMinWidth；拖拽低于它触发隐藏）
  */
 export function SidebarView(props) {
   const panels = props.registry?.list?.() ?? []
   const ctx = props.ctx
   const activePanel = props.activePanel
   const onActive = props.onActive
+  const visible = props.visible !== false
+  const onShow = props.onShow
   const width = props.width
   const onWidth = props.onWidth
   const onHide = props.onHide
+  const wMin = Math.max(120, Math.min(W_MAX, Math.round(Number(props.minWidth) || 300)))
 
   const active = panels.find((p) => p.id === activePanel) || panels[0]
 
@@ -36,14 +49,51 @@ export function SidebarView(props) {
     e.preventDefault()
     const startX = e.clientX
     const startW = width
+    const cleanup = () => {
+      window.removeEventListener('pointermove', onMove)
+      window.removeEventListener('pointerup', onUp)
+    }
+    const onUp = () => cleanup()
     const onMove = (ev) => {
-      const w = Math.max(W_MIN, Math.min(W_MAX, startW + (ev.clientX - startX)))
-      onWidth(w)
+      const raw = startW + (ev.clientX - startX)
+      // 低于最小宽度：清理监听并直接收起面板区（不夹住）
+      if (raw < wMin) {
+        cleanup()
+        onHide()
+        return
+      }
+      onWidth(Math.min(W_MAX, raw))
     }
-    const onUp = () => {
+    window.addEventListener('pointermove', onMove)
+    window.addEventListener('pointerup', onUp)
+
+  }
+
+  /**
+   * 隐藏态接缝拖拽：向右拖过阈值把面板区拉出来（以记忆宽度展开），继续拖动实时调宽。
+   * @param e pointerdown 事件
+   */
+  const onSeamPointerDown = (e) => {
+    e.preventDefault()
+    const startX = e.clientX
+    const baseW = Math.max(wMin, Math.min(W_MAX, Math.round(Number(width) || wMin)))
+    let expanded = false
+    let expandStartX = 0
+    const cleanup = () => {
       window.removeEventListener('pointermove', onMove)
       window.removeEventListener('pointerup', onUp)
     }
+    const onUp = () => cleanup()
+    const onMove = (ev) => {
+      if (!expanded) {
+        if (ev.clientX - startX < PULL_OUT_THRESHOLD) return
+        expanded = true
+        expandStartX = ev.clientX
+        onShow()
+        return
+      }
+      onWidth(Math.max(wMin, Math.min(W_MAX, baseW + (ev.clientX - expandStartX))))
+    }
     window.addEventListener('pointermove', onMove)
     window.addEventListener('pointerup', onUp)
   }
@@ -54,20 +104,36 @@ export function SidebarView(props) {
         const count = typeof p.badge === 'function' ? p.badge(ctx) : null
         return React.createElement('button', {
           key: p.id,
-          className: 'edrv-rail-btn' + (active && p.id === active.id ? ' edrv-rail-on' : ''),
+          className: 'edrv-rail-btn' + (visible && active && p.id === active.id ? ' edrv-rail-on' : ''),
           title: p.title,
-          onClick: () => onActive(p.id),
+          onClick: () => {
+            onActive(p.id)
+            // 面板区隐藏时点击图标 = 展开到该面板（VSCode 活动栏行为）
+            if (!visible && typeof onShow === 'function') onShow()
+          },
         },
           React.createElement('span', { className: 'edrv-rail-icon' }, p.icon),
           count > 0
             ? React.createElement('span', { className: 'edrv-rail-badge' }, String(count))
             : null)
       })),
-    React.createElement('button', { className: 'edrv-rail-btn', title: '隐藏侧边栏 (Ctrl+B)', onClick: onHide }, '◀'))
+    React.createElement('button', {
+      className: 'edrv-rail-btn',
+      title: (visible ? '隐藏面板区' : '展开面板区') + ' (Ctrl+B)',
+      onClick: () => (visible ? onHide() : onShow?.()),
+    }, visible ? '◀' : '▶'))
 
-  return React.createElement('div', { className: 'edrv-sidebar', style: { width } },
+  return React.createElement('div', {
+    className: 'edrv-sidebar' + (visible ? '' : ' edrv-sidebar-rail-only'),
+    style: { width: visible ? width : RAIL_ONLY_W + SEAM_W },
+  },
     rail,
-    React.createElement('div', { className: 'edrv-side-body' },
-      active ? active.render(ctx) : null),
-    React.createElement('div', { className: 'edrv-side-resize', onPointerDown: onPointerDown }))
+    visible
+      ? React.createElement('div', { className: 'edrv-side-body' },
+          active ? active.render(ctx) : null)
+      : null,
+    visible
+      ? React.createElement('div', { className: 'edrv-side-resize', onPointerDown: onPointerDown })
+      // 隐藏态接缝：悬浮显示拖拽光标与高亮，向右拖把面板区拉出来
+      : React.createElement('div', { className: 'edrv-side-resize', title: '拖拽展开面板区', onPointerDown: onSeamPointerDown }))
 }

package/src/client/sidebar/menuItems.ts

@@ -1,10 +1,12 @@
 /**
  * dsh-vscode-mode client — 文件管理右键菜单内置项。
- * 首个内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）。
+ * 内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）；
+ * 「添加引用到对话」（文件/文件夹引用注入当前会话对话输入框）。
  * 反馈统一走 ctx.notify（由 EditorView 提供，落到编辑区路径栏状态）。
- * 作者 ddj 2026-08-27
+ * 作者 ddj 2026-08-27 / 2026-09-03
  */
 import { revealInExplorer } from '../fileReveal.js'
+import { statusOfAdd } from '../addToConversation.js'
 import type { TreeMenuItem } from './contextMenu.js'
 
 /**
@@ -24,5 +26,24 @@ export function createDefaultFileMenuItems(): TreeMenuItem[] {
         })
       },
     },
+    {
+      id: 'add-to-conversation',
+      label: '添加引用到对话',
+      order: 1,
+      // 排除根目录空白区（path==='' 无意义）、无会话、动作集缺失时隐藏
+      visible: (target, ctx) => Boolean(target.path && ctx.sessionId && ctx.addToConversation),
+      run: (target, ctx) => {
+        const isDir = target.type === 'directory'
+        const add = ctx.addToConversation
+        if (!add) {
+          ctx.notify?.('添加到对话不可用')
+          return
+        }
+        const okText = isDir ? '已添加文件夹引用' : '已添加文件引用'
+        void add.appendReference(ctx.sessionId, target.path, undefined, isDir ? 'folder' : 'file').then((outcome) => {
+          ctx.notify?.(statusOfAdd(outcome, okText))
+        })
+      },
+    },
   ]
 }

package/src/client/sidebar/panels/FileExplorer.ts

@@ -11,7 +11,6 @@
 import React from 'react'
 import { rpc } from '../../rpc.js'
 import { ContextMenu } from '../../ui/ContextMenu.js'
-import { rowMenuPosition } from '../../ui/menuPosition.js'
 import { buildTreeMenu } from '../contextMenu.js'
 import { explorerLoad, explorerSave } from '../../state/explorerCache.js'
 import { entriesCacheGet, entriesCacheIsFresh, entriesCachePut } from '../../state/explorerEntriesCache.js'
@@ -219,9 +218,8 @@ export function FileExplorer(props) {
       onContextMenu: (ev) => {
         ev.preventDefault()
         ev.stopPropagation()
-        const rect = ev.currentTarget?.getBoundingClientRect?.()
-        const position = rowMenuPosition(rect, ev.clientX, ev.clientY)
-        setMenu({ x: position.left, y: position.top, target: { path: e.path, type: e.type } })
+        // 菜单左上角对齐鼠标点击位置（视口坐标，ContextMenu 内再做 viewport clamp）
+        setMenu({ x: ev.clientX, y: ev.clientY, target: { path: e.path, type: e.type } })
       },
     },
       React.createElement('span', { className: 'edrv-tree-chev' },