Feature/perf ui logic (#13)

## Summary

Nhánh `feature/perf-ui-logic`: tối ưu hiệu năng/UI, sửa lỗi workspace và điều hướng, và làm cho công tắc **"Block network for agent-run commands"** chặn thật mọi đường ra mạng của app, **trừ nhà cung cấp AI**.

**Chặn mạng (b78d483, 8c497cf, 10b8379)**
- Bộ kiểm tra chung `application/network/network_guard.py`, nối vào cấu hình đang chạy ở Composition Root: đổi công tắc trong Settings là có hiệu lực ngay.
- Lệnh shell của agent và task script chạy trong **Windows AppContainer không có quyền mạng**: kernel chặn socket, ping, DNS, Invoke-WebRequest… Không cần quyền admin. Không cô lập được thì lệnh bị từ chối, không chạy khi mạng còn mở. macOS dùng `sandbox-exec`, Linux dùng `unshare --net`.
- Bật chặn thì: dừng MCP đang chạy, không khởi động server mới, từ chối lời gọi connector; Microsoft 365 (đăng nhập, Graph, đồng bộ cloud, rules, mail), Teams, nút Test REST/Jira/MCP, link đính kèm task, pip tự cài và tài nguyên web trong xem trước HTML đều bị từ chối.
- Vẫn dùng được: chat, tải danh sách model, thử model; tool OneDrive đã đồng bộ trên máy.
- Công tắc **mặc định tắt** khi mở app lần đầu; nhãn giữ nguyên như cũ.
- Xem trước HTML trong tab Folder giờ hiện được ảnh/CSS/JS từ web khi mạng mở (trước đây trang `file://` không tải được).
- Sửa lỗi app văng khi chuyển tab Graph → Folder: profile WebEngine của trang xem trước bị huỷ trước trang (`0xc0000409` trong Qt6Core.dll); giờ dùng một profile chung thuộc QApplication.
- Không cấp quyền AppContainer kế thừa lên thư mục chứa PySide6 (nếu có, Chromium không nạp được `Qt6WebEngineCore.dll` và tab Graph trắng).
- Cột mục lục trong Settings tính độ rộng theo kiểu chữ của mục đang chọn, "Sandbox Security Layer" không còn bị cắt.

**Các commit khác trong nhánh**
- `b7a41b3` mỗi thư mục làm việc chỉ thuộc về một project · `bbdf146` bật nút Sửa project khi đã có project đang mở
- `35f24e0`, `cc8d5c8`, `2e3e719`, `c699beb` canh hàng / khoảng cách thanh điều hướng
- `2759ed9` không refresh workspace khi chuyển tab Cowork · `7607f44` checkpoint hiệu năng và UI
- `8548c1e` chặn tool mạng của agent · `caf3b74` renderer GraphRAG native trên macOS · `c00b83c` khoảng cách metadata hàng project · `a04f8a9` ẩn picker workspace cloud

## Change Type

- [x] Cowork feature
- [x] Bug fix
- [ ] Core AI contribution
- [x] Test / hardening
- [x] Performance
- [ ] Documentation

## Related Work

Cowork Task:

Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets

Core AI Issue:

Core Task:

Related PR:

## Scope

What is intentionally included?
- Mọi đường ra mạng do app tự mở, trừ nhà cung cấp AI (xem Summary).
- Test: `tests/test_network_guard_lanes.py` (có bài chạy AppContainer thật trên Windows), `tests/ui/test_html_preview_remote_images.py`.

What is intentionally NOT included?
- Chặn cả nhà cung cấp AI / chạy model trên máy (Phương án 2).
- Terminal người dùng tự gõ trong tab Folder, sinh ảnh, cơ chế tự tin chứng chỉ lạ (`tls_trust`).
- Huy hiệu trạng thái "đang chặn" trên thanh trên cùng.

## Validation

- [x] Unit tests
- [x] Integration tests
- [x] Manual verification
- [x] Regression check

Commands / evidence:
- `python -m pytest tests/test_network_guard_lanes.py tests/test_sandbox_block_network.py tests/ui -q` → chỉ còn 1 bài fail, fail cả trên `b7a41b3` (nhãn `ProjectRow` 'Project' chưa dịch, `tests/ui/test_i18n_khong_con_chu_cu.py`).
- `python -m pytest tests -q --ignore=tests/ui` → 4 bài fail, cả 4 cũng fail trên `b7a41b3` (`test_canonical_audit_logger`, 2 bài `test_mcp_audit_security`, `test_monitoring_tab_container`).
- Chạy cả `tests` trong một lượt thì treo ở các test dựng MainWindow trong `tests/ui`; `b7a41b3` cũng treo đúng chỗ đó.
- `check_imports.py` và `check_orphan_modules.py` PASS. `check_loc.py` báo 9 file quá dài, giống hệt trước khi sửa (không file nào do nhánh này làm dài thêm).
- Kiểm tra tay trên Windows 11: trong AppContainer, Python báo `WinError 10013`, ping/nslookup/PowerShell/curl đều không ra được mạng; cmd, git, python chạy bình thường.
- Kiểm tra tay trên Windows 11: xem trước HTML tải được 4/4 tài nguyên web khi mạng mở, 0/4 khi bật chặn; tab Graph hoạt động; tạo/huỷ trang xem trước nhiều lần không còn cảnh báo profile của Qt.

## Security Impact

Permission / credential / network / customer data impact:
- Network: khi bật công tắc, chỉ nhà cung cấp AI còn ra mạng; nội dung chat vẫn gửi tới nhà cung cấp AI.
- Permission: lần đầu chạy lệnh trong sandbox, app **thêm quyền (ACE) cho SID AppContainer** trên thư mục làm việc (ghi), thư mục cài Python gốc (đọc), gốc venv và `Scripts` (đọc). Không xoá quyền nào. Thư mục chứa PySide6 không bao giờ nhận quyền kế thừa; một quyền kế thừa sai trên venv (từ bản dev trước) được tự gỡ.
- Credential: không đổi. Khi chặn, trạng thái đăng nhập M365 được đọc thẳng từ kho token trên máy, không dựng MSAL.

## Compatibility

- [x] No breaking change
- [ ] Breaking change documented

Ghi chú: `block_network` mặc định đổi từ bật sang tắt cho cấu hình mới; máy đã lưu `true` thì giữ nguyên. Khi đang chặn, lệnh dùng công cụ cài trong thư mục người dùng (ngoài Program Files) có thể báo Access denied; thư viện trong venv của app không dùng được trong sandbox.

## Reviewer Notes

- `infrastructure/sandbox/appcontainer_process.py` gọi Win32 bằng ctypes (CreateAppContainerProfile, CreateProcessW với SECURITY_CAPABILITIES) và dùng `icacls` để cấp quyền: nên xem kỹ phần cấp quyền.
- `tests/conftest.py` thêm fixture autouse gỡ `network_guard` sau mỗi test, vì `build_context()` gắn cổng này ở mức process.
- `core/task_executors.py` đang đúng bằng trần LOC nên `_run_script` được tách sang `core/task_script.py`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: minhanhpkpro <minhanhpkpro@gmail.com>
Co-authored-by: Duy Le Huu <duylh19@fpt.com>
Co-authored-by: thanhnv <thanhnv.ip@gmail.com>
Reviewed-on: #13

presentation/chat/chat_agents.py

@@ -115,10 +115,23 @@ class ChatAgentsMixin:
             if err:
                 self.status_message.emit(tr("chatpanel.agent_list_error", err=err))
 
-        w = AgentWorker(job)
-        w.finished_ok.connect(done)
-        self._agent_worker = w
-        w.start()
+        # Model discovery can involve a provider/network request.  Constructing
+        # the chat panel during startup must not wait for it; schedule it after
+        # the first event-loop turn so the initial shell can paint immediately.
+        from PySide6.QtCore import QTimer
+
+        if getattr(self, "_agent_refresh_pending", False):
+            return
+        self._agent_refresh_pending = True
+
+        def start_worker() -> None:
+            self._agent_refresh_pending = False
+            w = AgentWorker(job)
+            w.finished_ok.connect(done)
+            self._agent_worker = w
+            w.start()
+
+        QTimer.singleShot(0, start_worker)
 
     def _populate_agents(self, models, keep: str) -> None:
         """Đổ danh sách vào bộ chọn Agent.

presentation/chat/chat_history_widget.py

@@ -51,6 +51,8 @@ class MessageBubble(QFrame):
         super().__init__()
         self.role = role
         self._text = ""
+        self._stream_pending = False
+        self._render_count = 0
         self._collapsible = collapsible
         self._title = title
         self._head = None
@@ -164,12 +166,20 @@ class MessageBubble(QFrame):
     def append_delta(self, delta: str) -> None:
         """Nối thêm một mẩu văn bản đang phát dần từ model rồi vẽ lại dạng markdown."""
         self._text += delta
-        self.set_markdown(self._text)
+        if not self._stream_pending:
+            self._stream_pending = True
+            QTimer.singleShot(40, self.flush_stream)
+
+    def flush_stream(self) -> None:
+        if self._stream_pending:
+            self._stream_pending = False
+            self.set_markdown(self._text)
 
     def set_markdown(self, text: str) -> None:
         """Đặt toàn bộ nội dung, hiển thị dạng markdown, rồi co giãn lại chiều cao."""
         self._text = text
         self.body.setMarkdown(text)
+        self._render_count += 1
         self._autosize()
         if self._collapsible:
             self._update_head()
@@ -393,4 +403,3 @@ class ChatView(QScrollArea):
 ChatHistoryWidget = ChatView
 
 __all__ = ["ChatView", "ChatHistoryWidget", "MessageBubble"]
-

presentation/folder/office_document_renderer.py

@@ -110,7 +110,10 @@ class OfficeDocumentRenderer:
         if self._engine is None:
             try:
                 from PySide6.QtWebEngineWidgets import QWebEngineView
+
+                from .offline_web_page import install_offline_page
                 self._engine = QWebEngineView()
+                install_offline_page(self._engine)
                 self._owner.stack.addWidget(self._engine)
             except Exception:  # noqa: BLE001
                 self._engine = None

presentation/folder/offline_web_page.py

@@ -0,0 +1,66 @@
+"""HTML preview page that loads nothing from the web while "Block network" is on.
+
+``QWebEngineView.setHtml`` happily fetches every ``<img src="https://...">``,
+``<script src>`` and stylesheet the previewed file references — an outbound
+connection the user never asked for, made by the app itself. The preview gets
+its own off-the-record profile (so the interceptor below touches no other web
+view, e.g. the GraphRAG renderer) and every remote request is refused while
+the switch is on. Local files, ``data:`` and ``qrc:`` URLs still load.
+
+Lifetime rule: a ``QWebEngineProfile`` must outlive every page that uses it.
+A profile owned by the view is destroyed *before* the page (children die in
+creation order) — Qt then warns "Release of profile requested but
+WebEnginePage still not deleted" and the app can abort later (0xc0000409 in
+Qt6Core.dll, seen when switching tabs). So there is ONE profile for the whole
+app, owned by the QApplication, and each page is owned by its view.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtWebEngineCore import (
+    QWebEnginePage, QWebEngineProfile, QWebEngineSettings, QWebEngineUrlRequestInterceptor,
+)
+from PySide6.QtWidgets import QApplication
+
+from cowork_local.application.network import network_guard
+
+_REMOTE_SCHEMES = frozenset({"http", "https", "ws", "wss", "ftp"})
+_profile: Optional[QWebEngineProfile] = None
+_blocker: Optional["RemoteRequestBlocker"] = None   # Python must hold it, or it is collected
+
+
+class RemoteRequestBlocker(QWebEngineUrlRequestInterceptor):
+    """Refuses remote URLs whenever the network guard says the network is blocked."""
+
+    def interceptRequest(self, info) -> None:  # noqa: N802 - Qt override
+        """Called by WebEngine for every request the page makes."""
+        if info.requestUrl().scheme().lower() in _REMOTE_SCHEMES and network_guard.is_blocked():
+            info.block(True)
+
+
+def preview_profile() -> QWebEngineProfile:
+    """The app-wide off-the-record profile shared by every HTML preview."""
+    global _profile, _blocker
+    if _profile is None:
+        _profile = QWebEngineProfile(QApplication.instance())   # no storage name = off the record
+        _blocker = RemoteRequestBlocker(_profile)
+        _profile.setUrlRequestInterceptor(_blocker)
+        _profile.settings().setAttribute(
+            QWebEngineSettings.WebAttribute.LocalContentCanAccessRemoteUrls, True)
+    return _profile
+
+
+def install_offline_page(view) -> None:
+    """Give ``view`` a page on the shared preview profile.
+
+    The previewed file is loaded with a ``file://`` base URL, and Qt refuses
+    every remote resource of such a page unless
+    ``LocalContentCanAccessRemoteUrls`` is on — so web images never showed,
+    even with the network open. The switch is turned on for the profile; the
+    interceptor is what keeps remote content out while "Block network" is on.
+    """
+    view.setPage(QWebEnginePage(preview_profile(), view))
+
+
+__all__ = ["RemoteRequestBlocker", "install_offline_page", "preview_profile"]

