构建你的 Expo 应用。 主动权在你手中。

Autotomy 是一套 Expo 和 React Native 启动套件,提供可编辑的 TypeScript 源码、架构检查,以及配合 AI 编程助手使用的 CLI。

看看项目里有什么
或在项目文件夹中开始
npx autotomy install

发布准备完成后才开放安装和购买。现在可以先阅读安装指南。

你的源码。你的 AI 工具。可检查的规则。

你的应用,由哪些部分组成。

底层工具Expo + React Native

Expo 和 React Native 提供移动平台。第三方库负责导航、样式和存储等工作。

套件为你准备的基础Autotomy Expo Starter Pack

Autotomy 提供清晰的项目结构、给 AI 的开发指引、检查工具和可运行的示例。源代码可由你查看和修改。

你要构建的应用你的功能与集成

加入让应用与众不同的功能。当产品需要身份验证、后端或支付时,再按照文档中的模式添加。

先看清你的应用基础。

选择目录,了解它的用途。

autotomy / expo沿着实际源码,了解项目结构
expo / package.jsonAutotomy 基础代码

用好工具,分清职责。

Expo 和 React Native 负责运行应用。第三方库承担导航、样式和存储等工作。

为什么需要它

Autotomy 在这些工具之外提供项目结构、AI 开发指引和检查。添加自己的功能之前,你可以先了解各部分如何配合。

查看技术细节

这些库分别做什么

第三方库为什么需要它
Expo移动开发工具与运行时React Native原生应用界面Expo Router基于文件的导航NativeWind实用类样式TanStack Query服务端状态协调AsyncStorage本地持久化Zod运行时数据验证

依赖在 package.json 中声明,由 pnpm 安装。Autotomy 的适配器是项目自有源码,不是第三方库代码。

目录内的文件

package.json
pnpm-lock.yaml
expo / src/app/Autotomy 基础代码

路由是进入页面的门。

Expo Router 文件把标签页和 URL 连接到页面及其控制器。根层还负责组合应用的上下文提供器。

为什么需要它

路由保持精简,页面展示和产品操作各有归属,避免整个功能都挤进路由。

查看技术细节

目录内的文件

src/app/_layout.tsx
src/app/(tabs)/settings.tsx
expo / src/ui/Autotomy 基础代码

用户看见和触碰的部分。

页面呈现加载、就绪和错误状态。共享基础组件与通用组合提供一致的视觉语言。

为什么需要它

展示层接收明确的输入,不进入另一个页面借用其实现。

查看技术细节

目录内的文件

src/ui/components/shared/
src/ui/components/common/
src/ui/settings/
expo / src/ui/settings/内置示例

小功能,也有完整路径。

外观设置连接页面、控制器、用例、reducer 和存储适配器,包括加载与失败状态。

为什么需要它

在加入自己的功能之前,你可以先检查一条贯穿架构的完整路径。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/ui/settings/
src/hooks/settings/useSettingsController.ts
src/use-cases/settings/settings.ts
src/services/settings.ts
expo / src/ui/puzzle-lab/内置示例

带有退出路径的示例。

一个完整的国际象棋解题功能,展示如何获取数据、处理错误,并连接应用的各个部分。

为什么需要它

先从完整示例中学习,再在准备添加自己的功能时将其归档。内置的设置功能保持独立。

查看技术细节

保留经验,移除演示。

