Listen 1 桌面版安装与使用指南

1. 项目目录结构及介绍

.
├── app                  # 应用核心代码
│   ├── public           # 静态资源文件
│   └── src              # 业务逻辑代码
├── build                # 构建相关脚本和配置
├── .gitignore           # Git 忽略文件配置
├── .gitmodules          # 子模块配置
├── prettierrc           # Prettier 配置
├── LICENSE.md           # 开源许可证文件
├── README.md            # 项目简介文件
├── package-lock.json    # npm 包锁定文件
└── package.json         # 项目依赖和脚本配置

这个项目的目录结构主要分为两个部分：app 和 build。app 文件夹包含了应用的所有前端代码，包括静态资源和业务逻辑。build 文件夹则包含构建相关的配置和脚本。.git* 文件用于管理 Git 版本控制，而 package*.json 文件则定义了项目的依赖和npm脚本。

2. 项目启动文件介绍

项目的启动文件位于 app 目录下。具体来说，是通过 npm 脚本来运行的。要启动 Listen 1 桌面应用，你需要执行以下步骤：

1. 初始化子模块：如果你是从源码克隆下来的，需要先初始化子模块，因为项目中引用了其他仓库作为子模块。

   cd path/to/listen1_desktop
   git submodule update --init --recursive
   

2. 安装依赖：接下来，确保已经全局安装了 Node.js 和 npm。然后在项目根目录运行：

   npm install
   

3. 启动应用：完成依赖安装后，通过下面的命令启动开发服务器：

   npm run start
   

这将会启动一个本地开发服务器，你可以通过浏览器访问来测试应用。

3. 项目配置文件介绍

项目的主要配置文件是 app/src/config.js。在这个文件中，你可以找到应用程序的关键设置，如音乐服务提供商的API配置和默认设置。例如，它包含了不同的音乐平台的API密钥和基础URL等信息。

如果你想修改应用的行为，如默认搜索的音乐服务、语言设置等，可以在该文件中进行调整。但请注意，如果你打算共享你的修改，应该遵守开源许可协议，并可能需要申请相应的API密钥。

此外，package.json 文件也包含了一些脚本配置，例如构建和打包应用的命令，例如 npm run dist:* 用于生成不同平台的安装包。

记得在编辑配置文件后保存，并重新运行应用以查看更改效果。对于部署和发布，参考 npm 脚本以获取更多信息。