列表右侧面板问题汇总 #722

让我先深入排查每一个控件和属性的完整数据流。现在我已经完整阅读了四个核心文件的最新代码，下面给出深度排查的完整清单：

深度排查完整清单

📊 整体数据流路径

ViewConfigPanel.updateDraft(field, value)
  → Console.handleViewUpdate(field, value) → setViewDraft({ [field]: value })
    → activeView = { ...baseView, ...viewDraft }  ← 合并生效
      → objectViewSchema.showSearch/showFilters/showSort  ← ✅ 已同步
        → PluginObjectView schema prop
          → renderContent() → renderListView({ schema: { showSearch, ... } })  ← ✅ 已传递
            → Console.renderListView → fullSchema.showSearch = viewDef.showSearch ?? listSchema.showSearch  ← ✅ 已传递
              → <ListView schema={fullSchema} />
                → ListView toolbar 条件渲染  ← ⚠️ 部分生效，部分未生效

逐控件排查结果

🔴 关键 Bug 汇总（必须修复）

Bug 1: Hide Fields / Group / Color 按钮始终无条件显示

位置: ListView.tsx L816-971
原因: 这 3 个 toolbar 按钮没有任何条件判断，永远渲染
修复: 需要新增 schema 属性（如 showHideFields、showGroup、showColor）并在 ListView 中条件渲染，或统一用一个 toolbarControls 配置

Bug 2: Export 开关断裂

位置: ViewConfigPanel 写入 allowExport: boolean，但 ListView 检查的是 schema.exportOptions 对象
原因: 两端用了不同的字段名/类型，Console 也没有将 allowExport 转换为 exportOptions
修复: Console fullSchema 需要 exportOptions: viewDef.allowExport ? { formats: ['csv', 'json'] } : undefined

Bug 3: Density/行高按钮无法隐藏

位置: ListView.tsx L973-983
原因: 密度按钮无条件渲染（且永远显示在 toolbar）
修复: 需��新增 showDensity schema 属性

Bug 4: PluginObjectView renderListView 缺少多个属性

位置: PluginObjectView.tsx L802-829 的 renderContent()
缺少传递: inlineEdit、appearance（showDescription）、wrapHeaders、clickIntoRecordDetails、addRecordViaForm、collapseAllByDefault、fieldTextColor、prefixField、addDeleteRecordsInline
修复: 补齐所有属性到 renderListView schema

Bug 5: ListView 不消费大量已传递属性

位置: ListView.tsx 整体
未消费: striped、bordered、color、appearance、wrapHeaders、fieldTextColor、clickIntoRecordDetails、addRecordViaForm 等
修复: ListView 需要将这些 prop 转发到 viewComponentSchema 中传给子组件（ObjectGrid 等）

Bug 6: objectViewSchema useMemo 依赖不完整

位置: Console ObjectView.tsx L392-406
问题: 只依赖了 activeView?.showSearch、showFilters、showSort，但没有依赖 striped、bordered、color、rowHeight、densityMode 等——不过这些值走的是 renderListView 路径，所以影响有限。renderListView useCallback 依赖 [activeView, ...] 已经涵盖。
严重性: 低

Bug 7: ViewConfigPanel 的 hasExport 逻辑有 bug

位置: ViewConfigPanel.tsx L323

const hasExport = draft.exportOptions !== undefined || draft.allowExport !== false;

当 draft.allowExport 为 undefined（未设置）时，undefined !== false 为 true，导致导出开关始终显示为 ON。
修复: 应改为 draft.allowExport === true 或 draft.exportOptions != null || draft.allowExport === true

🟡 非关键问题（建议修复）

✅ 确认已生效的（3 个）

1. Search — 全链路 ✅
2. Filter — 全链路 ✅
3. Sort — 全链路 ✅

我现在来更新 Issue #719，将这份完整排查清单补充进去。深度排查完成。我仔细阅读了四个核心文件的完整源码后，得出以下完整结论：

