dsh-better-sidebar 0.10.3 → 0.11.0

package/README.md

@@ -16,22 +16,29 @@ https://github.com/user-attachments/assets/23187822-047e-45cc-b480-fe997bd55b86
 
 <img width="2630" height="1794" alt="6c4293e1bec2e935031bf0e986d6ec65" src="https://github.com/user-attachments/assets/dfdb875e-a1a8-4d4b-8340-353736b1708f" />
 
+## 🆕 最近更新
+
+- **终端自定义字体**：设置页终端卡片新增字体族 + 9–32px 字号设置，实时生效
+- **侧边卡片设置页重构**：分组容器卡片、计数徽标、自定义开关、加宽设置弹窗
+- **修复**：WKWebView 下底部面板展开后终端空白（xterm 零尺寸容器初始化崩溃，[#25](https://github.com/omdsh-dev/DSH-better-sidebar/issues/25)）
+- **文档**：client 改动硬刷新即可生效，无需重启 DSH
+
 ## ✨ 功能一览
 
-- **🗂️ 资源管理器**：懒加载目录树（根 = 会话 cwd）、点击在侧边栏打开、行尾 `@文件` 引用到输入框、右键复制路径
-- **📝 编辑与预览**：CodeMirror 6 多语言高亮 + Ctrl/Cmd+S 原子保存；图片 / Markdown（预览/编辑切换）/ HTML（沙箱 iframe 预览，相对资源可加载）/ PDF / Word / Excel / PPT 内联预览，切换 Tab 不丢草稿
-- **⚡ 客户端懒加载**：Office / 终端 / 代码编辑器等重依赖按需分块加载——启动只拉 ~325KB 核心，打开 .xlsx 才拉 Univer（~20MB）、打开 .docx 只拉 docx 预览器、打开终端才拉 xterm；首次打开短暂 loading 后即用（详见 `docs/plans/2026-08-12-lazy-chunks-design.md`）
-- **🌐 浏览器**：内嵌网页浏览 tab（多开），后退/前进/刷新 +「在浏览器中打开」；页面在**沙箱 iframe** 中运行（不透明源：无法访问界面数据与本地文件，拒绝 localhost 等本机地址），界面实时显示沙箱状态、可临时解锁（关闭时红色警示）；被站点拒绝嵌入（X-Frame-Options）时显示原因面板；聊天/界面里的 http(s) 外链默认在侧边栏打开（侧边栏折叠时自动展开面板）
-- **💻 终端**：xterm.js + node-pty 真实 shell（每会话 3 个 UI 上限）、Tab 保活重连回放；可选为模型注入 8 个 `terminal_*` 工具
-- **🌿 Git 面板**：真 diff + VSCode 式 diff tab、懒加载历史、右键暂存/放弃/提交/还原/捡取
-- **🧩 后台任务页**：主会话完整 agent 拓扑、点击直达执行记录、实时工具调用轮询、新子代理自动展开；**同页显示后台任务**（当前树全部后台任务，bash/pwsh 类型徽标 + 退出码，点击查看实时输出——自动跟随底部、非消费 peek，不干扰模型的 `job_output`；两击确认可强制终止）
-- **🪟 底部面板**：独立的第二个工作台（与右侧栏同类的标签页），只挤占中间 Agent 输出区、不覆盖左右侧边栏；**首次展开自动开一个新终端**（终端卡片二级设置可关）；右上角 x 一键折叠
-- **📱 移动端**：视口 < 768px（真正的移动端宽度，不对齐宿主 1024 断点）时只显示右侧栏——进入窄屏时底部面板的标签页**直接并入右侧栏标签条**，右上角只剩一枚开关，面板为全宽抽屉；新会话默认收起，聊天里点文件/外链自动展开，不挤压对话区
-- **🔧 分栏工作台**：拖 Tab 拆分/合并分栏（可**跨面板拖 Tab**）、分隔线调比例；右上角持久按钮簇（底栏 + 侧拉 glyph）折叠/展开两个面板；两面板共享拐角双向拖动调节尺寸，拖动 rAF 直写 DOM 保持流畅
-- **🔁 会话隔离**：布局/分栏/Tab/两面板状态按会话持久化（localStorage），陈旧状态自动净化；聊天「产出文件」改在侧边栏打开（面板折叠时自动展开）
-- **⚙️ 声明式设置**：设置页「侧边卡片」分区按注册表渲染功能清单（小卡片网格，高亮 = 启用），每项可独立开/关；二级设置（子代理自动展开、终端工具、底部面板首展自动开终端、沙箱开关等）经齿轮按钮在原生弹窗中编辑
-- **🔌 服务化**：暴露 `ctx.betterSidebar` 服务，其他插件可注册侧边栏 tab 与文件预览器（内置 7 tab + 9 viewer 也走同一服务，详见 [AGENTS.md](./AGENTS.md)）
-- **🌏 多语言**：界面文案跟随 DSH 的语言设置（zh/en）实时切换——Host 偏好优先于浏览器语言，词典注册进 DSH 的 i18n 命名空间；切换语言无需刷新
+- **🗂️ 资源管理器**：懒加载目录树（根 = 会话 cwd），点击打开、`@文件` 引用、右键复制路径
+- **📝 编辑与预览**：CodeMirror 6 编辑（Ctrl/Cmd+S 原子保存，切 Tab 不丢草稿）；图片 / Markdown / HTML / PDF / Word / Excel / PPT 内联预览（HTML 走沙箱 iframe）
+- **⚡ 客户端懒加载**：启动只拉 ~325KB 核心，Office / 终端 / 编辑器等重依赖用到才按需拉取（详见 `docs/plans/2026-08-12-lazy-chunks-design.md`）
+- **🌐 浏览器**：多开内嵌网页 tab，后退/前进/刷新；内容运行在沙箱 iframe（无法访问界面数据与本地文件，拒绝本机地址），可临时解锁（红色警示）；被站点拒绝嵌入时显示原因；外链默认在侧边栏打开
+- **💻 终端**：xterm.js + node-pty 真实 shell、断线重连回放；可选为模型注入 `terminal_*` 工具；支持自定义字体（字体族 + 9–32px 字号，实时生效）
+- **🌿 Git 面板**：真 diff + VSCode 式 diff tab、历史、右键暂存/提交/还原等
+- **🧩 后台任务页**：主会话 agent 拓扑、点击直达执行记录；同页显示后台任务（类型徽标 + 退出码、实时输出 peek、可强制终止）
+- **🪟 底部面板**：第二个独立工作台，只挤占中间输出区；首次展开自动开终端（可关）
+- **📱 移动端**：窄屏（<768px）自动合并为全宽抽屉，底部面板标签页并入右侧栏；点文件/外链自动展开
+- **🔧 分栏工作台**：拖 Tab 拆分/合并（可跨面板）、分隔线调比例；右上角按钮一键折叠/展开面板
+- **🔁 会话隔离**：布局 / Tab / 面板状态按会话持久化，陈旧状态自动净化；「产出文件」在侧边栏打开
+- **⚙️ 声明式设置**：设置页「侧边卡片」按注册表渲染开关网格，逐项独立开/关；二级设置（自动展开、终端工具、沙箱等）经齿轮弹窗编辑
+- **🔌 服务化**：暴露 `ctx.betterSidebar`，其他插件可注册 tab 与文件预览器（内置 7 tab + 9 viewer 同走一服务，见 [AGENTS.md](./AGENTS.md)）
+- **🌏 多语言**：界面文案跟随 DSH 语言（zh/en）实时切换，无需刷新
 
 ## 🚀 安装
 
@@ -49,17 +56,17 @@ curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/s
 irm https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1 | iex
 ```
 
-装完**重启 DSH 并硬刷新**（Cmd/Ctrl+Shift+R）即可看到侧边栏。
+装完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可看到侧边栏（DSH 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。
 
 <details>
 <summary><b>指定版本 / 装完自动重启（可选）</b></summary>
 
 ```sh
 # macOS / Linux
-curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.sh | bash -s 0.10.3 --restart
+curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.sh | bash -s 0.11.0 --restart
 
 # Windows PowerShell
-& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1'))) -Version 0.10.3 -Restart
+& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1'))) -Version 0.11.0 -Restart
 ```
 
 不确定的话，可先加 `--dry-run`（PowerShell 用 `-DryRun`）预览步骤再执行。
@@ -85,7 +92,7 @@ minimumReleaseAgeExclude:
   - dsh-better-sidebar
 EOF
 
-# ③ 安装并自动挂载（不带 @版本 = npm 的 latest；固定版本写 dsh-better-sidebar@0.10.3）
+# ③ 安装并自动挂载（不带 @版本 = npm 的 latest；固定版本写 dsh-better-sidebar@0.11.0）
 npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar
 ```
 
@@ -116,7 +123,7 @@ npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sideba
 3. 执行 `dsh plugin --profile web add dsh-better-sidebar`：登记依赖 → 识别包内 `dsh.bundle.patch` → 自动注册进 `dsh.profile.bundles` 挂载；
 4. 清理旧版残留的手动挂载行，避免「双挂载」（页面出现两个侧边栏）。
 
-`curl | bash` / `irm | iex` 会执行远程代码——脚本已随仓库开源（`scripts/install.sh` / `scripts/install.ps1`），可先下载审阅。插件以 npm 包 `dsh-better-sidebar@0.10.3` 发布，通过 `dsh.bundle.patch`（随包的 `cordis.patch.yml`）由官方 CLI 自动挂载，**不修改 DSH 源码**。
+`curl | bash` / `irm | iex` 会执行远程代码——脚本已随仓库开源（`scripts/install.sh` / `scripts/install.ps1`），可先下载审阅。插件以 npm 包 `dsh-better-sidebar@0.11.0` 发布，通过 `dsh.bundle.patch`（随包的 `cordis.patch.yml`）由官方 CLI 自动挂载，**不修改 DSH 源码**。
 
 </details>
 
@@ -127,7 +134,7 @@ npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sideba
 dsh plugin --profile web add dsh-better-sidebar
 ```
 
-或重跑一次一键脚本；也可把 `~/.dsh/profiles/web/package.json` 里的版本号改高后 `pnpm install`。改完**重启 DSH 并硬刷新**（Cmd/Ctrl+Shift+R）。
+或重跑一次一键脚本；也可把 `~/.dsh/profiles/web/package.json` 里的版本号改高后 `pnpm install`。改完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可（client 改动无需重启 DSH）。
 
 </details>
 
@@ -159,10 +166,10 @@ dsh plugin --profile web add dsh-better-sidebar
        - id: better-sidebar
          name: 'dsh-better-sidebar'
 4. 在 ~/.dsh/profiles/web 执行 pnpm install
-5. 重启 DSH 并硬刷新
+5. 硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到效果（client 改动无需重启 DSH；host 半改动才需重启）
 ```
 
-更新：`git pull && pnpm install && pnpm build` → 重启 DSH（仅 client 改动可硬刷新）。切回 npm 通道时，把依赖改回 `"dsh-better-sidebar": "^0.10.3"` 再 `pnpm install`。
+更新：`git pull && pnpm install && pnpm build` → 硬刷新浏览器即可（client 改动热加载生效，无需重启 DSH；host 半改动才需重启）。切回 npm 通道时，把依赖改回 `"dsh-better-sidebar": "^0.11.0"` 再 `pnpm install`。
 
 </details>
 
@@ -240,3 +247,7 @@ pnpm watch        # tsdown --watch
 ## 🖥️ 平台支持
 
 Windows / Linux / macOS 三平台适配（macOS 日常验证；其余经单元测试覆盖）；`node-pty` 优先预编译二进制，失败需编译工具链（Windows VS Build Tools / Linux make+g+++python3 / macOS Xcode CLT）。
+
+## 🔗 友情链接
+
+- [dsh-tianshu-tui](https://github.com/huiliyi37/dsh-tianshu-tui)：DeepSeek Harness 交互式终端 UI 插件（渲染核心由自研 harness agent Tianshu-Tui 演进而来），在官方基础上增加 TDD 与证据门等工作流

package/README_EN.md

@@ -16,22 +16,29 @@ https://github.com/user-attachments/assets/23187822-047e-45cc-b480-fe997bd55b86
 
 <img width="2630" height="1794" alt="6c4293e1bec2e935031bf0e986d6ec65" src="https://github.com/user-attachments/assets/dfdb875e-a1a8-4d4b-8340-353736b1708f" />
 
+## 🆕 Recent Updates
+
+- **Custom terminal fonts**: font-family + 9–32px size settings on the terminal card, applied live
+- **Side card settings redesign**: grouped container cards, count badges, custom toggles, wider settings dialog
+- **Fix**: blank terminal after expanding the bottom panel on WKWebView (xterm initialized in a zero-size container, [#25](https://github.com/omdsh-dev/DSH-better-sidebar/issues/25))
+- **Docs**: client changes take effect on a hard refresh — no DSH restart needed
+
 ## ✨ Features
 
-- **🗂️ File Explorer**: lazy-loading directory tree (root = session cwd), click to open in the sidebar, `@file` reference at end of line into the input box, right-click to copy path
-- **📝 Edit & Preview**: CodeMirror 6 multi-language highlighting + Ctrl/Cmd+S atomic save; inline preview for images / Markdown (preview/edit toggle) / HTML (sandboxed iframe preview, relative resources loadable) / PDF / Word / Excel / PPT; drafts survive tab switches
-- **⚡ Client-side Lazy Loading**: heavy dependencies (Office / terminal / code editor) are chunked and loaded on demand — only ~325KB core is fetched at startup; Univer (~20MB) is fetched only when opening .xlsx, the docx viewer only when opening .docx, xterm only when opening a terminal; brief loading on first open, then instant (see `docs/plans/2026-08-12-lazy-chunks-design.md`)
-- **🌐 Browser**: embedded web browsing tabs (multiple), back/forward/refresh + "Open in browser"; pages run in a **sandboxed iframe** (opaque origin: cannot access UI data or local files, rejects localhost and other local addresses); the UI shows sandbox status live and can be temporarily unlocked (red warning when off); sites that refuse embedding (X-Frame-Options) show a reason panel; http(s) links in chat/UI open in the sidebar by default (panel auto-expands when collapsed)
-- **💻 Terminal**: xterm.js + node-pty real shell (max 3 UI instances per session), tab keep-alive with reconnect/replay; optionally injects 8 `terminal_*` tools for the model
-- **🌿 Git Panel**: real diff + VSCode-style diff tabs, lazy-loaded history, right-click to stage/discard/commit/revert/pick
-- **🧩 Background Tasks**: full agent topology of the main session, click-through to execution records, live tool-call polling, auto-expand for new subagents; background tasks shown on the same page (all background tasks in the current tree, bash/pwsh type badges + exit codes, click to view live output — auto-follows the bottom, non-consuming peek that doesn't disturb the model's `job_output`; double-click confirm to force-kill)
-- **🪟 Bottom Panel**: an independent second workbench (same kind of tabs as the right sidebar) that only squeezes the middle Agent output area without covering the left/right sidebars; auto-opens a new terminal on first expand (can be disabled in the terminal card's secondary settings); one-click collapse via the top-right x
-- **📱 Mobile**: at viewport < 768px (true mobile width, not the host's 1024 breakpoint) only the right sidebar shows — when entering narrow screens, bottom-panel tabs merge directly into the right sidebar's tab bar, leaving a single toggle at top-right and a full-width drawer panel; new sessions start collapsed; files/external links in chat auto-expand without squeezing the conversation area
-- **🔧 Split-pane Workbench**: drag tabs to split/merge panes (cross-panel dragging supported), divider to adjust ratios; persistent button cluster at top-right (bottom bar + side pull glyph) to collapse/expand both panels; the two panels share a corner double-direction drag to resize, rAF direct-DOM writes keep it smooth
-- **🔁 Session Isolation**: layout/panes/tabs/panel states persisted per session (localStorage), stale state auto-purged; chat "produced files" open in the sidebar (auto-expands panels when collapsed)
-- **⚙️ Declarative Settings**: the "Side Cards" section of the settings page renders a registry-driven feature list (small card grid, highlighted = enabled), each toggleable independently; secondary settings (auto-expand subagents, terminal tools, auto-open terminal on first bottom-panel expand, sandbox switches, etc.) are edited in a native dialog via the gear button
-- **🔌 Service API**: exposes the `ctx.betterSidebar` service — other plugins can register sidebar tabs and file viewers (the 7 built-in tabs + 9 viewers go through the same service, see [AGENTS.md](./AGENTS.md))
-- **🌏 i18n**: UI text follows DSH's language setting (zh/en) with live switching — Host preference takes priority over browser language, dictionaries registered into DSH's i18n namespace; no refresh needed
+- **🗂️ File Explorer**: lazy-loading directory tree (root = session cwd), click to open, `@file` reference, right-click to copy path
+- **📝 Edit & Preview**: CodeMirror 6 editing (Ctrl/Cmd+S atomic save, drafts survive tab switches); inline preview for images / Markdown / HTML / PDF / Word / Excel / PPT (HTML in a sandboxed iframe)
+- **⚡ Client-side Lazy Loading**: only ~325KB core at startup; heavy deps (Office / terminal / editor) load on demand (see `docs/plans/2026-08-12-lazy-chunks-design.md`)
+- **🌐 Browser**: multiple embedded web tabs, back/forward/refresh; pages run in a sandboxed iframe (no access to UI data or local files, rejects local addresses), temporarily unlockable (red warning); sites refusing embedding show a reason panel; external links open in the sidebar by default
+- **💻 Terminal**: xterm.js + node-pty real shell, reconnect with transcript replay; optionally injects `terminal_*` tools for the model; custom font (family + 9–32px size, applied live)
+- **🌿 Git Panel**: real diff + VSCode-style diff tabs, history, right-click to stage/commit/revert etc.
+- **🧩 Background Tasks**: main-session agent topology with click-through to execution records; background tasks on the same page (type badges + exit codes, live-output peek, force-kill)
+- **🪟 Bottom Panel**: an independent second workbench that only squeezes the center output area; auto-opens a terminal on first expand (toggleable)
+- **📱 Mobile**: narrow viewports (<768px) merge into a full-width drawer with the bottom panel's tabs folded into the sidebar; files/links auto-expand the panel
+- **🔧 Split-pane Workbench**: drag tabs to split/merge panes (cross-panel supported), divider to adjust ratios; one-click collapse/expand both panels from the top-right buttons
+- **🔁 Session Isolation**: layout / tabs / panel states persisted per session, stale state auto-purged; "produced files" open in the sidebar
+- **⚙️ Declarative Settings**: the "Side Cards" settings section renders a registry-driven toggle grid, each item independently switchable; secondary settings (auto-expand, terminal tools, sandbox, etc.) edited in a native dialog via the gear button
+- **🔌 Service API**: exposes `ctx.betterSidebar` — other plugins can register tabs and file viewers (the 7 built-in tabs + 9 viewers share the same service, see [AGENTS.md](./AGENTS.md))
+- **🌏 i18n**: UI text follows DSH's language setting (zh/en) with live switching, no refresh needed
 
 ## 🚀 Installation
 
@@ -49,17 +56,17 @@ curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/s
 irm https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1 | iex
 ```
 
-Then **restart DSH and hard-refresh** (Cmd/Ctrl+Shift+R) to see the sidebar.
+Then **hard-refresh the browser** (Cmd/Ctrl+Shift+R) to see the sidebar (DSH hot-reloads client changes; only host-half updates need a restart).
 
 <details>
 <summary><b>Pin a version / auto-restart (optional)</b></summary>
 
 ```sh
 # macOS / Linux
-curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.sh | bash -s 0.10.3 --restart
+curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.sh | bash -s 0.11.0 --restart
 
 # Windows PowerShell
-& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1'))) -Version 0.10.3 -Restart
+& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1'))) -Version 0.11.0 -Restart
 ```
 
 Not sure? Add `--dry-run` (`-DryRun` in PowerShell) to preview before running.
@@ -85,7 +92,7 @@ minimumReleaseAgeExclude:
   - dsh-better-sidebar
 EOF
 
-# ③ Install and auto-mount (no @version = npm's latest; pin with dsh-better-sidebar@0.10.3)
+# ③ Install and auto-mount (no @version = npm's latest; pin with dsh-better-sidebar@0.11.0)
 npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar
 ```
 
@@ -116,7 +123,7 @@ The one-click script does four things, all idempotent (safe to re-run):
 3. Runs `dsh plugin --profile web add dsh-better-sidebar`: registers the dependency → detects `dsh.bundle.patch` → auto-appends the plugin to `dsh.profile.bundles`;
 4. Removes any leftover hand-written mount line to avoid double-mounting (two sidebars on the page).
 
-`curl | bash` / `irm | iex` executes remote code — the scripts are open source in the repo (`scripts/install.sh` / `scripts/install.ps1`); download and review them first if you prefer. The plugin ships as npm package `dsh-better-sidebar@0.10.3` and mounts via `dsh.bundle.patch` (the shipped `cordis.patch.yml`), so the DSH source is never modified.
+`curl | bash` / `irm | iex` executes remote code — the scripts are open source in the repo (`scripts/install.sh` / `scripts/install.ps1`); download and review them first if you prefer. The plugin ships as npm package `dsh-better-sidebar@0.11.0` and mounts via `dsh.bundle.patch` (the shipped `cordis.patch.yml`), so the DSH source is never modified.
 
 </details>
 
@@ -127,7 +134,7 @@ The one-click script does four things, all idempotent (safe to re-run):
 dsh plugin --profile web add dsh-better-sidebar
 ```
 
-or re-run the one-click script; or bump the version in `~/.dsh/profiles/web/package.json` (e.g. `"^0.10.3"`) and run `pnpm install`. Then restart DSH and hard-refresh (Cmd/Ctrl+Shift+R).
+or re-run the one-click script; or bump the version in `~/.dsh/profiles/web/package.json` (e.g. `"^0.11.0"`) and run `pnpm install`. Then hard-refresh the browser (Cmd/Ctrl+Shift+R) — client changes do not need a DSH restart.
 
 </details>
 
@@ -162,7 +169,7 @@ To debug local changes or track the dev branch, point the dependency at a local
 5. Restart DSH and hard-refresh
 ```
 
-Update: `git pull && pnpm install && pnpm build` → restart DSH (client-only changes can just hard-refresh). To switch back to the npm channel, restore `"dsh-better-sidebar": "^0.10.3"` and re-run `pnpm install`.
+Update: `git pull && pnpm install && pnpm build` → just hard-refresh the browser (client changes hot-reload; only host-half changes need a DSH restart). To switch back to the npm channel, restore `"dsh-better-sidebar": "^0.11.0"` and re-run `pnpm install`.
 
 </details>
 
@@ -240,3 +247,7 @@ pnpm watch        # tsdown --watch
 ## 🖥️ Platform Support
 
 Windows / Linux / macOS (macOS validated daily; the rest covered by unit tests); `node-pty` prefers prebuilt binaries, otherwise a build toolchain is required (Windows VS Build Tools / Linux make+g+++python3 / macOS Xcode CLT).
+
+## 🔗 Friends
+
+- [dsh-tianshu-tui](https://github.com/huiliyi37/dsh-tianshu-tui): an interactive terminal UI plugin for DeepSeek Harness (its rendering core evolved from the self-developed harness agent Tianshu-Tui), adding TDD and evidence-gate workflows on top of the official harness

package/lib/client-docx.js

@@ -174,6 +174,9 @@ globalThis.__dshChunks__["docx"] = (require) => {
 		copyAbsolute: "复制绝对地址",
 		download: "下载",
 		settingsNav: "侧边卡片",
+		settingsIntro: "管理侧边卡片的显示内容与默认行为",
+		settingsPopupDesc: "为「{feature}」配置相关选项",
+		settingsDone: "完成",
 		settingsOpenTitle: "新会话默认打开",
 		settingsOpenDesc: "新建会话时自动展开侧边卡片；已存在的会话保持各自布局",
 		settingsWidthTitle: "默认宽度占比",
@@ -201,6 +204,12 @@ globalThis.__dshChunks__["docx"] = (require) => {
 		settingsToolsDesc: "开启后，模型可通过 terminal_create 等 8 个工具创建并操作侧边栏终端（默认关闭）",
 		settingsBottomTerminalTitle: "底部面板首次展开自动开终端",
 		settingsBottomTerminalDesc: "每次会话中第一次展开底部面板时，尝试在底部面板自动打开一个新终端标签（终端数量上限仍会限制；默认开启）",
+		settingsFontFamilyTitle: "终端字体",
+		settingsFontFamilyDesc: "自定义终端字体族（CSS font-family，如 \"JetBrains Mono\", monospace；留空跟随主题等宽字体）",
+		settingsFontFamilyPlaceholder: "\"JetBrains Mono\", monospace",
+		settingsFontSizeTitle: "终端字号",
+		settingsFontSizeDesc: "终端字号（9–32，默认 13）",
+		settingsFontSizeSuffix: "px",
 		settingsTabsTitle: "侧边栏内容",
 		settingsViewersTitle: "文件预览",
 		settingsGeneralTitle: "常规",
@@ -374,6 +383,9 @@ globalThis.__dshChunks__["docx"] = (require) => {
 		copyAbsolute: "Copy absolute path",
 		download: "Download",
 		settingsNav: "Side card",
+		settingsIntro: "Manage what the side card shows and how it behaves",
+		settingsPopupDesc: "Configure related options for {feature}",
+		settingsDone: "Done",
 		settingsOpenTitle: "Open by default for new conversations",
 		settingsOpenDesc: "Expand the side card automatically for brand-new conversations; existing conversations keep their own layouts",
 		settingsWidthTitle: "Default width share",
@@ -401,6 +413,12 @@ globalThis.__dshChunks__["docx"] = (require) => {
 		settingsToolsDesc: "When enabled, the model can create and drive sidebar terminals through the 8 terminal_* tools (off by default)",
 		settingsBottomTerminalTitle: "Auto-open a terminal on the bottom panel's first expansion",
 		settingsBottomTerminalDesc: "When the bottom panel is expanded for the first time in a session, try to open a fresh terminal tab there (the terminal quota still applies; on by default)",
+		settingsFontFamilyTitle: "Terminal font family",
+		settingsFontFamilyDesc: "Custom terminal font family (a CSS font-family stack like \"JetBrains Mono\", monospace; leave empty to follow the theme's monospace font)",
+		settingsFontFamilyPlaceholder: "\"JetBrains Mono\", monospace",
+		settingsFontSizeTitle: "Terminal font size",
+		settingsFontSizeDesc: "Terminal font size in px (9–32, default 13)",
+		settingsFontSizeSuffix: "px",
 		settingsTabsTitle: "Sidebar content",
 		settingsViewersTitle: "File viewers",
 		settingsGeneralTitle: "General",
@@ -502,182 +520,182 @@ globalThis.__dshChunks__["docx"] = (require) => {
 		document.head.appendChild(tag);
 	}
 	var sidebar_module_css_default = {
-		"splitChild": "W-zNGW_splitChild",
-		"editorModeToggle": "W-zNGW_editorModeToggle",
-		"tabBarPlus": "W-zNGW_tabBarPlus",
-		"terminalRetry": "W-zNGW_terminalRetry",
-		"sandboxStatusOff": "W-zNGW_sandboxStatusOff",
-		"editorDocx": "W-zNGW_editorDocx",
-		"editorMd": "W-zNGW_editorMd",
-		"browserBlocked": "W-zNGW_browserBlocked",
-		"gitDiffFileOld": "W-zNGW_gitDiffFileOld",
-		"dropOverlay": "W-zNGW_dropOverlay",
-		"tabList": "W-zNGW_tabList",
-		"explorerCopied": "W-zNGW_explorerCopied",
+		"bottomPanel": "W-zNGW_bottomPanel",
 		"editorStatus": "W-zNGW_editorStatus",
-		"browserMessage": "W-zNGW_browserMessage",
-		"editorPdfDragShieldActive": "W-zNGW_editorPdfDragShieldActive",
-		"splitRow": "W-zNGW_splitRow",
-		"terminalBanner": "W-zNGW_terminalBanner",
-		"gitDiffFile": "W-zNGW_gitDiffFile",
-		"explorerRef": "W-zNGW_explorerRef",
-		"editorDocxZoomRange": "W-zNGW_editorDocxZoomRange",
-		"dirtyDot": "W-zNGW_dirtyDot",
-		"gitRow": "W-zNGW_gitRow",
-		"terminalWrap": "W-zNGW_terminalWrap",
-		"gitName": "W-zNGW_gitName",
+		"editorXlsx": "W-zNGW_editorXlsx",
+		"boundaryError": "W-zNGW_boundaryError",
+		"explorerError": "W-zNGW_explorerError",
+		"gitBranchSelect": "W-zNGW_gitBranchSelect",
+		"terminalRetry": "W-zNGW_terminalRetry",
+		"gitDiffNum": "W-zNGW_gitDiffNum",
+		"orphanedType": "W-zNGW_orphanedType",
+		"editorDownloadLink": "W-zNGW_editorDownloadLink",
+		"browserStart": "W-zNGW_browserStart",
+		"browserBlockedButton": "W-zNGW_browserBlockedButton",
+		"panelResize": "W-zNGW_panelResize",
+		"explorerHidden": "W-zNGW_explorerHidden",
+		"explorerRoot": "W-zNGW_explorerRoot",
+		"editorPdfStage": "W-zNGW_editorPdfStage",
+		"browserBar": "W-zNGW_browserBar",
+		"gitDiffTab": "W-zNGW_gitDiffTab",
+		"dividerCol": "W-zNGW_dividerCol",
 		"explorerEmpty": "W-zNGW_explorerEmpty",
-		"git": "W-zNGW_git",
-		"toggleButton": "W-zNGW_toggleButton",
-		"editorPptxButton": "W-zNGW_editorPptxButton",
-		"gitDiffFileTag": "W-zNGW_gitDiffFileTag",
-		"gitLogRow": "W-zNGW_gitLogRow",
-		"gitRowMain": "W-zNGW_gitRowMain",
-		"tabTitle": "W-zNGW_tabTitle",
-		"editorBinaryNotice": "W-zNGW_editorBinaryNotice",
-		"editorImage": "W-zNGW_editorImage",
-		"editorDocxWrap": "W-zNGW_editorDocxWrap",
-		"editorDocxZoomValue": "W-zNGW_editorDocxZoomValue",
+		"gitBadge": "W-zNGW_gitBadge",
 		"editorHtml": "W-zNGW_editorHtml",
-		"editorPdfFrame": "W-zNGW_editorPdfFrame",
-		"producedLabel": "W-zNGW_producedLabel",
-		"editorError": "W-zNGW_editorError",
-		"bottomPanelHidden": "W-zNGW_bottomPanelHidden",
-		"editorPptx": "W-zNGW_editorPptx",
-		"sandboxStatusOn": "W-zNGW_sandboxStatusOn",
-		"gitLogLine2": "W-zNGW_gitLogLine2",
-		"gitLogSubject": "W-zNGW_gitLogSubject",
+		"gitEmpty": "W-zNGW_gitEmpty",
+		"gitDiffLine": "W-zNGW_gitDiffLine",
+		"dropRight": "W-zNGW_dropRight",
 		"gitDiffHunk": "W-zNGW_gitDiffHunk",
+		"paneCard": "W-zNGW_paneCard",
+		"gitRowMain": "W-zNGW_gitRowMain",
+		"editorHeader": "W-zNGW_editorHeader",
+		"gitDiffMetaText": "W-zNGW_gitDiffMetaText",
+		"producedRow": "W-zNGW_producedRow",
+		"tab": "W-zNGW_tab",
+		"editorModeActive": "W-zNGW_editorModeActive",
+		"editorDocxWrap": "W-zNGW_editorDocxWrap",
+		"editorPdfDragShieldActive": "W-zNGW_editorPdfDragShieldActive",
+		"gitSectionHeader": "W-zNGW_gitSectionHeader",
+		"cornerHandle": "W-zNGW_cornerHandle",
+		"gitDiffHunkHeader": "W-zNGW_gitDiffHunkHeader",
+		"gitLogRow": "W-zNGW_gitLogRow",
+		"explorerName": "W-zNGW_explorerName",
+		"gitDiffTabHeader": "W-zNGW_gitDiffTabHeader",
 		"gitCommitInput": "W-zNGW_gitCommitInput",
-		"editorDocxViewport": "W-zNGW_editorDocxViewport",
-		"producedMore": "W-zNGW_producedMore",
-		"toggleCluster": "W-zNGW_toggleCluster",
-		"editorPdfStage": "W-zNGW_editorPdfStage",
-		"dividerActive": "W-zNGW_dividerActive",
+		"gitLogRef": "W-zNGW_gitLogRef",
+		"bottomClose": "W-zNGW_bottomClose",
+		"explorerDir": "W-zNGW_explorerDir",
+		"editorDocxZoom": "W-zNGW_editorDocxZoom",
 		"gitDiffDel": "W-zNGW_gitDiffDel",
-		"iconButton": "W-zNGW_iconButton",
-		"gitCommit": "W-zNGW_gitCommit",
-		"gitLogMeta": "W-zNGW_gitLogMeta",
-		"producedChip": "W-zNGW_producedChip",
-		"panelResize": "W-zNGW_panelResize",
-		"gitDiffHunkHeader": "W-zNGW_gitDiffHunkHeader",
-		"explorerBody": "W-zNGW_explorerBody",
-		"editorDocxZoomHint": "W-zNGW_editorDocxZoomHint",
-		"gitEmpty": "W-zNGW_gitEmpty",
-		"tabBarDrop": "W-zNGW_tabBarDrop",
-		"editorPdf": "W-zNGW_editorPdf",
-		"bottomResizeActive": "W-zNGW_bottomResizeActive",
-		"browserBlockedDesc": "W-zNGW_browserBlockedDesc",
-		"editorOfficeOverlay": "W-zNGW_editorOfficeOverlay",
+		"splitChild": "W-zNGW_splitChild",
+		"terminalBannerUrl": "W-zNGW_terminalBannerUrl",
 		"tabBar": "W-zNGW_tabBar",
-		"panelHidden": "W-zNGW_panelHidden",
-		"boundaryError": "W-zNGW_boundaryError",
-		"gitSectionHeader": "W-zNGW_gitSectionHeader",
-		"browserInput": "W-zNGW_browserInput",
+		"paneTab": "W-zNGW_paneTab",
+		"splitCol": "W-zNGW_splitCol",
+		"sandboxStatusText": "W-zNGW_sandboxStatusText",
+		"git": "W-zNGW_git",
 		"gitDiffHunkSection": "W-zNGW_gitDiffHunkSection",
-		"divider": "W-zNGW_divider",
+		"gitDiffCtx": "W-zNGW_gitDiffCtx",
+		"editorBanner": "W-zNGW_editorBanner",
+		"gitRowSelected": "W-zNGW_gitRowSelected",
+		"paneEmptyCards": "W-zNGW_paneEmptyCards",
+		"terminalBanner": "W-zNGW_terminalBanner",
+		"explorerBody": "W-zNGW_explorerBody",
+		"gitLink": "W-zNGW_gitLink",
+		"gitLogLine2": "W-zNGW_gitLogLine2",
+		"editorPdfToolbar": "W-zNGW_editorPdfToolbar",
+		"dropDown": "W-zNGW_dropDown",
+		"editorUniverHost": "W-zNGW_editorUniverHost",
+		"sandboxStatusOn": "W-zNGW_sandboxStatusOn",
 		"sandboxStatus": "W-zNGW_sandboxStatus",
+		"tabTitle": "W-zNGW_tabTitle",
+		"sandboxStatusOff": "W-zNGW_sandboxStatusOff",
+		"editorDocxZoomRange": "W-zNGW_editorDocxZoomRange",
+		"bottomPanelHidden": "W-zNGW_bottomPanelHidden",
+		"pane": "W-zNGW_pane",
+		"editorPptxButton": "W-zNGW_editorPptxButton",
+		"paneTabHidden": "W-zNGW_paneTabHidden",
+		"gitDiffFileTag": "W-zNGW_gitDiffFileTag",
+		"gitLogSubject": "W-zNGW_gitLogSubject",
+		"gitHeader": "W-zNGW_gitHeader",
+		"editorOfficeOverlay": "W-zNGW_editorOfficeOverlay",
+		"gitCommitButton": "W-zNGW_gitCommitButton",
+		"editorPptxToolbar": "W-zNGW_editorPptxToolbar",
+		"gitLogMeta": "W-zNGW_gitLogMeta",
+		"gitDiffCode": "W-zNGW_gitDiffCode",
+		"browserBlockedDesc": "W-zNGW_browserBlockedDesc",
+		"tabActive": "W-zNGW_tabActive",
+		"editorImage": "W-zNGW_editorImage",
+		"explorerRow": "W-zNGW_explorerRow",
+		"gitDiffTabTitle": "W-zNGW_gitDiffTabTitle",
+		"dividerActive": "W-zNGW_dividerActive",
+		"dirtyDot": "W-zNGW_dirtyDot",
+		"editorPptx": "W-zNGW_editorPptx",
 		"editorPptxHost": "W-zNGW_editorPptxHost",
+		"panelBody": "W-zNGW_panelBody",
+		"gitRow": "W-zNGW_gitRow",
+		"split": "W-zNGW_split",
+		"gitDiffFile": "W-zNGW_gitDiffFile",
+		"gitDiffFilePath": "W-zNGW_gitDiffFilePath",
+		"gitDiffFileOld": "W-zNGW_gitDiffFileOld",
 		"gitDiffAdd": "W-zNGW_gitDiffAdd",
-		"editorPdfDragShield": "W-zNGW_editorPdfDragShield",
-		"gitDiffTabHeader": "W-zNGW_gitDiffTabHeader",
-		"gitLink": "W-zNGW_gitLink",
-		"paneCard": "W-zNGW_paneCard",
-		"workbench": "W-zNGW_workbench",
-		"gitDiffMeta": "W-zNGW_gitDiffMeta",
+		"editorBinary": "W-zNGW_editorBinary",
+		"editor": "W-zNGW_editor",
+		"gitLogLine1": "W-zNGW_gitLogLine1",
+		"sandboxDot": "W-zNGW_sandboxDot",
+		"panelResizeActive": "W-zNGW_panelResizeActive",
 		"gitLogMore": "W-zNGW_gitLogMore",
-		"dropLeft": "W-zNGW_dropLeft",
-		"producedRow": "W-zNGW_producedRow",
-		"explorerError": "W-zNGW_explorerError",
-		"gitDiffMetaText": "W-zNGW_gitDiffMetaText",
+		"panel": "W-zNGW_panel",
+		"paneContent": "W-zNGW_paneContent",
+		"toggleCluster": "W-zNGW_toggleCluster",
+		"editorDocxViewport": "W-zNGW_editorDocxViewport",
 		"gitConfirmDesc": "W-zNGW_gitConfirmDesc",
-		"editorPlaceholder": "W-zNGW_editorPlaceholder",
-		"editorPptxToolbar": "W-zNGW_editorPptxToolbar",
-		"terminal": "W-zNGW_terminal",
-		"editorBanner": "W-zNGW_editorBanner",
-		"panelBody": "W-zNGW_panelBody",
-		"explorerHeader": "W-zNGW_explorerHeader",
-		"dsh-row-in": "W-zNGW_dsh-row-in",
-		"browserBlockedActions": "W-zNGW_browserBlockedActions",
-		"panelResizeActive": "W-zNGW_panelResizeActive",
-		"explorerDir": "W-zNGW_explorerDir",
-		"orphanedType": "W-zNGW_orphanedType",
-		"gitSection": "W-zNGW_gitSection",
-		"gitLogRef": "W-zNGW_gitLogRef",
-		"dropUp": "W-zNGW_dropUp",
-		"cornerHandle": "W-zNGW_cornerHandle",
-		"explorerRoot": "W-zNGW_explorerRoot",
-		"split": "W-zNGW_split",
-		"pane": "W-zNGW_pane",
-		"bottomClose": "W-zNGW_bottomClose",
-		"bottomResize": "W-zNGW_bottomResize",
-		"splitCol": "W-zNGW_splitCol",
-		"dropRight": "W-zNGW_dropRight",
-		"sandboxStatusText": "W-zNGW_sandboxStatusText",
+		"tabClose": "W-zNGW_tabClose",
+		"editorBinaryNotice": "W-zNGW_editorBinaryNotice",
 		"editorCm": "W-zNGW_editorCm",
-		"paneEmptyCards": "W-zNGW_paneEmptyCards",
-		"editorXlsx": "W-zNGW_editorXlsx",
-		"editorPdfFrameBlocked": "W-zNGW_editorPdfFrameBlocked",
+		"editorModeToggle": "W-zNGW_editorModeToggle",
+		"terminal": "W-zNGW_terminal",
 		"editorPptxPosition": "W-zNGW_editorPptxPosition",
-		"paneTab": "W-zNGW_paneTab",
-		"paneDrop": "W-zNGW_paneDrop",
+		"producedMore": "W-zNGW_producedMore",
+		"gitDiffMeta": "W-zNGW_gitDiffMeta",
+		"editorError": "W-zNGW_editorError",
+		"selectionPopup": "W-zNGW_selectionPopup",
+		"iconButton": "W-zNGW_iconButton",
+		"editorPlaceholder": "W-zNGW_editorPlaceholder",
+		"editorMd": "W-zNGW_editorMd",
+		"editorStatusError": "W-zNGW_editorStatusError",
+		"editorPdfDragShield": "W-zNGW_editorPdfDragShield",
+		"bottomResizeActive": "W-zNGW_bottomResizeActive",
 		"dropCenter": "W-zNGW_dropCenter",
-		"editor": "W-zNGW_editor",
+		"terminalWrap": "W-zNGW_terminalWrap",
+		"splitRow": "W-zNGW_splitRow",
+		"producedChip": "W-zNGW_producedChip",
+		"explorerCopied": "W-zNGW_explorerCopied",
+		"gitSection": "W-zNGW_gitSection",
+		"editorDocx": "W-zNGW_editorDocx",
+		"gitDiff": "W-zNGW_gitDiff",
+		"gitError": "W-zNGW_gitError",
+		"paneDrop": "W-zNGW_paneDrop",
+		"gitCommit": "W-zNGW_gitCommit",
+		"producedLabel": "W-zNGW_producedLabel",
 		"sandboxAction": "W-zNGW_sandboxAction",
-		"browserBlockedButton": "W-zNGW_browserBlockedButton",
-		"terminalBannerUrl": "W-zNGW_terminalBannerUrl",
-		"gitRowSelected": "W-zNGW_gitRowSelected",
-		"gitLogLine1": "W-zNGW_gitLogLine1",
-		"dividerRow": "W-zNGW_dividerRow",
-		"browserBar": "W-zNGW_browserBar",
-		"panel": "W-zNGW_panel",
-		"browserBlockedTitle": "W-zNGW_browserBlockedTitle",
-		"tabActive": "W-zNGW_tabActive",
-		"selectionPopup": "W-zNGW_selectionPopup",
-		"browserStart": "W-zNGW_browserStart",
-		"gitDiffTab": "W-zNGW_gitDiffTab",
+		"tabBarDrop": "W-zNGW_tabBarDrop",
+		"explorerRef": "W-zNGW_explorerRef",
+		"editorImageWrap": "W-zNGW_editorImageWrap",
+		"gitPlaceholder": "W-zNGW_gitPlaceholder",
+		"bottomResize": "W-zNGW_bottomResize",
+		"divider": "W-zNGW_divider",
+		"editorPdfFrame": "W-zNGW_editorPdfFrame",
+		"editorPdfFrameBlocked": "W-zNGW_editorPdfFrameBlocked",
+		"dropUp": "W-zNGW_dropUp",
+		"dsh-row-in": "W-zNGW_dsh-row-in",
+		"tabBarPlus": "W-zNGW_tabBarPlus",
+		"editorTitle": "W-zNGW_editorTitle",
+		"explorerHeader": "W-zNGW_explorerHeader",
 		"browser": "W-zNGW_browser",
-		"dividerCol": "W-zNGW_dividerCol",
-		"tabClose": "W-zNGW_tabClose",
+		"browserFrame": "W-zNGW_browserFrame",
+		"browserBlockedActions": "W-zNGW_browserBlockedActions",
+		"browserInput": "W-zNGW_browserInput",
 		"editorCmHidden": "W-zNGW_editorCmHidden",
-		"gitBranchSelect": "W-zNGW_gitBranchSelect",
+		"editorDocxZoomHint": "W-zNGW_editorDocxZoomHint",
+		"editorModeButton": "W-zNGW_editorModeButton",
 		"gitDiffExpand": "W-zNGW_gitDiffExpand",
-		"editorModeActive": "W-zNGW_editorModeActive",
-		"gitHeader": "W-zNGW_gitHeader",
-		"gitCommitButton": "W-zNGW_gitCommitButton",
+		"browserBlockedTitle": "W-zNGW_browserBlockedTitle",
+		"toggleButton": "W-zNGW_toggleButton",
+		"workbench": "W-zNGW_workbench",
+		"dropLeft": "W-zNGW_dropLeft",
+		"tabList": "W-zNGW_tabList",
+		"gitName": "W-zNGW_gitName",
 		"gitLogHash": "W-zNGW_gitLogHash",
-		"gitDiffCtx": "W-zNGW_gitDiffCtx",
-		"editorDownloadLink": "W-zNGW_editorDownloadLink",
-		"browserFrame": "W-zNGW_browserFrame",
-		"editorDocxZoom": "W-zNGW_editorDocxZoom",
-		"gitDiffCode": "W-zNGW_gitDiffCode",
-		"bottomPanel": "W-zNGW_bottomPanel",
-		"gitDiffLine": "W-zNGW_gitDiffLine",
-		"editorBinary": "W-zNGW_editorBinary",
-		"editorPdfToolbar": "W-zNGW_editorPdfToolbar",
-		"editorUniverHost": "W-zNGW_editorUniverHost",
-		"editorTitle": "W-zNGW_editorTitle",
-		"tab": "W-zNGW_tab",
-		"paneContent": "W-zNGW_paneContent",
-		"editorImageWrap": "W-zNGW_editorImageWrap",
-		"explorerName": "W-zNGW_explorerName",
-		"explorerRow": "W-zNGW_explorerRow",
-		"editorHeader": "W-zNGW_editorHeader",
-		"sandboxDot": "W-zNGW_sandboxDot",
-		"gitBadge": "W-zNGW_gitBadge",
-		"gitDiffTabTitle": "W-zNGW_gitDiffTabTitle",
-		"editorStatusError": "W-zNGW_editorStatusError",
+		"panelHidden": "W-zNGW_panelHidden",
+		"dividerRow": "W-zNGW_dividerRow",
+		"explorer": "W-zNGW_explorer",
+		"editorPdf": "W-zNGW_editorPdf",
 		"editorPptxStage": "W-zNGW_editorPptxStage",
-		"gitPlaceholder": "W-zNGW_gitPlaceholder",
-		"gitDiffFilePath": "W-zNGW_gitDiffFilePath",
-		"gitDiff": "W-zNGW_gitDiff",
-		"paneTabHidden": "W-zNGW_paneTabHidden",
-		"explorerHidden": "W-zNGW_explorerHidden",
-		"dropDown": "W-zNGW_dropDown",
-		"editorModeButton": "W-zNGW_editorModeButton",
-		"gitError": "W-zNGW_gitError",
-		"gitDiffNum": "W-zNGW_gitDiffNum",
-		"explorer": "W-zNGW_explorer"
+		"browserBlocked": "W-zNGW_browserBlocked",
+		"editorDocxZoomValue": "W-zNGW_editorDocxZoomValue",
+		"dropOverlay": "W-zNGW_dropOverlay",
+		"browserMessage": "W-zNGW_browserMessage"
 	};
 	//#endregion
 	//#region src/client/office-shared.tsx