dsh-vscode-mode 0.1.47 → 0.1.49

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

@@ -4,11 +4,14 @@
  * 作者 ddj 2026-08-26
  */
 import type { OutlineSourceRegistry } from '../outline/types.js'
+import type { AddToConversation } from '../addToConversation.js'
 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
@@ -25,6 +28,8 @@ export interface SidebarCtx {
   outlineSources?: OutlineSourceRegistry
   /** 文件右键菜单项注册表（公开 provide 为 edrvFileContextMenuItems；文件管理面板构建菜单用）。 */
   fileMenuItems?: TreeMenuRegistry
+  /** 「添加到对话」动作集（文件/文件夹引用注入对话输入框；缺省时菜单项降级提示）。 */
+  addToConversation?: AddToConversation
   /** 面板动作反馈（如右键菜单操作结果 → 编辑区路径栏状态）。 */
   notify?: (message: string) => 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
+}

package/src/client/styles/editor.css

@@ -295,5 +295,48 @@
 [data-edrv-view] .edrv-search-toggle.on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.14)); color: var(--dsw-alias-label-primary, #1f2933); border-color: var(--dsw-alias-brand-primary, #0f9d58); }
 [data-edrv-view] .edrv-search-toggle:disabled { opacity: .4; cursor: default; }
 
+/* ===== rules panel (sidebar, Codebuddy rules view) ===== */
+[data-edrv-view] .edrv-rules-panel { display: flex; flex-direction: column; min-height: 0; flex: 1; padding: 6px; gap: 4px; }
+[data-edrv-view] .edrv-rules-tabs { display: flex; align-items: center; gap: 2px; flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-tab { height: 24px; padding: 0 10px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-secondary, #52606d); font-size: 12px; cursor: pointer; }
+[data-edrv-view] .edrv-rules-tab:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
+[data-edrv-view] .edrv-rules-tab.on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.14)); color: var(--dsw-alias-label-primary, #1f2933); font-weight: 600; }
+[data-edrv-view] .edrv-rules-new { margin-left: auto; height: 24px; padding: 0 10px; border: 1px solid var(--dsw-alias-border-l2, #cbd2d9); border-radius: 6px; background: var(--dsw-alias-bg-layer-1, #fff); color: var(--dsw-alias-label-primary, #1f2933); font-size: 11px; cursor: pointer; flex-shrink: 0; }
+[data-edrv-view] .edrv-rules-new:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
+[data-edrv-view] .edrv-rules-ws-line { font-size: 11px; color: var(--dsw-alias-label-secondary, #52606d); padding: 0 2px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; flex: 0 0 auto; user-select: none; }
+[data-edrv-view] .edrv-rules-hint { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); padding: 0 2px; flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-list { flex: 1; min-height: 0; overflow: auto; }
+[data-edrv-view] .edrv-rules-row { position: relative; padding: 7px 100px 6px 4px; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
+[data-edrv-view] .edrv-rules-row.off .edrv-rules-file, [data-edrv-view] .edrv-rules-row.off .edrv-rules-desc { opacity: .5; }
+[data-edrv-view] .edrv-rules-main { display: flex; align-items: center; gap: 6px; min-width: 0; cursor: pointer; }
+[data-edrv-view] .edrv-rules-file { font-weight: 600; font-size: 12px; color: var(--dsw-alias-label-primary, #1f2933); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-rules-path { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); flex-shrink: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-rules-type { flex-shrink: 0; height: 15px; padding: 0 5px; border-radius: 999px; font-size: 10px; line-height: 15px; }
+[data-edrv-view] .edrv-rules-type-always { background: rgba(15,157,88,.15); color: #0b7c46; }
+[data-edrv-view] .edrv-rules-type-auto { background: rgba(79,140,255,.16); color: #3367c9; }
+[data-edrv-view] .edrv-rules-type-manual { background: var(--dsw-alias-bg-layer-2, #f0f4f4); color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-rules-offtag { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); flex-shrink: 0; }
+[data-edrv-view] .edrv-rules-desc { margin-top: 3px; font-size: 11px; color: var(--dsw-alias-label-secondary, #52606d); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+[data-edrv-view] .edrv-rules-actions { position: absolute; top: 5px; right: 4px; display: flex; align-items: center; gap: 2px; }
+[data-edrv-view] .edrv-rules-act { min-width: 22px; height: 22px; padding: 0 4px; border: none; border-radius: 5px; background: transparent; font-size: 12px; line-height: 1; cursor: pointer; color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-rules-act:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
+[data-edrv-view] .edrv-rules-switch { position: relative; width: 30px; height: 16px; border-radius: 999px; border: none; background: #b9c4cc; cursor: pointer; transition: background .15s; flex-shrink: 0; padding: 0; }
+[data-edrv-view] .edrv-rules-switch.on { background: #7c5cff; }
+[data-edrv-view] .edrv-rules-knob { position: absolute; top: 2px; left: 2px; width: 12px; height: 12px; border-radius: 50%; background: #fff; transition: left .15s; }
+[data-edrv-view] .edrv-rules-switch.on .edrv-rules-knob { left: 16px; }
+[data-edrv-view] .edrv-rules-empty { padding: 10px 4px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #9aa5b1); line-height: 1.6; }
+[data-edrv-view] .edrv-rules-err { padding: 6px 8px; border: 1px solid rgba(217,83,79,.4); border-radius: 6px; background: #fdeaea; color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; word-break: break-all; }
+[data-edrv-view] .edrv-rules-editor { display: flex; flex-direction: column; min-height: 0; flex: 1; gap: 6px; }
+[data-edrv-view] .edrv-rules-editor-head { display: flex; align-items: center; justify-content: space-between; font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-primary, #1f2933); flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-editor-file { display: flex; align-items: center; gap: 6px; font-size: 11px; color: var(--dsw-alias-label-secondary, #52606d); flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-input { flex: 1; min-width: 0; height: 24px; padding: 0 8px; border: 1px solid var(--dsw-alias-border-l2, #555); border-radius: 6px; background: var(--dsw-alias-bg-base, #111); color: var(--dsw-alias-label-primary, #eee); font-size: 11px; outline: none; font-family: var(--ds-font-family-code, ui-monospace, monospace); }
+[data-edrv-view] .edrv-rules-input:focus { border-color: var(--dsw-alias-brand-primary, #4f8cff); }
+[data-edrv-view] .edrv-rules-body { flex: 1; min-height: 0; resize: none; padding: 8px; border: 1px solid var(--dsw-alias-border-l2, #555); border-radius: 6px; background: var(--dsw-alias-bg-base, #111); color: var(--dsw-alias-label-primary, #eee); font-size: 12px; line-height: 1.5; outline: none; font-family: var(--ds-font-family-code, ui-monospace, monospace); }
+[data-edrv-view] .edrv-rules-body:focus { border-color: var(--dsw-alias-brand-primary, #4f8cff); }
+[data-edrv-view] .edrv-rules-editor-hint { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); line-height: 1.5; flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-editor-foot { display: flex; justify-content: flex-end; flex: 0 0 auto; }
+[data-edrv-view] .edrv-rules-save { height: 24px; padding: 0 14px; border: none; border-radius: 6px; background: var(--dsw-alias-brand-primary, #0f9d58); color: #fff; font-size: 12px; cursor: pointer; }
+[data-edrv-view] .edrv-rules-save:disabled { opacity: .5; cursor: default; }
+
 
 

package/src/client/ui/EditorView.ts

@@ -23,7 +23,9 @@ import { revealInExplorer as revealPathInExplorer } from '../fileReveal.js'
 import { setSidePending, SIDEBAR_INSTALL_CMD } from '../sidebarBridge.js'
 import { upsertViewState, viewStatesLoad, viewStatesSave } from '../state/viewStateCache.js'
 import { bindingsOf, chordOf, matchEvent, useKeybindingsVersion } from '../keybindings.js'
+import { getSidebarMinWidth } from '../sidebarMin.js'
 import { createNavHistory } from '../navHistory.js'
+import { statusOfAdd } from '../addToConversation.js'
 import { CACHE_KEY } from '../paths.js'
 import { bindLspEditor, runGoToDefinition, runFindReferences, hideReferencesOverlay } from '../monaco/lsp/providers.js'
 import { bindLspUnderline } from '../monaco/lsp/underline.js'
@@ -66,7 +68,7 @@ export function EditorView(props) {
   const [fileIdx, setFileIdx] = React.useState(0) // 全局差异文件位置（x/x 文件 显示）
   const [tabMenu, setTabMenu] = React.useState(null) // Tab 右键菜单 { x,y,path }（编辑区右键走 Monaco 原生菜单，无此浮层）
   const [sidebarOn, setSidebarOn] = React.useState(layout !== 'side') // 侧边栏显隐（侧栏形态默认收起）
-  const [sidebarW, setSidebarW] = React.useState(240) // 侧边栏宽度
+  const [sidebarW, setSidebarW] = React.useState(() => getSidebarMinWidth()) // 侧边栏宽度（初值 = 最小宽度，默认 300）
   const [activePanel, setActivePanel] = React.useState('explorer') // 激活面板 id
   const [focusRequest, setFocusRequest] = React.useState(0) // 外部差异聚焦请求版本
   const kbVersion = useKeybindingsVersion() // 快捷键配置版本（tooltip 文案随键位刷新）
@@ -507,6 +509,7 @@ export function EditorView(props) {
   }, [tabs, active, sessionId])
 
   // 侧边栏状态：恢复（显隐/宽度/激活面板）；侧栏形态独立键（默认收起，不共享页签形态偏好）
+  // 宽度下限来自通用设置 sidebarMinWidth（默认 300），恢复值按其重夹
   const sidebarKey = CACHE_KEY.sidebar + (layout === 'side' ? 'side.' : '') + String(sessionId)
   React.useEffect(() => {
     if (!sessionId) return
@@ -515,12 +518,23 @@ export function EditorView(props) {
       if (raw) {
         const saved = JSON.parse(raw)
         if (typeof saved.on === 'boolean') setSidebarOn(saved.on)
-        if (typeof saved.width === 'number') setSidebarW(Math.max(180, Math.min(560, saved.width)))
+        if (typeof saved.width === 'number') setSidebarW(Math.max(getSidebarMinWidth(), Math.min(560, saved.width)))
         if (typeof saved.panel === 'string') setActivePanel(saved.panel)
       }
     } catch (e) { /* 损坏忽略 */ }
   }, [sessionId, sidebarKey])
 
+  // 侧边栏最小宽度设置变更（edrv:sidebar-min-width）→ 更新 minW 并重夹当前宽度
+  const [sidebarMinW, setSidebarMinW] = React.useState(() => getSidebarMinWidth())
+  React.useEffect(() => {
+    const onMinChange = () => {
+      setSidebarMinW(getSidebarMinWidth())
+      setSidebarW((w) => Math.max(getSidebarMinWidth(), w))
+    }
+    window.addEventListener('edrv:sidebar-min-width', onMinChange)
+    return () => window.removeEventListener('edrv:sidebar-min-width', onMinChange)
+  }, [])
+
   // 侧边栏状态持久化
   React.useEffect(() => {
     if (!sessionId) return
@@ -1119,15 +1133,7 @@ export function EditorView(props) {
     setTabMenu(null)
   }
 
-  /** 把「添加到对话」返回状态映射为状态栏文案。
-   * @author ddj 2026年08月25号 */
-  const statusOfAdd = (outcome, okText) => {
-    if (outcome === 'ok') return okText
-    if (outcome === 'busy') return okText + '（输入框忙，已降级纯文本）'
-    return '无法添加到对话（无会话或输入框不可用）'
-  }
-
-  /** 添加文件/选中区引用到对话（异步，状态栏反馈）。 */
+  /** 添加文件/选中区引用到对话（异步，状态栏反馈；状态文案走共享 statusOfAdd）。 */
   const addRefToChat = (path, range) => {
     if (!path) { setStatus('无活动文件'); return }
     if (!addToConversation) { setStatus('添加到对话不可用'); return }
@@ -1251,7 +1257,7 @@ export function EditorView(props) {
       'aria-label': '前进',
       onClick: navForward,
     }, '→'),
-    React.createElement('button', { className: 'edrv-chip-btn' + (sidebarOn ? ' edrv-chip-on' : ''), title: '切换侧边栏 (' + (chordOf('edrv.toggleSidebar') ?? 'Ctrl+B') + ')', onClick: () => setSidebarOn((v) => !v) }, '☰'),
+    React.createElement('button', { className: 'edrv-chip-btn' + (sidebarOn ? ' edrv-chip-on' : ''), title: '切换面板区 (' + (chordOf('edrv.toggleSidebar') ?? 'Ctrl+B') + ')，图标列常显', onClick: () => setSidebarOn((v) => !v) }, '☰'),
     React.createElement('button', { className: 'edrv-chip-btn', title: '刷新', onClick: reloadFile }, '⟳'),
     React.createElement(QuickOpen, { sessionId, onOpen: (p) => openFile(p, false) }))
 
@@ -1397,6 +1403,8 @@ export function EditorView(props) {
   const sidebarPanels = props.sidebarPanels
   const sidebarCtx = {
     sessionId,
+    // 当前会话工作区（sessions 快照 byId[sessionId].cwd；规则面板项目 Tab 自动匹配）
+    cwd: props.sessions?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd ?? null,
     openFile: (p) => openFile(p, false),
     openFileAt,
     activePath: active,
@@ -1406,6 +1414,7 @@ export function EditorView(props) {
     editor: () => editorRef.current,
     outlineSources: props.outlineSources,
     fileMenuItems: props.fileMenuItems,
+    addToConversation,
     notify: (message) => setStatus(message),
   }
 
@@ -1438,15 +1447,18 @@ export function EditorView(props) {
   // 编辑器根节点按 composer 顶部边界动态限高，底部对话区域继续由 DSH 原生渲染。
   // 侧栏形态由面板容器给高（100%），不做 composer 几何同步。
   const editorRow = React.createElement('div', { className: 'edrv-editor-row' },
-    (sidebarOn && sidebarPanels
+    (sidebarPanels
       ? React.createElement(SidebarView, {
           registry: sidebarPanels,
           ctx: sidebarCtx,
           activePanel,
           onActive: setActivePanel,
+          visible: sidebarOn,
+          onShow: () => setSidebarOn(true),
           width: sidebarW,
           onWidth: setSidebarW,
           onHide: () => setSidebarOn(false),
+          minWidth: sidebarMinW,
         })
       : null),
     mainCol)

package/src/client/ui/McpSettings.ts

@@ -10,6 +10,7 @@ import type { MpcProject, MpcServer } from '../../shared/mcp.js'
 import '../styles/mcp.css'
 import { availableOpeners, AUTO_OPEN_TOOL } from '../fileOpeners.js'
 import { SettingsContext } from '../settingsContext.js'
+import { normalizeSidebarMinWidth, SIDEBAR_MIN_DEFAULT } from '../sidebarMin.js'
 import { KeybindingsPanel } from './KeybindingsPanel.js'
 import { LspSettings } from './LspSettings.js'
 import { PerfSettings } from './PerfSettings.js'
@@ -122,7 +123,7 @@ function ProjectGroup({ project, busy, onAdd, onRefresh, onToggle, onRemove }) {
   return React.createElement('section', { className: 'vsm-project' }, head, body)
 }
 
-/** 通用设置：选择当前对话文件链接的打开器 + 开发形态开关。 */
+/** 通用设置：选择当前对话文件链接的打开器 + 开发形态开关 + 编辑器布局（侧边栏最小宽度）。 */
 function GeneralSettings({ registry }) {
   const [tool, setTool] = React.useState(AUTO_OPEN_TOOL)
   const [busy, setBusy] = React.useState(false)
@@ -130,6 +131,8 @@ function GeneralSettings({ registry }) {
   const [devForm, setDevForm] = React.useState(null)
   const [devBusy, setDevBusy] = React.useState(false)
   const [devMessage, setDevMessage] = React.useState('')
+  const [minW, setMinW] = React.useState(SIDEBAR_MIN_DEFAULT)
+  const [minDraft, setMinDraft] = React.useState(null) // 输入草稿（null=跟随已保存值；blur/Enter 提交）
   const settings = React.useContext(SettingsContext)
   const snapshot = settings?.getSnapshot?.()
   const loading = !snapshot || snapshot.status === 'loading'
@@ -137,8 +140,10 @@ function GeneralSettings({ registry }) {
   const notReady = snapshot?.status !== 'ready'
   React.useEffect(() => {
     const onChange = () => {
-      const next = settings?.getSnapshot?.().value?.fileOpenTool
+      const snap = settings?.getSnapshot?.()
+      const next = snap?.value?.fileOpenTool
       if (typeof next === 'string') setTool(next)
+      setMinW(normalizeSidebarMinWidth(snap?.value?.sidebarMinWidth))
     }
     onChange()
     return settings?.subscribe?.(onChange)
@@ -153,6 +158,19 @@ function GeneralSettings({ registry }) {
     if (!settings?.set) { setError('设置服务不可用'); setBusy(false); return }
     settings.set('fileOpenTool', value).catch((e) => setError(String(e))).finally(() => setBusy(false))
   }
+  /** 提交侧边栏最小宽度（归一化夹取 180–560 后持久化）。 */
+  const saveMinW = (raw) => {
+    const next = normalizeSidebarMinWidth(raw)
+    setMinW(next); setBusy(true); setError('')
+    if (!settings?.set) { setError('设置服务不可用'); setBusy(false); return }
+    settings.set('sidebarMinWidth', next).catch((e) => setError(String(e))).finally(() => setBusy(false))
+  }
+  /** 结束输入（blur/Enter）时提交草稿。 */
+  const commitMinW = () => {
+    if (minDraft === null) return
+    setMinDraft(null)
+    saveMinW(minDraft)
+  }
   const closeDevForm = () => {
     if (!window.confirm('关闭开发形态：插件将切换为正式版安装（版本依赖 + 删除工作区链接），pnpm 装配后需重启 DSH 生效。确认关闭？')) return
     setDevBusy(true)
@@ -184,6 +202,23 @@ function GeneralSettings({ registry }) {
         devFormRow,
       ),
     ),
+    React.createElement('section', { className: 'vsm-panel' },
+      React.createElement('h3', { className: 'vsm-panel-title' }, '编辑器'),
+      React.createElement('div', { className: 'vsm-panel-body' },
+        React.createElement('label', { className: 'vsm-general-row' },
+          React.createElement('span', null, '侧边栏最小宽度'),
+          React.createElement('input', {
+            type: 'number', min: 180, max: 560, step: 10,
+            value: minDraft ?? minW,
+            disabled: loading || unavailable || notReady || busy || snapshot?.writable === false,
+            title: '180–560 px；拖拽侧边栏低于该宽度时自动隐藏',
+            onChange: (event) => setMinDraft(event.target.value),
+            onBlur: commitMinW,
+            onKeyDown: (event) => { if (event.key === 'Enter') commitMinW() },
+          }),
+          React.createElement('small', null, '180–560 px；拖拽低于该宽度自动隐藏')),
+      ),
+    ),
   )
 }
 

package/src/client/ui/SideEditorTab.ts

@@ -44,5 +44,6 @@ export function SideEditorTab(props) {
     sidebarPanels: props?.sidebarPanels,
     outlineSources: props?.outlineSources,
     fileMenuItems: props?.fileMenuItems,
+    sessions: props?.sessions,
   })
 }