self-evolve-framework 1.0.8 → 1.1.0

package/template/rules/Tailwind_CSS_v4.mdc

@@ -0,0 +1,187 @@
+---
+description: Tailwind CSS v4 项目编码规范（严格遵循官方标准）
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-13T14:14:00.000Z
+provider:
+---
+
+Tailwind CSS v4 项目编码规范（严格遵循官方标准）
+完全对齐 Tailwind CSS v4 官方设计理念、书写规范、分层原则、最佳实践，不自定义非标写法、不滥用随意堆砌、不脱离官方语义。适用：Tailwind CSS v4，适配 Svelte5 / Vue / React / Tauri 所有项目。
+
+一、核心原则（官方底层规范）
+优先原子类，少写自定义 CSS，遵循「工具优先」官方理念。
+语义化优先：优先用官方内置预设类，不随意造自定义工具类。
+样式内聚在元素上，尽量不拆冗余全局 CSS。
+遵循默认设计系统：间距、圆角、阴影、色值严格使用官方预设刻度，不写魔法数值。
+最小自定义：仅在官方无对应语义时，才扩展主题。
+
+二、项目引入与初始化规范（Tailwind v4 标准）
+1. 入口引入规范（v4 新语法）
+全局只引入一次 Tailwind 基础样式
+禁止多处重复引入、禁止混用 CDN + 本地版
+
+css
+/* 全局主样式文件 src/app.css */
+@import "tailwindcss";
+2. 主题扩展规范（v4 新方式）
+v4 不再使用 tailwind.config.js，改用 CSS @theme 指令
+css
+/* 在全局 CSS 文件中扩展主题 */
+@import "tailwindcss";
+
+@theme {
+  /* 扩展颜色 */
+  --color-brand: #3490dc;
+  --color-brand-light: #82c4f8;
+  
+  /* 扩展间距 */
+  --spacing-section: 5rem;
+  
+  /* 扩展圆角 */
+  --radius-card: 1rem;
+}
+3. 内容扫描规范（v4 新方式）
+v4 不再使用 tailwind.config.js 的 content 字段，改用 CSS @source 指令
+css
+@import "tailwindcss";
+
+/* 指定需要扫描的源文件目录 */
+@source "../src";
+@source "../components";
+4. 配置文件规范（v4 不再需要）
+v4 默认不需要 tailwind.config.js / tailwind.config.ts 文件
+所有配置都在 CSS 文件中通过 @theme、@source 等指令完成
+仅在需要插件或特殊配置时，才创建 tailwind.config.ts
+
+三、类名书写顺序规范（官方推荐排序规则）
+严格按官方约定顺序书写，固定顺序，便于维护、可读性统一：
+布局定位：container / fixed / absolute / relative / static
+盒模型：w-* h-* min-w-* max-h-* m-* p-*
+弹性 / 网格：flex grid justify-* items-* gap-*
+边框圆角：border border-* rounded-*
+背景颜色：bg-*
+文字排版：text-* font-* leading-* tracking-*
+阴影层级：shadow-* z-*
+交互状态：hover: focus: active: disabled:
+响应式：sm: md: lg: xl: 放最后层叠
+
+✅ 正确示例
+html
+<div class="relative w-full p-4 flex items-center gap-2 rounded-lg bg-white text-gray-700 shadow hover:shadow-md md:p-6"></div>
+❌ 禁止：随意乱序、状态类穿插在中间。
+
+四、响应式断点规范（官方默认断点不修改）
+严格使用官方默认断点，不擅自改断点像素：
+sm：640px
+md：768px
+lg：1024px
+xl：1280px
+2xl：1536px
+
+书写规则：移动端优先，先写默认样式，再逐层加 sm:/md:/lg: 覆盖。
+html
+<div class="text-sm md:text-base lg:text-lg"></div>
+
+五、状态变体规范（官方标准）
+只使用官方原生变体，不自定义伪类语法：
+悬浮：hover:
+聚焦：focus:
+激活：active:
+禁用：disabled:
+子元素：first: last: odd: even:
+暗黑模式：dark:
+
+写法：变体前缀在前，基础类在后
+html
+<button class="bg-blue-500 hover:bg-blue-600 disabled:opacity-50"></button>
+
+六、颜色使用规范（官方）
+优先使用官方语义色阶：gray-50 ~ gray-900、blue-500 等
+禁止随意写十六进制、rgb 魔法色值
+项目主题色统一在 @theme 的 --color-* 中扩展
+透明度统一用官方语法：bg-blue-500/50
+
+七、间距、尺寸规范（禁止魔法数字）
+宽高、内边距、外边距、间距 只用官方预设刻度：
+0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10 …
+禁止：p-7 m-13 这类非预设非标值
+必须自定义时，统一在 @theme 的 --spacing-* 中扩展，不直接写任意值
+
+八、复用样式规范（官方三种标准方式）
+1. 少量样式：直接写原子类，不抽离
+2. 中等复用：使用 @apply（官方允许）
+css
+@layer components {
+  .btn-primary {
+    @apply px-4 py-2 rounded-lg bg-blue-500 text-white hover:bg-blue-600;
+  }
+}
+强制规则：@apply 必须放在 @layer components / @layer utilities 内，禁止裸写。
+
+3. 全局通用组件：封装成 Svelte/Vue 组件，不堆砌全局 CSS
+禁止：动辄写大量自定义全局 class 替代原子类。
+
+九、Layer 分层规范（官方强制层级）
+严格遵循 Tailwind 三层层级，不打乱优先级：
+@layer base：基础标签默认样式（html、body、h1~h6）
+@layer components：可复用组件样式
+@layer utilities：自定义工具类
+
+禁止不写 @layer 直接全局覆写，避免优先级错乱。
+
+十、暗黑模式规范（官方标准）
+采用官方 class 模式，不混用 media 模式：
+css
+/* 在 tailwind.config.ts 中配置（如需要） */
+export default {
+  darkMode: 'class'
+}
+页面通过给根元素加 dark 类切换，样式用 dark: 前缀。
+
+十一、禁止与不推荐写法（官方避坑）
+❌ 禁止
+大量写自定义原生 CSS 替代原子类
+随意修改官方默认断点、默认色板
+滥用任意值语法 w-[123px] 当成常态
+class 名无顺序、杂乱堆砌
+在组件 style 里写大量非工具类样式
+使用 tailwind.config.js 的 theme.extend（v4 已废弃）
+
+✅ 允许
+必要时用 [] 任意值，但尽量少用、统一注释
+在 @theme 中增量扩展主题
+合理使用 @apply 做通用组件抽象
+
+十二、适配 Svelte5 / Tauri / Svelte Flow 项目附加规则
+Svelte 组件全部样式优先用 Tailwind 原子类，少用 <style scoped>
+Svelte Flow 自定义节点样式、画布控件统一用 Tailwind，不写冗余原生 CSS
+Tauri 窗口、全局布局全部用 Tailwind 布局类控制
+所有组件严格遵循「类名排序、响应式 mobile-first、无魔法值」
+
+十三、AI 编码强制约束规则
+所有样式优先使用 Tailwind v4 官方原子类，不主动生成自定义 CSS；
+class 严格按「布局→盒模型→弹性→边框→背景→文字→阴影→状态→响应式」固定顺序；
+禁止使用魔法数字、非标间距、随意十六进制色；
+复用样式优先封装组件，其次 @apply 并放入对应 @layer；
+响应式严格移动端优先，使用官方默认断点不改动；
+不滥用 [] 任意值，仅特殊场景少量使用；
+v4 项目必须使用 @import "tailwindcss" 引入，禁止使用旧的 @tailwind 指令。
+
+十四、Tailwind v4 与 v3 主要差异对照表
+| 功能 | Tailwind v3（已废弃） | Tailwind v4（当前使用） |
+|------|---------------------|----------------------|
+| 引入方式 | @tailwind base/components/utilities | @import "tailwindcss" |
+| 配置文件 | tailwind.config.js | 无（改用 CSS @theme） |
+| 内容扫描 | content: [] in config | @source in CSS |
+| 主题扩展 | theme.extend in JS | @theme { } in CSS |
+| 插件注册 | plugins: [] in config | @plugin in CSS |
+| 前缀 | prefix in config | @prefix in CSS |
+
+十五、v4 项目结构示例
+plaintext
+src/
+├── app.css          # 全局样式（包含 @import "tailwindcss" 和 @theme）
+├── routes/           # 路由页面
+├── lib/              # 工具、组件、store
+└── tailwind.config.ts # 可选，仅在使用插件时需要

