├── .gitignore
├── go.mod
├── go.sum
├── .github
    └── workflows
    │   └── package.yml
├── README.md
├── main.go
└── LICENSE


/.gitignore:
--------------------------------------------------------------------------------
1 | .idea
2 | .vscode


--------------------------------------------------------------------------------
/go.mod:
--------------------------------------------------------------------------------
1 | module yunshu_music_local
2 | 
3 | go 1.25.0
4 | 
5 | require github.com/unitnotes/audiotag v0.1.0 // indirect
6 | 


--------------------------------------------------------------------------------
/go.sum:
--------------------------------------------------------------------------------
1 | github.com/hjfreyer/taglib-go v0.0.0-20250508221915-cb3b18d1ad7b h1:205iYsSfmwawdcrADhzrnRSUeujcigFWPl0qbNuAJSs=
2 | github.com/hjfreyer/taglib-go v0.0.0-20250508221915-cb3b18d1ad7b/go.mod h1:eSDoUM0WCOj3y5CUX9yQVbMSlGd4YSd/ukmLIhxLZaI=
3 | github.com/unitnotes/audiotag v0.1.0 h1:HPJ2MxPKJX4NJvv6Zb6bNtyhPGCgATAeVP7fPn4zoW0=
4 | github.com/unitnotes/audiotag v0.1.0/go.mod h1:jc9bJbSj9+6OkJSDJfJv40jWfhOGCi7M4W23dp8frGA=
5 | 


--------------------------------------------------------------------------------
/.github/workflows/package.yml:
--------------------------------------------------------------------------------
 1 | name: Build Multi-Platform Binaries and Upload to Release
 2 | 
 3 | on:
 4 |   workflow_dispatch:
 5 | 
 6 | jobs:
 7 |   create-release:
 8 |     runs-on: ubuntu-latest
 9 |     outputs:
