self-evolve-framework 1.6.0 → 1.6.1

package/template/rules/knowledge/svelte.mdc

@@ -0,0 +1,135 @@
+---
+description: Svelte 5 框架层编码规则与多发问题（runes/$props/插槽/事件修饰符/节点参数同步/弹窗/Store 响应式循环/模板字面量/拖拽）
+alwaysApply: false
+---
+
+# Svelte 5 知识库
+
+> 仅涉及 Svelte 5 框架层的约束与多发问题。后端见 `rust.mdc` / `tauri.mdc`，样式见 `tailwind.mdc`，通用见 `general.mdc`。
+
+## 一、响应式与语法（runes）
+
+- 响应式只用 runes：`$state` / `$derived` / `$effect`，**禁止** `$:` 语法（Svelte 4 废弃）与第三方响应式库（mobx / valtio）
+- 对象 / 数组用 `$state({...})` 即可自动深度响应，无需 `$state.raw`
+- 全局共享状态：在 `*.svelte.ts` 文件中用 `$state` 导出，**禁止**第三方状态管理库
+- 生命周期：挂载一次用 `onMount`；响应式副作用用 `$effect`；清理用 `$effect(() => () => {...})`，**禁止** `beforeUpdate` / `onDestroy`
+
+```svelte
+<script lang="ts">
+  let { id }: { id: string } = $props();           // 禁止 export let
+  let count = $state(0);
+  const double = $derived(count * 2);
+</script>
+```
+
+### F-svelte-1. Props 用 `$props()`，禁止 `export let`
+Svelte 5 标准写法 `let { x = def } = $props<{ x?: T }>()`。`export let` 仅兼容不推荐。
+
+### F-svelte-2. 事件修饰符 `|` 语法禁止
+`onclick|stopPropagation` / `onsubmit|preventDefault` 在 Svelte 5 已废弃，改为显式调用：
+
+```svelte
+<form onsubmit={(e) => { e.preventDefault(); handleSubmit(); }}>...</form>
+<div onclick={(e) => e.stopPropagation()}>...</div>
+```
+
+### F-svelte-3. 插槽用 `{#snippet}` + `{@render}`，禁止 `<slot />`
+```svelte
+<!-- 子组件 -->
+{#snippet children()}
+  {@render children()}
+{/snippet}
+<!-- 父组件 -->
+<Component>
+  {#snippet children()}<p>内容</p>{/snippet}
+</Component>
+```
+
+### F-svelte-4. 组件名大驼峰 + 大小写敏感
+`<Button>...</Button>` 必须配对，混用 `<Button>...</button>` 编译报 `element_invalid_closing_tag`。所有文件用 `<script lang="ts">`，**禁止** `any`，Props / 事件 / 返回值必须强类型。
+
+## 二、节点参数同步（工作流编辑器高发区）
+
+### F-svelte-5. 节点参数同步禁止 `$effect` 调 `setParam`
+`$effect` 内调用 `flowStore.setParam()` 读写同一 `$state` 会触发 `effect_update_depth_exceeded`。正确做法：用 `oninput` / `onchange` / `onclick` 显式调用 + `onMount` 初始化；或优先用 composable：
+
+```ts
+// 扁平参数
+let p = useNodeParams(id, { key1: 'default' });
+oninput={(e) => p.syncParam('key1', e.target.value)};
+
+// 数组参数
+const arr = useArrayParam(id, 'rules', [defaultRule]);
+let rules = $derived(arr.items);   // 必须通过 arr.items / $derived 访问，禁止解构 items
+```
+
+> `flowStore.setParam` 内部已用 `untrack()` 包裹防止被 `$effect` 误追踪。
+
+## 三、多发问题处理模式
+
+### P-svelte-1. 确认弹窗不要 `window.confirm()`
+Tauri v2 WebView 中 `window.confirm()` 被 dialog 插件拦截报 `dialog.confirm not allowed`。统一用 `@tauri-apps/plugin-dialog` 的 `confirm`（异步，函数必须 `async` + `await`）：
+
+```ts
+import { confirm } from '@tauri-apps/plugin-dialog';
+const ok = await confirm('确定删除？', { title: '确认', kind: 'warning' });
+if (!ok) return;
+```
+
+### P-svelte-2. Store 展开写未变仍建新引用 → 响应式死循环
+`{...this.xxx}` 展开写 `$state` 即使值相同也会生成新引用，触发 `effect_update_depth_exceeded`。**赋值前先比较，相同则 `return`**，并用 `untrack()` 包裹：
+
+```ts
+setNodeColumns(nodeId: string, cols: string[]) {
+  untrack(() => {
+    const existing = this.columns[nodeId];
+    if (existing && existing.length === cols.length && existing.every((v, i) => v === cols[i])) return;
+    this.columns = { ...this.columns, [nodeId]: cols };
+  });
+}
+```
+
+### P-svelte-3. 模板 `{'${expr}'}` 被误解析为 JS 模板字面量插值
+Svelte 5 把 `{'${value}'}` 当作模板字面量插值，若 `value` 作用域未定义抛 `ReferenceError`。显示占位符文本（如 Rust `evalexpr` 的 `${value}`）用拼接写法：
+
+```svelte
+<!-- ❌ -->
+<span>{'${value}'}</span>
+<!-- ✅ -->
+<span>{'$'}{value}</span>
+```
+
+### P-svelte-4. 自定义下拉菜单 `wheel` 冒泡触发画布缩放
+下拉选项列表滚动时 `wheel` 事件冒泡到 Svelte Flow 画布触发缩放。所有自定义下拉容器必须 `onwheel stopPropagation`（原生 `<select>` 的 OS 弹窗无需处理）：
+
+```svelte
+<div class="dropdown-menu" onwheel={(e) => e.stopPropagation()}>...</div>
+```
+
+### P-svelte-5. Svelte Flow 节点禁止直接变异 `nodes`/`edges` 数组
+`nodes.push()` / `splice()` / `nodes[i] = x` 违反不可变约定。用不可变替换：`nodes = [...nodes, n]` / `nodes = nodes.map(n => ...)`。节点组件内只渲染 `Handle + UI`，不写业务逻辑、不修改全局状态。
+
+### P-svelte-6. Svelte Flow `Handle` 用 `position:absolute` 绝对定位
+`<Handle>` 内部 `position: absolute`，**不能**用 flex/grid 排列。多 Handle 必须手动算 `top`（`style="top: {CONTENT_OFFSET + i*HANDLE_STEP}px !important"`），且左右 Handle 用同一公式保证对齐。`!important` 范围严格限制 `top` 一个属性。
+
+### P-svelte-7. 前后端参数类型契约必须一一对应
+前端 store 类型（TS）必须与 Rust `#[derive(Deserialize)]` 字段类型对应，否则运行时 deserialize 失败（新增节点最常见错误）：
+
+| Rust | 前端 |
+|------|------|
+| `Vec<String>` | `string[]` |
+| `Vec<Struct>` | `{ field: type }[]` |
+| `Option<String>` | `string \| undefined` |
+| `bool` / `String` | `boolean` / `string` |
+| `serde_json::Value` | `any` |
+
+新增/改字段时前端（flow.ts）与后端（types.rs）**两处同步**，禁止单侧修改。
+
+### P-svelte-8. 新增节点前后端都要注册
+前端：`node-types.ts` + `node-categories.ts`；后端：`nodes/mod.rs`（pub use）+ `scheduler.rs` 的 `execute_single_node` 分支。缺任一注册则节点不可用。Rust 处理函数推荐按文件拆分（`executor/nodes/xxx.rs`）。
+
+### P-svelte-9. 表单 `<label>` 必须关联控件
+否则 Svelte 编译器警告 `A form label must be associated with a control`：用 `<label>名称 <input/></label>` 包裹，或 `<label for="x">` + `<input id="x">`。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/tailwind.mdc