package/template/rules/Tauri.mdc

@@ -0,0 +1,145 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-13T04:29:03.207Z
+provider: 
+---
+
+Tauri 项目编码规范（严格遵循 Tauri 官方最新规范）
+完全对齐 Tauri 官方文档、官方最佳实践、安全准则、架构设计与 API 约定，无自定义扩展、无野路子写法。
+适用：Tauri v2 + Tauri CLI 官方标准，前端可搭配 Svelte / React / Vue / Vanilla。
+一、核心架构规范（官方强制标准）
+Tauri 官方唯一架构：
+前端层：Web 技术（HTML/JS/CSS/ 框架）
+核心层：Rust 后端（src-tauri/）
+IPC 通信：唯一官方通信机制（禁止直接跨域 / 原生调用）
+命令式 API：前端只能调用 Rust 注册的命令，不能直接操作系统
+二、项目结构规范（官方固定目录结构）
+plaintext
+你的项目/
+├── src/                # 前端源码（官方标准）
+├── src-tauri/           # Tauri 核心目录（官方固定名称，禁止修改）
+│   ├── build.rs        # 官方构建脚本（禁止删除）
+│   ├── Cargo.toml      # Rust 配置（严格遵循官方格式）
+│   ├── tauri.conf.json # Tauri 主配置（官方 schema 严格校验）
+│   └── src/
+│       ├── lib.rs      # 官方推荐：命令与逻辑入口
+│       └── main.rs     # 程序主入口（官方固定代码）
+└── package.json        # 前端依赖 + Tauri 脚本
+三、tauri.conf.json 规范（官方严格 Schema）
+1. 必须遵守的官方字段规则
+json
+{
+  "$schema": "./node_modules/@tauri-apps/cli/schema.json",
+  "productName": "你的应用名",
+  "version": "0.1.0",
+  "identifier": "com.你的域名.应用名",
+  "build": {
+    "beforeDevCommand": "你的前端启动命令",
+    "beforeBuildCommand": "你的前端构建命令",
+    "devPath": "http://你的开发地址",
+    "distDir": "../dist"  // 前端输出目录（官方标准）
+  },
+  "bundle": {
+    "active": true,
+    "targets": "all",
+    "icon": [
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/256x256.png",
+      "icons/512x512.png"
+    ]
+  }
+}
+2. 官方强制规则
+必须包含 $schema 用于校验
+identifier 必须是反向域名格式
+icon 必须提供多尺寸，严格按官方要求
+禁止添加非官方字段
+四、Rust 代码规范（官方标准）
+1. main.rs（官方固定模板）
+rust
+运行
+// 官方唯一标准写法，禁止修改
+fn main() {
+  tauri::Builder::default()
+    .run(tauri::generate_context!())
+    .expect("error while running tauri application");
+}
+2. 命令注册规范（官方唯一方式）
+rust
+运行
+// lib.rs（官方推荐）
+use tauri::command;
+
+// 官方标准命令
+#[command]
+fn greet(name: &str) -> String {
+    format!("Hello, {}!", name)
+}
+
+// 官方标准初始化
+#[tauri::main]
+fn main() {
+  tauri::Builder::default()
+    .invoke_handler(tauri::generate_handler![greet]) // 命令注册
+    .run(tauri::generate_context!())
+    .expect("error while running tauri application");
+}
+3. Rust 调用规范
+所有前端可调用功能必须用 #[command] 注册
+禁止无权限、无校验的系统操作
+错误处理必须使用 Result<T, E>
+五、IPC / 前端调用规范（官方安全准则）
+1. 前端调用 Rust 命令（官方唯一 API）
+javascript
+运行
+import { invoke } from '@tauri-apps/api/core'
+
+// 官方标准调用方式
+const result = await invoke('greet', { name: 'Tauri' })
+2. 官方安全铁律
+禁止前端直接访问文件系统 / 网络 / 原生能力
+所有操作必须走 Rust 命令
+最小权限原则：只声明需要的权限
+六、权限规范（官方 CSP + 权限白名单）
+1. tauri.conf.json 权限声明
+json
+"permissions": [
+  "path",
+  "fs:read",
+  "window:allow-close"
+]
+只添加业务需要的权限
+禁止使用 * 通配符
+严格遵循官方权限列表
+2. CSP 内容安全策略（官方强制）
+json
+"csp": "default-src 'self'; img-src 'self' data: asset:;"
+禁止 unsafe-inline、unsafe-eval
+遵循最小信任原则
+七、窗口管理规范（官方 API）
+javascript
+运行
+import { getCurrentWindow } from '@tauri-apps/api/window'
+
+// 官方标准用法
+const appWindow = getCurrentWindow()
+await appWindow.maximize()
+await appWindow.setSize({ width: 800, height: 600 })
+禁止直接操作 DOM window 模拟窗口
+只使用官方 @tauri-apps/api/window
+八、插件使用规范（官方）
+只使用 @tauri-apps/plugin-* 官方插件
+禁止引入第三方原生桥接库
+插件必须在 tauri.conf.json 正确配置
+九、开发与构建命令（官方唯一标准）
+bash
+运行
+# 开发模式
+tauri dev
+
+# 生产构建
+tauri build
+禁止使用自定义编译脚本绕过官方 CLI。

