dsh-vscode-mode 0.1.48 → 0.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "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/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/panels/RulesPanel.ts

@@ -0,0 +1,284 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 侧边栏「规则」面板（Codebuddy 规则管理形态）。
+ * 双 Tab：用户规则（~/.dsh/rules/）与项目规则（<工作区>/.dsh/rules/）；
+ * 列表行 = 文件名 + 相对提示 + 类型徽标（总是/自动/手动）+ 描述 + 编辑/删除/启用开关；
+ * 新建/编辑 = 内嵌表单（文件名 + 原始 .mdc 文本域，frontmatter 可见），保存走 rules.save。
+ * 作者 ddj 2026年09月03号
+ */
+import React from 'react'
+import { rpc } from '../../rpc.js'
+import type { SidebarCtx } from '../types.js'
+import { CACHE_KEY } from '../../paths.js'
+
+/** 新建规则模板（frontmatter 字段与 host parseRuleMdc 对齐）。 */
+const NEW_TEMPLATE = '---\ndescription: \nalwaysApply: true\n---\n\n'
+const TYPE_LABEL = { always: '总是', auto: '自动', manual: '手动' }
+
+/**
+ * 读 localStorage（损坏/不可用安全）。
+ * @author ddj 2026年09月03号
+ * @param key 键
+ * @returns 值或 null
+ */
+function readLocal(key) {
+  try { return localStorage.getItem(key) } catch (e) { return null }
+}
+
+/**
+ * 写 localStorage（不可用安全）。
+ * @author ddj 2026年09月03号
+ * @param key 键
+ * @param value 值
+ */
+function writeLocal(key, value) {
+  try { localStorage.setItem(key, value) } catch (e) { /* 忽略 */ }
+}
+
+/**
+ * 类型徽标（总是=绿 / 自动=蓝 / 手动=灰）。
+ * @author ddj 2026年09月03号
+ * @param type 规则类型
+ * @returns 徽标元素
+ */
+function typeBadge(type) {
+  return React.createElement('span', { className: 'edrv-rules-type edrv-rules-type-' + type }, TYPE_LABEL[type] ?? type)
+}
+
+// --region 列表行
+/**
+ * 渲染一条规则行：文件名 + 相对提示 + 类型徽标，第二行描述；右侧编辑/删除/开关。
+ * @author ddj 2026年09月03号
+ * @param props.rule 规则元信息
+ * @param props.onEdit 编辑回调
+ * @param props.onRemove 删除回调
+ * @param props.onToggle 开关回调
+ * @returns 行元素
+ */
+function RuleRow(props) {
+  const rule = props.rule
+  const desc = [rule.error ? '解析失败：' + rule.error : null, rule.description || (rule.type === 'auto' ? 'globs: ' + rule.globs.join(', ') : '')]
+    .filter(Boolean).join(' · ')
+  return React.createElement('div', { className: 'edrv-rules-row' + (rule.enabled ? '' : ' off') },
+    React.createElement('div', { className: 'edrv-rules-main', onClick: () => props.onEdit(rule), title: rule.absPath },
+      React.createElement('span', { className: 'edrv-rules-file' }, rule.file),
+      React.createElement('span', { className: 'edrv-rules-path' }, '[' + rule.relHint + rule.file + ']'),
+      typeBadge(rule.type),
+      !rule.enabled ? React.createElement('span', { className: 'edrv-rules-offtag' }, '已停用') : null),
+    React.createElement('div', { className: 'edrv-rules-desc', title: desc }, desc ? '描述: ' + desc : '描述: —'),
+    React.createElement('div', { className: 'edrv-rules-actions' },
+      React.createElement('button', { className: 'edrv-rules-act', title: '编辑', onClick: () => props.onEdit(rule) }, '✏️'),
+      React.createElement('button', { className: 'edrv-rules-act', title: '删除', onClick: () => props.onRemove(rule) }, '🗑'),
+      React.createElement('button', {
+        className: 'edrv-rules-switch' + (rule.enabled ? ' on' : ''), role: 'switch', 'aria-checked': rule.enabled,
+        title: rule.enabled ? '已启用（点击停用）' : '已停用（点击启用）',
+        onClick: () => props.onToggle(rule),
+      }, React.createElement('span', { className: 'edrv-rules-knob' }))))
+}
+// --endregion
+
+// --region 内嵌编辑器
+/**
+ * 新建/编辑表单：文件名（仅新建可改）+ 原始 .mdc 文本域 + 保存/取消。
+ * @author ddj 2026年09月03号
+ * @param props.form 表单状态（mode/scope/workspacePath/file/content/error/saving）
+ * @param props.setForm 表单更新函数
+ * @param props.onSave 保存回调
+ * @param props.onCancel 取消回调
+ * @returns 表单元素
+ */
+function RuleEditor(props) {
+  const form = props.form
+  const isNew = form.mode === 'new'
+  return React.createElement('div', { className: 'edrv-rules-editor' },
+    React.createElement('div', { className: 'edrv-rules-editor-head' },
+      isNew ? '新建' + (form.scope === 'project' ? '项目' : '用户') + '规则' : '编辑：' + form.file,
+      React.createElement('button', { className: 'edrv-rules-act', title: '取消', onClick: props.onCancel }, '✕')),
+    React.createElement('div', { className: 'edrv-rules-editor-file' },
+      React.createElement('label', null, '文件名'),
+      React.createElement('input', {
+        className: 'edrv-rules-input', value: form.file, disabled: !isNew, spellCheck: false,
+        placeholder: 'my-rule.mdc', onChange: (e) => props.setForm({ ...form, file: e.target.value }),
+      })),
+    React.createElement('textarea', {
+      className: 'edrv-rules-body', spellCheck: false,
+      value: form.content,
+      onChange: (e) => props.setForm({ ...form, content: e.target.value }),
+    }),
+    React.createElement('div', { className: 'edrv-rules-editor-hint' },
+      'frontmatter 支持 description / alwaysApply / globs / enabled；无 frontmatter 的纯 markdown 视为「手动」规则'),
+    form.error ? React.createElement('div', { className: 'edrv-rules-err' }, form.error) : null,
+    React.createElement('div', { className: 'edrv-rules-editor-foot' },
+      React.createElement('button', { className: 'edrv-rules-save', disabled: form.saving, onClick: props.onSave }, form.saving ? '保存中…' : '保存')))
+}
+// --endregion
+
+/**
+ * 规则面板主体。
+ * @param props.ctx 面板共享上下文（notify 可选）
+ */
+export function RulesPanel(props) {
+  const ctx = props?.ctx
+  const notify = ctx?.notify ?? ((message) => {})
+  // 当前会话工作区（EditorView 从 sessions 快照注入；项目 Tab 自动匹配，不提供手动切换）
+  const cwd = ctx?.cwd ?? null
+  const [tab, setTab] = React.useState(() => (readLocal(CACHE_KEY.rules + 'tab') === 'project' ? 'project' : 'user'))
+  const [data, setData] = React.useState(null) // { user: RuleInfo[], projects: RuleProject[] }
+  const [error, setError] = React.useState('')
+  const [form, setForm] = React.useState(null) // 编辑器表单状态；null=列表态
+  const mountedRef = React.useRef(true)
+
+  /**
+   * 当前工作区对应的项目聚合（按 ctx.cwd 自动匹配；无会话/未注册返回 null）。
+   * @returns RuleProject 或 null
+   */
+  const activeProject = () => {
+    if (!cwd) return null
+    return (data?.projects ?? []).find((p) => p.workspacePath === cwd) ?? null
+  }
+
+  /** 拉取规则总列表（rules.list）。 */
+  const load = () => {
+    rpc('rules.list', {}).then((res) => {
+      if (!mountedRef.current) return
+      if (res && res.ok) { setData(res); setError('') } else setError(res?.error ?? '读取规则失败')
+    }).catch((e) => { if (mountedRef.current) setError('读取规则异常: ' + String(e)) })
+  }
+
+  React.useEffect(() => {
+    mountedRef.current = true
+    load()
+    return () => { mountedRef.current = false }
+  }, [])
+
+  /**
+   * 切换 Tab（记忆到 localStorage）。
+   * @param next 目标 Tab
+   */
+  const switchTab = (next) => {
+    setTab(next)
+    writeLocal(CACHE_KEY.rules + 'tab', next)
+  }
+
+  /**
+   * 打开新建表单（按当前 Tab 决定作用域；项目规则跟随当前会话工作区）。
+   */
+  const openNew = () => {
+    const scope = tab === 'project' ? 'project' : 'user'
+    if (scope === 'project' && !cwd) { notify('当前会话没有工作区，无法新建项目规则'); return }
+    setForm({ mode: 'new', scope, workspacePath: scope === 'project' ? cwd : undefined, file: '', content: NEW_TEMPLATE, error: '', saving: false })
+  }
+
+  /**
+   * 打开编辑表单：先拉全文再进入编辑态。
+   * @param rule 目标规则
+   */
+  const openEdit = (rule) => {
+    rpc('rules.read', { scope: rule.scope, workspacePath: rule.scope === 'project' ? rule.workspacePath : undefined, file: rule.file })
+      .then((res) => {
+        if (res && res.ok) {
+          setForm({ mode: 'edit', scope: rule.scope, workspacePath: rule.workspacePath, file: rule.file, content: res.content, error: '', saving: false })
+        } else notify(res?.error ?? '读取规则失败')
+      }).catch((e) => notify('读取规则异常: ' + String(e)))
+  }
+
+  /** 保存表单（rules.save；文件名仅新建校验非空）。 */
+  const saveForm = () => {
+    const next = { ...form, saving: true, error: '' }
+    const file = String(form.file ?? '').trim()
+    if (!file) { setForm({ ...next, saving: false, error: '文件名不能为空' }); return }
+    setForm(next)
+    rpc('rules.save', { scope: form.scope, workspacePath: form.workspacePath, file, content: form.content })
+      .then((res) => {
+        if (res && res.ok) {
+          setForm(null)
+          notify('规则已保存：' + file)
+          load()
+        } else setForm((prev) => ({ ...prev, saving: false, error: res?.error ?? '保存失败' }))
+      }).catch((e) => setForm((prev) => ({ ...prev, saving: false, error: '保存异常: ' + String(e) })))
+  }
+
+  /**
+   * 删除规则（confirm 后走 rules.remove）。
+   * @param rule 目标规则
+   */
+  const removeRule = (rule) => {
+    if (!window.confirm('删除规则 ' + rule.file + '？（不可恢复）')) return
+    rpc('rules.remove', { scope: rule.scope, workspacePath: rule.workspacePath, file: rule.file })
+      .then((res) => {
+        if (res && res.ok) { notify('已删除：' + rule.file); load() } else notify(res?.error ?? '删除失败')
+      }).catch((e) => notify('删除异常: ' + String(e)))
+  }
+
+  /**
+   * 切换启用开关：本地乐观翻转（按 workspacePath+file 定位，失败回滚）。
+   * @param rule 目标规则（project 已注入 workspacePath）
+   */
+  const toggleRule = (rule) => {
+    const enabled = !rule.enabled
+    const applyLocal = (on) => setData((prev) => prev ? {
+      ...prev,
+      user: prev.user.map((r) => (r.scope === 'user' && r.file === rule.file ? { ...r, enabled: on } : r)),
+      projects: prev.projects.map((p) => (p.workspacePath === rule.workspacePath
+        ? { ...p, rules: p.rules.map((r) => (r.file === rule.file ? { ...r, enabled: on } : r)) }
+        : p)),
+    } : prev)
+    applyLocal(enabled)
+    rpc('rules.toggle', { scope: rule.scope, workspacePath: rule.workspacePath, file: rule.file, enabled })
+      .then((res) => {
+        if (res && res.ok) { applyLocal(res.rule?.enabled === true); notify(res.rule?.enabled === false ? '已停用：' + rule.file : '已启用：' + rule.file) }
+        else { applyLocal(!enabled); notify(res?.error ?? '切换失败') }
+      }).catch((e) => { applyLocal(!enabled); notify('切换异常: ' + String(e)) })
+  }
+
+  /** 当前列表数据（按 Tab 取用户规则或当前工作区的项目规则）。 */
+  const rowsOf = () => {
+    if (!data) return []
+    if (tab === 'user') return data.user
+    return activeProject()?.rules ?? []
+  }
+
+  const renderTabs = () => React.createElement('div', { className: 'edrv-rules-tabs' },
+    React.createElement('button', { className: 'edrv-rules-tab' + (tab === 'user' ? ' on' : ''), onClick: () => switchTab('user') }, '用户规则'),
+    React.createElement('button', { className: 'edrv-rules-tab' + (tab === 'project' ? ' on' : ''), onClick: () => switchTab('project') }, '项目规则'),
+    React.createElement('button', { className: 'edrv-rules-new', title: '新建规则', onClick: openNew }, '＋ 新建规则'))
+
+  /** 项目 Tab 的工作区展示（不可编辑，自动跟随当前会话）。 */
+  const renderWsLine = () => {
+    if (tab !== 'project') return null
+    return React.createElement('div', { className: 'edrv-rules-ws-line', title: cwd ?? '' },
+      '工作区：' + (cwd ?? '当前会话未打开工作区'))
+  }
+
+  const renderEmpty = () => {
+    if (tab === 'project') {
+      if (!cwd) return '当前会话没有工作区，项目规则不可用（项目规则跟随会话所在工作区）'
+      if (!data?.projects?.length) return '当前 DSH 没有已注册的工作区；在目标工作区打开一次会话后再来管理'
+      if (!activeProject()) return '当前工作区未注册为 DSH workspace，暂不能管理其项目规则'
+      return '<工作区>/.dsh/rules/ 还没有规则，点击「＋ 新建规则」创建'
+    }
+    return '还没有用户规则（~/.dsh/rules/），点击「＋ 新建规则」创建'
+  }
+
+  const renderBody = () => {
+    if (form) return React.createElement(RuleEditor, { form, setForm, onSave: saveForm, onCancel: () => setForm(null) })
+    if (!data) return React.createElement('div', { className: 'edrv-rules-empty' }, '加载中…')
+    if (error) return React.createElement('div', { className: 'edrv-rules-err' }, error)
+    const rows = rowsOf()
+    if (!rows.length) return React.createElement('div', { className: 'edrv-rules-empty' }, renderEmpty())
+    const common = {
+      onEdit: (rule) => openEdit({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),
+      onRemove: (rule) => removeRule({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),
+      onToggle: (rule) => toggleRule({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),
+    }
+    return React.createElement('div', { className: 'edrv-rules-list' },
+      rows.map((rule) => React.createElement(RuleRow, { key: rule.scope + ':' + rule.file, rule, ...common })))
+  }
+
+  return React.createElement('div', { className: 'edrv-rules-panel' },
+    renderTabs(),
+    renderWsLine(),
+    React.createElement('div', { className: 'edrv-rules-hint' },
+      tab === 'user' ? '用户规则对所有会话生效（存放于 ~/.dsh/rules/）' : '项目规则仅对所在工作区的会话生效（存放于 <工作区>/.dsh/rules/）'),
+    renderBody())
+}

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

@@ -1,11 +1,12 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — 侧边栏面板定义（文件管理 + 搜索）。
- * 作者 ddj 2026-08-26 / 2026-08-26
+ * dsh-vscode-mode client — 侧边栏面板定义（文件管理 + 搜索 + 规则）。
+ * 作者 ddj 2026-08-26 / 2026-09-03
  */
 import React from 'react'
 import { FileExplorer } from './FileExplorer.js'
 import { SearchPanel } from './SearchPanel.js'
+import { RulesPanel } from './RulesPanel.js'
 import type { SidebarPanelDef, SidebarCtx } from '../types.js'
 
 /**
@@ -38,3 +39,18 @@ export function createSearchPanel(): SidebarPanelDef {
     render: (ctx: SidebarCtx) => React.createElement(SearchPanel, { ctx }),
   }
 }
+
+/**
+ * 构造规则管理面板定义（Codebuddy 规则形态：用户规则/项目规则双 Tab + 开关）。
+ * @author ddj 2026年09月03号
+ * @returns 面板定义（无徽标；活动栏图标 📏，与大纲 📜 区分）
+ */
+export function createRulesPanel(): SidebarPanelDef {
+  return {
+    id: 'rules',
+    title: '规则',
+    icon: '📏',
+    order: 20,
+    render: (ctx: SidebarCtx) => React.createElement(RulesPanel, { ctx }),
+  }
+}

package/src/client/sidebar/types.ts

@@ -10,6 +10,8 @@ import type { TreeMenuRegistry } from './contextMenu.js'
 /** 面板可用的共享上下文（由 SidebarView 从 EditorView 注入，面板不直碰其内部）。 */
 export interface SidebarCtx {
   sessionId?: string
+  /** 当前会话工作区 cwd（来自 sessions 快照；规则面板项目 Tab 自动匹配用）。 */
+  cwd?: string | null
   openFile: (path: string) => void
   /** 打开文件并跳转到指定行/列（搜索面板命中跳转；缺省仅打开）。 */
   openFileAt?: (path: string, line?: number, column?: number) => void

package/src/client/sidebarMin.ts

@@ -0,0 +1,48 @@
+/**
+ * dsh-vscode-mode client — 侧边栏最小宽度共享状态。
+ * 设置来源：dsh-vscode-mode 命名空间的 sidebarMinWidth 字段（通用设置页可调）；
+ * 客户端 settings 订阅经 sidebarMinApply 写入，编辑器/侧边栏容器经 getSidebarMinWidth 读取，
+ * 变更时由 client/index.ts 派发 edrv:sidebar-min-width 窗口事件通知编辑器重夹。
+ * 作者 ddj 2026年09月04号
+ */
+
+/** 默认最小宽度（设置缺失/非法时的兜底值）。 */
+export const SIDEBAR_MIN_DEFAULT = 300
+/** 最小宽度允许下界（与旧版拖拽下限一致）。 */
+export const SIDEBAR_MIN_FLOOR = 180
+/** 最小宽度允许上界（与侧边栏最大宽度 W_MAX 一致，避免区间倒挂）。 */
+export const SIDEBAR_MIN_CEIL = 560
+
+let currentMin = SIDEBAR_MIN_DEFAULT
+
+/**
+ * 归一化最小宽度：非法（NaN/非有限/负数）回退默认，越界夹取到 [180, 560]。
+ * @author ddj 2026年09月04号
+ * @param value 原始值（设置文档来的任意 JSON 值）
+ * @returns 合法最小宽度
+ */
+export function normalizeSidebarMinWidth(value: unknown): number {
+  const n = typeof value === 'number' ? value : Number(value)
+  if (!Number.isFinite(n) || n <= 0) return SIDEBAR_MIN_DEFAULT
+  return Math.max(SIDEBAR_MIN_FLOOR, Math.min(SIDEBAR_MIN_CEIL, Math.round(n)))
+}
+
+/**
+ * 应用设置值（client/index.ts 设置订阅同步调用）。
+ * @author ddj 2026年09月04号
+ * @param value 设置文档中的 sidebarMinWidth
+ * @returns 归一化后的生效值
+ */
+export function sidebarMinApply(value: unknown): number {
+  currentMin = normalizeSidebarMinWidth(value)
+  return currentMin
+}
+
+/**
+ * 读取当前生效的最小宽度（编辑器初始/恢复/拖拽夹取共用）。
+ * @author ddj 2026年09月04号
+ * @returns 当前最小宽度
+ */
+export function getSidebarMinWidth(): number {
+  return currentMin
+}