[222_84] 极简模式：隐藏模式工具栏、焦点工具栏 (#3292)

Author: da-liii

TeXmacs/plugins/lang/dic/en_US/zh_CN.scm

@@ -861,6 +861,7 @@
 ("fn" "字符")
 ("focus dependent icons" "焦点工具栏")
 ("focus mode" "专注模式")
+("simplest mode" "极简模式")
 ("focus" "焦点")
 ("fold all fields" "折叠全部区域")
 ("fold comments" "折叠所有批注")

TeXmacs/progs/kernel/texmacs/tm-modes.scm

@@ -278,6 +278,7 @@
   (spell-mode% (== (get-input-mode) 3))
   (complete-mode% (== (get-input-mode) 4))
   (remote-control-mode% (== remote-control-flag? #t))
+  (simplest-mode% (and (not (visible-icon-bar? 1)) (not (visible-icon-bar? 2))))
   (focus-mode% (not (visible-header?)))
   (in-cyrillic-jcuken% (cyrillic-input-method? "jcuken") in-cyrillic%)
   (in-cyrillic-translit% (cyrillic-input-method? "translit") in-cyrillic%)

TeXmacs/progs/texmacs/menus/main-menu.scm

@@ -106,11 +106,20 @@
   ("Focus mode" (toggle-focus-mode)))
 
 (tm-menu (texmacs-popup-menu)
-  (:require (focus-mode?))
+  (:require (and (focus-mode?) (not (simplest-mode?))))
   (link focus-popup-menu)
   ---
   (former))
 
+(menu-bind simplest-popup-menu
+  ("Simplest mode" (toggle-simplest-mode)))
+
+(tm-menu (texmacs-popup-menu)
+  (:require (simplest-mode?))
+  (link simplest-popup-menu)
+  ---
+  (former))
+
 (tm-menu (texmacs-popup-menu)
   ("Smart paste" (kbd-magic-paste))
   ("Paste special" (interactive-paste-special))

TeXmacs/progs/texmacs/menus/view-menu.scm

@@ -115,6 +115,7 @@
       ---)
   ("Full screen mode"  (toggle-full-screen-edit-mode))
   ("Focus mode" (toggle-focus-mode))
+  ("Simplest mode" (toggle-simplest-mode))
   ("Presentation mode" (toggle-full-screen-mode))
   ("Show panorama" (toggle-panorama-mode))
   ("Show all slides" (toggle-slideshow-mode))

TeXmacs/progs/texmacs/texmacs/tm-view.scm

@@ -143,8 +143,26 @@
 (tm-define (toggle-focus-mode)
   (:synopsis "Toggle focus mode.")
   (:check-mark "v" focus-mode?)
+  (if (and (not (focus-mode?)) (simplest-mode?))
+      (toggle-simplest-mode))
   (toggle-visible-header))
 
+(define saved-simplest-state '(#t #t))
+
+(tm-define (toggle-simplest-mode)
+  (:synopsis "Toggle simplest mode.")
+  (:check-mark "v" simplest-mode?)
+  (if (and (not (simplest-mode?)) (focus-mode?))
+      (toggle-focus-mode))
+  (if (simplest-mode?)
+      (begin
+        (show-icon-bar 1 (car saved-simplest-state))
+        (show-icon-bar 2 (cadr saved-simplest-state)))
+      (begin
+        (set! saved-simplest-state (list (visible-icon-bar? 1) (visible-icon-bar? 2)))
+        (show-icon-bar 1 #f)
+        (show-icon-bar 2 #f))))
+
 (define saved-informative-flags "default")
 
 (tm-define (toggle-full-screen-mode)

devel/222_84.md

@@ -0,0 +1,100 @@
+# [222_84] 极简模式：隐藏模式工具栏、焦点工具栏，保留菜单栏
+
+## 相关文档
+- [x_y.md](x_y.md) - 开发文档模板
+
+## 任务相关的代码文件
+- `TeXmacs/progs/texmacs/menus/view-menu.scm` - 查看菜单定义
+- `TeXmacs/progs/texmacs/texmacs/tm-view.scm` - 视图状态切换函数
+- `TeXmacs/progs/kernel/texmacs/tm-modes.scm` - 模式状态定义
+- `TeXmacs/progs/texmacs/menus/main-menu.scm` - 右键菜单定义
+- `src/Texmacs/Window/tm_frame.cpp` - C++ 层工具栏显示控制
+- `src/Plugins/Qt/qt_tm_widget.cpp` - Qt 层 UI 可见性控制
+
+## 如何测试
+1. 启动 Mogan
+2. 点击 `查看` 菜单，确认有 `极简模式` 选项
+3. 点击 `极简模式`，确认模式工具栏、焦点工具栏被隐藏，菜单栏保留
+4. 在编辑区域右键，确认有 `极简模式` 选项可退出
+5. 退出极简模式后，确认之前被隐藏的 UI 元素恢复显示
+6. 进入极简模式后，再进入专注模式，然后退出专注模式，确认不再是极简模式
+   - 点击 `极简模式`，确认模式工具栏、焦点工具栏被隐藏
+   - 点击 `Focus mode`，确认菜单栏被隐藏（此时极简模式自动退出）
+   - 退出 `Focus mode`，确认菜单栏恢复显示
+   - 确认模式工具栏、焦点工具栏保持显示（不是极简模式）
+
+## 如何提交
+```bash
+# 提交前执行的最少测试步骤
+xmake build mogan
+./build/mogan
+```
+
+## 2026/05/08 第一步：定义极简模式状态与切换函数
+
+### What
+在 Scheme 层定义极简模式的状态判断和切换函数。
+
+### Why
+参考专注模式（`toggle-focus-mode`）的实现方式，极简模式需要：
+1. 一个状态变量/函数判断当前是否处于极简模式
+2. 一个切换函数进入/退出极简模式
+3. 保存进入极简模式前的 UI 状态，以便退出时恢复
+
+### How
+1. 在 `tm-modes.scm` 中定义 `simplest-mode?`：
+   - 极简模式状态 = 模式工具栏隐藏 且 焦点工具栏隐藏
+   - 即 `(simplest-mode% (and (not (visible-icon-bar? 1)) (not (visible-icon-bar? 2))))`
+
+2. 在 `tm-view.scm` 中实现 `toggle-simplest-mode`：
+   - 需要保存进入极简模式前的状态（模式工具栏、焦点工具栏的可见性）
+   - 使用 `saved-simplest-state` 变量存储二元组 `(mode-visible? focus-visible?)`
+   - 进入极简模式时：
+     - 保存当前状态
+     - 调用 `(show-icon-bar 1 #f)`、`(show-icon-bar 2 #f)` 隐藏两个工具栏
+   - 退出极简模式时：
+     - 根据保存的状态恢复两个工具栏
+
+## 2026/05/08 第二步：在查看菜单和右键菜单中添加入口
+
+### What
+在查看菜单中添加 `极简模式` 选项，并在右键菜单中添加退出入口。
+
+### Why
+参考专注模式的交互方式：
+- 专注模式在 `查看` 菜单中有 `Focus mode` 入口
+- 进入专注模式后，右键菜单会出现 `Focus mode` 选项用于退出
+
+### How
+1. 在 `view-menu.scm` 的 `view-menu` 中，在 `Focus mode` 下方添加 `极简模式` 菜单项：
+   ```scheme
+   ("极简模式" (toggle-simplest-mode))
+   ```
+
+2. 在 `main-menu.scm` 的 `texmacs-popup-menu` 中，参照 `focus-popup-menu` 的实现，添加 `simplest-popup-menu`：
+   ```scheme
+   (menu-bind simplest-popup-menu
+     ("极简模式" (toggle-simplest-mode)))
+
+   (tm-menu (texmacs-popup-menu)
+     (:require (simplest-mode?))
+     (link simplest-popup-menu)
+     ---
+     (former))
+   ```
+   注意：需要处理与 `focus-popup-menu` 的共存逻辑，确保两个模式都能正确显示右键菜单。
+
+## 2026/05/08 第三步：处理模式共存与边界情况
+
+### What
+处理极简模式与专注模式、全屏模式等其他模式的共存逻辑。
+
+### Why
+如果用户同时开启了专注模式和极简模式，退出其中一个时可能会意外恢复 UI 元素。
+
+### How
+- 专注模式只控制菜单栏，极简模式控制模式工具栏+焦点工具栏：
+  - 两者控制不同的 UI 元素，可以完全共存
+  - 进入极简模式时，如果专注模式已开启，菜单栏保持隐藏状态
+  - 退出极简模式时，只恢复工具栏，不影响菜单栏
+  - 退出专注模式时，只恢复菜单栏，不影响工具栏