feat(chat): refine compact history controls and selection mode (#1596)

* Refine compact history controls

Move compact history visibility to a persistent handle while the export tool toggles the history action controls.

Add separate controls state, updated geometry metadata, enlarged handle styling, localized labels, and focused tests for persisted/open states.

* Finalize compact history selection mode

Default compact history to open when no preference is stored and preserve history action controls across visibility toggles.

Require the action controls to be visible for history selection, clear selected messages when the controls hide, and document the final compact history contract.

* Remove superseded compact chat design notes

Drop the older compact chat geometry and home compact design notes now that the consolidated compact chat mode design document is present.

* fix(chat): tighten compact history interaction contracts

修正紧凑历史消息在操作栏隐藏时仍暴露可选按钮语义的问题，仅在 controlsOpen 且消息可选时提供 role、aria-pressed 和可聚焦状态。

将常驻历史展开按钮纳入 compact input island，避免点击该按钮触发输入区强制收起。

同步静态 CSS 契约测试到新的常驻 handle 和 controls-collapsed 合约。

验证：
- bash build_frontend.sh
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- git diff --check

* test(chat): align compact history readonly bubble state

同步默认历史面板测试到新的 read-only bubble 语义：操作栏关闭时不暴露按钮角色和 aria-pressed，打开操作栏后再恢复可选择按钮语义。

验证：
- npm test -- App.test.tsx
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

* fix(chat): refine compact history handle

将紧凑聊天历史常驻展开按钮下移到聊天框拖拽条附近，并改成与原拖拽条一致的青蓝线条样式。

移除中间小三角视觉，改为一条中间粗、两侧细且渐隐的连续线；不增加背景、边框或阴影，不改变历史面板和展开内容结构。

同步静态 CSS 契约测试，锁定 handle 使用 compact surface top 的轻微上偏移定位。

验证：
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

* fix(chat): soften compact history handle line

优化紧凑聊天历史常驻 handle 的线条样式，参考原聊天框拖拽条的颜色、渐变和 3px 线条厚度。

隐藏中间小三角，改为单条两侧更细、中间保留厚度的平滑线；未展开历史时显示短线，展开后恢复满长度。

不改变历史面板、操作栏、点击区域和展开内容结构；同步静态 CSS 契约测试。

验证：
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

* fix(chat): toggle history handle on press

将紧凑聊天历史常驻 handle 改为 pointer down 即切换打开/关闭，短按和长按都不需要等松开。

按下事件会 preventDefault 并 stopPropagation，避免未来整块聊天框拖拽时长按 handle 被外层拖拽逻辑接管；随后产生的 click 会被吞掉，避免二次切换。

保留键盘和普通 click 兜底路径，并补充 App 测试覆盖按下即切换、松开不反向切换、事件不冒泡。

验证：
- npm test -- --run App.test.tsx
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

* fix(chat): allow empty compact input collapse with history

移除 compactExportHistoryOpen 对 collapseCompactInputIfEmpty 的全局早退，避免 first-run 默认显示历史时阻止空输入回到 subtitle。

保留焦点仍在输入壳、历史面板或 history handle 内时不折叠的判断；将 blur 测试改回无持久化记录场景，覆盖默认历史打开状态。

验证：
- npm test -- --run App.test.tsx
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

* test(chat): assert history handle visible behavior

将紧凑历史 handle 的按下测试从原生 pointerdown 冒泡细节，改为断言产品可见行为。

按下 handle 后继续验证历史展开、持久化状态写入，并新增 app-shell 仍保持 input 状态的断言，避免测试依赖 DOM 传播实现细节。

验证：
- npm test -- --run App.test.tsx
- .venv/bin/pytest tests/unit/test_react_chat_window_static.py -q
- bash build_frontend.sh
- git diff --check

Author: yiyiyiyiGKY

docs/design/compact-chat-geometry-issue-list.md

@@ -58,6 +58,10 @@
    - 历史文本拖到角色后发送给当前角色；消息 schema、App、Panel、静态发送桥和去重测试都有对应改动。
 7. `8325ed8b` / `6d6a693f`
    - 收口 compact interaction、工具恢复、命中、history geometry、测试和样式稳定性。
+8. `002407de refine compact history controls`
+   - 历史显隐改为常驻 handle 控制；工具转轮里的历史/导出按钮改为控制历史操作栏。
+9. `e7a8269 stabilize compact resize carrier bounds`
+   - 桌面端 compact resize 期间锁住 carrier 纵向 bounds，避免历史 extra island 在首次 resize 时触发窗口纵向跳动。
 
 ## 当前真实代码链路
 
@@ -82,15 +86,16 @@
    - `.compact-chat-surface-shell`
    - `.compact-chat-surface-frame`
    - `data-compact-geometry-owner="surface"`
-   - `data-compact-geometry-item="capsule" | "input" | "dragHandle" | "resizeHandle" | "toolFan" | "history" | "choice"`
+   - `data-compact-geometry-item="capsule" | "input" | "dragHandle" | "resizeHandle" | "toolFan" | "history" | "historyHandle" | "choice"`
    - `data-compact-geometry-part="capsuleBody" | "inputBody"`
 6. 早期 `.compact-chat-capsule-shell` / `.compact-chat-input-shell` 已不是当前主体事实，后续文档和实现不要再按这两个旧类名设计。
 7. `.compact-chat-surface-frame` 是同一个 54px 高的本体：`default/options` 内放 capsule button，`input` 内放 textarea 和右侧工具/发送按钮。
 8. 蓝线拖拽手柄是 `.compact-chat-drag-handle`，带 `data-compact-drag-handle="true"`，必须保留。
 9. 左右缩放手柄是 `.compact-chat-resize-handle-left/right`，通过 `neko:compact-surface-resize-request` 与宿主同步宽度。
 10. 工具转轮通过 portal 挂到 `document.body`，并以 `data-compact-geometry-item="toolFan"` 进入 geometry。
 11. 历史层由 `CompactExportHistoryPanel` 挂载到 `app-shell` 内，锚点是 `.compact-export-history-anchor`，并以 `data-compact-geometry-item="history"` 进入 geometry。
-12. ChoicePrompt 和 GalGame options 共享 compact choice layer；ChoicePrompt 优先，GalGame 在无 ChoicePrompt 时显示。
+12. 历史显隐由常驻 `.compact-history-visibility-handle` 控制，使用 `data-compact-geometry-item="historyHandle"` 进入 geometry。
+13. ChoicePrompt 和 GalGame options 共享 compact choice layer；ChoicePrompt 优先，GalGame 在无 ChoicePrompt 时显示。
 
 ### NEKO 宿主与静态桥
 
@@ -174,7 +179,7 @@
 ### `default`
 
 1. 显示 `.compact-chat-surface-frame` 胶囊和当前短句。
-2. 不显示完整历史。
+2. 历史层是否显示由独立 history visibility state 控制；初次启动默认显示历史，但历史不属于胶囊本体高度。
 3. 不展开 textarea。
 4. 点击胶囊进入 `input`。
 5. 语音模式 / `composerHidden` 下，点击胶囊不能请求或恢复 `input`，compact 只保留当前文字展示和已打开的历史显示。
@@ -281,10 +286,11 @@ Compact Interaction Geometry 是紧凑态的根合同。所有可见、可点、
 2. `input`
 3. `choice`
 4. `history`
-5. `toolFan`
-6. `dragHandle`
-7. `resizeHandle`
-8. `ball`
+5. `historyHandle`
+6. `toolFan`
+7. `dragHandle`
+8. `resizeHandle`
+9. `ball`
 
 规则：
 
@@ -342,7 +348,7 @@ Compact Interaction Geometry 是紧凑态的根合同。所有可见、可点、
 
 ## 内联历史与导出合同
 
-Compact 默认不展示完整历史；历史通过工具转轮中的历史/导出入口按需打开。
+Compact 历史默认在初次启动时显示。历史列表本身由常驻展开/收起 handle 控制；工具转轮中的历史/导出入口不再直接开关历史列表，而是开关历史下方的操作栏。
 
 当前已落地事实：
 
@@ -352,10 +358,16 @@ Compact 默认不展示完整历史；历史通过工具转轮中的历史/导
 4. 最新消息在最下方，靠近聊天框。
 5. 历史区域有最大高度，超出后内部滚动。
 6. 打开历史后，如果用户继续聊天，应自动保持或恢复到底部。
-7. 选择状态、导出预览和控件折叠状态由 React state 管理。
-8. 预览关闭时要清理 stale export error 和必要 preview lifecycle 状态，避免重新打开显示旧错误。
-9. 历史透明区域不能长期遮挡后方；可见气泡、按钮、预览控件和必要滚动区域可命中，气泡间透明区应尽量穿透。
-10. GalGame / ChoicePrompt 出现时，选项层在历史层上方。
+7. 没有 `neko.reactChatWindow.compactExportHistoryOpen` 持久化记录时，历史默认打开；用户显式收起后持久化为 `false`。
+8. 常驻 `.compact-history-visibility-handle` 只控制历史列表显隐；它关闭历史时不清除操作栏打开状态。
+9. 工具转轮历史/导出按钮控制操作栏显示；如果历史关闭时点击该按钮，应先打开历史并显示操作栏。
+10. 操作栏显示期间进入选择模式：气泡点击 / 键盘 Enter / Space 可以选中或取消选中历史消息。
+11. 操作栏隐藏时退出选择模式：必须清空当前选中项，并禁止继续通过点击或键盘选择；拖拽源识别和拖拽发送不受这个选择模式限制。
+12. 操作栏包含选择和导出动作，如计数、全选、取消/清空、反选、导出预览等；操作栏自身进入 history hit region。
+13. 选择状态、导出预览和操作栏显示状态由 React state 管理；操作栏状态可以跨历史显隐保留，但只在历史实际打开时算作可见。
+14. 预览关闭时要清理 stale export error 和必要 preview lifecycle 状态，避免重新打开显示旧错误。
+15. 历史透明区域不能长期遮挡后方；可见气泡、按钮、预览控件和必要滚动区域可命中，气泡间透明区应尽量穿透。
+16. GalGame / ChoicePrompt 出现时，选项层在历史层上方。
 
 ## 历史气泡拖拽与发送合同
 
@@ -512,7 +524,7 @@ Compact 当前文字是“当前轮轻提示”，不是完整历史记录、字
 基础形态：
 
 1. `compact ↔ minimized` 切换稳定。
-2. compact 默认不展示完整历史。
+2. compact 初次启动默认展示历史；用户显式收起历史后，下次按持久化记录恢复收起。
 3. compact 当前文字在下方 surface 内，不出现上方独立说话框。
 4. minimized ball 位于模型左侧，且不随 surface 拖拽。
 
@@ -551,11 +563,14 @@ Surface：
 
 历史：
 
-1. 历史入口只在用户明确打开时显示历史。
+1. 历史列表初次默认显示；常驻展开/收起 handle 可以显示或隐藏历史列表。
 2. 历史最新消息在下方并可自动回到底部。
-3. 历史选择、全选、反选、清空、导出预览可用。
-4. 历史透明区不遮挡后方。
-5. 预览关闭不会保留旧 error。
+3. 工具转轮历史/导出按钮显示或隐藏操作栏，不直接切换历史列表。
+4. 操作栏显示时可以点击/键盘选中历史消息；操作栏隐藏时清空已选消息并禁止继续选择。
+5. 操作栏隐藏后再次打开，选择、全选、反选、清空、导出预览可用。
+6. 历史列表收起再展开时，操作栏显示状态可保留，但按钮高亮只反映当前实际可见状态。
+7. 历史透明区不遮挡后方。
+8. 预览关闭不会保留旧 error。
 
 历史拖拽：
 

…/design/home-compact-chat-mode-design.md docs/design/compact-chat-mode-design.mddocs/design/home-compact-chat-mode-design.md renamed to docs/design/compact-chat-mode-design.md docs/design/home-compact-chat-mode-design.md renamed to docs/design/compact-chat-mode-design.md

@@ -350,7 +350,7 @@ describe('App', () => {
     }
   });
 
