从生成的代码,到你能留下来的代码。

Refract 阅读项目,找出将会变乱的地方,并准备好由你批准的清理。做决定时不必离开 GitHub。

开始使用

一个简单的循环

1

看清整个项目

Refract 把软件当作整体来看,这样一处界面上的改动也能尊重其余部分。

2

找出以后会疼的东西

它寻找代码被快速生成时出现的模式:被复制的逻辑、缠在一起的界面、残留的 State、经不起时间的结构。如果代码里留下了敏感内容——比如凭证——它会告诉你。它不会悄悄“修好”密钥。

3

能清理的就清理

清理安全时,你会得到一处具体改动来批准。不安全时,你会得到清楚的解释,而不是猜测。

4

检查,然后记住

你批准后,Refract 应用改动并再看一遍。随着时间推移,你能看到项目是在变干净,还是仍在把混乱送上线。

在 GitHub 上做决定。其余用网站。

在 GitHub 上

在网站上

网站不是第二个接受清理的地方。决定留在代码旁边。

你会看到几种诚实结果中的一种

仍在工作

请等待。这不是通过。

看起来没问题

这次改动不需要你处理 Refract 的事项。

清理已就绪

一处安全的清理已准备好。在 GitHub 上批准。

请看一眼

有重要的东西,而 Refract 不会替你改。请阅读说明。

出了问题

分析失败了。Refract 会直说。它不会刷出假的成功。

“更干净”在实践中意味着什么

在 React 和 TypeScript 项目上,Refract 尤其擅长处理快速生成留下的东西:

数据请求混进了界面

同一段逻辑写了两遍

从未真正被使用的 State

不会自我清理的 Effects

边缘缺少超时和错误处理

界面在做本该别处完成的工作

其中一些,它可以替你清理。其中一些,它只会指出——这是故意的。一次糟糕的自动重写,比一条诚实的说明更糟。

几分钟内上线

1

创建账户

2

安装 GitHub App 并选择仓库

3

打开一个拉取请求

创建账户

连接 GitHub 不会让你登录 Refract,登录 Refract 也不会安装 GitHub 访问权限。两步,两件事。

这会和我的 AI 工具打架吗?

不会。继续生成。Refract 是让结果保持可维护的那一遍。

它会在我不在场时改代码吗?

不会。你批准。你合并。

我必须学一个新的工作区吗?

不必。日常你仍待在 GitHub 上。