CLI 架构设计指南

Appearance

快速开始 ​

欢迎来到 feishu-cli 源码学习指南！本文档将帮助你快速上手 lark-cli 的鉴权系统。

初级用户 ​

如果你是第一次接触 lark-cli，建议按以下步骤开始：

1. 第一次使用 ​

bash
# 初始化应用
lark-cli config init

# 登录
lark-cli auth login --recommend

# 验证
lark-cli auth status

# 开始使用
lark-cli calendar +agenda

2. 查看快速参考 ​

前往 命令速查表 了解常用命令。

3. 遇到问题 ​

查看 故障排查 获取帮助。

中级开发者 ​

如果你需要修改或扩展鉴权系统：

1. 理解架构 ​

阅读 鉴权系统详细解读 了解系统设计。

2. 学习实现 ​

查看 实现指南 学习代码结构。

3. 掌握核心系统 ​

依次学习 命令系统设计、配置管理系统、错误处理体系。

4. 动手实战 ​

阅读 快捷命令开发实战，参考 场景和流程图 理解实际应用。

高级系统设计者 ​

如果你需要深入研究并设计自己的 CLI：

  1. 完整阅读 鉴权系统详细解读 和 实现指南
  2. 深入学习 命令系统、配置系统、错误处理
  3. 学习 快捷命令开发实战 和 Calendar 服务开发指南
  4. 研究 高级认证系统 和 凭证提供者系统
  5. 使用 源码导航指南 深入源码
  6. 阅读 设计你自己的 CLI 综合应用
  7. 查看 场景和流程图 中的所有场景

学习路径 ​

初级（新手用户） ​

  • 预计时间：30 分钟
  • 内容：快速参考 → 常用命令 → 第一次使用

中级（开发者） ​

  • 预计时间：6-7 小时
  • 内容：架构概览 → 实现指南 → 命令系统 → 配置系统 → 错误处理 → 快捷命令开发 → 流程图

高级（系统设计者） ​

  • 预计时间：10-12 小时
  • 内容：完整文档 → 实现细节 → 所有场景 → 源码导航 → 设计你自己的 CLI

快速上手： 完成学习后，使用项目自带的 /cli-designer Skill 让 AI 引导你创建自己的 CLI 项目（Skill 位于 .claude/skills/cli-designer/，详见 设计你自己的 CLI 中的安装说明）。

下一步 ​