不能直接 import './route.css'，因为Remix构建系统仅将其视为普通模块，不生成标签、不参与路由生命周期，导致服务端无样式、客户端FOUC、样式污染及无法按路由拆包；必须通过路由文件导出links函数显式声明LinkDescriptor数组，且href须为以~/开头的模块路径。
为什么不能直接 import './route.css'
直接在路由文件里写 import './admin.css' 看似简单，但 Remix 的构建系统（esbuild 或 Vite）只把它当普通模块处理，不会生成 <link rel="stylesheet"> 标签，更不会参与路由生命周期。结果是：服务端没样式、客户端 hydration 后才加载（FOUC）、样式被其他路由复用污染、CSS 无法按路由拆包。
links 函数是唯一被框架识别的出口
Remix 只认路由文件中导出的 links 函数返回的 LinkDescriptor 数组，它会在该路由匹配时，把每个对象转成 <link> 插入 HTML 。必须这么写：
import type { LinksFunction } from "@remix-run/node";
import adminStylesHref from "~/styles/admin.css";
export const links: LinksFunction = () => [
{ rel: "stylesheet", href: adminStylesHref },
];
-
href必须是模块路径（~/styles/xxx.css），不是字符串路径（"/styles/xxx.css"） - 支持条件加载：
{ rel: "stylesheet", href: adminStylesHref, media: "screen and (min-width: 768px)" } - 高频跳转路由可预加载：
{ rel: "prefetch", as: "style", href: adminStylesHref } - 全局样式要放在
root.tsx的links里，否则子路由可能漏载
路径别写错：~ 指向 app/，不是项目根目录
错误写法：import styles from "./styles/admin.css"（相对路径 → 构建失败或路径错乱）；import styles from "/styles/admin.css"（绝对路径 → 不被解析为模块，href 变成空字符串）。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 正确路径必须以
~/开头，例如~/styles/dashboard.css - Vite 和 esbuild 都依赖这个约定来定位和指纹化 CSS 文件
- 如果用了自定义
alias，确保~映射到app/（默认已配好，不建议改） - 构建后检查
dist/index.html中<link href>是否带正确前缀（比如部署在/admin/下，href 应为/admin/assets/admin-xxx.css）
动态样式或主题切换怎么搞？
links 是纯函数，不接收参数，也不能访问 loader 数据或组件状态。所以「根据用户偏好加载深色模式 CSS」这类需求不能靠 links 动态决定。
立即学习“前端免费学习笔记（深入）”；
- 方案一：用 CSS 自定义属性 + 全局 class 切换（如
document.documentElement.classList.toggle("dark")），所有逻辑写在全局 CSS 里 - 方案二：把主题相关样式打包进主 bundle，用 JS 控制
<link disabled>切换（但会失去 SSR 样式） - 方案三：服务端通过 loader 读取用户配置，返回
theme: "dark"，再由组件内useEffect注入 class —— 注意这会导致 FOUC，慎用 - 真正路由级的动态样式（比如 A/B 测试不同布局）只能靠多路由文件 + 条件路由匹配，而不是一个路由里动态换 CSS
links，如果 base 配置和部署路径不一致，href 生成的路径仍会 404——这和 CSS 本身无关，而是 Vite 的 base 和反向代理规则必须对齐。 