@@ -0,0 +1,66 @@
+---
+description: Tailwind CSS v4 框架层编码规则与多发问题（@import/@theme/@source、禁止魔法色值与魔法数字、桌面尺寸 Token、@layer 分层）
+alwaysApply: false
+---
+
+# Tailwind CSS v4 知识库
+
+> 仅涉及 Tailwind v4 样式框架的约束与多发问题。前端框架层见 `vue.mdc` / `svelte.mdc`，桌面尺寸标准见 `general.mdc` 与 Svelte/Vue 分库。
+
+## 一、v4 语法迁移（与 v3 不兼容）
+
+| 功能 | v3（废弃） | v4（当前） |
+|------|----------|----------|
+| 引入方式 | `@tailwind base/components/utilities` | `@import "tailwindcss"` |
+| 配置文件 | `tailwind.config.js` | `@theme {}` in CSS |
+| 内容扫描 | `content: []` | `@source` in CSS |
+| 主题扩展 | `theme.extend` in JS | `@theme { --color-*: ... }` |
+| 插件注册 | `plugins: []` | `@plugin` in CSS |
+
+### F-tailwind-1. 引入与主题用 v4 语法
+`@import "tailwindcss"`，禁止 `@tailwind` 旧指令；主题扩展写在 `@theme {}` 块内（CSS 中），不再用 `tailwind.config.js`（仅需要插件时才建）。
+
+### F-tailwind-2. 内容扫描用 `@source`
+在 CSS 中用 `@source "../src/**/*.{svelte,vue,ts}"` 声明扫描路径，禁止 v3 的 `content: []` 数组。
+
+## 二、强制规则
+
+### F-tailwind-3. 禁止魔法十六进制色值
+优先用官方语义色阶（`gray-50`-`gray-900`、`blue-500` 等），主题色统一在 `@theme` 的 `--color-*` 扩展；透明度用 `bg-blue-500/50` 语法。魔法色值（`#334155` 等）仅限组件特有 `<style scoped>` 中少量使用。
+
+### F-tailwind-4. 间距 / 尺寸 / 圆角只用官方刻度
+宽高、内外边距、间距只用预设刻度（`0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10, 12, 16...`），禁止 `p-7` / `m-13` 等非标值；必须自定义时在 `@theme` 的 `--spacing-*` 扩展。
+
+### F-tailwind-5. `@apply` 必须放在 `@layer` 内
+复用样式用 `@apply` 指令，且必须在 `@layer components` / `@layer utilities` 内；禁止不写 `@layer` 直接全局覆写。
+
+### F-tailwind-6. 状态变体 / 响应式只用官方
+状态变体只用 `hover:` / `focus:` / `active:` / `disabled:` / `first:` / `last:` / `dark:`；响应式移动端优先（先默认样式，再逐层 `sm:` / `md:` / `lg:`）。暗黑模式用 `class` 策略（根元素加 `dark` 类）。
+
+## 三、多发问题处理模式
+
+### P-tailwind-1. 桌面 UI 尺寸对齐 Ant Design Token 标准
+项目中控件尺寸已对齐 Ant Design 设计 Token，新增 UI 时复用而非自造：
+
+| 元素 | 尺寸 / Token | 对应 |
+|------|-------------|------|
+| 弹窗圆角 | `rounded-xl` = 12px | — |
+| 基础控件圆角 | `rounded-lg` = 6px | borderRadius = 6 |
+| 小元素圆角 | `rounded-md` = 4px | borderRadiusSM = 4 |
+| 正文 | `text-base` = 14px | fontSize |
+| 小标题 | `text-lg` = 16px / 600 | fontSizeHeading5 |
+| 辅助文字 | `text-sm` = 12px | fontSizeSM |
+| 常规按钮 | `h-10 px-5` | — |
+| 小按钮 | `h-8 px-3` | — |
+| 输入框高度 | 统一 `h-10` | — |
+| 顶部栏高度 | `h-14` / `h-16` | — |
+| 侧边栏宽度 | `w-56` / `w-64` | — |
+
+### P-tailwind-2. 节点 / 组件内禁止散落大量相同 Tailwind 类
+重复的类组合优先封装成通用组件（如 shadcn-svelte 的 `<Button>` / `<Input>` / `<Select>`）或 UI 组件，避免在每个节点组件里重复大量原子类。
+
+### P-tailwind-3. 自定义下拉 / 弹窗样式必须考虑画布交互
+若下拉菜单位于 Svelte Flow 画布内，需 `onwheel stopPropagation` 防止滚动冒泡缩放（见 `svelte.mdc` P-svelte-4）；弹窗统一用 Modal 外壳组件，禁止手写遮罩。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/tauri.mdc

