self-evolve-framework 1.6.0 → 1.6.1

package/README.md

@@ -42,17 +42,23 @@ npx self-evolve-framework init --skip-impeccable
 ```
 .codebuddy/
 ├── rules/
-│   ├── self-evolve.mdc    ← 进化编排（always 激活）
-│   └── ponytail.mdc       ← 代码最小化原则
+│   ├── self-evolve.mdc    ← 编排层（always 激活）
+│   ├── ponytail.mdc       ← 代码最小化原则
+│   └── knowledge/         ← 经验知识库（按语言/框架分目录）
+│       ├── general.mdc      ← 跨语言通用约束（always）
+│       ├── typescript.mdc   ← TS/JS 前端语言层（按需）
+│       ├── vue.mdc          ← Vue 框架层（按需）
+│       ├── ant-design-vue.mdc← ant-design-vue 组件库层（按需）
+│       ├── svelte.mdc       ← Svelte 5 框架层（按需）
+│       ├── tailwind.mdc     ← Tailwind CSS v4 框架层（按需）
+│       ├── shadcn-svelte.mdc← shadcn-svelte 组件库层（按需）
+│       ├── rust.mdc         ← Rust 后端层（按需）
+│       └── tauri.mdc        ← Tauri 框架层（按需）
 ├── skills/
-│   ├── skillopt-sleep/    ← 离线进化分析
-│   ├── impeccable/        ← 设计质量审计（含脚本和参考文档）
-│   ├── ponytail/          ← 代码最小化主 skill
-│   ├── ponytail-audit/    ← 代码审计
-│   ├── ponytail-debt/     ← 技术债分析
-│   ├── ponytail-gain/     ← 收益分析
-│   ├── ponytail-help/     ← 帮助文档
-│   └── ponytail-review/   ← 代码审查
+│   ├── skillopt-sleep/
+│   │   └── SKILL.md       ← 离线进化分析
+│   └── impeccable/
+│       └── SKILL.md       ← 设计质量审计
 CLAUDE.md                  ← 追加自我进化章节
 ```
 
@@ -80,9 +86,6 @@ skillopt-sleep adopt      → 采纳建议
 impeccable audit           → 设计质量技术审计
 impeccable critique        → 设计评审
 impeccable polish          → 页面润色
-ponytail                   → 代码最小化懒人模式
-ponytail audit             → 代码审计
-ponytail review            → 代码审查
 ```
 
 ### 设计上下文
@@ -103,16 +106,23 @@ self-evolve-framework/
 ├── bin/cli.js            # CLI 安装工具
 ├── template/
 │   ├── rules/
-│   │   ├── self-evolve.mdc   ← 进化编排
-│   │   └── ponytail.mdc      ← 代码最小化原则
+│   │   ├── self-evolve.mdc   ← 编排层（含 Impeccable 集成 + 知识库调度）
+│   │   ├── ponytail.mdc      ← 代码最小化原则
+│   │   └── knowledge/        ← 经验知识库（按语言/框架分目录，源自 Tauri 等项目沉淀）
+│   │       ├── README.md       ← 索引 + 归属约定 + 编号体系
+│   │       ├── general.mdc     ← 跨语言通用约束（always）
+│   │       ├── typescript.mdc  ← TS/JS 前端语言层（按需）
+│   │       ├── vue.mdc         ← Vue 框架层（按需）
+│   │       ├── ant-design-vue.mdc← ant-design-vue 组件库层（按需）
+│   │       ├── svelte.mdc      ← Svelte 5 框架层（按需）
+│   │       ├── tailwind.mdc    ← Tailwind CSS v4 框架层（按需）
+│   │       ├── shadcn-svelte.mdc← shadcn-svelte 组件库层（按需）
+│   │       ├── rust.mdc         ← Rust 后端层（按需）
+│   │       └── tauri.mdc        ← Tauri 框架层（按需）
 │   └── skills/
-│       ├── skillopt-sleep/   ← 离线进化引擎
-│       ├── impeccable/       ← 设计质量审计（含脚本）
-│       ├── ponytail/         ← 代码最小化主 skill
-│       ├── ponytail-audit/   ← 代码审计
-│       ├── ponytail-debt/    ← 技术债分析
-│       ├── ponytail-gain/    ← 收益分析
-│       ├── ponytail-help/    ← 帮助
-│       └── ponytail-review/  ← 代码审查
+│       ├── skillopt-sleep/
+│       │   └── SKILL.md      ← 离线进化引擎（含设计质量分析）
+│       └── impeccable/
+│           └── SKILL.md      ← 设计质量审计 skill
 └── README.md
 ```