src/*/puzzle-labdocs/reference/puzzle-lab

此命令专用于 Puzzle Lab。它归档示例源码,并记录示例对共享代码的贡献,供你审查。

pnpm puzzle-lab:move-to-docs
pnpm check

目录内的文件

src/ui/puzzle-lab/
src/hooks/puzzle-lab/usePuzzleLab.ts
src/use-cases/puzzle-lab/puzzle-lab.ts
src/services/lichess-puzzles/
expo / src/hooks/Autotomy 基础代码

各个部分在这里接合。

组合 hooks 连接状态、用例和服务,为页面准备模型与操作。

为什么需要它

页面专注于展示,这一层协调让页面真正可用的工作。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/hooks/settings/useSettingsController.ts
src/hooks/settings/settingsScreenModel.ts
expo / src/use-cases/应用逻辑

由应用决定该做什么。

这里决定应用要做什么。内置的设置功能通过这一层保存和恢复用户偏好。

为什么需要它

保存操作与存储库分开,因此你可以测试保存行为,而不必向真实设备写入数据。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/use-cases/settings/settings.ts
src/use-cases/puzzle-lab/puzzle-lab.ts
expo / src/state/应用逻辑

每次变化都有迹可循。

纯 reducer 描述状态转换,保存持久的客户端事实,并使用 Immer 进行不可变更新。

为什么需要它

网络和存储副作用放在别处。给定相同的状态与输入,reducer 能再次产生相同的结果。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/state/settings/settings.state.ts
src/state/puzzle-lab/puzzle-lab.state.ts
expo / src/services/Autotomy 基础代码

外部工具,通过边界接入。

这个目录连接应用与存储及外部服务。它检查传入的数据、处理故障,再把结果交回应用。

为什么需要它

每项集成都有明确的位置。应用自身的决策与执行工作的外部工具保持分离。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/services/settings.ts
src/services/api/
src/services/query-client.ts
expo / src/types/应用逻辑

把共同的含义写清楚。

设置、路由、错误和异步数据都有明确类型。结果 contract 使用 neverthrow 库。

为什么需要它

各部分能约定交换什么,而无需导入彼此的实现。

查看技术细节
跟随一次设置改动

这是内置 Settings 功能的简化路径。选择一个步骤,查看它所在的位置。

目录内的文件

src/types/settings.ts
src/types/result.ts
expo / src/theme/Autotomy 基础代码

从一处改变界面的视觉语言。

语义 tokens 和主题运行时定义应用的视觉词汇。tokens.ts 用于生成 global.css 中的主题区块。

为什么需要它

修改源 tokens,而不是修补生成的 CSS。共享组件将这些选择应用到页面。

查看技术细节

目录内的文件

src/theme/tokens.ts
src/theme/provider.tsx
src/theme/css-variables.ts
expo / src/route-error/Autotomy 基础代码

页面无法渲染时怎么办。

Expo Router 错误适配器记录渲染故障,并提供隔离的恢复界面。

为什么需要它

后备界面避免依赖故障页面的上下文提供器,减少恢复过程一起失败的可能。

查看技术细节

目录内的文件

src/route-error/index.tsx
expo / scripts/Autotomy 基础代码

让规则可以被检查。

脚本支持架构规则、主题生成、源码打包和 Puzzle Lab 归档流程。

为什么需要它

pnpm check 汇总类型、边界、测试、生成主题、原生配置和依赖检查。它能发现问题,但不保证应用没有缺陷。

查看技术细节

目录内的文件

scripts/eslint-rules.cjs
expo / docs/Autotomy 基础代码

让设计理由留在源码旁。

归属图、功能模式和 slice 原型说明项目如何组织、如何扩展。

为什么需要它

你和 AI 协作者有共同的改动依据。后续工程师也能读到同样的决策。

查看技术细节

目录内的文件

docs/SLICE_ARCHETYPES.md
docs/SETTINGS.md
docs/PUZZLE_LAB.md
expo / AGENTS.mdAutotomy 基础代码

把项目规则交给 AI。

AGENTS.md 记录在此仓库工作的架构边界和说明。

为什么需要它

范围明确的功能请求可以引用这些说明与 slice 原型,并要求审查前运行 pnpm check。

查看技术细节

目录内的文件

AGENTS.md
ARCHITECTURE.md
expo / START_HERE.mdAutotomy 基础代码

从明确的步骤开始。

使用指南涵盖安装、运行、检查改动和故障恢复。

为什么需要它

你获得可编辑源码和有文档的工作流程。应用商店账号、签名和产品发布决策仍由你负责。

查看技术细节

目录内的文件

START_HERE.md
PRIVATE_BETA.md
选择目录,了解它的用途。TypeScript · Expo

给 AI 一个清楚的起点。

在 Codex、Claude Code 或 Cursor 中使用下方提示词。账户和付款步骤由你在浏览器完成,之后由助手继续安装。

粘贴到你的编程助手
Set up Autotomy in this project. Inspect the current directory and Git status first. Preserve all existing work and secrets. Run npx autotomy doctor --json to inspect compatibility, then npx autotomy install for an Autotomy or unchanged Lite checkout; use npx autotomy init <new-directory> for a new project. If the CLI requests authentication or a purchase, show me its browser link and let me complete it myself, then resume the command. Never ask me to paste credentials into chat. Do not bypass compatibility or verification failures, overwrite conflicting files, or subscribe on my behalf. Follow the installed project instructions, report any required hook approval, run npx autotomy check, and show me how to start the app from its expo directory.
开始使用

Autotomy 是什么?

Autotomy 是一套 Expo 和 React Native 启动套件,提供可编辑的 TypeScript 源码、架构检查,以及配合 AI 编程助手使用的 CLI。

基础代码包含什么?

完整 Foundation 源码、基础检查、编程助手配置,以及已购版本和已发布 v1 修复的访问权限。

哪些由你添加?

你的产品功能。身份验证、后端、支付和需要权限的原生能力,留到产品需要时再加入。你选择服务,并实现相应的功能 slice。

先做一个改动,再检查它。

从 START_HERE.md 开始。向 AI 协作者描述一个范围明确的功能,遵循 slice 原型,运行检查。检查结果后,再继续构建。

探索项目说明看看项目里有什么
粘贴到你的编程助手
Add <feature> as a cohesive slice in this Autotomy project. Read AGENTS.md and expo/docs/SLICE_ARCHETYPES.md first. Preserve architecture boundaries, explicit error handling, and existing work. Do not modify generated theme CSS directly. Run npx autotomy check, fix failures without weakening gates, and summarize the change and verification evidence.

从源码开始,让维护有据可依。

一次购买 Foundation,需要时再加入持续维护的审查和升级指引。

Lite

免费

最小 Expo 应用和目录结构。购买前先了解起点。

了解 Lite 安装

Starter

US$149一次付款

完整 Foundation 源码、基础检查、编程助手配置,以及已购版本和已发布 v1 修复的访问权限。

Starter 包含 30 天 Pro,不会自动续费。

前往你的账户

Pro

US$19/ 月

或 US$190 / 年

持续维护的审查、验证配置漂移检查、AI 协助的 Expo 升级和高级 hook 反馈。

你的账户

每位开发者可用于不限数量的 Autotomy 项目。Pro 需要 Starter。编程助手及其费用由你自行选择和承担。

Pro 到期后,高级命令停止。你的源码、基础检查、构建和已部署应用继续工作。

单独购买 Pro 后立即计费,未使用的赠送天数不折抵费用。在续费前取消,可继续使用到已付费期限结束。

发布准备完成后才开放安装和购买。现在可以先阅读安装指南。

开始之前

我购买的是什么?

Starter 是可编辑的 Expo Foundation 源码和基础验证。Pro 是可选开发工具订阅,提供持续维护的审查和 AI 升级指引,两者都不是托管应用生成器。

赠送的 30 天结束后会怎样?

除非你主动订阅,否则 Pro 会停止,不会自动扣款。Starter 源码和基础检查继续工作。

Autotomy 会自动修改应用吗?

安装仅管理明确归属的文件。审查提供依据和修复提示词,由你选择的 AI 修改功能和执行升级计划,再由你审查。

源码采用什么许可证?

现有 Foundation 保留 MIT 许可证。新高级工具和升级方案采用单独商业条款,第三方包保留其许可证。

包含应用登录和支付吗?

不包含。Autotomy 账户用于购买开发工具。应用的身份系统、后端、支付、签名和商店发布仍由产品决定。

借助 AI 构建产品的笔记

阅读开发笔记