微前端样式隔离的本质是"作用域隔离"——子应用样式限定在自己容器内，不污染全局。

1. 三种策略：默认不隔离、容器作用域隔离、Shadow DOM 强隔离
2. 工程首选：容器作用域，运行时或构建时给规则前置容器 ID
3. 核心做法：拦截样式表，自动加 #subapp .btn { ... }
4. 构建方案：PostCSS 插件打包阶段前置，零运行时开销
5. 根级陷阱：html/body/:root 不能前置，否则全局 reset 失效
6. Shadow DOM 代价：Ant Design / Arco 的 Portal 会被拦截，组件渲染错位
7. Portal 应对：选库时确认 Modal/Drawer 支持自定义挂载点
8. 结论：绝大多数项目走容器作用域，Shadow DOM 留给零污染少数场景

核心论点：pnpm link 验证的是本地源码，不是发布产物——两套验证面必须各走各的。

1. link 视角：指向本地源仓库，src/ 里有什么就能解析什么。
2. publish 视角：files 白名单外的目录全不进 tarball。
3. CI 视角：装的是 npm 上的发布包，看不到未列进 files 的源码。
4. 缺失验证：pnpm pack 解包 grep，文件齐全才算发布面 OK。
5. 踩坑信号：link 全绿、CI 找不到 module，99% 是 files 漏了。

ClaudeCode 的 /loop 让 AI 自动定时执行任务，不用人盯着等结果。

1. 基础用法：/loop <interval> <prompt>，支持自然语言描述间隔
2. 底层实现：cron 表达式，最小粒度 1 分钟，秒级向上取整
3. 默认间隔：未指定 interval 时默认每 10 分钟执行一次
4. 取消方式：用自然语言 "Cancel the job for X" 即可停止
5. 自动过期：循环任务 3 天后自动删除，防忘记取消
6. 触发条件：只在 ClaudeCode 空闲时跑，与对话并行不打断
7. 失效场景：关闭会话即终止，不持久化、不可恢复
8. 持久化方案：Actions Workflow、Desktop Schedule Tasks

核心定位：/loop 是短周期、轻量级、可中断的自动值守，不是生产级调度。

Pi 不是「一个 CLI 加一个 RPC」——它是一个能在 CLI、Node.js 嵌入、子进程 RPC、JSONL 流四种场景下等价使用的 agent runtime。createAgentSession() 是统一入口。

1. 统一入口：createAgentSession() 同时支撑 CLI、SDK、RPC、JSON 四种姿势
2. AgentSession 三类方法：Prompt 排队、事件订阅、模型 / 状态控制
3. 四种运行模式：Interactive（TUI）/ Print（单次）/ RPC（stdin JSONL）/ JSON（事件流）
4. SDK vs RPC 选型：Node.js 嵌入 → SDK；Python / Go / Rust 集成 → CLI RPC
5. 最小 CLI 包装：40 行代码就能跑一个完整的 Pi agent
6. 五大核心启发：Pi 给 AI 产品开发的 5 条原则

CSS @layer 用声明式层级替代了特异性战争——无需 !important 也能精确控级。

1. 机制：先声明的层优先级最低，顺序决定一切
2. 核心：layer 优先于特异性，子选择器也能覆盖上层
3. 反转：!important 反转层级，重要样式反而走底层
4. 嵌套：子层用 . 访问，写成 @layer base.forms { }
5. 场景：框架 reset + 业务定制分层
6. 兼容：2023 起所有现代浏览器原生支持

Tailwind v3 的三条 @tailwind 指令对应 三个不同职责,不是同级概念。

1. @tailwind base:Preflight 重置,抹平浏览器默认
2. @tailwind components:复合组件类(.btn),中间层
3. @tailwind utilities:原子类,按需生成,最后输出
4. 级联顺序:base → components → utilities,后写的赢
5. v4 变化:三条合并成 @import "tailwindcss",components 删

原则:重置写 base,复合组件写 components,原子类写 utilities。

Tailwind v4 重新设计 CSS 入口,几条新指令各司其职,不再像 v3 那样靠 @tailwind 堆叠。

1. @import "tailwindcss":替代 v3 的三条 @tailwind,整合 base + utilities
2. @theme:设计 token 入口,颜色字号间距都在这定义
3. @utility:自定义工具类,替代 v3 的 @layer 写法
4. @variant:自定义变体(hover / focus / ...),替代 v3 的 JS 配置
5. 级联顺序:v4 只剩 base → utilities 两层

核心:@theme 把设计 token 从 JS 搬到 CSS,样式与变量同源。

Pi 在「统一多 provider」这件事上做得非常彻底——30+ 个内置 provider、4 种 key 解析语法、扩展可动态注册新 provider。但最值得记住的不是支持的 provider 多，而是它对「安全」这件事的态度：明确告知无沙箱，把隔离责任推给 OS / 容器 / 虚拟机。

1. 统一层 pi-ai：把 Anthropic / OpenAI / Google 等 API 收敛成统一接口
2. 两类 provider：订阅型（OAuth via /login）和 API Key 型
3. 4 种 key 解析：环境变量插值、shell 命令执行、转义符、字面量
4. model id 不用手动维护：列表随每次 release 更新
5. 思考等级 6 档：off / minimal / low / medium / high / xhigh
6. 安全模型：无沙箱，隔离责任在 OS / 容器 / 虚拟机层

shadcn/ui 官方 Skill，让 AI 写 符合规范 的 shadcn 项目代码。

1. 它是什么：放在 shadcn-ui/ui 仓库 skills/shadcn/ 下的官方 Skill
2. 解决的痛点：AI 写 shadcn 项目普遍走偏——用原生 div 替代组件、写自定义样式覆盖组件、手撸 chat UI
3. 核心机制：限定只跑 shadcn@latest CLI + 6 类强制 Critical Rules
4. 关键能力：shadcn mcp 给 AI 加 search/view/install 工具
5. 配套：--preset 主题码一键切换整套主题 + 组件
6. 结论：做 shadcn 项目 必装，别让 AI 瞎写

Electron 持久化没有"标准答案"，按数据类型选方案，比选库更重要。

1. 写对目录：一律写 app.getPath('userData')，打包后应用目录是只读的。
2. 配置 / 偏好：用 electron-store，一个 JSON 文件搞定，不用自己 fs。
3. 结构化大数据：上 better-sqlite3，同步 API，比 IndexedDB 省心。
4. 敏感信息：token / 密码走 safeStorage，落盘前用系统钥匙串加密。
5. 别踩的坑：renderer 里的 localStorage 会被用户清缓存清掉，不能当数据库。