`feishu2md` 使用教程：从零开始了解与配置

1. 项目目录结构及介绍

feishu2md 是一个基于 Go 语言开发的命令行工具，用于将飞书云文档导出为 Markdown 格式。其基本的目录结构如下：

.
├── cmd          # 包含主命令的源代码，如 feishu2md 的核心逻辑
├── config       # 存放配置文件相关代码
├── internal     # 内部使用的辅助库和组件
│   ├── auth      # 与认证相关的代码
│   ├── client    # 与飞书API交互的客户端
│   └── util      # 辅助工具函数
├── main.go      # 应用的入口点
└── README.md    # 项目的基本说明

main.go 文件是项目的启动点，它导入必要的包并定义程序的入口。

2. 项目启动文件介绍

main.go 文件是项目的主体部分，负责初始化和运行 feishu2md 的命令行接口。当您运行可执行文件时，这里定义的代码会被执行。典型的启动流程包括解析命令行参数，加载配置，以及调用相应的子命令（如 config 或 download）来完成实际的工作。

// ...
func main() {
    // 解析全局选项
    flags := cmd.Flags()
    flags.Parse(os.Args[1:])
    
    // 处理命令
    cmdName := ""
    if len(os.Args) > 1 {
        cmdName = os.Args[1]
    }
    switch cmdName {
    case "config":
        configCmd.Run()
    case "dl", "download":
        downloadCmd.Run()
    default:
        cmd.Usage()
    }
}
// ...

这里，cmdName 用于识别用户在命令行中输入的具体操作，然后调用对应的命令处理函数。

3. 项目配置文件介绍

feishu2md 需要使用 API 凭证来访问飞书的开放平台，这些凭证通常存储在一个名为 .env 的配置文件中。配置文件应该包含以下两行：

FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

这里的 your_app_id 和 your_app_secret 分别对应你在飞书开发者后台创建的应用的 App ID 和 App Secret。

如果你在命令行环境中运行 feishu2md，可以不用手动创建这个文件，而是通过命令行选项 - appId 和 -appSecret 提供这些值。例如：

feishu2md -appId your_app_id -appSecret your_app_secret config

如果希望持久化配置，建议将配置文件放在环境变量 $HOME/.config/feishu2md 下，并命名为 .env。

完成以上步骤后，你就可以使用 feishu2md 来下载和转换你的飞书文档为 Markdown 格式了。有关更多详细用法和示例，可以查阅项目仓库的 README.md 文件或运行 feishu2md -h 获取帮助信息。