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 条新设计原则

1. Web Standards first — 优先使用平台原语，不造框架抽象层
2. Static first — 动态运行时行为必须显式声明
3. DSD first — JavaScript 运行前 HTML 已可读
4. Island upgrade — 客户端 JavaScript 升级交互组件，而非整页
5. TC39 Signals first — 跟标准走，框架造自己的 effect/islandEffect API
6. Docs are falsifiable — 当前指南描述当前行为，未来工作留在 roadmap

配置精简

移除了 kiss.config.ts 中已废弃的 legacyMode、experimentalDSD、customIslandStrategy 等配置项。当前配置仅保留：

• routesDir — 路由目录
• islandsDir — Island 目录
• componentsDir — 共享组件目录
• packageIslands — 包级 Island 声明

修复统计

• CSS 注入修复：3 处
• Island 升级修复：2 处
• 配置精简：5 个废弃项移除
• 新增测试：12 个