飞书CLI一键安装助手

- ✅ 自动检测 npm/yarn 环境
- ✅ 自动检测网络连接
- ✅ 自动检测系统权限
- ✅ 提供环境问题解决方案

### 2. 一键自动安装
- ✅ 安装 lark-cli
- ✅ 安装相关 Skills
- ✅ 初始化应用配置
- ✅ 引导用户授权
- ✅ 验证安装结果

### 3. 断点续装
- ✅ 记录安装进度
- ✅ 失败后从断点继续
- ✅ 不重复安装已完成步骤

### 4. 友好错误处理
- ✅ 清晰的错误说明
- ✅ 具体的解决方案
- ✅ 交互式引导

## 快速开始

### 一键安装（推荐）

```python
python scripts/one_click_installer.py
```

### 分步安装

如果需要更精细控制，可以分步执行：

```python
# 1. 环境检测
python scripts/environment_checker.py

# 2. 安装CLI
python scripts/lark_installer.py

# 3. 安装Skills
python scripts/skills_installer.py

# 4. 初始化配置
python scripts/config_initializer.py

# 5. 用户授权
python scripts/auth_guide.py

# 6. 验证安装
python scripts/installation_validator.py
```

## 安装流程

```
[1/5] 环境检测
  ✅ Node.js v18.17.0 (满足要求)
  ✅ npm 9.6.7 (可用)
  ✅ 网络连接正常
  ✅ 系统权限正常

[2/5] 安装 lark-cli
  📦 安装中...
  ✅ 完成

[3/5] 安装 Skills
  📦 安装中...
  ✅ 完成

[4/5] 初始化配置
  🔧 创建应用...
  ✅ 应用创建成功
  📋 App ID: cli_xxx
  🔑 App Secret: xxx

[5/5] 用户授权
  📝 请打开以下链接完成授权：
  https://open.feishu.cn/open-apis/authen/v1/authorize?...
  
  ⏳ 等待授权完成...
  ✅ 授权成功

验证安装...
  ✅ lark-cli help 正常
  ✅ lark-cli auth status 正常

🎉 安装完成！
```

## 使用场景

### 场景1：首次安装飞书CLI

用户只需运行一个命令，技能会自动：
1. 检测环境是否满足要求
2. 安装所有必需组件
3. 创建应用并配置
4. 引导完成授权
5. 验证安装成功

### 场景2：安装失败后重新安装

技能会检测之前的安装进度，从失败的步骤继续，避免重复操作。

### 场景3：环境问题排查

如果环境不满足要求，技能会提供详细的解决方案，帮助用户快速解决问题。

## 常见问题

### 1. Node.js 版本过低

**问题**: Node.js 版本低于 16.0

**解决方案**:
```bash
# macOS/Linux
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 nvm
nvm install 18
nvm use 18
```

### 2. npm 权限不足

**问题**: EACCES permission denied

**解决方案**:
```bash
# 方案1: 使用 sudo
sudo npm install -g @larksuite/cli

# 方案2: 修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
```

### 3. 网络连接问题

**问题**: 网络超时或连接失败

**解决方案**:
```bash
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com
npm install -g @larksuite/cli
```

### 4. 授权失败

**问题**: 授权码已过期

**解决方案**:
重新执行授权命令：
```bash
lark-cli auth login
```

## 安装后验证

安装完成后，可以运行以下命令验证：

```bash
# 查看帮助
lark-cli help

# 查看登录状态
lark-cli auth status

# 查看配置
lark-cli config list
```

## 下一步

安装成功后，你可以：

1. **查看所有命令**
   ```bash
   lark-cli help
   ```

2. **查看登录状态**
   ```bash
   lark-cli auth status
   ```

3. **开始使用**
   - "帮我创建一篇云文档"
   - "查看我今天的日程"
   - "搜索包含'项目'的群聊"

## 技术架构

```
feishu-cli-installer/
├── SKILL.md                           # 技能文档
├── scripts/
│   ├── one_click_installer.py         # 一键安装主程序
│   ├── environment_checker.py         # 环境检测
│   ├── lark_installer.py              # 安装CLI
│   ├── skills_installer.py            # 安装Skills
│   ├── config_initializer.py          # 初始化配置
│   ├── auth_guide.py                  # 授权引导
│   └── installation_validator.py      # 验证安装
├── references/
│   ├── installation_guide.md          # 安装指南
│   ├── common_issues.md               # 常见问题
│   └── troubleshooting.md             # 故障排查
└── configs/
    └── progress_template.json         # 进度模板
```

## 参考资源

- [飞书CLI GitHub仓库](https://github.com/larksuite/cli)
- [飞书CLI官方文档](https://www.feishu.cn/content/article/7623291503305083853)
- [飞书开放平台](https://open.feishu.cn/)

## 更新日志

### v1.0.0 (2026-04-03)
- ✅ 初始版本发布
- ✅ 支持一键安装
- ✅ 支持环境检测
- ✅ 支持断点续装
- ✅ 支持错误处理

## 作者

贾维斯 - 阿里

## 许可证

MIT License