presentation/graph/graph_renderer.py

@@ -237,7 +237,7 @@ class GraphRenderer(QWidget):
     # ---- prewarm / scan lifecycle -------------------------------------------------- #
     def prewarm(self) -> None:
         """Pay for the graph view before it is clicked on, not during."""
-        if not HAS_WEB_ENGINE or self.web is not None:
+        if self.web is not None:
             return
         self._ensure_web()
         if self._graph is None and self.path_edit.text().strip():

presentation/monitoring/monitoring_tab.py

@@ -19,6 +19,7 @@ from PySide6.QtWidgets import QHBoxLayout, QLabel, QTabWidget, QVBoxLayout, QWid
 from ...core import audit_log
 from ...i18n import on_language_changed, tr
 from ...state import AppContext
+from ...performance import span
 from .tabs.action_logs_tab import ActionLogsTab
 from .tabs.agent_status_tab import AgentStatusTab
 from .tabs.mcp_tab import McpTab
@@ -282,12 +283,13 @@ class MonitoringTab(QWidget):
         """
         start = date.today() - timedelta(days=_LOG_WINDOW_DAYS)
         shared_dir = self.ctx.config.shared_dir
-        if shared_dir:
-            from ...core import telemetry_shared
-            shared_events = telemetry_shared.load_shared_audit_events(shared_dir, start=start)
-            if shared_events:
-                return shared_events
-        return audit_log.load_events(start=start)
+        with span("monitoring.load_events", window_days=_LOG_WINDOW_DAYS):
+            if shared_dir:
+                from ...core import telemetry_shared
+                shared_events = telemetry_shared.load_shared_audit_events(shared_dir, start=start)
+                if shared_events:
+                    return shared_events
+            return audit_log.load_events(start=start)
 
     def _apply_events_to_event_tabs(self, events: List[dict]) -> None:
         """Filters the ALREADY-LOADED event list (see ``_load_events`` — one

presentation/monitoring/tabs/tools_admin_tab.py

@@ -216,7 +216,8 @@ class ToolsAdminTab(QWidget):
         result. Respects the fetch_url toggle: when web access is OFF the agent
         cannot reach the internet, so the test reports that instead of probing."""
         disabled = ("fetch_url" in self.ctx.config.tools_disabled
-                    or not bool(self.ctx.config.agent_security.get("allow_url_fetch", True)))
+                    or not bool(self.ctx.config.agent_security.get("allow_url_fetch", True))
+                    or bool(self.ctx.config.agent_security.get("block_network", False)))
         if disabled:
             self.test_internet_status.setText(tr("tools_admin.internet_disabled"))
             self.test_internet_status.setStyleSheet("color: #c00;")

presentation/shared/list_sizing.py

@@ -0,0 +1,27 @@
+"""Width of a navigation list whose current row is drawn bold.
+
+The theme draws the selected ``sectionIndex`` row with ``font-weight: 600``
+and 10px padding each side (``theme/qss.py``). Sizing the list from the plain
+font left the selected label too wide for its row, so "Sandbox Security
+Layer" was cut off in Settings as soon as it was picked.
+"""
+from __future__ import annotations
+
+from typing import Iterable
+
+from PySide6.QtGui import QFont, QFontMetrics
+
+#: Item padding (10px x 2) + item radius + list frame, with a little slack.
+ROW_CHROME_PX = 48
+
+
+def selected_label_width(widget, labels: Iterable[str]) -> int:
+    """Pixels needed to show the widest of ``labels`` in the bold selected style."""
+    widget.ensurePolished()
+    bold = QFont(widget.font())
+    bold.setWeight(QFont.Weight.DemiBold)
+    metrics = QFontMetrics(bold)
+    return max((metrics.horizontalAdvance(label) for label in labels), default=0) + ROW_CHROME_PX
+
+
+__all__ = ["ROW_CHROME_PX", "selected_label_width"]

presentation/shared/web_engine_support.py

@@ -27,7 +27,14 @@ def _frozen_onefile() -> bool:
         return True
 
 
+# QtWebEngine is noisy and unreliable on the macOS runtime we support (GPU/
+# helper-process failures leave the stacked view blank). The native Qt graph is
+# already available and avoids that failure path entirely.
+HAS_WEB_ENGINE = False
+
 try:  # WebEngine + WebChannel are optional PySide6 add-ons
+    if sys.platform == "darwin":
+        raise ImportError("use native graph renderer on macOS")
     from PySide6.QtWebEngineWidgets import QWebEngineView  # noqa: F401
     from PySide6.QtWebChannel import QWebChannel  # noqa: F401
     HAS_WEB_ENGINE = not _frozen_onefile()

presentation/shell/bootstrap.py

@@ -42,5 +42,14 @@ def build_config(path: Path | None = None) -> JsonConfigRepository:
 
 
 def build_context(path: Path | None = None) -> AppContext:
-    """Dựng AppContext hoàn chỉnh — điểm vào cho ``app.run()`` và cho checker."""
-    return AppContext(build_config(path))
+    """Dựng AppContext hoàn chỉnh — điểm vào cho ``app.run()`` và cho checker.
+
+    Nối luôn cổng mạng chung vào cấu hình SỐNG của context: đổi công tắc
+    "Chặn mạng" trong Settings là có hiệu lực ngay ở lời gọi mạng kế tiếp.
+    """
+    from ...application.network import network_guard
+    from ...core.agent_security import sandbox_settings
+
+    ctx = AppContext(build_config(path))
+    network_guard.bind(lambda: sandbox_settings(ctx.config)[1])
+    return ctx

presentation/shell/main_window.py

@@ -32,9 +32,7 @@ from .rail_metrics import _NAV_MIN_WIDTH
 from .tray_manager import TrayManager
 from ...state import AppContext
 from ...core.task_scheduler import TaskScheduler
-from ...ui.cowork_tab import CoworkTab
 from ...ui.sidebar import HistorySidebar
-from ..graph.structure_graph_view import StructureGraphView
 from ...ui.workspace_tab import WorkspaceTab
 
 
@@ -111,10 +109,9 @@ class MainWindow(NavRailMixin, RailProjectMixin, TopBarMixin,
         # Workspace screen (per selected project). GraphRAG's heavy
         # QtWebEngine is still built lazily on first display
         # (StructureGraphView._ensure_web).
+        from ...ui.cowork_tab import CoworkTab
         self.cowork = CoworkTab(ctx)
-        self.structure = StructureGraphView(ctx)
-        self.structure.status_message.connect(self.statusBar().showMessage)
-        self.cowork.output_changed.connect(self.structure.schedule_rescan)
+        self.structure = None
         self.cowork.status_message.connect(self.statusBar().showMessage)
         # Refresh History (list + running markers + current highlight) whenever a
         # conversation is created/updated or a turn finishes.

presentation/shell/page_registry.py

@@ -142,10 +142,11 @@ class PageRegistryMixin:
         Vệt sáng trên thanh menu cũng cập nhật ở đây, để nó đi theo NỘI DUNG chứ
         không theo thứ vừa được bấm.
         """
+        was_page = self.pages.currentIndex()
         self._ensure_page(page)                # build lazy page on first visit
         self.pages.setCurrentIndex(page)
-        if page == self._ROW_WORKSPACE:
-            self.workspace.refresh()           # re-list projects + threads on entry
+        if page == self._ROW_WORKSPACE and was_page != page:
+            self.workspace.refresh()           # refresh only when entering Workspace
         widget = self._page_widgets[page]
         if sub is not None and hasattr(widget, "select_subtab"):
             # Enforce the project gate here rather than at each entry point. A

presentation/shell/rail_metrics.py

@@ -19,9 +19,8 @@ _NAV_ROW_GAP = 6
 # Không đặt bằng ``margin`` trong QSS: margin của stylesheet được vẽ BÊN TRONG
 # hộp của widget, mà nút này lại bị ``_rebuild_nav`` ghim đúng chiều cao một
 # dòng menu — nên margin không mua được một pixel khoảng cách nào.
-# 10 -> 4: đủ để Cài đặt không dính vào nhóm Dashboard/Giám sát, nhưng không
-# rộng đến mức trông như hai khu tách rời.
-_NAV_SETTINGS_GAP = 4
+# Settings dùng cùng nhịp hàng với Dashboard và Monitoring.
+_NAV_SETTINGS_GAP = 0
 # 132 -> 232: o 132px nhan "Cuoc tro chuyen moi" bi cat mat chu. San phai du
 # rong cho nhan DAI NHAT tren thanh, khong phai cho nhan trung binh.
 _NAV_MIN_WIDTH = 232

presentation/shell/session_events.py

@@ -42,7 +42,14 @@ class SessionEventsMixin:
             self.sidebar.refresh()
             self._refresh_rail_recents()   # the rail shortcut follows the panel
 
-        QTimer.singleShot(0, _do)
+        # Coalesce bursts from turn/tool/history signals into one sidebar read.
+        timer = getattr(self, "_history_refresh_timer", None)
+        if timer is None:
+            timer = QTimer(self)
+            timer.setSingleShot(True)
+            timer.timeout.connect(_do)
+            self._history_refresh_timer = timer
+        timer.start(0)
     def _on_scheduled_task_done(self, task_id: str, ok: bool) -> None:
         """Desktop notification for a finished scheduled task (toast always,
         tray balloon when the window isn't focused), then refresh History —
@@ -106,4 +113,5 @@ class SessionEventsMixin:
         """Project được tạo/sửa/xoá: gom nhóm lại cột lịch sử và cập nhật nhãn thư mục."""
         self.sidebar.refresh()                 # History regroups by project
         self.cowork._apply_output_folder_label()  # project may have been renamed
-        self.structure._refresh_project_combo()   # GraphRAG's project lock list follows too
+        if getattr(self, "structure", None) is not None:
+            self.structure._refresh_project_combo()   # GraphRAG's project lock list follows too

presentation/shell/top_bar.py

@@ -32,10 +32,10 @@ class TopBarMixin:
         ``_build_account_row`` ngay bên dưới, chỉ khác chỗ đặt trên màn hình.
         """
         from PySide6.QtCore import Qt
-        from PySide6.QtWidgets import QHBoxLayout, QLabel, QPushButton
+        from PySide6.QtWidgets import QHBoxLayout, QLabel, QPushButton, QStyle
         from ...i18n import tr
         from ...ui.icons import icon as _icon
-        from .rail_metrics import _NAV_ROW_GAP, _NAV_ROW_INSET, _NAV_SETTINGS_GAP
+        from .rail_metrics import _NAV_ROW_INSET, _NAV_SETTINGS_GAP
 
         # Bottom-pinned group: the places you visit occasionally, kept out of the
         # way of the ones you live in. A hairline (styled via #navrailBottom in
@@ -59,11 +59,17 @@ class TopBarMixin:
         # that number. Adding it again here made the row taller than the button
         # (28 wanted, 20 given), which both clipped the icon and pushed the text
         # 8px below an even pitch with Dashboard / Giám sát.
-        srow.setContentsMargins(_NAV_ROW_INSET, 0, 8, 0)
-        srow.setSpacing(_NAV_ROW_GAP)
+        srow.setContentsMargins(_NAV_ROW_INSET + 2, 0, 8, 0)
+        # Khe giữa icon và chữ phải là khe của STYLE, không phải nhịp riêng của
+        # rail: delegate của cây vẽ chữ ngay sau hộp icon, cách đúng
+        # ``PM_FocusFrameHMargin + 1``. Đặt ``_NAV_ROW_GAP + 4`` (=10) ở đây cộng
+        # với 10px lề trái và hộp icon 22px thành 42 — trong khi Dashboard /
+        # Giám sát đặt chữ ở 35, nên hàng Cài đặt thụt phải 7px.
+        srow.setSpacing(
+            self.nav_bottom.style().pixelMetric(QStyle.PM_FocusFrameHMargin) + 1)
         self._nav_settings_icon = QLabel()
-        self._nav_settings_icon.setPixmap(_icon("settings").pixmap(16, 16))
-        self._nav_settings_icon.setFixedSize(16, 16)
+        self._nav_settings_icon.setPixmap(_icon("gear").pixmap(16, 16))
+        self._nav_settings_icon.setFixedSize(22, 16)
         self._nav_settings_text = QLabel(tr("app.settings"))
         srow.addWidget(self._nav_settings_icon)
         srow.addWidget(self._nav_settings_text)

presentation/workspace/project_editing.py

@@ -52,7 +52,7 @@ class ProjectRow(QWidget):
 
         lay = QVBoxLayout(self)
         lay.setContentsMargins(6, 4, 6, 4)
-        lay.setSpacing(0)
+        lay.setSpacing(3)
         self.title_label = QLabel(name)
         self.counts_label = QLabel()
         self.counts_label.setObjectName("hint")
@@ -90,6 +90,7 @@ def _row_layout_of(widget: QWidget) -> QLayout | None:
     return None
 
 
+
 class ProjectEditingMixin:
     """Danh sách project + CRUD + chế độ sửa. Trộn vào ``WorkspaceTab``.
 
@@ -133,10 +134,17 @@ class ProjectEditingMixin:
         # dung luat ma _new_btn da theo (_new_btn.setVisible(on_project) trong
         # WorkspaceTab._apply_pane_visibility) — hai nut nay phai theo y nhu vay.
         self.tabs.currentChanged.connect(self._sync_project_buttons)
+        # Đổi project cũng phải đồng bộ lại: ``_load_current`` nạp form và đặt
+        # ``_current_id`` rồi phát tín hiệu này, nhưng không đụng tới ba nút.
+        self.project_selected.connect(self._sync_project_buttons)
 
         self.project_list.setContextMenuPolicy(Qt.CustomContextMenu)
         self.project_list.customContextMenuRequested.connect(self._show_project_menu)
 
+        # Luật "mỗi thư mục một project" sống ở module riêng — xem
+        # ``project_folder_rules.py`` về lý do nó không nằm trong file này.
+        self.install_project_folder_rule()
+
         self.set_project_editable(False)
 
     # ---- chế độ chỉ-xem / sửa -------------------------------------------
@@ -153,15 +161,14 @@ class ProjectEditingMixin:
         Bật: ngược lại, và nút Lưu chuyển sang màu xác nhận (token ``success``).
         """
         self._project_editable = on
-        has_project = bool(getattr(self, "_current_id", ""))
 
         for field in self._editable_fields():
             # setReadOnly thay vì setEnabled: ô mờ đi thì không bôi đen copy
             # được nữa, mà đọc và copy chính là việc của chế độ chỉ-xem.
             field.setReadOnly(not on)
-        self._browse_btn.setEnabled(on and has_project)
-        self._save_btn.setEnabled(on and has_project)
-        self._edit_btn.setEnabled(not on and has_project)
+        # Ba nút không tự bật/tắt ở đây: ``_sync_project_buttons`` mới là nơi
+        # duy nhất tính trạng thái của chúng, vì nó còn chạy cả khi người dùng
+        # đổi project — lúc đó ``set_project_editable`` không được gọi.
         self._sync_project_buttons()
 
         # Nút Lưu xanh lá khi đang sửa (hành động xác nhận), về màu nhấn mặc
@@ -171,15 +178,25 @@ class ProjectEditingMixin:
         self._repolish(self._edit_btn)
 
     def _sync_project_buttons(self, *_a) -> None:
-        """Ẩn "Sửa project" và "Lưu project" ngoài sub-tab Project.
+        """Đồng bộ CẢ hiện/ẩn LẪN bật/mờ của ba nút theo trạng thái hiện tại.
 
-        Chúng nằm trên hàng tiêu đề dùng chung, nên không tự ẩn là chúng hiện
-        cả ở Cowork — nơi không có biểu mẫu project nào để sửa hay lưu.
+        Ẩn ngoài sub-tab Project: chúng nằm trên hàng tiêu đề dùng chung, nên
+        không tự ẩn là chúng hiện cả ở Cowork — nơi không có biểu mẫu project
+        nào để sửa hay lưu.
+
+        Bật/mờ cũng tính ở đây chứ không ở ``set_project_editable``: đổi
+        project KHÔNG đi qua hàm đó (``_load_current`` chỉ nạp lại form), nên
+        để ở đó thì "Sửa project" giữ nguyên trạng thái tính từ lúc dựng —
+        lúc chưa project nào được chọn — và cứ mờ mãi dù project đã mở.
         """
         on_project = self.tabs.currentIndex() == self._project_tab_idx
         has_project = bool(getattr(self, "_current_id", ""))
+        dang_sua = bool(getattr(self, "_project_editable", False))
         self._edit_btn.setVisible(on_project and has_project)
         self._save_btn.setVisible(on_project and has_project)
+        self._edit_btn.setEnabled(not dang_sua and has_project)
+        self._save_btn.setEnabled(dang_sua and has_project)
+        self._browse_btn.setEnabled(dang_sua and has_project)
 
     @staticmethod
     def _repolish(widget: QWidget) -> None:

presentation/workspace/project_folder_rules.py

@@ -0,0 +1,113 @@
+"""Luật "mỗi thư mục làm việc chỉ thuộc về MỘT project".
+
+Tách khỏi ``project_editing.py`` chứ không nhét thêm vào đó: file kia đã gom
+bốn tính năng và thêm luật này là chạm trần 400 dòng của
+``scripts/check_loc.py``. Đây cũng là một mối quan tâm riêng — nó không nói về
+việc *sửa* một project mà về việc hai project không được giẫm lên nhau.
+
+Luật có hai nửa, cố ý không đối xứng:
+
+* **Chặn lúc CHỌN.** Ba nơi đặt được thư mục làm việc (nút "Đổi" ở màn Project,
+  thư mục cloud, nút chọn thư mục trong tab Cowork) đều đi qua
+  :func:`folder_taken_blocked`, để cả ba chặn giống hệt nhau. Không chặn ở
+  "Lưu project": nút đó chỉ ghi tên/mô tả/chỉ dẫn, chặn ở đó sẽ khoá luôn việc
+  đổi tên một project lỡ đang trùng thư mục.
+* **Cảnh báo cho cái ĐANG sai.** Dữ liệu cũ có thể đã có hai project trỏ vào
+  cùng một thư mục, mà nửa trên chỉ chặn từ nay trở đi. Nhãn dưới ô "Thư mục
+  làm việc" nói ra điều đó và để người dùng tự đổi — sửa hộ là tự ý đụng vào
+  dữ liệu của họ.
+
+Phép so trùng nằm ở ``core/projects.py::folder_conflict`` (thuần, không Qt).
+"""
+from __future__ import annotations
+
+from PySide6.QtWidgets import QLabel, QLayout, QMessageBox, QWidget
+
+from ...i18n import tr
+from .project_editing import _row_layout_of
+
+
+def _layout_chua(layout: QLayout, con: QLayout) -> "tuple | None":
+    """``(layout_cha, vị_trí)`` của ``con`` bên trong ``layout``, duyệt đệ quy."""
+    for i in range(layout.count()):
+        item = layout.itemAt(i)
+        ben_trong = item.layout()
+        if ben_trong is con:
+            return layout, i
+        if ben_trong is not None:
+            tim = _layout_chua(ben_trong, con)
+            if tim is not None:
+                return tim
+    return None
+
+
+def folder_taken_blocked(parent: QWidget, path: str, ignore_id: str) -> bool:
+    """``True`` nếu ``path`` đã thuộc project khác — và đã báo cho người dùng.
+
+    Dùng chung cho cả ba nơi đặt được thư mục làm việc (nút "Đổi" ở màn
+    Project, thư mục cloud, và nút chọn thư mục trong tab Cowork), để cả ba
+    chặn giống hệt nhau thay vì mỗi nơi tự nghĩ ra một luật.
+
+    Chặn ở lúc CHỌN chứ không ở lúc Lưu: "Lưu project" chỉ ghi tên, mô tả và
+    chỉ dẫn — chặn ở đó sẽ khoá luôn việc đổi tên một project lỡ đang trùng
+    thư mục, tức phạt người dùng vì một trạng thái họ chưa kịp sửa.
+    """
+    from ...core.projects import folder_conflict
+
+    khac = folder_conflict(path, ignore_id=ignore_id)
+    if khac is None:
+        return False
+    QMessageBox.warning(parent, tr("workspace.folder_taken_title"),
+                        tr("workspace.folder_taken_body", name=khac.name,
+                           folder=str(khac.workspace_dir())))
+    return True
+
+
+
+class ProjectFolderRuleMixin:
+    """Nửa giao diện của luật. Trộn vào ``WorkspaceTab``."""
+
+    def install_project_folder_rule(self) -> None:
+        """Dựng nhãn cảnh báo và nối nó vào việc đổi project.
+
+        Gọi từ ``install_project_editing``, tức sau khi form đã dựng xong.
+        """
+        self._folder_warn_lbl = QLabel()
+        self._folder_warn_lbl.setObjectName("warning")   # màu lấy từ theme/
+        self._folder_warn_lbl.setWordWrap(True)
+        self._folder_warn_lbl.hide()
+        self._gan_nhan_canh_bao_thu_muc()
+        self.project_selected.connect(self._sync_folder_warning)
+
+    def _gan_nhan_canh_bao_thu_muc(self) -> None:
+        """Chèn nhãn cảnh báo ngay DƯỚI hàng chứa ô Thư mục làm việc.
+
+        Chèn từ đây thay vì thêm dòng vào ``_build_project_tab``: file
+        ``ui/workspace_tab.py`` đang vượt trần của ``scripts/check_loc.py``,
+        nên mọi dòng mới đều phải tránh nó (cùng lý do nút "Sửa project" được
+        chèn bằng ``_row_layout_of``).
+        """
+        hang = _row_layout_of(self.folder_lbl)
+        cha = self.folder_lbl.parentWidget()
+        if hang is None or cha is None or cha.layout() is None:
+            return
+        tim = _layout_chua(cha.layout(), hang)
+        if tim is None:
+            return
+        layout, vi_tri = tim
+        layout.insertWidget(vi_tri + 1, self._folder_warn_lbl)
+
+    def _sync_folder_warning(self, *_a) -> None:
+        """Hiện/ẩn cảnh báo "thư mục đang dùng chung" theo project đang mở."""
+        from ...core.projects import folder_conflict, load_project
+
+        pid = getattr(self, "_current_id", "")
+        project = load_project(pid) if pid else None
+        khac = (folder_conflict(project.workspace_dir(), ignore_id=pid)
+                if project is not None else None)
+        if khac is None:
+            self._folder_warn_lbl.hide()
+            return
+        self._folder_warn_lbl.setText(
+            tr("workspace.folder_shared_warning", name=khac.name))
+        self._folder_warn_lbl.show()