@@ -0,0 +1,65 @@
+---
+description: Tauri 2 框架层编码规则与多发问题（IPC 通信、TS-Rust 命名桥接、WebView2 落盘、Dialog API、双配置同步、配置字段校验）
+alwaysApply: false
+---
+
+# Tauri 2 知识库
+
+> 仅涉及 Tauri 框架层的约束与多发问题。后端语言层见 `rust.mdc`，前端框架见 `vue.mdc`。
+
+## 一、前后端通信（IPC）
+
+- 前端调用：`invoke("command-name", params)`（`@tauri-apps/api/core`）
+- 后端注册：`#[tauri::command("command-name")]`，函数 `pub`
+- 参数：统一用 `{ key: value }` 对象包裹
+- 必须 `await` + `try/catch`
+- 通信**只**用 IPC invoke + Event，**禁止** HTTP / WebSocket / axios / fetch（纯桌面应用无后端服务）
+- 所有文件读写 / 系统操作放 Rust 端
+
+### TS ↔ Rust 命令命名桥接
+- 简单参数：Rust 用 `snake_case`，前端用 `camelCase`，Tauri **自动转换**
+  ```rust
+  #[tauri::command] fn load_workflow(workflow_id: String) {}
+  // 前端：invoke('load_workflow', { workflowId: 'x' })  // workflowId 自动映射到 workflow_id
+  ```
+- 结构体参数：外层 key 匹配 Rust 参数名，内层字段用 `#[serde(rename_all = "camelCase")]`
+  ```rust
+  #[derive(Deserialize)]
+  #[serde(rename_all = "camelCase")]
+  struct SomeRequest { user_name: String }
+  // 前端：invoke('save_data', { req: { userName: 'x' } })
+  ```
+
+### AppError + invokeSafe 错误处理（前端侧）
+所有 `#[command]` 返回 `Result<T, AppError>`，`AppError` 用 `#[serde(tag = "type", content = "message")]`（6 变体：`FileNotFound`/`Io`/`Parse`/`Validation`/`Execution`/`Generic`）。前端统一用 `invokeSafe`，错误 sentinel 是 `INVOKE_ERROR = Symbol('invoke_error')`，**判断错误用 `=== INVOKE_ERROR`，禁止 `=== null` 或 `!result`**（Rust `Ok(())` 序列化为 `null` 会被误判）。
+
+## 二、强制规则
+
+### F9. 文件/目录选择走原生 Dialog API
+**禁止** HTML `<input type="file">` / `webkitdirectory`（WebView2 各版本行为不一致，`file.path` 兼容性不稳）。
+用 `@tauri-apps/plugin-dialog` 的 `open({ multiple, filters })` / `open({ directory: true })`。
+
+### F10. 文件落盘走 Tauri Dialog + Rust 写文件
+WebView2 不处理 JS 触发的 `<a download>` 下载，`XLSX.writeFile(wb, name)` 等浏览器下载方法**无法保存**。
+正确：`save()` 原生对话框取路径 → `XLSX.write(wb, { type: 'array' })` 生成 Uint8Array → 通过 Rust 命令（base64 编码后 invoke）写入文件。所有保存操作统一走此链路。
+
+## 三、多发问题处理模式
+
+### P5. Tauri 配置双文件必须同步
+项目有 `tauri.conf.json`（开发）与 `tauri.prod.conf.json`（生产/调试构建）两个配置，`tb`/`tb-fast` 用后者。改 bundle 配置（resources、icon 等）必须同步改两个文件，否则构建出的安装包缺资源。
+
+### P6. 修改 Tauri 配置字段先 cargo check
+`tauri.conf.json` 加了 `tauri-build` crate 不支持的字段，构建报 `unknown field`。改配置前跑 `cargo check` / `npm run cargo:check` 验证字段合法性。
+附带：`languages` 数组用 NSIS `.nlf` 文件名（如 `"SimpChinese"`），**不**用 locale 代码（如 `"zh-CN"`）——schema 通过但 NSIS 运行时因找不到 `.nlf` 报错。
+
+### P-tauri-1. 前端文件保存绕过浏览器机制
+任何"导出/下载"功能都不要依赖 WebView2 的浏览器下载能力（不稳定/无效）。统一：Dialog 选路径 → Rust 写文件（见 F10）。
+
+### P-tauri-2. 确认弹窗用 Tauri dialog（前端侧）
+`window.confirm()` 在 Tauri v2 WebView 报 `dialog.confirm not allowed`。统一用 `@tauri-apps/plugin-dialog` 的 `confirm`（async/await），前端运行时节详见 `svelte.mdc` P-svelte-1。
+
+### P-tauri-3. Tauri 配置多文件必须同步
+除开发 `tauri.conf.json` 外常有多份覆写（如 `tauri.prod.conf.json` 生产/调试、`tauri.win7.conf.json` Win7 兼容）。改 bundle 配置（resources、icon 等）或新增覆写字段时，必须同步所有配置变体，否则对应构建出的安装包缺资源或字段不生效。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/typescript.mdc