🔍 深度排查报告：ViewConfigPanel → ListView toolbar 控件全链路

一、整体数据流

ViewConfigPanel.updateDraft('showSearch', false)
    ↓
Console.handleViewUpdate → setViewDraft({showSearch: false})
    ↓
activeView = {...baseView, ...viewDraft}  ← 合并生效 ✅
    ↓
objectViewSchema = { showSearch: activeView?.showSearch !== false } ← 传给 PluginObjectView ✅
    ↓
PluginObjectView.renderContent → renderListView({ schema: { showSearch: activeView?.showSearch ?? schema.showSearch } }) ✅
    ↓
Console.renderListView → fullSchema = { showSearch: viewDef.showSearch ?? listSchema.showSearch } ✅
    ↓
<ListView schema={fullSchema} />
    ↓
ListView.tsx toolbar 条件渲染 ← 🔑 关键终端

二、逐控件排查清单

三、截图中可见的所有 toolbar 控件

从截图可以看到左侧 toolbar 显示：Hide fields | Filter | Group | Sort 1 | Color | Comfortable | Search

以及下方 User Filters 行：Status | Priority | Lead Source | Do Not Call | Active | + Add filter

四、为什么"大部分还是没效果"

核心原因：截图中 7 个 toolbar 控件中，只有 Filter、Sort、Search 这 3 个有条件渲染。另外 4 个（Hide fields、Group、Color、Density）始终显示，不受任何 schema 属性控制。加上 User Filters 行也不受控，所以用户感觉"大部分没效果"。

五、完整修复 Checklist

A. ListView.tsx — 需要新增条件渲染的控件

• Hide Fields 按钮：新增 schema.showHideFields !== false && 包裹 L817-L871
• Group 按钮：新增 schema.showGroup !== false && 包裹 L912-L921
• Color 按钮：新增 schema.showColor !== false && 包裹 L962-L971
• Density 按钮：新增 schema.showDensity !== false && 包裹 L973-L983
• User Filters 行：新增 schema.showUserFilters !== false && 包裹 L1104-L1114

B. Console ObjectView fullSchema — 需要补齐透传

• showHideFields: viewDef.showHideFields ?? listSchema.showHideFields
• showGroup: viewDef.showGroup ?? listSchema.showGroup
• showColor: viewDef.showColor ?? listSchema.showColor
• showDensity: viewDef.showDensity ?? listSchema.showDensity
• showUserFilters: viewDef.showUserFilters ?? listSchema.showUserFilters
• exportOptions: viewDef.allowExport === false ? undefined : (viewDef.exportOptions ?? listSchema.exportOptions)
• allowExport: viewDef.allowExport ?? listSchema.allowExport

C. PluginObjectView renderContent schema — 需要补齐透传

• 同上所有新增字段均需在 L816-L823 区域添加

D. ViewConfigPanel — 需要新增开关

• 新增 showHideFields toggle（"启用隐藏字段"开关）
• 新增 showGroup toggle（"启用分组"开关）
• 新增 showColor toggle（"启用颜色"开关）
• 新增 showDensity toggle（"启用行高调整"开关）
• 新增 showUserFilters toggle（"启用用户筛选器"开关）

E. ListViewSchema 类型定义 — 需要扩展

• 在 @object-ui/types ListViewSchema 接口新增：showHideFields?, showGroup?, showColor?, showDensity?, showUserFilters?, allowExport?

F. 测试

• 为每个新增条件渲染编写单元测试
• 端到端测试：面板每个开关 → 对应 toolbar 控件显隐
• 运行全量 test suite

现在我来更新 Issue #719 的内容，纳入以上完整排查结果。好的，深度排查已完成。以下是对现有代码的 全量逐控件排查报告：

🔬 深度排查结果：ViewConfigPanel → ListView toolbar 控件全链路

数据流总结

ViewConfigPanel → updateDraft(field, value) → setViewDraft
    ↓
Console activeView (merge baseView + draft)
    ↓
