dust-tarui-layout

star 19

通用 Tauri 桌面端 UI 布局模板,复现 DiskRookie 风格的无边框窗口外壳、粘性顶栏、主内容滚动区与专家模式分栏结构。适用于从 0 到 1 快速构建类似布局的客户端软件(如笔记管理、即时通讯等)。基于 Tauri 2 + React + MUI + Tailwind。

LSTM-Kirigaya By LSTM-Kirigaya schedule Updated 4/13/2026

name: dust-tarui-layout description: 通用 Tauri 桌面端 UI 布局模板,复现 DiskRookie 风格的无边框窗口外壳、粘性顶栏、主内容滚动区与专家模式分栏结构。适用于从 0 到 1 快速构建类似布局的客户端软件(如笔记管理、即时通讯等)。基于 Tauri 2 + React + MUI + Tailwind。 rootUrl: https://raw.githubusercontent.com/LSTM-Kirigaya/jinhui-skills/main/skills/dust-tarui-layout/SKILL.md tags: - tauri - desktop - layout - template - react model: deepseek-chat

DiskRookie 应用布局(结构复现指南)

本 Skill 描述 DiskRookie 桌面端(apps/desktop/frontend)的 空间结构、区域划分与交互分区,便于在另一套配色下复刻相同布局。
默认不强制色板与主题 token;但若需求明确,可在本 Skill 上增加项目级外观约束(见下方“项目化外观补充”)。

技术栈与入口(仅结构)

  • :Tauri 2,单窗口,系统标题栏关闭(自绘顶栏)。
  • 根布局:React + ThemeProvider + CssBaseline,根节点为 纵向 flex 全屏
  • 组件库:MUI 用于按钮/对话框等;Tailwind 用于大量布局 class(flexgridmin-h-0 等)。
  • 顶栏:本项目 无左侧独立导航栏全局操作集中在窗口顶部一条自定义 header(应用名、快照入口、外链、队列、设置、系统窗口按钮)。

分册目录(每类内容一个文件夹)

文件夹 说明
window-frame/ Tauri 窗口几何、无边框、透明与最小尺寸
title-bar/ 顶栏高度、左/中/右分区、拖拽区、macOS 与 Win/Linux 差异
app-shell/ 根容器与主内容区滚动、与 ExpertMode 的嵌套关系
expert-workbench/ 专家模式:工具条、模式切换、扫描结果分栏与状态机
overlays-settings/ 设置/快照/任务队列叠层与典型对话框结构

阅读顺序建议:window-frame → title-bar → app-shell → expert-workbench → overlays-settings

复现时优先保证的约束

  1. 顶栏固定sticky top-0,高度约 40px(h-10,主内容区在其下方占满剩余高度。
  2. 主内容可滚动:外层 overflow-hidden,内层 main 使用 flex-1 + min-h-0 + overflow-y-auto,避免 flex 子项高度撑破窗口。
  3. 拖拽:顶栏可拖拽区域使用 data-tauri-drag-region;可点击控件上 stopPropagation 避免误拖。
  4. 分栏:扫描结果在宽屏下常见 左侧固定宽度侧栏(约 w-80)+ 右侧自适应,右侧内部再用 响应式 grid

项目化外观补充(当前仓库约束)

当用户要求与当前示例一致时,除结构外还需满足:

  1. 圆角:应用最外层容器使用 macOS 常见圆角 12px(例如 rounded-[12px])。
  2. 外框:最外层容器添加 1px 边框border),颜色用主题分隔线同级语义色即可。
  3. 去阴影:最外层容器不加 CSS box-shadow;Tauri 窗口层 shadow 也应设为 false
  4. 透明配合:若窗口 transparent: true,需确保 html/body/#rootCssBaseline 不绘制不透明底色,避免圆角外露区域发灰。

后续:颜色与主题的质询清单(给使用本 Skill 的协作者)

在实现或换肤前,应向产品/用户确认以下问题(本分册不预设答案):

  1. 明暗策略:仅浅色、仅深色、还是跟随系统?是否需要持久化用户选择?
  2. 品牌主色:主按钮、链接、聚焦环所使用的主色与对比色(需满足可读性与 WCAG)。
  3. 表面层级:页面底、卡片、顶栏、悬停/按下态分别使用几层“表面”,是否区分边框与分隔线。
  4. 语义色:成功、警告、错误、信息类提示是否沿用固定语义色,是否与主色解耦。
  5. 圆角与密度:全局圆角尺度(小按钮 vs 大卡片)、控件间距是否对齐 MUI theme.shape / 自定义 spacing。
  6. 字体:标题与正文族、等宽(路径/Token)是否单独指定;是否加载 Web 字体。
  7. 无障碍:焦点可见性、最小点击区域(尤其顶栏约 24–40px 的图标按钮)。

将以上答案映射到 MUI createThemeTailwind 语义扩展(或 CSS 变量)即可在保持本 Skill 布局不变的前提下替换外观。

Install via CLI
npx skills add https://github.com/LSTM-Kirigaya/jinhui-skills --skill dust-tarui-layout
Repository Details
star Stars 19
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator
LSTM-Kirigaya
LSTM-Kirigaya Explore all skills →