-  it('toggles compact inline history from the export tool without calling the full export path', async () => {
+  it('defaults compact history open and preserves history controls through visibility toggles', async () => {
     const onExportConversationClick = vi.fn();
     const message = parseChatMessage({
       id: 'assistant-history-1',
@@ -371,8 +371,6 @@ describe('App', () => {
       />,
     );
 
-    const exportButton = await clickCompactExportTool();
-
     expect(onExportConversationClick).not.toHaveBeenCalled();
     expect(container.querySelector('.compact-export-history-anchor')).not.toBeNull();
     expect(container.querySelector('.compact-export-history-anchor')).toHaveAttribute('data-compact-geometry-hit-scope', 'children');
@@ -381,18 +379,43 @@ describe('App', () => {
     expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('data-compact-hit-region', 'true');
     expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('data-compact-hit-region-id', 'history:message:assistant-history-1');
     expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('data-compact-hit-region-kind', 'message');
-    expect(container.querySelector('.compact-export-history-controls')).toHaveAttribute('data-compact-hit-region-id', 'history:controls');
+    expect(container.querySelector('.compact-export-history-controls')).toBeNull();
+    expect(container.querySelector('.compact-history-visibility-handle')).toHaveAttribute('data-compact-geometry-item', 'historyHandle');
+    expect(container.querySelector('.compact-history-visibility-handle')).toHaveAttribute('aria-expanded', 'true');
     expect(container.querySelector('.compact-export-history-message')).toHaveAttribute('role', 'listitem');
     expect(container.querySelector('.compact-export-history-message')).not.toHaveAttribute('aria-pressed');
+    expect(container.querySelector('.compact-export-history-bubble')).not.toHaveAttribute('role');
+    expect(container.querySelector('.compact-export-history-bubble')).not.toHaveAttribute('aria-pressed');
+    expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('aria-disabled', 'true');
+    expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('tabindex', '-1');
+    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBeNull();
+
+    const exportButton = await clickCompactExportTool();
     expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('role', 'button');
+    expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('aria-pressed', 'false');
+    expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('aria-disabled', 'false');
+    expect(container.querySelector('.compact-export-history-bubble')).toHaveAttribute('tabindex', '0');
+    expect(container.querySelector('.compact-export-history-controls')).toHaveAttribute('data-compact-hit-region-id', 'history:controls');
     expect(exportButton).toHaveAttribute('aria-pressed', 'true');
-    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('true');
 
-    await clickCompactExportTool();
+    fireEvent.click(container.querySelector<HTMLButtonElement>('.compact-history-visibility-handle')!);
     expect(container.querySelector('.compact-export-history-anchor')).toBeNull();
     expect(container.querySelector('[data-compact-hit-region-id^="history:"]')).toBeNull();
+    expect(container.querySelector('.compact-history-visibility-handle')).toHaveAttribute('aria-expanded', 'false');
     expect(exportButton).toHaveAttribute('aria-pressed', 'false');
     expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('false');
+
+    fireEvent.click(container.querySelector<HTMLButtonElement>('.compact-history-visibility-handle')!);
+    expect(container.querySelector('.compact-export-history-anchor')).not.toBeNull();
+    expect(container.querySelector('.compact-export-history-controls')).toHaveAttribute('data-compact-hit-region-id', 'history:controls');
+    expect(container.querySelector('.compact-history-visibility-handle')).toHaveAttribute('aria-expanded', 'true');
+    expect(exportButton).toHaveAttribute('aria-pressed', 'true');
+    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('true');
+
+    await clickCompactExportTool();
+    expect(container.querySelector('.compact-export-history-anchor')).not.toBeNull();
+    expect(container.querySelector('.compact-export-history-controls')).toBeNull();
+    expect(exportButton).toHaveAttribute('aria-pressed', 'false');
   });
 
   it('restores compact inline history from persisted open state after remount', () => {
@@ -412,7 +435,42 @@ describe('App', () => {
     );
 
     expect(container.querySelector('.compact-export-history-anchor')).not.toBeNull();
-    expect(container.querySelector('.compact-input-tool-item-export')).toHaveAttribute('aria-pressed', 'true');
+    expect(container.querySelector('.compact-export-history-controls')).toBeNull();
+    expect(container.querySelector('.compact-history-visibility-handle')).toHaveAttribute('aria-expanded', 'true');
+    expect(container.querySelector('.compact-input-tool-item-export')).toHaveAttribute('aria-pressed', 'false');
+  });
+
+  it('toggles compact history visibility as soon as the handle is pressed', () => {
+    window.localStorage.setItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY, 'false');
+
+    const { container } = render(
+      <App chatSurfaceMode="compact" compactChatState="input" />,
+    );
+
+    const handle = container.querySelector<HTMLButtonElement>('.compact-history-visibility-handle');
+    expect(handle).not.toBeNull();
+    expect(handle).toHaveAttribute('aria-expanded', 'false');
+    expect(container.querySelector('.compact-export-history-anchor')).toBeNull();
+
+    fireEvent.pointerDown(handle!, { pointerType: 'mouse', button: 0 });
+    expect(handle).toHaveAttribute('aria-expanded', 'true');
+    expect(container.querySelector('.compact-export-history-anchor')).not.toBeNull();
+    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('true');
+    expect(container.querySelector('.app-shell')).toHaveAttribute('data-compact-chat-state', 'input');
+
+    fireEvent.click(handle!);
+    expect(handle).toHaveAttribute('aria-expanded', 'true');
+
+    fireEvent.pointerDown(handle!, { pointerType: 'mouse', button: 0 });
+    expect(handle).toHaveAttribute('aria-expanded', 'false');
+    expect(container.querySelector('.compact-export-history-anchor')).toBeNull();
+    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('false');
+
+    fireEvent.click(handle!);
+    expect(handle).toHaveAttribute('aria-expanded', 'false');
+
+    fireEvent.click(handle!);
+    expect(handle).toHaveAttribute('aria-expanded', 'true');
   });
 
   it('keeps compact export history message actions read-only', async () => {
@@ -582,10 +640,10 @@ describe('App', () => {
     const anchor = container.querySelector('.compact-export-history-anchor');
     expect(anchor).not.toHaveClass('controls-collapsed');
 
-    fireEvent.click(container.querySelector<HTMLButtonElement>('.compact-export-history-controls-toggle')!);
+    await clickCompactExportTool();
     expect(anchor).toHaveClass('controls-collapsed');
 
-    fireEvent.click(container.querySelector<HTMLButtonElement>('.compact-export-history-controls-toggle')!);
+    await clickCompactExportTool();
     expect(anchor).not.toHaveClass('controls-collapsed');
   });
 
@@ -627,11 +685,18 @@ describe('App', () => {
         <App chatSurfaceMode="compact" compactChatState="input" messages={[assistantMessage, userMessage]} />,
       );
 
-      await clickCompactExportTool();
       const messages = container.querySelectorAll<HTMLElement>('.compact-export-history-message');
       const bubbles = container.querySelectorAll<HTMLElement>('.compact-export-history-bubble');
       fireEvent.click(bubbles[1]);
 
+      expect(messages[1]).not.toHaveClass('is-selected');
+      await clickCompactExportTool();
+      fireEvent.click(bubbles[1]);
+      expect(messages[1]).toHaveClass('is-selected');
+      await clickCompactExportTool();
+      expect(messages[1]).not.toHaveClass('is-selected');
+      await clickCompactExportTool();
+      fireEvent.click(bubbles[1]);
       expect(messages[1]).toHaveClass('is-selected');
       fireEvent.click(container.querySelector<HTMLButtonElement>('.compact-export-history-export')!);
 
@@ -1757,7 +1822,7 @@ describe('App', () => {
 
     expect(container.querySelector('.compact-export-history-anchor')).toBeNull();
     expect(container.querySelector('[data-compact-hit-region-id^="history:"]')).toBeNull();
-    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBe('true');
+    expect(window.localStorage.getItem(COMPACT_EXPORT_HISTORY_OPEN_STORAGE_KEY)).toBeNull();
 
     rerender(<App chatSurfaceMode="compact" compactChatState="input" messages={[message]} />);