toor
76a5d71252
删除 android/、ios/ 两个 Capacitor 原生工程与 capacitor.config.ts、 ionic.config.json，以及 scripts/android、scripts/ios.sh 构建脚本； 根与 apps/web 的 @capacitor/* 依赖和相关 npm scripts 一并移除。 Web 侧去掉原生分支：登录只走云乐坊容器授权面板或顶层重定向， 暗色模式不再改原生状态栏，移除 Android 物理返回键处理。 保留 @nuxtjs/ionic（Web UI 框架）、云乐坊 window.ylf 桥接与 PWA。 决策记录见 docs/decisions/0004-web-only.md。
81 lines
1.5 KiB
Markdown
81 lines
1.5 KiB
Markdown
# 快速开始
|
||
|
||
欢迎使用 Cook! 这是一个帮助你决定"今天吃什么"的应用。
|
||
|
||
## 环境准备
|
||
|
||
### 系统要求
|
||
|
||
- Node.js >= 22
|
||
- pnpm >= 11.21
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone https://github.com/YunYouJun/cook.git
|
||
cd cook
|
||
|
||
# 安装依赖
|
||
pnpm install
|
||
```
|
||
|
||
## 开发
|
||
|
||
### 启动开发服务器
|
||
|
||
```bash
|
||
pnpm dev
|
||
```
|
||
|
||
访问 <http://localhost:3000> 查看应用。
|
||
|
||
### 数据管理
|
||
|
||
菜谱数据保存在本地 CSV 文件 `packages/data/recipe.csv` 中。
|
||
|
||
#### 更新菜谱数据
|
||
|
||
```bash
|
||
# 手动编辑 packages/data/recipe.csv 后转换为 JSON
|
||
pnpm convert
|
||
```
|
||
|
||
详细的 CLI 使用说明请查看 [Cook CLI 文档](/dev/cli)。
|
||
|
||
## 构建
|
||
|
||
### Web 应用
|
||
|
||
```bash
|
||
# 构建生产版本
|
||
pnpm build
|
||
|
||
# 预览构建结果
|
||
pnpm preview
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
cook/
|
||
├── apps/web/ # Web 应用（Nuxt）
|
||
│ ├── app/ # 应用源码
|
||
│ │ ├── components/ # Vue 组件
|
||
│ │ ├── composables/# 组合式函数
|
||
│ │ ├── pages/ # 页面路由
|
||
│ │ └── utils/ # 工具函数
|
||
│ └── public/ # 静态资源
|
||
├── docs/ # 文档网站
|
||
├── packages/
|
||
│ ├── cook/ # CLI 工具与推荐/搜索核心
|
||
│ └── data/ # 菜谱数据 (CSV + JSON)
|
||
└── test/ # 测试
|
||
```
|
||
|
||
## 下一步
|
||
|
||
- 📖 查看 [CLI 文档](/dev/cli) 了解数据管理
|
||
- 💻 查看 [Web 应用开发](/dev/app) 了解技术栈与登录流程
|
||
- 🍳 开始添加你喜欢的菜谱!
|