package/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync, readdirSync, statSync } from "fs"
+import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync } from "fs"
 import { join, resolve } from "path"
 import { fileURLToPath } from "url"
 
@@ -9,17 +9,13 @@ const TEMPLATE_DIR = resolve(__dirname, "../template")
 
 const COMMANDS = {
   init: {
-    desc: "一键安装全部 CodeBuddy skill + 规则到当前项目",
+    desc: "安装自我进化飞轮到当前项目",
     run: async (args) => init(args),
   },
   sync: {
-    desc: "从框架项目同步最新的 skill + 规则到当前项目",
+    desc: "从源项目同步配置到当前项目",
     run: async (args) => sync(args),
   },
-  list: {
-    desc: "列出模板中包含的所有 skill 和规则",
-    run: () => listSkills(),
-  },
   help: {
     desc: "显示帮助信息",
     run: () => showHelp(),
@@ -31,49 +27,22 @@ function showHelp() {
   self-evolve — CodeBuddy 自我进化飞轮安装工具
 
   用法:
-    npx self-evolve-framework init       一键安装全部 skill + 规则
-    npx self-evolve-framework list       列出模板中包含的所有 skill
-    npx self-evolve-framework sync       从框架同步最新版本
+    npx self-evolve-framework init       安装到当前项目
+    npx self-evolve-framework sync       从源项目同步
 
   选项:
     --project <path>      指定目标项目路径（默认当前目录）
     --skip-claude-md      跳过更新 CLAUDE.md
-    --skip-impeccable     跳过 Impeccable 设计质量 skill
+    --skip-impeccable     跳过复制 Impeccable skill
     --dry-run             预览要复制的文件，不实际写入
 
   示例:
     npx self-evolve-framework init
     npx self-evolve-framework init --project ./my-app
-    npx self-evolve-framework init --skip-claude-md --dry-run
+    npx self-evolve-framework init --skip-claude-md --skip-impeccable --dry-run
   `)
 }
 
-function listSkills() {
-  const rulesDir = resolve(TEMPLATE_DIR, "rules")
-  const skillsDir = resolve(TEMPLATE_DIR, "skills")
-  console.log("\n📦 模板中包含的规则：")
-  if (existsSync(rulesDir)) {
-    for (const f of readdirSync(rulesDir).filter(f => f.endsWith(".mdc")).sort()) {
-      console.log(`  rules/${f}`)
-    }
-  }
-  console.log("\n🧠 模板中包含的技能：")
-  if (existsSync(skillsDir)) {
-    for (const d of readdirSync(skillsDir).filter(f => statSync(join(skillsDir, f)).isDirectory()).sort()) {
-      const skillMd = join(skillsDir, d, "SKILL.md")
-      let desc = ""
-      if (existsSync(skillMd)) {
-        const firstLine = readFileSync(skillMd, "utf-8").split("\n").find(l => l.startsWith("description:"))
-        if (firstLine) desc = firstLine.replace("description: ", "").trim()
-      }
-      console.log(`  ${d}/  ${desc ? "— " + desc : ""}`)
-    }
-  }
-  if (!existsSync(rulesDir) && !existsSync(skillsDir)) {
-    console.log("  （模板目录为空）")
-  }
-}
-
 async function init(args) {
   const baseDir = resolve(args["--project"] || process.cwd())
   const dryRun = !!args["--dry-run"]
@@ -83,35 +52,25 @@ async function init(args) {
   console.log(`📍 项目路径: ${baseDir}`)
   console.log(`🧪 ${dryRun ? "DRY RUN — 不写入文件" : "执行中..."}\n`)
 
-  let count = 0
+  // 要复制的目录映射：{ 源相对路径 → 目标相对路径 }
+  const dirs = [
+    { src: "rules",  dest: ".codebuddy/rules" },
+    { src: "skills/skillopt-sleep", dest: ".codebuddy/skills/skillopt-sleep" },
+  ]
 
-  // 复制 rules（排除 .mdc 文件可以在以后细化）
-  const rulesSrc = resolve(TEMPLATE_DIR, "rules")
-  if (existsSync(rulesSrc)) {
-    if (!dryRun) {
-      mkdirSync(resolve(baseDir, ".codebuddy/rules"), { recursive: true })
-      cpSync(rulesSrc, resolve(baseDir, ".codebuddy/rules"), { recursive: true, force: true })
-    }
-    const ruleFiles = readdirSync(rulesSrc).filter(f => f.endsWith(".mdc"))
-    console.log(`  ${dryRun ? "🔍 将复制" : "✅ 复制"}  rules/  →  .codebuddy/rules/（${ruleFiles.length} 个规则）`)
-    count++
+  // 默认复制 impeccable skill（除非 --skip-impeccable）
+  if (!skipImpeccable) {
+    dirs.push({ src: "skills/impeccable", dest: ".codebuddy/skills/impeccable" })
   }
 
-  // 复制 skills（排除 impeccable 如果 --skip-impeccable）
-  const skillsSrc = resolve(TEMPLATE_DIR, "skills")
-  if (existsSync(skillsSrc)) {
-    const skillDirs = readdirSync(skillsSrc).filter(f =>
-      statSync(join(skillsSrc, f)).isDirectory() &&
-      !(skipImpeccable && f === "impeccable")
-    )
-    const skillsDest = resolve(baseDir, ".codebuddy/skills")
-    if (!dryRun) {
-      mkdirSync(skillsDest, { recursive: true })
-      for (const dir of skillDirs) {
-        cpSync(join(skillsSrc, dir), join(skillsDest, dir), { recursive: true, force: true })
-      }
-    }
-    console.log(`  ${dryRun ? "🔍 将复制" : "✅ 复制"}  skills/  →  .codebuddy/skills/（${skillDirs.length} 个技能）`)
+  let count = 0
+  for (const { src, dest } of dirs) {
+    const srcDir = resolve(TEMPLATE_DIR, src)
+    const destDir = resolve(baseDir, dest)
+    if (!existsSync(srcDir)) continue
+    if (!dryRun) mkdirSync(destDir, { recursive: true })
+    console.log(`${dryRun ? "  🔍 将复制" : "  ✅ 复制"}  ${src}/  →  ${dest}/`)
+    if (!dryRun) cpSync(srcDir, destDir, { recursive: true, force: true })
     count++
   }
 
@@ -146,13 +105,11 @@ async function init(args) {
   }
 
   console.log(`\n${dryRun ? `🔍 预览完成，共 ${count} 项操作` : `✅ 已完成 ${count} 项操作 — 下次对话即可生效`}`)
-  if (!dryRun && count > 0) {
+  if (!dryRun) {
     console.log("\n📖 使用指南（在 CodeBuddy 对话中输入）：")
     console.log("  skillopt-sleep dry-run  → 每日健康检查")
     console.log("  skillopt-sleep run      → 周改进提案")
     console.log("  impeccable audit/critique  → 设计质量审查")
-    console.log("  ponytail                 → 代码最小化（懒人模式）")
-    console.log("  npx self-evolve-framework list  → 查看所有可用 skill")
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "self-evolve-framework",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "CodeBuddy 自我进化飞轮 — 仅适用于 CodeBuddy IDE。Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析",
   "type": "module",
   "bin": {

package/template/rules/knowledge/README.md

@@ -0,0 +1,56 @@
+# 知识库（Knowledge Base）
+
+> 经验知识库按**语言 / 框架 / 组件库**分目录组织，源自长期项目（Tauri 2 + Vue 3 + ant-design-vue + Svelte 5 + shadcn-svelte + Rust 桌面应用等）的踩坑沉淀。
+> 由 `self-evolve.mdc` 编排层统一调度，是「post-edit 验证 → 错误记忆 → 规则推荐」飞轮的经验支撑层。
+
+## 目录结构
+
+```
+knowledge/
+├── README.md          ← 本文件：索引 + 维护约定
+├── general.mdc        ← 跨语言通用约束（always 激活）
+├── typescript.mdc     ← TS/JS 前端语言层（按需加载）
+├── vue.mdc            ← Vue 框架层（按需加载）
+├── ant-design-vue.mdc ← ant-design-vue 组件库层（按需加载）
+├── svelte.mdc         ← Svelte 5 框架层（按需加载）
+├── tailwind.mdc       ← Tailwind CSS v4 框架层（按需加载）
+├── shadcn-svelte.mdc  ← shadcn-svelte 组件库层（按需加载）
+├── rust.mdc           ← Rust 后端层（按需加载）
+└── tauri.mdc          ← Tauri 框架层（按需加载）
+```
+
+## 加载策略
+
+| 文件 | 激活方式 | 原因 |
+|------|----------|------|
+| `general.mdc` | `alwaysApply: true` | 跨项目通用，任何代码改动都适用 |
+| 语言/框架专项 | `alwaysApply: false` | 仅在涉及对应语言/框架代码时由 description 语义检索加载，避免一次性注入全部 context 导致膨胀 |
+
+## 编号体系
+
+全库统一编号，跨文件引用不冲突：
+
+- **F1–F13**：强制规则（违反即返工）
+- **P1–P15**：多发问题处理模式（同类 bug 反复出现，按模式处理）
+
+新增规则时延续当前最大编号；若某类问题膨胀（如 Rust 专项超过 ~8 条），可在对应专项文件内用 `F-rust-1` / `P-rust-1` 子编号，保持主线编号稳定。
+
+## 归属判断（新增知识放哪）
+
+1. 跨语言/跨框架通用（命名总原则、错误友好、文档漂移、DB 通用坑）→ `general.mdc`
+2. 仅 TS/JS 语言层（strict、类型命名、import 安装）→ `typescript.mdc`
+3. 仅 Vue 框架（v-model、响应式、弹窗、组件命名）→ `vue.mdc`
+4. 仅 Svelte 5 框架（runes、Props、插槽、节点参数同步、画布交互）→ `svelte.mdc`
+5. 仅 Tailwind CSS（v4 语法、魔法值、尺寸 Token、@layer）→ `tailwind.mdc`
+6. 仅 shadcn-svelte（组件引入、API、尺寸/Portal/下拉防误触、重复弹窗抽壳）→ `shadcn-svelte.mdc`
+7. 仅 Rust 语言层（ownership、DB 读取、XLSX、命令注册、AppError）→ `rust.mdc`
+8. 仅 Tauri 框架（IPC 通信、WebView2 特性、配置、Dialog API、AppError 前端侧）→ `tauri.mdc`
+9. 仅 ant-design-vue（组件引入、ConfigProvider token、优先用组件替代原生、a-table 分页、骨架屏、CSS-in-JS 特异性）→ `ant-design-vue.mdc`
+
+> 一条知识涉及多层时，放在"最通用且最不易过期"的那一层，其余层用一句话引用。
+
+## 与进化飞轮的衔接
+
+- 命中任意强制规则 / 多发模式 → 把「命中 + 处理方式」写入记忆（`update_memory`）。
+- 同类问题（P 系列任一类）累计 **≥2 次** 仍无专门规则 → 在 `.codebuddy/rules/` 下新建 `{pattern}.mdc` 固化，并回流到本知识库保持单一真源。
+- 调整任何强制规则 → 同步回流本知识库，避免规则散落多处导致漂移。

package/template/rules/knowledge/ant-design-vue.mdc

@@ -0,0 +1,54 @@
+---
+description: ant-design-vue 组件库层编码规则与多发问题（全局引入、ConfigProvider token、优先用组件替代原生、a-table 分页、骨架屏、CSS-in-JS 特异性）
+alwaysApply: false
+---
+
+# ant-design-vue 知识库
+
+> 仅涉及 ant-design-vue（Vue 3 UI 组件库）的约束与多发问题。框架层见 `vue.mdc`，样式 token 见 `general.mdc` F6。
+
+## 一、引入与机制
+
+- 安装：Vue 3 用 `ant-design-vue@^4`（v4 基于 `@ant-design/cssinjs`）。
+- 全量注册：在 `main.js` 用 `app.use(Antd)` 注册全部组件，并 `import 'ant-design-vue/dist/reset.css'`（v4 用 reset.css，非旧版 antd.css）。
+- 按需引入：若改用按需，需配置 `unplugin-vue-components` + `unplugin-auto-import` 的 `AntDesignVueResolver`；未配置好前不要零散 `import` 单组件（易漏样式或 tree-shaking 不全）。
+- 图标：`@ant-design/icons-vue` 单独安装，按需引入具体图标组件。
+
+## 二、强制规则
+
+### F-antd-1. 主题尺寸走 ConfigProvider token 统一控制
+在根组件用 `<a-config-provider :theme="{ token: { ... } }">` 统一 `fontSize` / `controlHeight` / `borderRadius` / `colorPrimary` 等。
+禁止各页面单独设控件高度/字号（避免尺寸与主题不统一）。主题切换时同步更新 token，而非改组件 `style`。
+
+### F-antd-2. 优先用 antd 组件替代原生 HTML
+按钮用 `<a-button>`、输入框用 `<a-input>`、卡片用 `<a-card>`、表单用 `<a-form>`/`<a-form-item>`、布局用 `<a-row>`/`<a-col>`/`<a-space>`、日期选择用 `<a-date-picker>`。
+禁止大段手写重复的按钮/卡片/输入框 CSS，禁止原生 `<button>/<input>/<div>` 自行布局（否则主题切换时视觉不一致）。
+重构原生页面时：原生按钮→`a-button`（含 loading/disabled）、原生输入框→`a-input`、容器→`a-card`、进度→`a-progress`、状态提示→`a-alert`/`a-tag`；替换后删除不再需要的自定义 CSS。
+
+### F-antd-3. 分页用 a-table :pagination 配置对象
+表格分页通过 `<a-table :pagination="paginationConfig">` 配置（pageSize / showSizeChanger / showQuickJumper / showTotal 等），事件走 `<a-table @change>` 统一管理。
+禁止自定义 `<a-pagination>` 组件单独渲染（a-table 内部已渲染 Pagination）。分页参数抽到共享配置对象复用，避免每页重复。
+
+### F-antd-4. 加载状态用 antd 原语，骨架屏结构对齐
+骨架屏用 `<a-skeleton>` 独立占位；**禁止**用 `<a-spin>` 包裹整个卡片/列表。
+骨架屏的容器结构、内部嵌套、高度必须与真实卡片完全一致，避免加载完成瞬间布局跳跃、颜色跳变。过渡动画同时包裹 loading 与实际内容分支。
+
+## 三、多发问题处理模式
+
+### P-antd-1. 全局 CSS 重置 / !important 会破坏 antd 样式（CSS-in-JS 特异性）
+antd v4 用 `@ant-design/cssinjs`（CSS-in-JS），组件样式以 `<style>` 注入，选择器权重约 **0,1,0（一个类）**。
+- 全局 `* { margin: 0; padding: 0 }`（权重 0,0,0）**不会**覆盖组件默认样式，无需为"覆盖 antd"而额外处理。
+- 但全局 `.xxx { ... !important }` 会覆盖组件样式，是分页/按钮 hover 错位的高频根因。
+需微调 antd 内部样式时，用组件 scoped 样式 `:deep(.ant-xxx)` 精确反覆盖（选择器权重高于组件样式），**禁止**用全局 `!important` 强改。
+
+### P-antd-2. 不为单一交互引入额外 antd 组件依赖
+评估每个组件的必要性；仅为某处小交互就引入整套/大组件会造成体积膨胀。能用现有组件组合（`a-space` / `a-button`）实现的，不新增依赖。
+
+### P-antd-3. 先确认是否全局 CSS 干扰，再精准修复
+a-table 分页 hover/垂直居中异常时，先经源码确认组件默认样式优先级，确认是全局 CSS 干扰后再用 `:deep()` 精准反覆盖；不要修复"不存在的 bug"（优先级不足以覆盖时无需加冗余覆盖）。
+
+### P-antd-4. 主题 token 与项目 CSS 变量体系对齐
+若项目另有一套 `:root` CSS 变量主题体系，确保 ConfigProvider token（colorPrimary 等）与各主题主色同步，使 antd 组件与自定义元素切换主题时一致。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/general.mdc

@@ -0,0 +1,56 @@
+---
+description: 跨语言通用编码约束与多发问题（命名总原则、友好错误、受保护组件、CSS token、筛选/SQLite/文档漂移等），任何项目都适用
+alwaysApply: true
+---
+
+# 通用约束知识库（General）
+
+> 跨语言 / 跨框架的通用约束与多发问题。语言/框架专项见 `knowledge/` 下的 `typescript` / `vue` / `rust` / `tauri`。
+
+## 一、命名总原则（跨语言桥接）
+
+| 层 | 约定 |
+|----|------|
+| 前端 HTML 标签 / 类名 / ID | 小写连字符 `kebab-case`（BEM） |
+| CSS / SCSS / Less 变量 | 小写连字符 `kebab-case` |
+| TS/JS 变量·函数·方法 | 小驼峰 `camelCase` |
+| TS/JS 类·组件·接口(I 前缀) | 大驼峰 `PascalCase` |
+| TS 常量 | 全大写下划线 `UPPER_SNAKE_CASE` |
+| 前端文件夹 / 图片 / 资源 | 小写连字符 `kebab-case` |
+| Rust 函数·变量·方法 | 蛇形 `snake_case` |
+| Rust 类型·Trait | 大驼峰 `PascalCase` |
+| Rust 常量·静态 | 大蛇形 `UPPER_SNAKE_CASE` |
+| Rust 文件 / 文件夹 | 小写蛇形 `snake_case` |
+
+**TS ↔ Rust IPC 命名桥接**：前端 invoke command 名与参数 key 用短横线 `get-user-list`；后端 `#[tauri::command("get-user-list")]` 接收函数用蛇形 `get_user_list`。（详见 `tauri.mdc`）
+
+## 二、强制规则（F 系列）
+
+### F1. 修改前最小性检查（Ponytail 门）
+改动能否用更少代码实现？是否 >3 文件（能缩小吗）？是否新增依赖（有更轻量吗）？是否仅为"可读性"大段改写（放弃）？→ 详见 `ponytail.mdc`。
+
+### F3. 错误消息必须友好中文
+用户可见错误用友好中文，**禁止**直接拼接原始异常对象。原始异常走 `console.error` 保留线索，不静默忽略。弹窗说明「原因 + 建议操作」，不暴露系统细节。
+
+### F5. 受保护组件 / 配置文件禁改
+标记为「禁止修改」的组件与配置文件，**未经用户明确同意不得改动**。改前先确认是否落入保护范围。
+
+### F6. 样式统一走 token
+颜色 / 圆角 / 间距 / 字体等一律用 `:root` CSS 变量（`var(--xxx)`），**禁止**硬编码 hex。设计变更只改 `:root`，各页面自动继承。新增 token 加到 `:root`，禁止在 scoped 新增 token。
+
+## 三、多发问题处理模式（P 系列）
+
+### P1. 同一字段多筛选条件用 AND → 必然零行
+同一字段设两个"等于"条件且用 AND 连接 → 逻辑上不可能同时成立，必然返回零行。遇此配置主动提醒用户是否应改为 OR（同字段多值取并集）。
+
+### P2. SQLite 中文列名必须用双引号包裹
+跨模块查中文字段（如 `线名`/`车站名`/`道岔编号`）的 SQL，列名用双引号包裹：`SELECT "线名", "车站名" FROM dao_cha`。否则 SQLite 把中文当标识符报语法错误。
+
+### P3. SQLite 不支持 TRUNCATE
+执行 `TRUNCATE TABLE` 报语法错误。改用 `DROP TABLE IF EXISTS` + `CREATE TABLE`（自动重置自增 ID、修复 schema，比 `DELETE FROM` 彻底）。
+
+### P15. 文档 / 代码漂移
+文档声称某功能/composable 已完成，实际代码库零引用（如声称抽出的 `useAuth/usePolling` 实际未建）。写/改文档时核对代码实际引用；声称"已完成"前用搜索确认有真实调用方，避免自我指涉的虚假进度。
+
+## 四、与进化飞轮衔接
+命中上述任意规则/模式 → 写入记忆；同类问题 ≥2 次仍无专门规则 → 固化到 `.codebuddy/rules/` 并回流本知识库。

package/template/rules/knowledge/rust.mdc

@@ -0,0 +1,55 @@
+---
+description: Rust 后端编码规则与多发问题（命名、数据库类型容错、XLSX 工厂、MutexGuard、invoke_handler 单宏、全局状态、连接诊断）
+alwaysApply: false
+---
+
+# Rust 知识库
+
+> 仅涉及 Rust 语言/后端的约束与多发问题。框架层（IPC/WebView2/配置）见 `tauri.mdc`，通用见 `general.mdc`。
+
+## 一、命名约定
+
+- 函数 / 变量 / 方法：蛇形 `snake_case`
+- 结构体 / 枚举 / Trait / 类型：大驼峰 `PascalCase`
+- 常量 / 静态变量：大蛇形 `UPPER_SNAKE_CASE`
+- 文件 / 文件夹：小写蛇形 `snake_case`
+
+## 二、强制规则
+
+### F-rust-2. 所有 `#[command]` 返回 `Result<T, AppError>`
+Tauri 命令统一返回 `Result<T, AppError>`（6 变体：`FileNotFound`/`Io`/`Parse`/`Validation`/`Execution`/`Generic`），用 `#[serde(tag = "type", content = "message")]` 序列化，前端按 `type` 字段差异化处理（前端侧见 `tauri.mdc`）。`validation` 类错误 re-throw 给调用方高亮字段，其余弹 toast。
+
+### F4. 数据库读取按类型容错
+`rusqlite::Row` 读取字段，除非 100% 确定类型一致，否则**禁止** `row.get_unwrap::<_, T>()`。
+用 `row.get::<_, rusqlite::types::Value>(idx)` + `match Value::Integer / Value::Text`。同一字段在 API / seed.sql / 手动导入中可能以 INTEGER 或 TEXT 存储。
+
+### F11. XLSX 样式用工厂函数
+新增 xlsx 导出模块优先用 `cell_format()` / `header_format()` 工厂函数，禁止自造 `Format::new()` 重复样式；需微调时在工厂返回的 Format 上链式 `set_*()`。
+列宽用统一 `display_width()`（中文字符算 2 宽度）；数值检测用 `value.parse::<f64>()`，禁止自造 `is_numeric_string()`。
+写入日期单元格时继承 `data_fmt.clone().set_num_format("yyyy/mm/dd")`，避免 `Format::new()` 丢失 `data_fmt` 样式导致日期格式丢失。
+
+## 三、多发问题处理模式
+
+### P4. async 中 MutexGuard 必须在 .await 前 drop
+`std::sync::Mutex` 在 async 函数里加锁后跨 `.await`，Future 不满足 `Send` trait 编译失败。用 `{ /* 加锁区 */ }` 块包围加锁逻辑，确保 MutexGuard 在 `.await` 前被 drop。
+
+### P8. Tauri invoke_handler 单宏约束
+多次调用 `.invoke_handler()` 只有最后一次生效（后续覆盖前次）。所有 `#[tauri::command]` 必须在唯一一个 `generate_handler![]` 宏中注册；函数实现留在各自模块，lib.rs 只做注册中转。
+
+### P13. 全局状态访问用统一入口
+散落多处直接持有全局指针 / 各自读配置 → 迁移困难、易不一致。全局状态通过统一 `get()` 入口（如 `app_state::get()`）访问；配置读写、DB 路径、桌面路径等提取为单一工具函数，禁止重复实现。
+
+### P14. 数据库连接诊断不泄露密码
+前端仅显示 `pass_len=N`（密码长度）；后端连接前做空密码前置校验，错误按关键词分类返回，便于前端精确诊断（前端部分见 Tauri/Vue 层）。
+
+### P-rust-2. 节点处理函数按文件拆分
+工作流类项目把每个节点的后端处理函数拆到独立文件（`executor/nodes/xxx.rs`），在 `mod.rs` 用 `pub use` 暴露，调度器 `scheduler.rs` 的 `execute_single_node` 用 `"xxx" =>` 分支分发。新增节点须前后端都注册（前端见 `svelte.mdc` P-svelte-8）。
+
+### P-rust-3. `evalexpr` 公式占位符 `${value}` 解析
+公式引擎用 `evalexpr` 时，`${value}` 是变量占位符语法（如 `=B1 公式 · 或 ${value}`）。前端模板显示该占位符须用拼接写法（见 `svelte.mdc` P-svelte-3），避免被 Svelte 编译器误解析。
+
+### P-rust-1. 日志解析误判（后端侧）
+同一逻辑的正常/警告日志被前端日志解析误判为错误（如 SQLite 导入成功却弹"有部分错误"）。刷新/成功判定应由明确业务事件/返回值驱动，**不**依赖日志文本解析；确需解析时按数据源分别处理（前端侧见 `vue.mdc` P-vue-1）。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/shadcn-svelte.mdc

@@ -0,0 +1,64 @@
+# shadcn-svelte 组件库层（按需加载）
+
+> 仅当项目使用 **shadcn-svelte**（Svelte 5 + Tailwind v4 的 UI 组件库）时激活。
+> 组件以**源码形式**生成到 `src/lib/components/ui/`，可完全自定义样式；与 `svelte.mdc`（语言/框架层）、`tailwind.mdc`（样式层）协同，不与二者重叠。
+
+## 一、引入与机制
+
+- 添加组件：`npx shadcn-svelte@latest add button input select dialog sonner ...`（源码生成到 `src/lib/components/ui/<comp>/`）
+- 提供 `cn()` 工具（clsx + tailwind-merge）合并 className；组件统一用 `class` 而非 `className`
+- 每个组件可能带来额外底层依赖（`@melt-ui/svelte` / `@zag-js`），引入前评估包体积
+- 引入后清理未使用的旧 UI 库死依赖（如已用 shadcn 则 `npm uninstall bits-ui`），避免样式冲突
+- 通过 barrel export（`$lib/components/ui/index.js`）统一导入：`import { Button, Input, Select } from '$lib/components/ui'`
+
+## 二、通用组件 API 约定
+
+| 组件 | 关键 API | 说明 |
+|------|---------|------|
+| `<Button>` | `variant="default\|outline\|destructive\|ghost\|link"`，`size="default\|sm\|lg\|icon"` | 圆角 `rounded-md`、中文场景用 `size="sm"` |
+| `<Input>` | `class` 控制尺寸 | 统一文本框外观，禁用原生 `<input>` 手写样式 |
+| `<Select>` | `<SelectItem>` 动态生成选项；`value` / `onValueChange` | **自定义渲染，非原生 `<select>`**，无 `appearance-none` 箭头 |
+| `<Sonner>` | 全局 `<Toaster>`，配合 `toastStore.success/error/warning/info` | 替换自制 Toast |
+| 弹窗外壳 | 封装 `ModalShell` 模式：遮罩 + 容器 + ✕ + Escape + Portal | 集成 Svelte Flow `use:portal`，消除每处重复 |
+
+## 三、强制规则
+
+### F-shadcn-1. 通用 UI 控件优先用 shadcn 组件
+新增输入/下拉/按钮/弹窗，**优先**用 `<Input>`/`<Select>`/`<Button>`/统一弹窗外壳。禁止大段手写 Tailwind 类模拟同款控件、禁止每个节点重复粘贴相同原子类组合（可读性差且易漂移）。仅在精确 flex 尺寸 / 绝对定位 / 节点联锁布局等特有场景才保留本地 `<style>`。
+
+### F-shadcn-2. 节点 / 紧凑 UI 统一尺寸与宽度
+shadcn 默认 `h-10`，节点内紧凑 UI 统一 `size="sm"`（`h-8`）+ `text-xs`；**禁止同一组内混用不同高度控件**。节点内输入控件统一固定宽度（`w-14`≈56px / `w-20` / `w-28`），**禁止 `width:100%`、禁止自定义 `flex:0 0 Npx`**（易撑宽画布/容器导致节点 max-width 变形）。
+
+### F-shadcn-3. 弹窗必须 Portal + 统一外壳
+画布 / Svelte Flow 节点内的弹窗必须 `portal`（兼容 transform 定位）；**所有弹窗统一用封装外壳**，禁止手写遮罩层 + 容器 + 关闭按钮 + Escape 逻辑。超出默认 `max-w-lg` 的宽度用 `contentClass` / `width` prop 配置（小配置 `w-[400px]`、标准 `w-[600px]`、数据预览 `w-[80vw]`）。
+
+### F-shadcn-4. 下拉 / Select 在画布节点内防误触
+- `<Select>` 是组合组件，**不自动继承**画布的 `noDragClassName`，必须置于 `.nodrag` 容器内防拖拽误触发
+- 自定义下拉菜单容器必须 `onwheel={(e) => e.stopPropagation()}`，防止滚动选项冒泡到画布触发缩放（原生 `<select>` 的 option 是 OS 弹窗，无需处理）
+- 详见 `svelte.mdc` P-svelte-4（画布交互）
+
+### F-shadcn-5. 避免为单一交互引入额外组件依赖
+仅需简单开关（如 AND/OR 切换）时，用 Tailwind 自写 Segmented/Switch 控件，**不引入** shadcn `switch` 等额外依赖，控制包体积。
+
+## 四、多发模式
+
+### P-shadcn-1. 引入 shadcn 后清理死依赖
+原项目若已有未使用 UI 库（bits-ui 等），`npx shadcn-svelte init` 后 `npm uninstall` 移除；且需确认 shadcn 的 CSS 变量主题与项目现有 `@theme`（`--color-background` 等）不冲突。
+
+### P-shadcn-2. 默认值差异导致视觉不一致
+shadcn 默认 `h-10`、圆角、字号与项目紧凑设计不符 → 全局用 `size="sm"` 或覆写组件默认值；替换后**逐页验证**按钮/输入框高度、弹窗宽度一致，重点核对工具栏与节点内添加/删除按钮。
+
+### P-shadcn-3. 重复弹窗逻辑必须抽公共外壳
+多个弹窗各自维护遮罩/关闭/Escape/Portal（8 处合计 ~200 行重复 CSS）→ 抽 `ModalShell` 后每处模板从 ~14 行降到 0 行、消除全部重复。**新增弹窗一律走外壳**，不回头手写。
+
+### P-shadcn-4. 控件响应式解构陷阱（与 svelte 联动）
+数组参数用 `useArrayParam` 时，`let { items } = useArrayParam()` 解构会断开 `$state` 响应式 → 改用 `let arr = useArrayParam(); let items = $derived(arr.items)`。详见 `svelte.mdc` F-svelte-5。
+
+### P-shadcn-5. 条件组 / 列表控件统一风格
+多行规则（筛选、排序、清洗等）使用统一：容器（`bg-*-50` + `border` + `rounded-lg`）、序号（大写字母 A/B/C）、添加按钮（虚线橙边 `outline` + `size="sm"` + `border-dashed`）、删除按钮（`secondary` + `size="icon"` + `text-rose-500`）。避免每节点各自维护一套不一致的高度/字号/颜色。
+
+### P-shadcn-6. Toast 迁移适配现有 store 接口
+替换为 `<Sonner>` 时需适配项目既有 `toastStore.success/error/warning/info` 调用接口，保留方法签名、仅替换底层渲染，避免改动所有调用点。
+
+### P-shadcn-7. 不要为高风险的统一外壳做全量替换
+节点外壳（NodeShell）等高耦合关键交互组件**不要**为套用 shadcn `Card` 而全量替换（阴影/Handle 定位/圆角兼容性风险高），保持原结构、内部控件仍可用 shadcn。