# AGENTS.md

本项目是洛雪音乐源仓库，包含多个音乐源的 JS 文件。

## 项目结构

- `sixyin/` - 六音源
- `huibq/` - Huibq 源
- `flower/` - 野花源
- `lx/` - 洛雪官方源
- `ikun/` - ikun 源
- `grass/` - Grass 源
- `juhe/` - 聚合 API 源
- `xinghai/` - 星海源
- `CreateLatest.py` - 更新 latest.js 的脚本

## 命令

### 更新 latest.js

```bash
python CreateLatest.py
```

将各源的版本文件复制为 latest.js。

### 添加新版本

1. 将新版本 JS 文件放入对应源目录（如 `sixyin/1.2.2.js`）
2. 编辑 `CreateLatest.py`，更新 `VERSIONS` 字典中的版本号
3. 运行 `python CreateLatest.py`

### 新增音源

1. 完成"添加新版本"的三个步骤
2. 在 `README.md` 的"在线导入"章节按音源名字母升序插入对应小节，格式为：小节标题上方添加显式锚点 `<a id="<目录名>"></a>`（锚点名与音源目录名一致，"音源可用性"表格中的链接依赖它），小节内含两个独立代码块（第一个为原始链接、第二个为加速链接，含义见章节开头说明）

## 代码风格

### JS 文件规范

- 文件头部必须包含注释块，包含：
  - `@name` - 音源名称
  - `@description` - 描述和版本信息
  - `@version` - 版本号
  - `@author` - 作者
  - `@homepage` - 主页（可选）
  - `@repository` - 仓库地址（可选）
  - `@netease` / `@tencent` - 平台标识（可选）

示例：
```javascript
/*!
 * @name 六音音源
 * @description v1.2.1
 * @version v1.2.1
 * @author 六音
 * @homepage www.sixyin.com
 * @netease MUSIC_U=;
 * @tencent ts_last=y.qq.com/n/ryqq/album;
 * @preserve
 */
```

- `@preserve` 标记表示保留注释，防止被压缩工具移除

### Python 脚本规范

- 使用 Python 3
- 遵循 PEP 8 风格指南
- 使用类型提示（PEP 484）
- 注释使用中文

### 版本命名

- 使用语义化版本号（如 `1.2.0`, `4`）
- 版本号对应文件名（如 `1.2.0.js`）
- latest.js 始终指向当前最新版本

### Git 提交

- 使用中文提交信息
- 格式：`[源名] 更新到 v版本号`
- 示例：`[sixyin] 更新到 v1.2.1`

## 注意事项

- JS 文件通常是混淆或压缩后的代码，无需手动编辑
- 如需更新源，请从上游项目获取最新版本
- 保持各源目录结构一致