用途：在 React Web 应用中实现 argon-router，配合 Effector 的可预测数据流与类型化路径。适用于创建路由与路由器、接线 RouterControls/history、React 视图、查询追踪、路由组合、适配器与 SSR 等任务。
任务分类：setup（路由表、路由器、controls）、ui（连接 React 视图、链接、outlet）、native（React Native 的 React Navigation）、query（URL 查询状态与进出流程同步）、composition（派生/受保护/虚拟路由）、adapters（history/query/自定义适配器）、ssr（内存 history 作用域安全初始化与 allSettled）、hooks、debug。
按需加载参考：先读 references/core-routing.md；React Web 加 react-web.md；React Native 加 react-native.md；路径语法加 paths-dsl.md；查询参数加 query-tracking.md；认证守卫/虚拟路由加 route-composition.md；适配器与 SSR 加 adapters-ssr.md；Link/useRouter 等 API 加 react-navigation-apis.md；懒加载布局加 lazy-layout.md；示例加 examples.md；最后读 checklist.md。
事实来源：优先 ../argon-router/packages//lib/.ts 与 lib/index.ts 导出；文档作解释，冲突时以代码行为为准。
构建顺序：定义带路径与参数的路由单元；创建 router controls 并初始化 history 适配器；用已知路由（可选 base、显式无路径映射 { path, route }）创建 router；创建 React 路由视图并接 RouterProvider 与 createRoutesView（需回退时加 otherwise）；用 route open 和 Link 添加导航；仅在自定义交互时用 useLink；需要时才用 router.registerRoute(...)；需要 URL 查询时才加 trackQuery；基线可用后再加 chainRoute/group；路由树稳定后再加 createLazyRouteView/withLayout。
输出约定：路由器拓扑、导航与查询接线片段、各路由参数/路径 DSL 说明、适配器与 SSR 决策说明、验证清单。默认仅面向 React Web（@argon-router/react），仅在明确面向移动端时切换 React Native 模式。
护栏：期望 URL 变化激活路由前先用 setHistory 初始化 controls；向 setHistory 传路由器适配器（historyAdapter(...)/queryAdapter(...)）而非原始 history 对象；useLink 使用的每条路由都需在 createRouter({ routes }) 注册；路径保持确定，避免模糊通配；查询状态通过 trackQuery 建模而非组件内临时解析；视图渲染集中在 createRoutesView 与 Outlet；路径路由用 historyAdapter，次级/模态/标签路由用 queryAdapter；SSR/测试时在作用域内以 allSettled(router.setHistory, { params: historyAdapter(createMemoryHistory(...)) }) 初始化。具体版本、平台支持与收费信息暂未提供。