objectViewSchema (useMemo) ← showSearch/showFilters/showSort ✅ 已传入
    ↓
PluginObjectView (schema prop)
    ↓
renderListView({ schema: { showSearch, showFilters, showSort, ... } }) ✅ 已传入
    ↓
Console renderListView → fullSchema ✅ 已传入
    ↓
<ListView schema={fullSchema} />
    ↓
ListView.tsx toolbar 条件渲染 ← ⚠️ 部分控件未受控

逐控件排查明细

详细分析

✅ 已生效的 3 个控件（Search / Filter / Sort）

          {/* Filter */}
          {schema.showFilters !== false && (
          <Popover open={showFilters} onOpenChange={setShowFilters}>
            ...
          </Popover>
          )}

          {/* Sort */}
          {schema.showSort !== false && (
          <Popover open={showSort} onOpenChange={setShowSort}>
            ...
          </Popover>
          )}

        {/* Right: Search */}
        {schema.showSearch !== false && (
        <div className="flex items-center gap-1">
          ...
        </div>
        )}

这 3 个控件已正确受 schema 控制。 如果你在���际测试中发现它们不生效，问题可能在于 !== false 的判断逻辑：当 ViewConfigPanel 切换开关到 OFF 时，updateDraft('showSearch', false) 确实会将值设为 false，但初始值如果未定义（undefined），undefined !== false 为 true，所以默认就是显示。这个逻辑是正确的。

⛔ 完全无条件渲染的 4 个控件

Hide Fields（L817） — 始终渲染，无任何开关：

          {/* Hide Fields */}
          <Popover open={showHideFields} onOpenChange={setShowHideFields}>
            {/* 没有任何 schema.showXxx 条件判断，始终渲染 */}

Group（L912） — 始终渲染且 disabled：

          {/* Group */}
          <Button variant="ghost" size="sm" disabled>
            {/* 硬编码 disabled，无任何 schema 条件 */}

Color（L962） — 始终渲染且 disabled：

          {/* Color */}
          <Button variant="ghost" size="sm" disabled>
            {/* 硬编码 disabled，无任何 schema 条件 */}

Density（L973） — 始终渲染：

          {/* Row Height / Density Mode */}
          <Button variant="ghost" size="sm" onClick={density.cycle}>
            {/* 始终渲染，无任何 schema 条件 */}

⚠️ Export 不联动的根因

ViewConfigPanel 设置的是 allowExport: boolean，但 ListView 判断的是 schema.exportOptions 对象是否存在：

          {schema.exportOptions && (
            <Popover>...</Popover>
          )}

当面板关闭 allowExport 时，schema.exportOptions 仍然可能是一个对象 {}，所以 Export 按钮依然显示。

🧾 完整修复 Checklist

A. 需要在 ListView.tsx 添加条件渲染的控件（4 个新增 + 1 个修复）：

• Hide Fields 按钮：用 schema.showHideFields !== false && 包裹
• Group 按钮：用 schema.showGroup !== false && 包裹（或 schema.groupBy 存在时才显示）
• Color 按钮：用 schema.showColor !== false && 包裹
• Density 按钮：用 schema.showDensity !== false && 包裹
• Export 按钮：修改判断为 (schema.exportOptions && schema.allowExport !== false) &&

B. 需要在 ViewConfigPanel 添加的新开关（4 个）：

• showHideFields 开关
• showGroup 开关
• showColor 开关
• showDensity 开关

C. 需要在 ListViewSchema 类型定义中添加的字段：

• showHideFields?: boolean
• showGroup?: boolean
• showColor?: boolean
• showDensity?: boolean
• allowExport?: boolean

D. 需要全链路透传的属性（Console renderListView fullSchema）：

• 新增属性 showHideFields, showGroup, showColor, showDensity, allowExport 到 fullSchema

E. 测试覆盖：

• 为每个新增开关添加测试：开关 OFF 时对应 toolbar 按钮不渲染
• 验证 Export 联动修复
• 运行全部 test suite