dsh-vscode-mode 0.1.48 → 0.1.50

package/package.json

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

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/rulesMdc.ts

@@ -0,0 +1,141 @@
+/**
+ * dsh-vscode-mode client — 规则 frontmatter 纯函数（解析 + 按类型改写）。
+ * 与 host parseRuleMdc/ruleTypeOf 语义对齐的浏览器端实现：编辑器类型下拉与
+ * 原始 .mdc 文本域双向同步共用；纯字符串运算，禁 node/react 导入。
+ * 作者 ddj 2026年09月07号
+ */
+
+/** 规则生效类型（与 shared/rules.ts RuleType 一致，此处独立声明避免引入 host 依赖）。 */
+export type RuleFmType = 'always' | 'auto' | 'manual'
+
+/** 一条 .mdc 文本的解析结果（改写 frontmatter 所需的全部上下文）。 */
+export interface RuleFmParsed {
+  type: RuleFmType
+  description: string
+  alwaysApply: boolean
+  globs: string[]
+  enabled: boolean
+  /** 是否存在规则 frontmatter（首行 --- 且有闭合）。 */
+  hasFm: boolean
+  /** 闭合 --- 之后的正文（按 \n 归一，与 host 解析一致）。 */
+  body: string
+  /** 已知键之外的 frontmatter 原行（如 updatedAt），改写时原样保留。 */
+  fmExtra: string[]
+  /** 原文是否带 BOM（改写后回填）。 */
+  bom: boolean
+  /** 原文 frontmatter 是否显式写了 enabled 行（改写时保持该行存在与否）。 */
+  hasEnabledLine: boolean
+}
+
+/** 类型改写入参：下拉/描述/globs 控件的最新值。 */
+export interface RuleMetaNext {
+  type: RuleFmType
+  description: string
+  globs: string[]
+}
+
+/**
+ * 去除值两侧成对引号（与 host stripQuotes 一致）。
+ * @author ddj 2026年09月07号
+ * @param raw 原始值
+ * @returns 去引号后的值
+ */
+function stripQuotes(raw: string): string {
+  const value = raw.trim()
+  if (value.length >= 2 && ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'")))) {
+    return value.slice(1, -1)
+  }
+  return value
+}
+
+// --region 解析
+/**
+ * 解析 .mdc 全文：首行 --- 且 100 行内有闭合 --- 才视为 frontmatter；
+ * 已知键 description/alwaysApply/globs/enabled，其余原行进 fmExtra；永不抛错。
+ * @author ddj 2026年09月07号
+ * @param text 文件全文
+ * @returns 解析结果
+ */
+export function parseRuleFm(text: string): RuleFmParsed {
+  const bom = text.startsWith('\uFEFF')
+  const lines = text.replace(/^\uFEFF/, '').split(/\r?\n/)
+  const none: RuleFmParsed = { type: 'manual', description: '', alwaysApply: false, globs: [], enabled: true, hasFm: false, body: text.replace(/^\uFEFF/, ''), fmExtra: [], bom, hasEnabledLine: false }
+  if (lines[0]?.trim() !== '---') return none
+  let close = -1
+  for (let i = 1; i < lines.length && i <= 101; i++) {
+    if (lines[i].trim() === '---') { close = i; break }
+  }
+  if (close < 0) return none
+  const parsed: RuleFmParsed = { type: 'manual', description: '', alwaysApply: false, globs: [], enabled: true, hasFm: true, body: lines.slice(close + 1).join('\n'), fmExtra: [], bom, hasEnabledLine: false }
+  for (let i = 1; i < close; i++) {
+    const match = /^([A-Za-z_-]+)[ \t]*:[ \t]?(.*)$/.exec(lines[i])
+    if (!match) { parsed.fmExtra.push(lines[i]); continue }
+    const [, key, raw] = match
+    if (key === 'description') parsed.description = stripQuotes(raw)
+    else if (key === 'alwaysApply') parsed.alwaysApply = stripQuotes(raw).toLowerCase() === 'true'
+    else if (key === 'enabled') { parsed.enabled = stripQuotes(raw).toLowerCase() !== 'false'; parsed.hasEnabledLine = true }
+    else if (key === 'globs') parsed.globs = parseGlobsValue(raw, lines, i, close)
+    else parsed.fmExtra.push(lines[i])
+  }
+  parsed.type = fmTypeOf(parsed)
+  return parsed
+}
+
+/**
+ * 解析 globs 值：内联逗号分隔串，或空值后接 YAML 短横列表（与 host parseGlobs 一致）。
+ * @author ddj 2026年09月07号
+ * @param value 内联值
+ * @param lines 全文行
+ * @param start globs 行下标
+ * @param close 闭合 --- 下标
+ * @returns glob 数组
+ */
+function parseGlobsValue(value: string, lines: string[], start: number, close: number): string[] {
+  const inline = stripQuotes(value)
+  if (inline) return inline.split(',').map((item) => stripQuotes(item)).filter(Boolean)
+  const list: string[] = []
+  for (let j = start + 1; j < close; j++) {
+    const item = /^[ \t]*-[ \t]*(.+)$/.exec(lines[j])
+    if (!item) break
+    list.push(stripQuotes(item[1]))
+  }
+  return list
+}
+
+/**
+ * 由 frontmatter 推导类型：alwaysApply=true → 总是；有 globs → 自动；否则手动。
+ * @author ddj 2026年09月07号
+ * @param parsed 解析结果
+ * @returns 规则类型
+ */
+function fmTypeOf(parsed: RuleFmParsed): RuleFmType {
+  if (parsed.alwaysApply) return 'always'
+  if (parsed.globs.length) return 'auto'
+  return 'manual'
+}
+// --endregion
+
+// --region 改写
+/**
+ * 按最新控件值重写 frontmatter：known 键固定顺序 + fmExtra + 闭合 --- + 原 body；
+ * 无 frontmatter 且目标为手动时：有描述则新建仅含描述的 frontmatter，否则原文返回。
+ * @author ddj 2026年09月07号
+ * @param parsed parseRuleFm 的结果（必须来自同一文本）
+ * @param next 控件最新值
+ * @returns 重写后的全文
+ */
+export function applyRuleMeta(parsed: RuleFmParsed, next: RuleMetaNext): string {
+  if (!parsed.hasFm && next.type === 'manual') {
+    if (!next.description.trim()) return (parsed.bom ? '\uFEFF' : '') + parsed.body
+    return (parsed.bom ? '\uFEFF' : '') + ['---', 'description: ' + next.description.trim(), '---'].join('\n') + '\n' + parsed.body
+  }
+  const lines: string[] = ['---']
+  lines.push('description: ' + next.description.trim())
+  if (next.type === 'always') lines.push('alwaysApply: true')
+  if (next.type === 'auto') lines.push('globs: ' + next.globs.join(', '))
+  if (parsed.hasEnabledLine) lines.push('enabled: ' + (parsed.enabled ? 'true' : 'false'))
+  lines.push(...parsed.fmExtra)
+  lines.push('---')
+  return (parsed.bom ? '\uFEFF' : '') + lines.join('\n') + '\n' + parsed.body
+}
+// --endregion

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,37 @@ 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'),
+    // maxWidth 兜底：持久化宽度超过容器可用空间时也不允许布局宽溢出（配合 flex-shrink:1 收缩）
+    style: { width: visible ? width : RAIL_ONLY_W + SEAM_W, maxWidth: '100%' },
+  },
     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 }))
 }