@@ -0,0 +1,41 @@
+---
+description: TypeScript/JavaScript 前端语言层编码规则与多发问题（类型命名、strict、禁用 any、双栏命名、注释语法、依赖安装）
+alwaysApply: false
+---
+
+# TypeScript / JavaScript 知识库
+
+> 仅涉及 TS/JS 语言层的约束与多发问题。跨语言通用见 `general.mdc`，Vue 框架见 `vue.mdc`。
+
+## 一、命名与类型约定
+
+- 变量 / 函数 / 方法：`camelCase`（首字母小写，后续单词首字母大写）
+- 类 / 构造函数 / 组件：`PascalCase`（首字母大写）
+- 接口 / 类型（TS）：`PascalCase`，推荐前缀 `I`
+- 常量：`UPPER_SNAKE_CASE`
+- 前端 composable 函数：`use` + `PascalCase`（如 `usePolling()`、`useAuth()`）
+- 前端文件夹 / 资源文件：小写连字符 `kebab-case`
+- HTML 标签 / 类名 / ID：小写连字符 `kebab-case`（BEM）
+- CSS / SCSS / Less 变量：小写连字符 `kebab-case`
+
+## 二、强制规则
+
+### F-ts-1. strict 模式 + 禁用 any
+TypeScript 启用 `strict: true`，**禁止**使用 `any` 类型。不确定类型用 `unknown` + 类型收窄。
+
+### F13. 注释语法约束（SFC）
+Vue SFC `<script>` 块**禁止** `///` 三斜线注释（TS 三斜线指令语法，普通 `<script setup>` 下导致构建失败），只用 `//` 或 `/* */`。
+
+### F6. 样式走 token（前端侧）
+颜色 / 圆角 / 间距 / 字体用 `var(--xxx)` CSS 变量，禁止硬编码（详见 `general.mdc` F6）。
+
+## 三、多发问题处理模式
+
+### P7. 前端 import 的 npm 包必须先装
+源码 `import` 的包未 `npm install` 写入 `package.json.dependencies`，生产构建（`vite build` / Rolldown）因无法解析失败。任何新增 import 必须先安装并确认进入 `dependencies`。
+
+### P-ts-1. 双栏命名不一致
+前端 HTML 用 `kebab-case`、CSS 变量用 `kebab-case`、TS 标识符用 `camelCase`——三者不可混用（如模板写 ` userName `、CSS 写 `--UserName`）。新建文件/类名/变量严格按层对应风格。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/knowledge/vue.mdc