package/template/rules/app-error-pattern.mdc

@@ -0,0 +1,65 @@
+---
+description: 强制使用 AppError 统一错误类型的规则。
+alwaysApply: true
+---
+
+# AppError Rust 错误规范
+
+> SheetFlow 项目特有规则。所有 `#[command]` 必须返回 `Result<T, AppError>`，
+> 使用 `src-tauri/src/error.rs` 中定义的 6 个变体。
+
+## 强制规则
+
+### 所有 #[command] 必须返回 Result<T, AppError>
+
+```rust
+use crate::error::AppError;
+
+// ✅ 正确
+#[command]
+fn some_command(input: String) -> Result<String, AppError> {
+    Ok(input.trim().to_string())
+}
+
+// ❌ 禁止 — 返回 Result<T, String>
+// ❌ 禁止 — 无错误处理
+// ❌ 禁止 — 使用 anyhow::Error
+```
+
+### AppError 的 6 个变体
+
+| 变体 | 用途 | 示例 |
+|------|------|------|
+| `AppError::FileNotFound` | 文件/路径不存在 | `AppError::FileNotFound(path)` |
+| `AppError::Io` | IO 错误 | `AppError::Io(e)` |
+| `AppError::Parse` | 解析失败（JSON/CSV） | `AppError::Parse(msg)` |
+| `AppError::Validation` | 参数校验失败 | `AppError::Validation(msg)` |
+| `AppError::Execution` | 执行时错误 | `AppError::Execution(msg)` |
+| `AppError::Generic` | 其他错误 | `AppError::Generic(msg)` |
+
+```rust
+// ✅ 正确 — 用对应变体
+Err(AppError::Validation("参数不能为空".into()))
+
+// ❌ 禁止 — 全部用 Generic
+Err(AppError::Generic("参数不能为空".into()))
+```
+
+### 前端接收格式
+
+`AppError` 使用 `#[serde(tag = "type", content = "message")]`，前端收到：
+
+```json
+{ "type": "Validation", "message": "参数不能为空" }
+```
+
+## Validation 错误特殊处理
+
+Validation 类型的错误会 re-throw（不由 invokeSafe 吞掉），供调用方做表单校验反馈。
+
+## 新增命令流程
+
+1. 新建 `.rs` 文件 → `src-tauri/src/commands/`
+2. 在 `mod.rs` 注册模块 + `lib.rs` 注册命令
+3. 返回类型用 `Result<T, AppError>`
+4. 错误用对应的变体，不要全部塞 Generic

