[0976] 侧边栏联网搜索和深度思考按钮改为纯图标样式 (#4540)

Co-authored-by: Claude Code <noreply@anthropic.com>

Author: PinkMagicFly

devel/0976.md

@@ -0,0 +1,68 @@
+# [0976] 侧边栏的联网搜索和深度思考按钮改为纯图标样式
+
+## 1 任务描述
+
+AI 聊天**侧边栏（dock）**中的「深度思考」「联网搜索」两个开关按钮，样式改为：
+没有按钮边框，也没有文字显示，只有图标。**Chat 标签页（全屏）中的按钮保持
+原样**（主题边框 + 图标 + 文字）。
+
+## 2 任务相关的代码文件
+
+- `src/Plugins/Qt/qt_chat_tab_widget.hpp/.cpp`
+  - `toggle_btn_qss (iconOnly, btnH)`：开关按钮内联样式助手。纯图标模式显式
+    `border: none`（内联样式优先级高于主题 CSS，覆盖主题边框）；文字模式
+    不声明 border，沿用主题 CSS。
+  - `ChatConversationPanel::setToggleButtonsIconOnly`：切换两个按钮的
+    `ToolButtonStyle`（IconOnly / TextBesideIcon）与内联样式。
+  - `QTChatTabWidget::setDockMode` + `dockMode_`：对已有面板立即生效，
+    `createPanel` 对新建面板沿用当前模式。
+  - `make_toggle_btn`：默认仍为文字模式；文字同时设为 tooltip（纯图标模式
+    下供悬停辨认）。
+- `src/Plugins/Qt/qt_tm_widget.cpp`：`sync_chat_sidebar_mode` 进入侧边栏时
+  `setDockMode (true)`；`sync_chat_tab_mode` 及侧边栏隐藏路径把控件移出
+  dock 时 `setDockMode (false)`。
+
+按钮图标本身由主题 CSS 的 `qproperty-iconNormal/iconChecked` 提供
+（`QTMStateToolButton`），勾选态仍通过背景色/图标切换表达，不受影响。
+
+## 3 如何测试
+
+### 3.1 格式化与基础校验
+
+```bash
+gf fmt --changed-since=main
+xmake b stem
+```
+
+### 3.2 手动测试（GUI）
+
+1. 编译并启动 Mogan STEM：
+   ```bash
+   xmake b stem
+   xmake r stem
+   ```
+2. 打开 AI 聊天**侧边栏**（dock）：「深度思考」「联网搜索」按钮无边框、
+   无文字、只显示图标；悬停有 tooltip；点击切换勾选态后图标/背景正常变化。
+3. 打开 Chat **标签页**（全屏会话）：两按钮保持原样（边框 + 图标 + 文字）。
+4. 在侧边栏 ↔ 标签页之间来回切换（含「关闭侧边栏后再打开标签页」路径），
+   两种形态样式各自正确；新建会话面板同样遵循当前模式。
+5. 浅色（liii）与深色（liii-night）主题下分别验证。
+
+## 4 What / Why / How
+
+- **What**：仅侧边栏的深度思考、联网搜索按钮改为纯图标；标签页保持原样。
+- **Why**：侧边栏宽度有限，纯图标按钮更紧凑；标签页空间充裕，保留文字更易读。
+- **How**：同一 `QTChatTabWidget` 在两种模式间复用并被 reparent，故在
+  模式切换点（`sync_chat_sidebar_mode` / `sync_chat_tab_mode`）调用
+  `setDockMode`，由 View 层统一切换按钮样式；`border` 用按钮内联样式
+  覆盖主题 CSS，不改动主题文件。
+
+## 5 如何提交
+
+```bash
+gf fmt --changed-since=main
+git add devel/0976.md
+git commit -m "[0976] 补充任务文档"
+git add src/Plugins/Qt/qt_chat_tab_widget.cpp src/Plugins/Qt/qt_chat_tab_widget.hpp src/Plugins/Qt/qt_tm_widget.cpp
+git commit -m "[0976] 侧边栏联网搜索和深度思考按钮改为纯图标样式"
+```

src/Plugins/Qt/qt_chat_tab_widget.cpp

@@ -189,6 +189,26 @@ ChatConversationPanel::ChatConversationPanel (const string& sessionId,
   setup_ui ();
 }
 
+/**
+ * @brief 思考/搜索开关按钮的内联样式。
+ *
+ * 纯图标模式（dock 侧边栏）需显式 border: none 覆盖主题 CSS 中的边框；
+ * 文字模式（Chat 标签页）不声明 border，由主题 CSS 提供。
+ */
+static QString
+toggle_btn_qss (bool iconOnly, int btnH) {
+  if (iconOnly) {
+    return QString ("QToolButton { border: none; border-radius: %1px; "
+                    "padding: 2px; margin: 0px; }")
+        .arg (btnH / 2);
+  }
+  int fontPx= DpiUtils::scaled (12);
+  return QString ("QToolButton { border-radius: %1px; padding: 2px 2px 2px "
+                  "6px; margin: 0px; font-size: %2px; }")
+      .arg (btnH / 2)
+      .arg (fontPx);
+}
+
 QTMStateToolButton*
 make_toggle_btn (QWidget* parent, const char* objName, const QString& text) {
   int   btnH= DpiUtils::scaled (kSendButtonSize);
@@ -201,18 +221,26 @@ make_toggle_btn (QWidget* parent, const char* objName, const QString& text) {
   btn->setIconSize (QSize (DpiUtils::scaled (kSendIconSize),
                            DpiUtils::scaled (kSendIconSize)));
   btn->setText (text);
+  // 纯图标模式（dock 侧边栏）下文字不显示，靠 tooltip 辨认按钮含义
+  btn->setToolTip (text);
   btn->setToolButtonStyle (Qt::ToolButtonTextBesideIcon);
   btn->setFixedHeight (btnH);
   btn->setSizePolicy (QSizePolicy::Preferred, QSizePolicy::Fixed);
-  int fontPx= DpiUtils::scaled (12);
-  btn->setStyleSheet (
-      QString ("QToolButton { border-radius: %1px; padding: 2px 2px 2px 6px; "
-               "margin: 0px; font-size: %2px; }")
-          .arg (btnH / 2)
-          .arg (fontPx));
+  btn->setStyleSheet (toggle_btn_qss (false, btnH));
   return btn;
 }
 
+void
+ChatConversationPanel::setToggleButtonsIconOnly (bool iconOnly) {
+  Qt::ToolButtonStyle style=
+      iconOnly ? Qt::ToolButtonIconOnly : Qt::ToolButtonTextBesideIcon;
+  int btnH= DpiUtils::scaled (kSendButtonSize);
+  thinkingButton_->setToolButtonStyle (style);
+  thinkingButton_->setStyleSheet (toggle_btn_qss (iconOnly, btnH));
+  searchButton_->setToolButtonStyle (style);
+  searchButton_->setStyleSheet (toggle_btn_qss (iconOnly, btnH));
+}
+
 void
 ChatConversationPanel::setup_ui () {
   QVBoxLayout* contentLayout= new QVBoxLayout (this);
@@ -1667,6 +1695,7 @@ QTChatTabWidget::createPanel (const string& sessionId) {
       sessionId, msgBufUrl, inBufUrl, conversationStack_);
   conversationStack_->addWidget (panel);
   conversations_.append (panel);
+  panel->setToggleButtonsIconOnly (dockMode_);
   return panel;
 }
 
@@ -1915,6 +1944,13 @@ QTChatTabWidget::setSidebarVisible (bool visible) {
   if (floatingBtnContainer_) floatingBtnContainer_->hide ();
 }
 
+void
+QTChatTabWidget::setDockMode (bool dock) {
+  dockMode_= dock;
+  for (int i= 0; i < conversations_.size (); i++)
+    conversations_[i]->setToggleButtonsIconOnly (dock);
+}
+
 void
 QTChatTabWidget::setCloseSidebarButtonVisible (bool visible) {
   if (closeSidebarBtn_) closeSidebarBtn_->setVisible (visible);

src/Plugins/Qt/qt_chat_tab_widget.hpp

@@ -112,6 +112,14 @@ class ChatConversationPanel : public QWidget {
    */
   tree readInputMessage () const;
 
+  /**
+   * @brief 切换思考/搜索按钮为纯图标样式（无边框、无文字）。
+   *
+   * dock 侧边栏模式为纯图标；Chat 标签页模式恢复主题边框 + 图标 + 文字。
+   * @param iconOnly 是否纯图标
+   */
+  void setToggleButtonsIconOnly (bool iconOnly);
+
   QToolButton*  sendButton () const { return sendButton_; }
   QToolButton*  thinkingButton () const { return thinkingButton_; }
   QToolButton*  searchButton () const { return searchButton_; }
@@ -445,6 +453,15 @@ class QTChatTabWidget : public QWidget {
   void setSidebarVisible (bool visible);
   void setCloseSidebarButtonVisible (bool visible);
 
+  /**
+   * @brief 设置 dock 侧边栏模式。
+   *
+   * dock 模式下思考/搜索按钮为纯图标（无边框、无文字）；标签页模式
+   * 恢复主题边框 + 文字。对已有面板立即生效，后续 createPanel 沿用。
+   * @param dock 是否 dock 侧边栏模式
+   */
+  void setDockMode (bool dock);
+
   // ---- 供外部组件访问 ----
   QWidget* contentWidget () const { return contentWidget_; }
 
@@ -497,7 +514,8 @@ class QTChatTabWidget : public QWidget {
   QList<ChatConversationPanel*> conversations_;          ///< 所有会话面板
   ChatConversationPanel* activeConversation_  = nullptr; ///< 当前激活的面板
   bool                   sidebarCollapsed_    = false;   ///< 侧边栏是否折叠
-  int                    sidebarExpandedWidth_= 0;       ///< 侧边栏展开时宽度
+  bool                   dockMode_            = false; ///< 是否 dock 侧边栏模式
+  int                    sidebarExpandedWidth_= 0;     ///< 侧边栏展开时宽度
   qt_tm_widget_rep*      parentTmWidget_= nullptr; ///< 关联的 TeXmacs widget
 
   static bool globalSidebarCollapsed_; ///< 全局记忆的侧边栏折叠状态

src/Plugins/Qt/qt_tm_widget.cpp

@@ -1324,6 +1324,7 @@ qt_tm_widget_rep::sync_chat_tab_mode () {
           chatWidget->setSidebarCollapsed (
               QTChatTabWidget::globalSidebarCollapsed ());
           chatWidget->setCloseSidebarButtonVisible (false);
+          chatWidget->setDockMode (false);
         }
       }
       if (chatSideDock) chatSideDock->hide ();
@@ -1452,6 +1453,7 @@ qt_tm_widget_rep::sync_chat_sidebar_mode () {
     if (chatWidget) {
       chatWidget->setSidebarVisible (false);
       chatWidget->setCloseSidebarButtonVisible (true);
+      chatWidget->setDockMode (true);
       // 连接关闭按钮信号（先断开所有旧连接，避免重复触发）
       QObject::disconnect (chatWidget, &QTChatTabWidget::closeSidebarRequested,
                            nullptr, nullptr);
@@ -1521,6 +1523,7 @@ qt_tm_widget_rep::sync_chat_sidebar_mode () {
         chatWidget->setSidebarCollapsed (
             QTChatTabWidget::globalSidebarCollapsed ());
         chatWidget->setCloseSidebarButtonVisible (false);
+        chatWidget->setDockMode (false);
       }
     }