10 |       upload_url: ${{ steps.create_release.outputs.upload_url }}
11 |     steps:
12 |       - name: Create Release
13 |         id: create_release
14 |         uses: actions/create-release@v1
15 |         env:
16 |           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
17 |         with:
18 |           tag_name: ${{ github.ref }}
19 |           release_name: Release ${{ github.ref }}
20 |           draft: true
21 |           prerelease: false
22 | 
23 |   build-and-upload:
24 |     runs-on: ubuntu-latest
25 |     needs: create-release
26 |     strategy:
27 |       matrix:
28 |         os: [linux, windows, darwin]
29 |         arch: [amd64, arm64]
30 | 
31 |     steps:
32 |       - name: Checkout Code
33 |         uses: actions/checkout@v4
34 | 
35 |       - name: Set up Go
36 |         uses: actions/setup-go@v5
37 |         with:
38 |           go-version: '1.25.0'
39 | 
40 |       - name: Build Binary
41 |         id: build
42 |         run: |
43 |           export GOOS=${{ matrix.os }}
44 |           export GOARCH=${{ matrix.arch }}
45 |           # Determine the output file name with .exe extension for Windows
46 |           OUTPUT_FILE="yunshu_music_local-${GOOS}-${GOARCH}${{ matrix.os == 'windows' && '.exe' || '' }}"
47 |           echo "Building for ${GOOS}/${GOARCH}..."
48 |           go build -o $OUTPUT_FILE main.go
49 |           echo "output_file=$OUTPUT_FILE" >> $GITHUB_ENV
50 | 
51 |       - name: Upload Release Asset
52 |         uses: actions/upload-release-asset@v1
53 |         env:
54 |           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
55 |         with:
56 |           upload_url: ${{ needs.create-release.outputs.upload_url }}
57 |           asset_path: ${{ env.output_file }}
58 |           asset_name: ${{ env.output_file }}
59 |           asset_content_type: application/octet-stream
60 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | <h3 align="center">云舒音乐本地服务端</h3>
  2 | 
  3 | <div align="center">
  4 | 
  5 | [![GitHub stars](https://img.shields.io/github/stars/itning/yunshu_music_local.svg?style=social&label=Stars)](https://github.com/itning/yunshu_music_local/stargazers)
  6 | [![GitHub forks](https://img.shields.io/github/forks/itning/yunshu_music_local.svg?style=social&label=Fork)](https://github.com/itning/yunshu_music_local/network/members)
  7 | [![GitHub watchers](https://img.shields.io/github/watchers/itning/yunshu_music_local.svg?style=social&label=Watch)](https://github.com/itning/yunshu_music_local/watchers)
  8 | [![GitHub followers](https://img.shields.io/github/followers/itning.svg?style=social&label=Follow)](https://github.com/itning?tab=followers)
  9 | 
 10 | </div>
 11 | 
 12 | <div align="center">
 13 | 
 14 | [![GitHub issues](https://img.shields.io/github/issues/itning/yunshu_music_local.svg)](https://github.com/itning/yunshu_music_local/issues)
 15 | [![GitHub license](https://img.shields.io/github/license/itning/yunshu_music_local.svg)](https://github.com/itning/yunshu_music_local/blob/master/LICENSE)
 16 | [![GitHub last commit](https://img.shields.io/github/last-commit/itning/yunshu_music_local.svg)](https://github.com/itning/yunshu_music_local/commits)
 17 | [![GitHub repo size in bytes](https://img.shields.io/github/repo-size/itning/yunshu_music_local.svg)](https://github.com/itning/yunshu_music_local)
 18 | [![Hits](https://hitcount.itning.com?u=itning&r=yunshu_music_local)](https://github.com/itning/hit-count)
 19 | [![language](https://img.shields.io/badge/language-Dart-green.svg)](https://github.com/itning/yunshu_music_local)
 20 | 
 21 | </div>
 22 | 
 23 | ## 功能概述
 24 | 
 25 | - 自动扫描指定目录下的音频文件（支持 `.flac`, `.mp3`, `.wav`, `.aac`）
 26 | - 提取音频元数据（标题、艺术家等）
 27 | - 支持通过 HTTP 查询音乐列表
 28 | - 支持在线播放、下载音频文件
 29 | - 支持查找对应的 `.lrc` 歌词文件
 30 | - 支持提取音频封面图（如 ID3 中包含）
 31 | 
 32 | ---
 33 | 
 34 | ## 安装与运行
 35 | 
 36 | ### 启动服务
 37 | 
 38 | ```bash
 39 | ./yunshu_music_local -d /path/to/music/dir -p 8080
 40 | ```
 41 | 
 42 | - `-d` 指定音频文件所在目录（必须）
 43 | - `-p` 指定监听端口号，默认 `8080`
 44 | 
 45 | ---
 46 | 
 47 | ## API 接口说明
 48 | 
 49 | ### 获取所有音乐信息
 50 | 
 51 | **GET** `/music`
 52 | 
 53 | #### 响应示例：
 54 | 
 55 | ```json
 56 | {
 57 |   "code": 200,
 58 |   "msg": "查询成功",
 59 |   "data": [
 60 |     {
 61 |       "musicId": "1",
 62 |       "name": "歌曲名称",
 63 |       "singer": "歌手名字",
 64 |       "lyricId": "1",
 65 |       "type": 2,
 66 |       "musicUri": "http://localhost:8080/music/file/1",
 67 |       "musicDownloadUri": "http://localhost:8080/music/file/download/1",
 68 |       "lyricUri": "http://localhost:8080/music/lyric/1",
 69 |       "coverUri": "http://localhost:8080/music/cover/1"
 70 |     }
 71 |   ]
 72 | }
 73 | ```
 74 | 
 75 | ---
 76 | 
 77 | ### 获取音频文件（在线播放）
 78 | 
 79 | **GET** `/music/file/{musicId}`
 80 | 
 81 | 返回音频文件流，可直接用于 HTML5 `<audio>` 标签播放。
 82 | 
 83 | ---
 84 | 
 85 | ### 下载音频文件
 86 | 
 87 | **GET** `/music/file/download/{musicId}`
 88 | 
 89 | 触发浏览器下载该音频文件。
 90 | 
 91 | ---
 92 | 
 93 | ### 获取歌词文件
 94 | 
 95 | **GET** `/music/lyric/{musicId}`
 96 | 
 97 | 如果存在同名 `.lrc` 文件，则返回歌词内容。
 98 | 
 99 | ---
100 | 
101 | ### 获取音频封面图
102 | 
103 | **GET** `/music/cover/{musicId}`
104 | 
105 | 从音频文件中提取的封面图（仅限嵌入在 ID3 等标签中的图像）。
106 | 


--------------------------------------------------------------------------------
/main.go:
--------------------------------------------------------------------------------
  1 | package main
  2 | 
  3 | import (
  4 | 	"crypto/sha256"
  5 | 	"encoding/json"
  6 | 	"flag"
  7 | 	"fmt"
  8 | 	tag "github.com/unitnotes/audiotag"
  9 | 	"io"
 10 | 	"log"
 11 | 	"net/http"
 12 | 	"net/url"
 13 | 	"os"
 14 | 	"path/filepath"
 15 | 	"strings"
 16 | 	"time"
 17 | )
 18 | 
 19 | // Music defines the structure of music file
 20 | type Music struct {
 21 | 	MusicId          string `json:"musicId"`
 22 | 	Name             string `json:"name"`
 23 | 	Singer           string `json:"singer"`
 24 | 	LyricId          string `json:"lyricId"`
 25 | 	Type             int    `json:"type"`
 26 | 	MusicUri         string `json:"musicUri"`
 27 | 	MusicDownloadUri string `json:"musicDownloadUri"`
 28 | 	LyricUri         string `json:"lyricUri"`
 29 | 	CoverUri         string `json:"coverUri"`
 30 | 	FilePath         string `json:"-"`
 31 | }
 32 | 
 33 | // Response defines API response structure
 34 | type Response struct {
 35 | 	Code int     `json:"code"`
 36 | 	Msg  string  `json:"msg"`
 37 | 	Data []Music `json:"data"`
 38 | }
 39 | 
 40 | var musicList []Music
 41 | var musicIdMap = make(map[string]Music)
 42 | var musicExtMap = map[string]bool{
 43 | 	".flac": true,
 44 | 	".mp3":  true,
 45 | 	".wav":  true,
 46 | 	".aac":  true,
 47 | }
 48 | 
 49 | func main() {
 50 | 	var (
 51 | 		portFlag string
 52 | 		dirFlag  string
 53 | 	)
 54 | 
 55 | 	flag.StringVar(&portFlag, "p", "8080", "Specify the port for service monitoring")
 56 | 	flag.StringVar(&dirFlag, "d", "", "Specify the directory where the music file resides")
 57 | 	flag.Parse()
 58 | 
 59 | 	if dirFlag == "" {
 60 | 		log.Fatal("A directory must be specified through -d")
 61 | 	}
 62 | 
 63 | 	path := dirFlag
 64 | 
 65 | 	err := filepath.Walk(path, func(filePath string, info os.FileInfo, err error) error {
 66 | 		if err != nil {
 67 | 			return err
 68 | 		}
 69 | 
 70 | 		// If it is a file and the extension matches
 71 | 		if !info.IsDir() {
 72 | 			ext := strings.ToLower(filepath.Ext(filePath))
 73 | 			if musicExtMap[ext] {
 74 | 				processMusicFile(filePath)
 75 | 			}
 76 | 		}
 77 | 
 78 | 		return nil
 79 | 	})
 80 | 
 81 | 	if err != nil {
 82 | 		log.Printf("An error occurred while traversing the directory %s: %v\n", path, err)
 83 | 	}
 84 | 
 85 | 	// HTTP routing
 86 | 	http.HandleFunc("/music", musicHandler)
 87 | 	http.HandleFunc("/music/file/download/", musicFileDownloadHandler)
 88 | 	http.HandleFunc("/music/file/", musicFileHandler)
 89 | 	http.HandleFunc("/music/lyric/", lyricHandler)
 90 | 	http.HandleFunc("/music/cover/", coverHandler)
 91 | 
 92 | 	// Start HTTP service
 93 | 	log.Printf("The service has been started and is listening :%s\n", portFlag)
 94 | 	log.Fatal(http.ListenAndServe(":"+portFlag, nil))
 95 | }
 96 | 
 97 | func generateIDByHash(filePath string) (string, error) {
 98 | 	f, err := os.Open(filePath)
 99 | 	if err != nil {
100 | 		return "", err
101 | 	}
102 | 	defer f.Close()
103 | 
104 | 	hash := sha256.New()
105 | 	if _, err := io.Copy(hash, f); err != nil {
106 | 		return "", err
107 | 	}
108 | 
109 | 	return fmt.Sprintf("%x", hash.Sum(nil)), nil
110 | }
111 | 
112 | func processMusicFile(filePath string) {
113 | 	f, err := os.Open(filePath)
114 | 	if err != nil {
115 | 		log.Printf("Unable to open the file: %v\n", err)
116 | 		return
117 | 	}
118 | 	m, err := tag.ReadFrom(f)
119 | 	if err != nil {
120 | 		log.Printf("Failed to read the tag: %v\n", err)
121 | 		return
122 | 	}
123 | 
124 | 	musicId, err := generateIDByHash(filePath)
125 | 	if err != nil {
126 | 		log.Fatalf("Unable to generate music id: %v\n", err)
127 | 		return
128 | 	}
129 | 	// Building music objects
130 | 	music := Music{
131 | 		MusicId:  musicId,
132 | 		Name:     m.Title(),
133 | 		Singer:   m.Artist(),
134 | 		LyricId:  musicId,
135 | 		Type:     determineMusicType(filePath),
136 | 		FilePath: filePath,
137 | 	}
138 | 
139 | 	musicList = append(musicList, music)
140 | 	musicIdMap[musicId] = music
141 | }
142 | 
143 | func determineMusicType(filename string) int {
144 | 	ext := strings.ToLower(filepath.Ext(filename))
145 | 	switch ext {
146 | 	case ".flac":
147 | 		return 1
148 | 	case ".mp3":
149 | 		return 2
150 | 	case ".wav":
151 | 		return 3
152 | 	case ".aac":
153 | 		return 4
154 | 	default:
155 | 		return 0
156 | 	}
157 | }
158 | 
159 | func musicHandler(w http.ResponseWriter, r *http.Request) {
160 | 	w.Header().Set("Access-Control-Allow-Origin", "*")
161 | 	for i := range musicList {
162 | 		music := &musicList[i]
163 | 		music.MusicUri = fmt.Sprintf("http://%s/music/file/%s", r.Host, music.MusicId)
164 | 		music.CoverUri = fmt.Sprintf("http://%s/music/cover/%s", r.Host, music.MusicId)
165 | 		music.LyricUri = fmt.Sprintf("http://%s/music/lyric/%s", r.Host, music.MusicId)
166 | 		music.MusicDownloadUri = fmt.Sprintf("http://%s/music/file/download/%s", r.Host, music.MusicId)
167 | 	}
168 | 	response := Response{
169 | 		Code: 200,
170 | 		Msg:  "查询成功",
171 | 		Data: musicList,
172 | 	}
173 | 
174 | 	w.Header().Set("Content-Type", "application/json")
175 | 	json.NewEncoder(w).Encode(response)
176 | }
177 | 
178 | func getContentTypeByMusicType(musicType int) string {
179 | 	switch musicType {
180 | 	case 1: // FLAC
181 | 		return "audio/flac"
182 | 	case 2: // MP3
183 | 		return "audio/mpeg"
184 | 	case 3: // WAV
185 | 		return "audio/wav"
186 | 	case 4: // AAC
187 | 		return "audio/aac"
188 | 	default:
189 | 		return "application/octet-stream"
190 | 	}
191 | }
192 | 
193 | func musicFileHandler(w http.ResponseWriter, r *http.Request) {
194 | 	musicId := strings.TrimPrefix(r.URL.Path, "/music/file/")
195 | 	if val, ok := musicIdMap[musicId]; ok {
196 | 		filePath := val.FilePath
197 | 		f, err := os.Open(filePath)
198 | 		if err != nil {
199 | 			http.NotFound(w, r)
200 | 			return
201 | 		}
202 | 		defer f.Close()
203 | 
204 | 		w.Header().Set("Cache-Control", "no-cache, no-store, must-revalidate")
205 | 		w.Header().Set("Pragma", "no-cache")
206 | 		w.Header().Set("Expires", "0")
207 | 
208 | 		var contentType = getContentTypeByMusicType(val.Type)
209 | 		w.Header().Set("Content-Type", contentType)
210 | 
211 | 		filename := filepath.Base(filePath)
212 | 		encodedFilename := url.PathEscape(filename)
213 | 		headerValue := fmt.Sprintf("inline; filename=\"%s\"; filename*=UTF-8''%s", filename, encodedFilename)
214 | 		w.Header().Set("Content-Disposition", headerValue)
215 | 
216 | 		modTime := time.Time{}
217 | 		http.ServeContent(w, r, filename, modTime, f)
218 | 	} else {
219 | 		http.NotFound(w, r)
220 | 	}
221 | }
222 | 
223 | func musicFileDownloadHandler(w http.ResponseWriter, r *http.Request) {
224 | 	musicId := strings.TrimPrefix(r.URL.Path, "/music/file/download/")
225 | 	music, ok := musicIdMap[musicId]
226 | 	if !ok {
227 | 		http.NotFound(w, r)
228 | 		return
229 | 	}
230 | 
231 | 	filename := filepath.Base(music.FilePath)
232 | 	encodedFilename := url.PathEscape(filename)
233 | 	headerValue := fmt.Sprintf("attachment; filename=\"%s\"; filename*=UTF-8''%s", filename, encodedFilename)
234 | 	w.Header().Set("Content-Disposition", headerValue)
235 | 
236 | 	http.ServeFile(w, r, music.FilePath)
237 | }
238 | 
239 | func lyricHandler(w http.ResponseWriter, r *http.Request) {
240 | 	musicId := strings.TrimPrefix(r.URL.Path, "/music/lyric/")
241 | 	if val, ok := musicIdMap[musicId]; ok {
242 | 		lyricPath := strings.TrimSuffix(val.FilePath, filepath.Ext(val.FilePath)) + ".lrc"
243 | 
244 | 		if _, err := os.Stat(lyricPath); err == nil {
245 | 			f, err := os.Open(lyricPath)
246 | 			if err != nil {
247 | 				http.NotFound(w, r)
248 | 				return
249 | 			}
250 | 			defer f.Close()
251 | 
252 | 			w.Header().Set("Content-Type", "text/plain; charset=utf-8")
253 | 			w.Header().Set("Cache-Control", "no-cache, no-store, must-revalidate")
254 | 			w.Header().Set("Pragma", "no-cache")
255 | 			w.Header().Set("Expires", "0")
256 | 
257 | 			filename := filepath.Base(lyricPath)
258 | 			modTime := time.Time{}
259 | 			http.ServeContent(w, r, filename, modTime, f)
260 | 		} else {
261 | 			http.NotFound(w, r)
262 | 		}
263 | 	} else {
264 | 		http.NotFound(w, r)
265 | 	}
266 | }
267 | 
268 | func extractCover(filePath string) ([]byte, string, error) {
269 | 	f, err := os.Open(filePath)
270 | 	if err != nil {
271 | 		return nil, "", err
272 | 	}
273 | 	defer f.Close()
274 | 
275 | 	m, err := tag.ReadFrom(f)
276 | 	if err != nil {
277 | 		return nil, "", err
278 | 	}
279 | 
280 | 	pic := m.Picture()
281 | 	if pic == nil {
282 | 		return nil, "", fmt.Errorf("NO COVER")
283 | 	}
284 | 
285 | 	return pic.Data, pic.MIMEType, nil
286 | }
287 | 
288 | func coverHandler(w http.ResponseWriter, r *http.Request) {
289 | 	musicId := strings.TrimPrefix(r.URL.Path, "/music/cover/")
290 | 	if val, ok := musicIdMap[musicId]; ok {
291 | 		coverData, mimeType, err := extractCover(val.FilePath)
292 | 		if err != nil {
293 | 			http.Error(w, "Cover not found", http.StatusNotFound)
294 | 			return
295 | 		}
296 | 
297 | 		w.Header().Set("Content-Type", mimeType)
298 | 		w.Write(coverData)
299 | 	} else {
300 | 		http.NotFound(w, r)
301 | 	}
302 | }
303 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "{}"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright 2025 itning
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.


--------------------------------------------------------------------------------