package/template/rules/invoke-safe-pattern.mdc

@@ -0,0 +1,53 @@
+---
+description: 强制使用 invokeSafe + INVOKE_ERROR 模式的规则。防止前端 IPC 调用错误处理不一致。
+alwaysApply: true
+---
+
+# invokeSafe 调用规范
+
+> SheetFlow 项目特有规则。当 Rust `#[command]` 返回 `Result<T, AppError>` 时，`Ok(())` 会被序列化为 JSON `null`，
+> 导致 `if (!result)` 错误地认为"结果是空"。必须统一使用 `invokeSafe` + `=== INVOKE_ERROR` 判断。
+
+## 强制规则
+
+### 所有 IPC 调用必须使用 invokeSafe
+
+```typescript
+import { invokeSafe, INVOKE_ERROR } from '$lib/utils/invokeSafe'
+
+// ✅ 正确
+const result = await invokeSafe('some_command', { param: value })
+if (result === INVOKE_ERROR) return
+
+// ❌ 禁止 — 直接 invoke
+const result = await invoke('some_command', { param: value })
+
+// ❌ 禁止 — 用 !result 判断错误
+if (!result)  // Ok(()) 是 null，会被误判
+
+// ❌ 禁止 — 用 result === null 判断
+if (result === null)  // 同上
+```
+
+### 判断错误的唯一正确方式
+
+```typescript
+// ✅ 唯一正确
+if (result === INVOKE_ERROR) { /* 错误处理 */ }
+
+// ❌ 禁止的所有写法
+if (!result)          // Ok(()) 是 null
+if (result == null)   // 宽松比较也会命中 null
+if (result === null)  // 明确 null 检查也错
+```
+
+## 例外
+
+只有不需要返回值的纯 UI 操作（如 `appWindow.close()`）可以不经过 invokeSafe。
+
+## 验证
+
+```typescript
+// commit 前自审：搜索 invoke( 是否被直接使用
+// grep -n "invoke(" src/**/*.svelte src/**/*.ts | grep -v "invokeSafe"
+```

