# Brainstorm

> 当需要探索方案、头脑风暴、创意思维时自动使用此 Skill。 触发场景： - 不知道怎么设计 - 需要多种方案 - 架构讨论 - 功能规划 触发词：头脑风暴、方案、怎么设计、有什么办法、创意、讨论、探索、建议、怎么做、如何实现

- Skill: `bkywksj/brainstorm` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bkywksj/brainstorm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bkywksj/brainstorm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bkywksj (https://skillmd.com/u/bkywksj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bkywksj/brainstorm

---


# 头脑风暴框架

## 本项目技术约束

> 所有方案必须在以下技术栈约束内思考

### 技术边界

- **后端架构**: 三层架构（Commands → Services → Database）
- **后端语言**: Rust 2021 edition + Tauri 2.x（不是 Java/Python/Node.js）
- **前端框架**: React 19 + TypeScript 5.8 + Vite 7（不是 Vue/Angular）
- **UI 组件库**: Ant Design 5 + TailwindCSS 4（不是 Material-UI/Chakra UI）
- **状态管理**: Zustand（不是 Redux/MobX）
- **路由**: React Router v7（不是 Next.js/Remix）
- **通信**: Tauri IPC `invoke()` / `listen()`（不是 HTTP REST API）
- **安全**: Capabilities 权限声明（不是 RBAC/JWT）
- **数据库**: rusqlite (Rust 侧 `Mutex<Connection>`)（不是 tauri-plugin-sql）
- **数据存储**: 本地文件 / SQLite（不是 MySQL/PostgreSQL 服务器）
- **部署**: 桌面安装包 .exe/.dmg/.deb（不是服务器部署）
- **依赖管理**: Cargo (Rust) + pnpm (Node.js)

---

## 思维模式

### 发散思维
1. **不评判**: 先不考虑可行性
2. **联想**: 从一个想法延伸
3. **Rust 生态**: 能否用现有 crate 解决？
4. **Tauri 插件**: 有没有现成的插件？
5. **Ant Design 组件**: UI 能否复用现有组件？
6. **跨界借鉴**: Electron/Flutter 怎么做的？
7. **反向思考**: 反过来就是解决方案

### 收敛思维
1. **复用优先**: 能否复用现有 crate 或 npm 包？
2. **可行性**: 在 Rust + React 技术栈内能否实现？
3. **三层架构**: 这个逻辑应该放在哪一层？
4. **前后端分工**: 这个逻辑应该放在 Rust 侧还是 React 侧？
5. **权限**: 是否需要声明额外的 Capabilities？
6. **成本**: 开发时间和复杂度
7. **跨平台**: 方案在 Windows/macOS/Linux 上是否都能工作？
8. **UI 一致性**: 是否符合 Ant Design 设计规范？

---

## 方案评估矩阵

```markdown
| 方案 | 复用度(15%) | 可行性(20%) | 开发量(20%) | 跨平台(15%) | 安全性(15%) | UI一致性(15%) | 总分 |
|------|-------------|------------|-------------|-------------|-------------|--------------|------|
| 方案A | ? | ? | ? | ? | ? | ? | ? |
| 方案B | ? | ? | ? | ? | ? | ? | ? |
```

### 评分标准

| 维度 | 1 分 | 2 分 | 3 分 | 4 分 | 5 分 |
|------|------|------|------|------|------|
| **复用度** | 全新开发 | 少量复用 | 部分复用 | 大量复用 | 完全复用 |
| **可行性** | 不可行 | 技术风险高 | 需要探索 | 可行 | 完全可行 |
| **开发量** | >5天 | 3-5天 | 1-3天 | 0.5-1天 | <0.5天 |
| **跨平台** | 不跨平台 | 需要适配 | 部分兼容 | 基本兼容 | 完全兼容 |
| **安全性** | 存在风险 | 需要加固 | 一般 | 安全 | 非常安全 |
| **UI一致性** | 不一致 | 需要定制 | 基本一致 | 一致 | 完美一致 |

---

## 方案探索模板

```markdown
## 问题描述
- 是什么: [功能描述]
- 为什么重要: [业务价值]
- 当前状态: [现有能力]

## 可能方案

### 方案 A: [名称]
- **描述**: ...
- **架构设计**:
  - Database 层工作: ...
  - Service 层工作: ...
  - Command 层工作: ...
  - React 侧工作: ...
- **UI 组件**: [使用的 Ant Design 组件]
- **状态管理**: [Zustand store 设计]
- **数据库变更**: [需要添加的表/字段]
- **需要的 Capabilities**: ...
- **优点**: ...
- **缺点**: ...
- **评分**:
  - 复用度: ?/5
  - 可行性: ?/5
  - 开发量: ?/5
  - 跨平台: ?/5
  - 安全性: ?/5
  - UI一致性: ?/5
  - **总分**: ?/30

### 方案 B: [名称]
- **描述**: ...
- **架构设计**:
  - Database 层工作: ...
  - Service 层工作: ...
  - Command 层工作: ...
  - React 侧工作: ...
- **UI 组件**: [使用的 Ant Design 组件]
- **状态管理**: [Zustand store 设计]
- **数据库变更**: [需要添加的表/字段]
- **需要的 Capabilities**: ...
- **优点**: ...
- **缺点**: ...
- **评分**:
  - 复用度: ?/5
  - 可行性: ?/5
  - 开发量: ?/5
  - 跨平台: ?/5
  - 安全性: ?/5
  - UI一致性: ?/5
  - **总分**: ?/30

## 推荐方案
方案 [X] - [理由]

## 实施计划
1. [第一步]
2. [第二步]
3. [第三步]
```

---

## 架构决策要点

### 数据存储位置

| 场景 | 推荐方案 | 理由 |
|------|---------|------|
| 持久化业务数据 | SQLite (rusqlite) | 关系型数据、事务支持 |
| 简单键值配置 | SQLite app_config 表 | 统一管理、易于查询 |
| 临时会话数据 | Zustand store | 无需持久化 |
| 大文件 | 文件系统 + DB 存路径 | 性能更好 |

### 业务逻辑位置

| 场景 | 推荐层级 | 理由 |
|------|---------|------|
| 数据验证 | Service 层 | 业务逻辑集中 |
| 复杂计算 | Rust Service 层 | 性能更好 |
| UI 交互逻辑 | React 组件 | 用户体验更好 |
| 数据库查询 | Database 层 | 职责单一 |
| 权限检查 | Service 层 | 业务逻辑 |

### UI 组件选择

| 需求 | 推荐组件 | 说明 |
|------|---------|------|
| 表单 | Ant Design Form | 完整的表单方案 |
| 表格 | Ant Design Table | 功能强大 |
| 弹窗 | Ant Design Modal | 标准弹窗 |
| 消息提示 | Ant Design message | 轻量级提示 |
| 通知 | Ant Design notification | 复杂通知 |
| 布局 | TailwindCSS | 灵活的工具类 |
| 图标 | @ant-design/icons | 官方图标库 |

---

## 常见场景方案库

### 场景 1：用户认证

**方案对比**:

| 方案 | 实现 | 优点 | 缺点 |
|------|------|------|------|
| 本地密码 | SQLite 存储哈希 | 简单、离线可用 | 无云同步 |
| OAuth2 | 调用外部 API | 专业、安全 | 需要网络 |
| 生物识别 | Windows Hello API | 用户体验好 | 平台限制 |

### 场景 2：数据同步

**方案对比**:

| 方案 | 实现 | 优点 | 缺点 |
|------|------|------|------|
| 文件导出/导入 | SQLite dump | 简单 | 手动操作 |
| WebSocket | 实时同步 | 实时性好 | 复杂度高 |
| REST API | 定期拉取 | 简单可靠 | 非实时 |

### 场景 3：大文件处理

**方案对比**:

| 方案 | 实现 | 优点 | 缺点 |
|------|------|------|------|
| 流式处理 | Rust async + chunk | 内存占用小 | 复杂度高 |
| 分片上传 | 分块处理 | 可断点续传 | 实现复杂 |
| Worker 线程 | tokio::spawn | 不阻塞主线程 | 进度回报复杂 |

---

## 决策树示例

```
需要持久化数据？
├─ 是 → 数据类型？
│   ├─ 结构化数据 → SQLite (rusqlite)
│   ├─ 大文件 → 文件系统 + DB 存路径
│   └─ 简单配置 → SQLite app_config 表
└─ 否 → 数据作用域？
    ├─ 全局共享 → Zustand store
    ├─ 组件内 → useState
    └─ URL 参数 → React Router params
```

---

## 常见陷阱

| 错误思路 | 正确思路 |
|---------|---------|
| 用 tauri-plugin-sql 从前端操作数据库 | 用 rusqlite 在 Rust 侧操作 |
| 把所有逻辑放在 Command 层 | 使用三层架构拆分职责 |
| 前端直接调用 Rust 业务逻辑 | 通过 Command 暴露 API |
| 混用多种状态管理方案 | 统一使用 Zustand |
| 不使用 Ant Design 重复造轮子 | 优先使用 Ant Design 组件 |
| 内联样式或 CSS-in-JS | 优先使用 TailwindCSS |
| HTTP 请求直接在前端 | 通过 Rust Command 代理 |

---

## 技术选型参考

### Rust Crate 推荐

| 需求 | 推荐 Crate | 说明 |
|------|-----------|------|
| 数据库 | rusqlite | SQLite 绑定 |
| 错误处理 | thiserror | 自定义错误类型 |
| 序列化 | serde + serde_json | JSON 序列化 |
| HTTP 请求 | reqwest | 异步 HTTP 客户端 |
| 日期时间 | chrono | 日期时间处理 |
| 加密 | sha2, bcrypt | 密码哈希 |
| 日志 | log, env_logger | 日志记录 |

### NPM 包推荐

| 需求 | 推荐包 | 说明 |
|------|-------|------|
| UI 组件 | antd | Ant Design |
| 样式 | tailwindcss | TailwindCSS |
| 状态管理 | zustand | 轻量级状态管理 |
| 路由 | react-router | React Router |
| 图标 | @ant-design/icons | Ant Design 图标 |
| 表单验证 | (内置在 antd) | Form 组件内置 |
| 日期选择 | (内置在 antd) | DatePicker 组件 |

---

## 检查清单

- [ ] 方案符合三层架构
- [ ] 数据库操作在 Database 层
- [ ] 业务逻辑在 Service 层（或 Command 层简单逻辑）
- [ ] IPC 接口在 Command 层
- [ ] UI 优先使用 Ant Design 组件
- [ ] 样式优先使用 TailwindCSS
- [ ] 全局状态使用 Zustand
- [ ] 需要的 Capabilities 已列出
- [ ] 跨平台兼容性已考虑
- [ ] 安全性已评估