一、前言
在实现一款KMP路由框架一文中，我们介绍KMP路由框架。接入一个路由框架往往不难，难的是把它真正用顺手。你要先看文档、配依赖、补 KSP、处理主模块聚合、确认业务模块 sourceSet、再去研究页面跳转、结果回传、跨模块通信、路由守卫、DeepLink、预加载、404 降级……很多时候，不是框架不好，而是从接入到落地的链路太长了。
这次，天衢把这条链路直接砍短了。
现在你可以做到：
- 一句话接入天衢
- 一句话让天衢帮你实现一个具体功能
- 一句话先问清楚天衢能不能做，再决定怎么做
这不是“帮你写几个示例”级别的辅助，而是把接入、能力识别、工程分析、代码落地串成了一条完整工作流。
二、一句话安装，唤醒天衢专属 AI 助手
先安装天衢提供的 Claude Code 集成能力，执行下面命令
curl -fsSL https://gitee.com/zhongte/TianQu/raw/master/install-claude.sh | bash
需要注意两点：
- 需要 安装Java 17+
- 需要你已经安装并可正常使用 Claude Code
装完以后，不需要你自己去翻能力文档、找接入模板、背 API。
你可以直接开始说需求。
三、一句话接入天衢
最直接的用法，就是先让它帮你把框架接进项目。
你只需要说：
接入天衢框架
如果你想说得更具体一点，也可以这样：
把当前 KMP 项目接入天衢，并检查 app 主模块和 feature 模块的 KSP 配置是否完整
它不是简单往 build.gradle.kts 里乱塞几行依赖，而是会先按固定流程做几件事：
-
先检查版本更新
确保当前 AI 使用的是最新的能力定义和接入指南。 -
读取天衢能力边界
先判断你要做的事是不是天衢当前支持的能力，避免 AI 幻觉。 -
分析你的工程结构
判断哪些是 app 壳模块、哪些是 feature 模块、哪些地方需要 KSP 配置和聚合入口。 -
再生成接入改动方案
包括依赖、KSP 参数、sourceSet、聚合初始化、主路由宿主等。
也就是说，它不是“先写代码，再看运气”，而是先确认边界，再理解项目，再动手改。
四、一句话，不只是接入，还能直接实现功能
真正有价值的不是“装上了”，而是你后面开发业务时，真的能一句话把需求交给它。
下面这些，都是非常适合直接拿来用的场景。
案例 1：先问清楚，天衢现在到底能做什么
如果你还不确定框架支持哪些能力，不用翻文档，直接问：
天衢实现了哪些功能
如果你要更贴近业务，也可以这样问：
先告诉我天衢目前支持哪些能力，再推荐最适合商品详情页的路由方案
这一步很重要。
因为它会基于当前能力清单告诉你：
- 支持哪些能力
- 每项能力适合什么场景
- 有哪些约束
- 不支持什么
这意味着你不会在一个不支持的方向上白折腾半天。
案例 2：一句话接入登录模块并生成首个路由页面
比如你新建了一个业务模块，想让它接入天衢并生成第一个页面：
新建登录模块接入天衢路由，并生成第一个登录页路由
它会帮你处理这类接入细节：
- 给模块加上 KSP 配置
- 配置
tianqu.moduleName - 把生成目录加入
commonMain - 确保 Kotlin 编译依赖 KSP metadata 任务
- 生成第一个
@Router页面模板 - 补齐
RouterContext之类的必要参数约束
你不用再反复对照模板检查“是不是漏了一步”。
案例 3：一句话实现页面结果回传
比如你要做一个非常常见的场景：
从“个人主页”跳到“编辑资料页”，编辑完成后把昵称和头像带回来。
你可以直接说：
实现“编辑资料页 -> 个人主页”的结果回传，返回昵称和头像
这类需求如果手写，最容易踩坑的地方有两个：
- 发起跳转的协程作用域选错
- 返回结果展示后状态丢失
而 AI 在这个场景里会自动按天衢正确方式落代码，比如会优先采用挂起式结果回传能力，而不是帮你兜一套回调。
你只要描述业务目标，它会帮你把这些细节一起处理掉。
如果你想更泛化一点，也可以这样说：
使用协程实现页面间通信
案例 4：一句话做带预加载的商品详情页
这是一个特别适合拿来展示天衢能力的例子。
你可以直接说：
写一个带预加载的商品详情页，点击列表时提前加载详情数据
或者更业务化一点：
在商品模块用天衢写一个带有预加载的商品详情页
这个需求背后不是“跳个页面”这么简单，而是：
- 列表点击后立即跳转
- 转场过程中并发预取详情数据
- 页面到达时直接消费预加载结果
- 避免因为 Compose 重组导致预加载器重复创建
这类场景如果全靠手写，开发者要同时记住路由、预加载、Compose 状态约束。
而现在你只需要把产品诉求说清楚。
案例 5：一句话实现跨模块通信
跨模块调用一直是 KMP 项目里很容易变乱的地方。
比如订单模块想调用用户模块的会员能力，你可以直接说：
实现跨模块通信：订单模块调用用户模块的会员服务
或者更泛一点：
实现跨模块通信
它会优先按天衢的服务发现模型来做，而不是帮你硬连模块依赖、或者把接口乱塞到不该放的位置。
这种场景下，AI 的价值不只是“帮你写接口”，而是会优先遵守天衢现有的跨模块服务模式。
案例 6：一句话实现登录拦截 / 路由守卫
很多业务都有路由守卫诉求。
比如未登录用户访问订单确认页时，先拦截再去登录。
你可以直接说：
给订单模块加一个登录校验的路由守卫
或者更完整一些：
实现下单前登录校验，未登录先跳登录页，登录成功后再继续原路由
这里的重点是，天衢的守卫体系本身就是协程式的。
所以 AI 可以直接围绕挂起式守卫能力帮你生成更符合框架风格的实现，而不是退回传统回调写法。
案例 7：一句话搞定栈顶复用 / 栈内复用
这种需求很常见，但很多人一时想不起注解参数该怎么配。
比如商品详情页不希望重复打开栈顶同页：
把商品详情页改成 SINGLE_TOP，避免重复打开同一个页面
又比如订单确认页不希望在栈内堆很多份：
把订单确认页改成 SINGLE_TASK，避免重复打开多个确认页
或者你也可以直接按框架术语说：
实现栈顶复用或者栈内复用
AI 会把你的需求映射到天衢当前支持的启动模式，而不是让你自己回去翻注解枚举。
案例 8：一句话配置全局 404 降级
这是线上很实用的能力。
比如有路由拼错、灰度地址没注册、DeepLink 指向无效路径时，你希望统一兜底到首页：
配置全局 404 降级拦截，未知路由统一跳回首页并打印日志
或者更短：
配置天衢的全局 404 降级拦截
这种能力特别适合在接入完成后顺手补上。
因为它本来就属于“平时不写，线上出问题才后悔”的部分，而现在你可以一句话提前配好。
案例 9：一句话实现 DeepLink 冷启动缓存
有些 App 在冷启动时，框架和页面容器还没完全初始化，但外部 DeepLink 已经进来了。
这时你可以直接说：
实现冷启动 DeepLink 缓存，App 初始化完成后再跳到活动页
这个场景的价值在于，它不是一个简单 demo，而是真正接近线上问题。
如果靠自己从零梳理，往往要同时考虑冷启动时机、初始化顺序、路由分发时机。
而现在你可以直接把场景丢给 AI。
案例 10：一句话把页面做成弹窗路由
比如优惠券选择页，本质上更适合做成弹窗，而不是完整页面跳转：
把优惠券选择页做成 DIALOG 路由，并把结果回传给结算页
这个例子很适合说明一件事：
天衢不是只能做“页面跳转”，也能做路由式弹层。
而且你不只是能把弹窗拉起来，还能顺手把“选择结果回传”一起说清楚，让 AI 直接按同一套路由能力完成。
案例 11：一句话接入 ViewModel 自动注入
比如登录页想绑定页面生命周期、让页面退出时自动释放相关协程任务：
给登录页接入 tianQuViewModelInject，并自动释放页面协程
或者更明确一些：
在登录页接入天衢 ViewModel 自动注入，并让页面出栈时自动释放协程任务
这类能力特别适合团队里对天衢还不够熟的人。
因为他们不一定知道应该从哪个 API 进、怎么和页面生命周期对齐，但 AI 可以先按天衢支持方式生成出来。
五、它为什么比普通 AI 编码更可靠？
关键不在于“模型更会写代码”，而在于这次天衢把框架知识、能力边界、接入模板、执行流程都标准化了。
简单说，它背后不是一个裸 prompt，而是三层协作：
1. MCP Server：提供最新的框架能力知识
里面维护了：
- 天衢支持哪些能力
- 每项能力对应的 API
- 哪些能力不支持
- 接入指南模板
- 版本更新信息
所以 AI 不是靠记忆猜，而是先拿到当前这版框架的“真值源”。
2. Skill技能：强制执行固定工作流
它不是一上来就生成代码，而是先走这类步骤：
- 检查是否有更新
- 读取能力边界
- 分析当前工程
- 再去生成接入或实现方案
这样可以显著降低“写错方向”的概率。
3. Claude Code：结合你的真实工程做落地
最后才是 Claude Code 去读你的 Gradle、模块结构、现有代码，再把能力真正落进项目里。
所以它不是“会聊天的文档助手”，而是有边界、有模板、有执行顺序的工程化辅助能力。
六、不是所有需求都硬做，这反而更值得信任
这一点非常重要。
如果你提的是天衢明确不支持的能力，比如：
- 传统 Fragment 路由
- XML / View 体系页面路由
- 运行时反射扫描注册
- ASM 字节码插桩式方案
它不会偷偷帮你换成别的框架，也不会假装“已经支持”。
它会明确告诉你：
这个能力目前不在天衢支持范围内。
这比“看起来帮你写了很多代码，实际上方向已经偏了”要可靠得多。
一句话实现功能，不代表什么都胡乱实现。
恰恰相反，它的前提就是：只在天衢能力边界内，精准地实现。
七、你可以直接复制的提示词清单
如果你想马上体验，下面这些可以直接拿去用：
接入天衢框架
天衢实现了哪些功能
在登录模块接入天衢路由，并生成第一个登录页路由
实现“编辑资料页 -> 个人主页”的结果回传，返回昵称和头像
写一个带预加载的商品详情页，点击列表时提前加载详情数据
实现跨模块通信：订单模块调用用户模块的会员服务
给订单模块加一个登录校验的路由守卫
把商品详情页改成 SINGLE_TOP，避免重复打开同一个页面
配置全局 404 降级拦截，未知路由统一跳回首页并打印日志
实现冷启动 DeepLink 缓存，App 初始化完成后再跳到活动页
把优惠券选择页做成 DIALOG 路由，并把结果回传给结算页
在登录页接入天衢 ViewModel 自动注入，并让页面出栈时自动释放协程任务
八、结语
这次更新，真正改变的不是“多了一个 AI 命令”，而是天衢第一次把“框架能力”和“开发动作”打通了。
以前你是：
- 先查文档
- 再查模板
- 再猜怎么配
- 再试错
现在你可以变成：
- 直接说目标
- 让 AI 先判断能不能做
- 再结合你的工程自动落地
这就是天衢这次最重磅的升级：
一句话接入天衢。
一句话使用天衢实现功能。
而且不是演示级别，是可以真正进入日常开发流程的那种。