@@ -0,0 +1,48 @@
+---
+description: Vue 3 框架层编码规则与多发问题（组件命名、v-model、响应式、弹窗懒加载、DOM 时序）
+alwaysApply: false
+---
+
+# Vue 3 知识库
+
+> 仅涉及 Vue 框架层的约束与多发问题。语言层见 `typescript.mdc`，通用见 `general.mdc`。
+
+## 一、组件命名约定
+
+- 组件文件：`PascalCase`（SFC，如 `CSVProcessor.vue`）
+- 模板中组件名：`kebab-case`（如 `<csv-processor>`）
+- Props：小驼峰；自定义事件名：小写 + 连字符（`update:model-value`）
+- 原子化拆分：偏好大量小组件
+
+## 二、强制规则
+
+### F2. 组件 v-model 禁止本地 ref + 双 watch 同步
+子组件实现 `v-model` **禁止** `const local = ref(props.modelValue)` + `watch(props.modelValue)` + `watch(local)` 同步写法。
+正确：模板 `:checked="modelValue.includes(x)"`，`@change` 时直接 `emit('update:modelValue', 新数组)`，不经过本地 ref。
+根因：造成 父→子→父→子 循环触发，页面卡顿（已多次复现）。
+
+### F7. 响应式强制
+所有页面适配 ≤820px（侧栏折叠、网格变单列）与 ≤480px。用 Grid/Flexbox 弹性布局，禁止 px 固定宽度。每个新组件必须验证 820px / 480px 显示效果。
+
+### F8. 弹窗懒加载 / 异步渲染
+- 弹窗先 `visible/open = true` 再加载数据；用 `setTimeout(() => loadData(), 0)` 推迟到下一宏任务，确保弹窗动画优先渲染。
+- **禁止**弹窗打开前 `await` 等数据就绪（阻塞显示）。表格设 `:loading`，大数据用虚拟滚动（`:scroll`），默认每页 ≤50 条。
+
+### F12. DOM 时序
+- 获取 DOM 尺寸前加 `setTimeout(..., 50)` 确保 WebView2 渲染完成；不要在 `onMounted` 立即读 `offsetHeight/Width`（容器可能未布局）。
+- 受 `v-show` + `v-if` 时序影响的子组件宽度，用 `nextTick` 延迟加载 + `min-width` 兜底。
+
+### F6. 样式走 token（Vue 侧）
+`:root` 集中定义设计令牌，页面引用 `var(--xxx)`（详见 `general.mdc` F6）。新增 token 加到 `:root`，禁止 scoped 内新增。
+
+## 三、多发问题处理模式
+
+### P-vue-1. 数据刷新竞态
+导入/删除成功后数据选择卡片不自动刷新，需手动刷新页面。在明确的完成事件回调里调用 `refresh()`；注意新表首次创建时 `table_exists` 竞态（导入期间查询可能返回 false）。
+
+### P11. 图表空数据 / 大数据量渲染失败
+日期范围变大或数据为空时 ECharts 渲染失败、空白或报错（空数据分支语法错、try/catch 静默后继续跑空数据、`initChart` 创建实例时即设 option 导致后续不更新）。
+处理：`initChart` 只创建实例不设 option；空数据分支声明移出对象字面量；loading watch 加 `nextTick`；大数据用 `dataZoom` 动态适配，对 `null/undefined` 兜底。
+
+## 四、与进化飞轮衔接
+命中上述规则/模式 → 写入记忆；同类 ≥2 次 → 固化规则并回流知识库。

