| name | tauri-next-coding-notes |
| description | Enforces architecture rules and reusable coding patterns for this Tauri + Next.js desktop app. Use when implementing Tauri commands or events, frontend pages/components, i18n copy, Redux logic, title bar behavior, modal windows, or main-window layout. |
| user-invocable | true |
Tauri + Next 编码规范
本技能用于本仓库日常开发（桌面模板，无内置业务域）。前端为 Turborepo monorepo（apps/* + packages/*），优先遵守已存在目录结构与命名方式。
关键上下文
- 前端：Next App Router + React + Redux Toolkit + shadcn/ui；完整控制台在
apps/full，共享逻辑在 packages/shared 与 packages/ui。
- 固定字符串：业务相关字面量统一放
packages/shared/src/tauri-bridge/enums/（见 frontend-enums.md），通过 @supportflow/shared/tauri-bridge/enums 引用。
- Command 桥接：
packages/shared/src/tauri-bridge/cmd/invoke.ts 的 invokeWrapper + TauriCmd 枚举。
- Event 桥接：
src-tauri/src/events/ ↔ tauri-bridge/enums/tauri-event.ts + tauri-bridge/tauri-event.ts + desktop-shell/providers/tauri-event-provider.tsx。
- 跨 Webview 同步：
desktop-shell/events/cross-webview-sync.ts（会话 → Redux）。
- 窗口 / Modal：
apps/full/src/config/windows.ts（re-export）；useModalWindow 在 @supportflow/ui/modal；面板注册在 apps/full/src/components/modal/panels/。
- Rust
context/：.manage 会话；utils/：无 Store 的通用逻辑；cmd/：薄 command。
- Rust 入口：
src-tauri/src/lib.rs（generate_handler! + events::setup）。
- i18n：
react-i18next + src-tauri/resources/languages/*.json（展示文案走 i18n，不进 enums）。
- 主窗：
TitleBar + ContentContainer，重点防止滚动条。
Critical Rules
- 前端枚举与禁止魔法字符串 → frontend-enums.md
- Tauri 命令链路完整性 → tauri-command-chain.md
- Tauri 事件总线 → tauri-events.md
- i18n 与文案规范 → i18n-and-copy.md
- 主窗布局与滚动控制 → layout-and-scroll.md
- 标题栏拖拽与交互区域 → titlebar-drag-region.md
- 状态与副作用边界 → state-and-effects.md
- 日志与错误处理 → logging-and-errors.md
- 提交前检查 → preflight-checks.md
- Rust 分层 → 仓库
.cursor/rules/tauri-rust-layering.mdc（cmd / context / utils）
快速模式（常用）
import { Language, ModalPanel } from "@supportflow/shared/tauri-bridge/enums";
const { t } = useTranslation("home");
<h1>{t("title")}</h1>;
<ContentContainer className="flex flex-col overflow-hidden">{children}</ContentContainer>
.invoke_handler(tauri::generate_handler![
cmd::xxx::your_command,
])
import { ModalPanel } from "@supportflow/shared/tauri-bridge/enums";
import { useModalWindow } from "@supportflow/ui/modal";
const { openModal } = useModalWindow();
await openModal({ name: ModalPanel.Demo, width: 480, height: 360 });
crate::events::session_changed_all(app, &session)?;
参考资料
