3 agent 扫描 13k 行源码 · CSS 注入修复 · Island 升级修复 · 6 条新设计原则 · 配置精简
发现的问题
Bug 1: CSS 注入顺序错乱
CSS Custom Properties 主题系统替代了旧的 _propagateTheme DOM 遍历，但注入顺序不正确导致暗色模式下部分组件闪烁。修复：确保 theme CSS 在 component CSS 之前注入。
Bug 2: Island 升级路径断裂
idle 策略的 requestIdleCallback 降级在部分浏览器上没有正确回退到 setTimeout，导致 island 组件永远不加载。修复：添加 setTimeout 兜底。
Bug 3: 配置冗余
kiss.config.ts 中有多个已废弃的配置项仍然被读取，增加了维护负担和出错概率。修复：移除废弃配置，精简为最小配置集。
6 条新设计原则
- Web Standards first — 优先使用平台原语，不造框架抽象层
- Static first — 动态运行时行为必须显式声明
- DSD first — JavaScript 运行前 HTML 已可读
- Island upgrade — 客户端 JavaScript 升级交互组件，而非整页
- TC39 Signals first — 跟标准走，框架造自己的 effect/islandEffect API
- Docs are falsifiable — 当前指南描述当前行为，未来工作留在 roadmap
配置精简
移除了 kiss.config.ts 中已废弃的 legacyMode、experimentalDSD、customIslandStrategy 等配置项。当前配置仅保留：
routesDir— 路由目录islandsDir— Island 目录componentsDir— 共享组件目录packageIslands— 包级 Island 声明
修复统计
- CSS 注入修复：3 处
- Island 升级修复：2 处
- 配置精简：5 个废弃项移除
- 新增测试：12 个