package/template/rules/ponytail.mdc

@@ -1,108 +1,33 @@
 ---
-description: >
-  Ponytail — 懒人高级开发者模式。强制写最少、最安全的代码。
-  每次对话 always 激活，用户说"stop ponytail"退出。
+description: Ponytail - 懒人高级开发者模式。写最少、最安全的代码。
 alwaysApply: true
 ---
 
-# Ponytail
+## Ponytail 核心规则
 
-You are a lazy senior developer. Lazy means efficient, not careless. You have
-seen every over-engineered codebase and been paged at 3am for one. The best
-code is the code never written.
+在写任何代码之前，先停在能解决问题的**最低台阶**上，按优先级检查：
 
-## Persistence
+1. **这东西真的需要建吗？**（YAGNI）不需要就跳过
+2. **标准库已经提供了吗？** 直接用它
+3. **平台/框架原生功能能覆盖吗？** 直接用它
+4. **已安装的依赖能解决吗？** 直接用它
+5. **能一行搞定吗？** 就写一行
+6. **以上都不行？** 才写最少工作的代码
 
-ACTIVE EVERY RESPONSE. No drift back to over-building. Still active if
-unsure. Off only: "stop ponytail" / "normal mode". Default: **full**.
-Switch: `ponytail lite|full|ultra`.
+## 执行规则
 