package/template/rules/js.mdc

@@ -0,0 +1,10 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-10T07:40:32.184Z
+provider: 
+---
+
+避免发生 TDZ 问题
+避免发生 函数 作用域问题

package/template/rules/powershell.mdc

@@ -0,0 +1,9 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-09T11:25:21.078Z
+provider: 
+---
+
+1.使用Get-Content命令时，增加-Encoding UTF8 参数

package/template/rules//346/227/245/345/277/227.mdc

@@ -0,0 +1,15 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-11T07:40:04.494Z
+provider: 
+---
+
+*.rs 文件日志级别使用规范：
+use log::{info, error, debug, warn};
+
+info!()：用于记录常规的运行信息，如服务启动、命令调用开始、任务执行成功等
+error!()：用于记录错误信息，如文件读取失败、数据解析失败、命令执行异常等
+debug!()：用于记录调试信息，在开发阶段使用，生产环境可关闭，如参数接收、关键变量打印等
+warn!()：用于记录警告信息，如非关键性问题、文件不存在、配置缺失等

package/template/rules//350/257/267/346/261/202.mdc

@@ -0,0 +1,49 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-11T07:37:36.959Z
+provider: 
+---
+
+你是Tauri + Vue3 + TypeScript + Rust项目的专属助手，所有输出必须严格遵守以下规范：
+
+一、项目基础架构约定
+- 技术栈：Tauri 2 + Vue 3 + TypeScript + Rust
+- 前端：Vue 3 单文件组件，统一使用 <script setup lang="ts"> 组合式API
+- 后端：Rust 命令，使用 #[tauri::command] 宏定义
+- 前后端通信：仅使用 @tauri-apps/api/core 的 invoke 方法调用，禁止使用其他API
+
+二、前端调用格式（强制）
+1. 必须从 '@tauri-apps/api/core' 导入 invoke
+2. 必须使用 await 异步调用，入参统一用对象包裹
+3. 必须添加 try/catch 异常捕获
+4. 固定模板：
+import { invoke } from '@tauri-apps/api/core'
+try {
+  const result = await invoke('rust_command_name', {
+    param1: value1,
+    param2: value2
+  })
+  // 成功逻辑
+} catch (err) {
+  console.error('调用失败:', err)
+  // 错误处理
+}
+
+三、Rust后端命令规范（强制）
+1. 必须用 #[tauri::command] 标记，函数必须 pub 公开
+2. 函数参数名与前端 invoke 入参的 key 完全对应（蛇形命名）
+3. 返回值统一用 Result<T, String>，成功返回 Ok(数据)，失败返回 Err("错误信息")
+4. 命令名与前端 invoke 第一个参数完全一致（蛇形命名）
+5. 所有文件读写、系统操作、耗时逻辑必须放在 Rust 端，前端只做调用与UI渲染
+
+四、命名与代码规范
+1. 前端：变量/函数名用小驼峰 camelCase，类型/接口名用 PascalCase
+2. Rust：函数/变量名用蛇形命名 snake_case，类型名用 PascalCase
+3. 代码必须添加必要注释，禁止使用 any 类型
+4. 生成前后端代码时，同时提供：前端调用示例 + Rust 命令实现 + main.rs 注册代码
+
+五、输出要求
+- 所有生成的代码必须可直接复制运行，无需额外修改格式
+- 前后端参数、命名、类型必须完全对齐，避免类型错误

package/template/skills/caveman/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.