-## The ladder
+- 不要创建未经明确要求的抽象
+- 能不引入新依赖就别引入
+- 不要写没人要的样板代码
+- 删除优于添加，无聊优于花哨，文件数量越少越好
+- 质疑复杂需求："你真的需要 X，还是 Y 可以覆盖？"
+- 当两种方法长度相同时，选边界情况更正确的那一个
+- 有意的简化用 `ponytail:` 注释标注，写明已知上限和升级路径
 
-Stop at the first rung that holds:
+## 不偷懒的地方（必须认真对待）
 
-1. **Does this need to exist at all?** Speculative need = skip it, say so in one line. (YAGNI)
-2. **Already in this codebase?** A helper, util, type, or pattern that already lives here → reuse it. Look before you write; re-implementing what's a few files over is the most common slop.
-3. **Stdlib does it?** Use it.
-4. **Native platform feature covers it?** `<input type="date">` over a picker lib, CSS over JS, DB constraint over app code.
-5. **Already-installed dependency solves it?** Use it. Never add a new one for what a few lines can do.
-6. **Can it be one line?** One line.
-7. **Only then:** the minimum code that works.
-
-The ladder is a reflex, not a research project — but it runs *after* you
-understand the problem, not instead of it. Read the task and the code it
-touches first, trace the real flow end to end, then climb. Two rungs work →
-take the higher one and move on. The first lazy solution that works is the
-right one — once you actually know what the change has to touch.
-
-**Bug fix = root cause, not symptom.** A report names a symptom. Before you
-edit, grep every caller of the function you're about to touch. The lazy fix IS
-the root-cause fix: one guard in the shared function is a smaller diff than a
-guard in every caller — and patching only the path the ticket names leaves
-every sibling caller still broken. Fix it once, where all callers route through.
-
-## Rules
-
-- No unrequested abstractions: no interface with one implementation, no factory for one product, no config for a value that never changes.
-- No boilerplate, no scaffolding "for later", later can scaffold for itself.
-- Deletion over addition. Boring over clever, clever is what someone decodes at 3am.
-- Fewest files possible. Shortest working diff wins — but only once you understand the problem. The smallest change in the wrong place isn't lazy, it's a second bug.
-- Complex request? Ship the lazy version and question it in the same response, "Did X; Y covers it. Need full X? Say so." Never stall on an answer you can default.
-- Two stdlib options, same size? Take the one that's correct on edge cases. Lazy means writing less code, not picking the flimsier algorithm.
-- Mark deliberate simplifications with a `ponytail:` comment (`// ponytail: this exists`), simple reads as intent, not ignorance. Shortcut with a known ceiling (global lock, O(n²) scan, naive heuristic)? The comment names the ceiling and the upgrade path: `# ponytail: global lock, per-account locks if throughput matters`.
-
-## Output
-
-Code first. Then at most three short lines: what was skipped, when to add it.
-No essays, no feature tours, no design notes. If the explanation is longer
-than the code, delete the explanation, every paragraph defending a
-simplification is complexity smuggled back in as prose. Explanation the user
-explicitly asked for (a report, a walkthrough, per-phase notes) is not debt,
-give it in full, the rule is only against unrequested prose.
-
-Pattern: `[code] → skipped: [X], add when [Y].`
-
-## Intensity
-
-| Level | What change |
-|-------|------------|
-| **lite** | Build what's asked, but name the lazier alternative in one line. User picks. |
-| **full** | The ladder enforced. Stdlib and native first. Shortest diff, shortest explanation. Default. |
-| **ultra** | YAGNI extremist. Deletion before addition. Ship the one-liner and challenge the rest of the requirement in the same breath. |
-
-Example: "Add a cache for these API responses."
-- lite: "Done, cache added. FYI: `functools.lru_cache` covers this in one line if you'd rather not own a cache class."
-- full: "`@lru_cache(maxsize=1000)` on the fetch function. Skipped custom cache class, add when lru_cache measurably falls short."
-- ultra: "No cache until a profiler says so. When it does: `@lru_cache`. A hand-rolled TTL cache class is a bug farm with a hit rate."
-
-## When NOT to be lazy
-
-Never simplify away: input validation at trust boundaries, error handling
-that prevents data loss, security measures, accessibility basics, anything
-explicitly requested. User insists on the full version → build it, no
-re-arguing.
-
-Never lazy about understanding the problem. The ladder shortens the
-solution, never the reading. Trace the whole thing first — every file the
-change touches, the actual flow — before picking a rung. Laziness that skips
-comprehension to ship a small diff is the dangerous kind: it dresses up as
-efficiency and ships a confident wrong fix. Read fully, then be lazy.
-
-Hardware is never the ideal on paper: a real clock drifts, a real sensor
-reads off, a PCA9685 runs a few percent fast. Leave the calibration knob, not
-just less code, the physical world needs tuning a minimal model can't see.
-
-Lazy code without its check is unfinished. Non-trivial logic (a branch, a
-loop, a parser, a money/security path) leaves ONE runnable check behind, the
-smallest thing that fails if the logic breaks: an `assert`-based
-`demo()`/`__main__` self-check or one small `test_*.py`. No frameworks, no
-fixtures, no per-function suites unless asked. Trivial one-liners need no
-test, YAGNI applies to tests too.
-
-## Boundaries
-
-Ponytail governs what you build, not how you talk (pair with Caveman for
-terse prose). "stop ponytail" / "normal mode": revert. Level persists until
-changed or session end.
-
-The shortest path to done is the right path.
+- 输入校验
+- 错误处理
+- 安全性
+- 可访问性
+- 任何明确要求的事情

package/template/rules/self-evolve.mdc

@@ -12,6 +12,7 @@ alwaysApply: true
 ```
 self-evolve.mdc（编排层 — 当前文件）
   ├── ponytail.mdc       → 代码最小化检查（每个操作前）
+  ├── knowledge/         → 经验知识库（按语言/框架分目录，见下）
   ├── CodeGraph MCP       → 依赖图分析（重构/调 bug 时）
   ├── 核心边界审计        → 删/改功能前确认承重墙（本文件内联）
   ├── Impeccable           → 设计质量审计（前端修改后自动触发）
@@ -20,6 +21,29 @@ self-evolve.mdc（编排层 — 当前文件）
   post-edit 验证闭环 ← ⭐ 核心
 ```
 
+## 📚 经验知识库（knowledge/ 目录）
+
+> 按**语言 / 框架 / 组件库**分目录组织的经验沉淀。完整索引与归属约定见 `knowledge/README.md`。每次动手前先对照相关知识库自查。
+
+```
+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 框架层（按需）
+```
+
+- **改代码前 / 遇 bug 时**：命中某条强制规则（F 系列）或已知多发模式（P 系列）→ 直接按既定方案执行，不重复踩坑。
+  - 例：组件 v-model 禁止双 watch（vue F2）、文件落盘走 Dialog+Rust（tauri F10）、XLSX 用工厂函数（rust F11）、同一字段 AND 筛选=零行（general P1）、SQLite 中文列名需双引号（general P2）、Svelte `$effect` 调 setParam 死循环（svelte P-svelte-2）、Tauri confirm 替代 window.confirm（svelte P-svelte-1）、Tailwind 禁魔法色值（tailwind F-tailwind-3）、shadcn Select 在画布节点内需 `.nodrag` + `onwheel` 防误触（shadcn F-shadcn-4）、antd 分页走 a-table :pagination 配置（antd F-antd-3）。
+- **按需加载**：`general.mdc` 常驻；语言/框架专项 `alwaysApply: false`，由 description 语义检索在对应代码上下文自动加载，避免一次性注入全部 context。
+- **命中即记录**：凡触发强制规则或命中多发模式，把「命中 + 处理方式」写入记忆。
+- **≥2 次同模式仍无专门规则** → 在 `.codebuddy/rules/` 下新建 `{pattern}.mdc` 固化，并回流到知识库保持单一真源。
+
 ## 🔄 核心工作流：Post-Edit 验证闭环
 
 **每次修改代码后必须执行以下流程：**