spotifify 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## [0.1.1](https://github.com/FYWinds/Spotifify/compare/v0.1.0...v0.1.1) (2026-09-05)
+
+
+### Features
+
+* **release:** npm package and compressed archives ([ce7712d](https://github.com/FYWinds/Spotifify/commit/ce7712d6c1c06c9fe5272e4d7741f7bf86e40000))
+
+
+### Bug Fixes
+
+* **netease:** create anonymous_token before lib loads ([908b266](https://github.com/FYWinds/Spotifify/commit/908b266a327aeb2ee58ebf18b377748a72947168))
+
+
+### Documentation
+
+* AI authorship note and usage disclaimer ([bdf6890](https://github.com/FYWinds/Spotifify/commit/bdf6890b486bc63135ad7a96a2ce6464b201250f))
+
+## [0.1.0](https://github.com/FYWinds/Spotifify/releases/tag/v0.1.0) (2026-09-04)
+
+### Features
+
+* **sources:** NetEase Cloud Music playlists and "Liked Music" via QR or cookie login, with include/exclude filters
+* **sources:** local library scanning with in-memory `.ncm` decryption and NetEase-id recovery from `.ncm` headers and `163 key` comment tags
+* **match:** tiered matching (ISRC → field search → free text → artist aliases → title), CJK/Traditional normalization, duration checks, confidence scoring, optional AcoustID fingerprinting
+* **match:** search cache, per-run search budget and persisted rate-limit deadline for Development-mode `/search` quotas
+* **match:** `aliases` command mines `matching.artist_aliases` from confirmed matches
+* **sync:** idempotent plan (`desired − remote`), LIS-based reordering, foreign items preserved, `--prune` for removals, Liked Songs reconciliation
+* **export:** unmatched tracks transcoded/copied into the Spotify Local Files folder with canonical tags and the desktop client's exact `spotify:local:…:{duration}` identity; atomic placement so the client never indexes a half-written file
+* **tui:** Ink review UI with custom search, paste, browser open and undo
+* **cli:** `init --upgrade`, `doctor`, `auth`, `sync`, `review`, `status`, `unmatched`, `aliases`, `pending --copy`, `rematch`, `export`, `task install|uninstall`
+* **build:** single-binary compile via `bun build --compile`, Windows Task Scheduler registration script

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FYWinds
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# Spotifify
+
+[![CI](https://github.com/FYWinds/Spotifify/actions/workflows/ci.yml/badge.svg)](https://github.com/FYWinds/Spotifify/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/FYWinds/Spotifify?sort=semver)](https://github.com/FYWinds/Spotifify/releases)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+English | [简体中文](README.zh-CN.md)
+
+Idempotent, schedulable sync of **NetEase Cloud Music playlists** and a **local music library** (including `.ncm`) to **Spotify**. Tracks that exist on Spotify are matched and mirrored into playlists (and Liked Songs); everything else is exported as Spotify desktop *local files* with ready-to-paste URIs.
+
+> **Written by an AI.** This project was produced by an AI coding agent under human direction and has been exercised against one real account. **Use it with care:** it writes to your Spotify library, so start with `sync --dry-run`, leave `--prune` off until you trust the plan, and back up anything you cannot re-create. Provided as-is, without warranty ([MIT](LICENSE)).
+
+```
+NetEase playlists ─┐                 ┌─ match ─► spotify:track:…  ─► mirrored playlists + Liked Songs
+                   ├─ canonical keys ┤
+Local library ─────┘  (netease id /  └─ unmatched ─► ffmpeg export ─► spotify:local:… (paste once)
+   .ncm / mp3 / flac   isrc / hash)
+```
+
+## Features
+
+- **Sources**: NetEase Cloud Music (QR or cookie login; own playlists + "Liked Music", include/exclude filters) and local folders (`mp3 flac m4a ogg wav ncm`). `.ncm` files are decrypted in memory; the NetEase id embedded in `.ncm` headers and in `163 key` comment tags lets a local file stand in for the same song in a NetEase playlist.
+- **Tiered matching**: ISRC → field-restricted search → free text → artist aliases → title only, with CJK/Traditional-Chinese normalization, duration checks and a confidence score. Low-confidence hits go to an interactive **review TUI** (`spotifify review`); optional AcoustID fingerprinting.
+- **Idempotent sync**: the remote state is re-fetched on every run and the plan is `desired − remote`. Second run with no changes = zero write requests. Source order is enforced with minimal moves (LIS); items you added by hand are kept at the tail; tool-added items that left the source are only removed with `--prune`.
+- **Local files that actually play**: unmatched tracks are transcoded/copied into your Spotify *Local Files* folder with canonical tags, and the tool emits the exact `spotify:local:{artist}:{album}:{title}:{duration}` identity the desktop client computes — including the duration arithmetic the client uses, which is *not* what ffprobe reports. Paste the URIs once; later runs recognise, reorder and prune those entries like any other.
+- **Rate-limit aware**: Development-mode Spotify apps have a daily `/search` quota. Searches are cached, budgeted per run and a long `429` stops the match phase (persisted deadline) instead of sleeping; playlist writes still happen for what is already matched.
+- **Single binary** (`bun build --compile`) and a Windows Task Scheduler helper for nightly runs.
+
+## Install
+
+| Method | Command |
+|---|---|
+| Release archive | Download `spotifify-<platform>.zip` / `.tar.xz` from [Releases](https://github.com/FYWinds/Spotifify/releases), unpack, put `spotifify` on `PATH`. |
+| npm (needs [Bun](https://bun.sh) ≥ 1.2) | `bun install -g spotifify` — or one-off: `bunx spotifify sync --dry-run` |
+| From source | `git clone https://github.com/FYWinds/Spotifify && cd Spotifify && bun install`, then `bun run spotifify …` |
+
+Also needed:
+
+- `ffmpeg` on `PATH` (exports/transcoding). `fpcalc` only if you enable fingerprinting.
+- A Spotify app from the [Developer Dashboard](https://developer.spotify.com/dashboard): add the Redirect URI `http://127.0.0.1:8765/callback` (port = `spotify.redirect_port`). Only the Client ID is needed (Authorization Code + PKCE).
+- The Spotify **desktop** client for local files (playing them on mobile needs Premium and the same Wi‑Fi network; see below).
+
+The binaries embed the Bun runtime (~70–90 MB unpacked); the archives are what keep downloads small — UPX-style executable packers break Bun's embedded module graph, so they are not used.
+
+## Quick start
+
+```sh
+spotifify init                 # writes ~/.spotifify/config.toml
+#   edit: spotify.client_id, netease.include_playlists, local.dirs, export.dir
+spotifify auth spotify         # opens the browser (PKCE)
+spotifify auth netease         # QR code in the terminal, or --cookie "MUSIC_U=…"
+spotifify doctor               # config / db / ffmpeg / auth checks
+spotifify sync --dry-run       # prints the plan
+spotifify sync
+spotifify pending --copy       # local-file URIs → clipboard; paste into the playlist in Spotify desktop
+spotifify review               # resolve low-confidence matches
+```
+
+From a source checkout use `bun run spotifify …` instead of `spotifify …`.
+
+State lives in `~/.spotifify` (`config.toml`, `state.db`, logs); override with `--state-dir` or `SPOTIFIFY_STATE_DIR`.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `init [--force\|--upgrade]` | Write the config template; `--upgrade` merges options added in newer versions into your file (values kept, `.bak` written). |
+| `doctor` | Check config, state db, `ffmpeg`/`fpcalc`, token scopes, search-quota deadline. |
+| `auth spotify` / `auth netease [--cookie …]` | Log in. |
+| `sync [--dry-run] [--prune] [--source netease\|local] [--playlist NAME] [--skip-match]` | Pull → match → export → plan → apply → report. Exit code `3` = re-authenticate. |
+| `review` | Ink TUI: `j/k` move, `1-9`/`Enter` pick a candidate, `/` custom search, `p` paste a Spotify URL/URI, `o`/`O` open candidate/source in the browser, `l` keep as local file, `s` skip, `u` undo, `?` help. |
+| `status` | Match counts, playlist mappings, last run. |
+| `unmatched [--status local\|review\|all] [--tsv]` | Tracks without a Spotify match and the local file that backs them. |
+| `aliases [--apply] [--min N]` | Mine `matching.artist_aliases` (e.g. `"陈奕迅" = "Eason Chan"`) from confirmed matches. |
+| `pending [--copy] [--playlist NAME]` | Local-file URIs still to be pasted, from the last sync. |
+| `rematch <key…> \| --all-local` | Forget match decisions so the next sync searches again. |
+| `export [--force]` | Run only the export step. |
+| `task install [--time HH:mm] [--exe PATH]` / `task uninstall` | Register a daily Windows Scheduled Task (`scripts/register-task.ps1`). |
+
+Global options: `--config`, `--state-dir`, `--log-file`, `--verbose`.
+
+## How local files work
+
+Spotify's Web API cannot *add* a local file to a playlist, but it can read, reorder and remove local entries that are already there. So the loop is:
+
+1. `sync` exports every unmatched track that has a local source into `export.dir` (`{artist} - {title}.mp3|m4a`, canonical tags, cover art). Files are written under a temporary name and then placed atomically, because the desktop client indexes a file the moment its directory entry appears and never re-reads it.
+2. `pending --copy` puts the URIs on the clipboard; open the playlist in Spotify desktop and press Ctrl+V once.
+3. The next `sync` sees those entries, matches them to the export records (duration included), and from then on orders and prunes them like normal tracks.
+
+If pasted entries stay grey ("can't play this right now"), restart the desktop client or toggle the folder off/on under *Settings → Local Files* so its index is rebuilt. Playing local files on a phone: Premium, same Wi‑Fi as the desktop client, then *Download* the playlist on the phone.
+
+Set `local.mirror_playlist = false` if you only want local files to supply audio for NetEase playlists rather than mirroring the whole folder as its own playlist.
+
+## Configuration
+
+`spotifify init` writes an annotated template; see [`config.example.toml`](config.example.toml). Highlights:
+
+| Key | Notes |
+|---|---|
+| `spotify.market` | `"from_token"` (account country) or an ISO code. Tracks not playable in that market count as unmatched. |
+| `netease.include_playlists` | Playlist names/ids; the special value `"liked"` selects "Liked Music". Empty = all own playlists. |
+| `local.dirs`, `local.extensions`, `local.filename_pattern` | Folders to scan; tag-less files fall back to `artist-title` / `title-artist` filename parsing. |
+| `export.dir`, `export.bitrate` | Your Spotify Local Files folder; non-mp3/m4a sources are encoded with `libmp3lame`. |
+| `matching.auto_threshold`, `review_threshold` | Score cut-offs for auto-accept and review queue. |
+| `matching.max_searches_per_run`, `max_queries_per_track`, `search_concurrency`, `search_min_interval_ms` | Search budget (Development-mode quota protection). |
+| `matching.artist_aliases` | `"周杰倫" = "周杰伦"` style table; `spotifify aliases --apply` fills it. |
+| `sync.playlist_prefix` | Prefix for playlists created on Spotify. |
+
+## Scheduling
+
+```powershell
+spotifify task install --time 03:00            # from a checkout: runs `bun run src/cli.ts sync`; from npm: the installed package
+spotifify task install --exe D:\tools\spotifify.exe
+```
+
+Runs are serialised by a pid lock (`sync.lock`); Ctrl+C releases it. On other platforms use cron with `spotifify sync --log-file …`.
+
+## Development
+
+```sh
+bun install
+bun run typecheck      # tsc --noEmit
+bun test               # unit + end-to-end (e2e needs ffmpeg; skipped otherwise)
+bun run build          # dist/spotifify (add --target bun-linux-x64 etc. to cross-compile)
+```
+
+The design document is [`DESIGN.md`](DESIGN.md) (Chinese). Commits follow [Conventional Commits](https://www.conventionalcommits.org/); [release-please](https://github.com/googleapis/release-please) turns them into the changelog, the semver tag and a GitHub Release with binaries for Windows, Linux and macOS.
+
+## License
+
+[MIT](LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,131 @@
+# Spotifify
+
+[![CI](https://github.com/FYWinds/Spotifify/actions/workflows/ci.yml/badge.svg)](https://github.com/FYWinds/Spotifify/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/FYWinds/Spotifify?sort=semver)](https://github.com/FYWinds/Spotifify/releases)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[English](README.md) | 简体中文
+
+把**网易云音乐歌单**和**本地音乐库**（含 `.ncm`）幂等地同步到 **Spotify**，可放进定时任务。Spotify 曲库里有的歌匹配后镜像成歌单（并加入"已点赞的歌曲"）；找不到的导出成 Spotify 桌面端的*本地文件*，并给出可直接粘贴的 URI。
+
+> **本项目由 AI 编写。** 代码由 AI 编程代理在人工指导下完成，只在一个真实账号上实测过。**请谨慎使用：** 它会写入你的 Spotify 曲库，先用 `sync --dry-run` 看计划，确认无误前不要开 `--prune`，无法重建的数据请先备份。按现状提供，不做任何担保（[MIT](LICENSE)）。
+
+```
+网易云歌单 ────┐                 ┌─ 匹配 ─► spotify:track:…  ─► 镜像歌单 + 已点赞的歌曲
+              ├─ 规范键 ────────┤
+本地音乐库 ────┘ (网易云 id /   └─ 未匹配 ─► ffmpeg 导出 ─► spotify:local:…（粘贴一次）
+ .ncm/mp3/flac   isrc / 哈希)
+```
+
+## 功能
+
+- **来源**：网易云音乐（扫码或 Cookie 登录；自建歌单 + "我喜欢的音乐"，支持白名单/黑名单）和本地目录（`mp3 flac m4a ogg wav ncm`）。`.ncm` 在内存中解密；`.ncm` 头部和 `163 key` 注释里的网易云 id 让本地文件能顶替网易云歌单里的同一首歌。
+- **分层匹配**：ISRC → 字段限定搜索 → 自由文本 → 艺人别名 → 纯标题，带 CJK / 繁简归一化、时长校验和置信度打分。低置信度进入交互式**复核 TUI**（`spotifify review`）；可选 AcoustID 声纹。
+- **幂等同步**：每次运行重新拉取远端状态，Plan = `期望 − 远端`。无变化的第二次运行 = 零写请求。按来源顺序用最少移动（LIS）排序；你手动加的歌留在尾部；工具加的、已从来源消失的歌只在 `--prune` 时删除。
+- **真正能播的本地文件**：未匹配的歌转码/复制到你的 Spotify *本地文件* 目录，写规范 tag，并生成桌面端自己算出的那个身份 `spotify:local:{艺人}:{专辑}:{标题}:{时长}`——包括客户端的整秒时长算法（和 ffprobe 的结果并不一样）。粘贴一次，之后的运行会像普通歌曲一样识别、排序、清理这些条目。
+- **懂配额**：Development Mode 的 Spotify 应用 `/search` 有每日配额。搜索有缓存、每次运行有预算，遇到长时间 `429` 直接停止匹配阶段（截止时间持久化）而不是干等；已匹配的部分照常写入歌单。
+- **单文件二进制**（`bun build --compile`）和 Windows 任务计划注册脚本。
+
+## 安装
+
+| 方式 | 命令 |
+|---|---|
+| Release 压缩包 | 从 [Releases](https://github.com/FYWinds/Spotifify/releases) 下载 `spotifify-<平台>.zip` / `.tar.xz`，解压后把 `spotifify` 放进 `PATH`。 |
+| npm（需要 [Bun](https://bun.sh) ≥ 1.2） | `bun install -g spotifify`，或一次性运行：`bunx spotifify sync --dry-run` |
+| 源码 | `git clone https://github.com/FYWinds/Spotifify && cd Spotifify && bun install`，然后 `bun run spotifify …` |
+
+另外需要：
+
+- `ffmpeg` 在 `PATH` 里（导出/转码）。只有开启声纹时才需要 `fpcalc`。
+- 在 [Spotify Developer Dashboard](https://developer.spotify.com/dashboard) 建一个应用，Redirect URI 填 `http://127.0.0.1:8765/callback`（端口 = `spotify.redirect_port`）。只需要 Client ID（Authorization Code + PKCE）。
+- 本地文件需要 Spotify **桌面端**（手机上播放需要 Premium 且和桌面端在同一 Wi‑Fi，见下文）。
+
+二进制内嵌了 Bun 运行时（解压后约 70–90 MB），靠压缩包控制下载体积——UPX 这类可执行文件压缩器会破坏 Bun 内嵌的模块图，所以没有使用。
+
+## 快速开始
+
+```sh
+spotifify init                 # 生成 ~/.spotifify/config.toml
+#   编辑：spotify.client_id、netease.include_playlists、local.dirs、export.dir
+spotifify auth spotify         # 打开浏览器登录（PKCE）
+spotifify auth netease         # 终端扫码，或 --cookie "MUSIC_U=…"
+spotifify doctor               # 检查配置 / 数据库 / ffmpeg / 登录状态
+spotifify sync --dry-run       # 只打印计划
+spotifify sync
+spotifify pending --copy       # 本地文件 URI 进剪贴板；到 Spotify 桌面端对应歌单里粘贴
+spotifify review               # 处理低置信度匹配
+```
+
+源码方式把 `spotifify …` 换成 `bun run spotifify …`。
+
+状态目录是 `~/.spotifify`（`config.toml`、`state.db`、日志）；可用 `--state-dir` 或 `SPOTIFIFY_STATE_DIR` 覆盖。
+
+## 命令
+
+| 命令 | 作用 |
+|---|---|
+| `init [--force\|--upgrade]` | 写配置模板；`--upgrade` 把新版本新增的选项合并进现有文件（保留原值，写 `.bak`）。 |
+| `doctor` | 检查配置、状态库、`ffmpeg`/`fpcalc`、token scope、搜索配额截止时间。 |
+| `auth spotify` / `auth netease [--cookie …]` | 登录。 |
+| `sync [--dry-run] [--prune] [--source netease\|local] [--playlist 名称] [--skip-match]` | 拉取 → 匹配 → 导出 → 计划 → 执行 → 报告。退出码 `3` = 需要重新登录。 |
+| `review` | Ink TUI：`j/k` 移动，`1-9`/`Enter` 选候选，`/` 自定义搜索，`p` 粘贴 Spotify 链接/URI，`o`/`O` 在浏览器打开候选/来源，`l` 保持为本地文件，`s` 跳过，`u` 撤销，`?` 帮助。 |
+| `status` | 匹配统计、歌单映射、上次运行。 |
+| `unmatched [--status local\|review\|all] [--tsv]` | 没有 Spotify 匹配的歌以及对应的本地文件。 |
+| `aliases [--apply] [--min N]` | 从已确认的匹配里挖 `matching.artist_aliases`（例如 `"陈奕迅" = "Eason Chan"`）。 |
+| `pending [--copy] [--playlist 名称]` | 上次 sync 之后仍待粘贴的本地文件 URI。 |
+| `rematch <key…> \| --all-local` | 忘掉匹配决策，下次 sync 重新搜索。 |
+| `export [--force]` | 只跑导出阶段。 |
+| `task install [--time HH:mm] [--exe 路径]` / `task uninstall` | 注册每日 Windows 任务计划（`scripts/register-task.ps1`）。 |
+
+全局选项：`--config`、`--state-dir`、`--log-file`、`--verbose`。
+
+## 本地文件是怎么工作的
+
+Spotify Web API 不能把本地文件*加入*歌单，但能读取、重排、删除已经在歌单里的本地条目。所以流程是：
+
+1. `sync` 把每首有本地来源的未匹配歌导出到 `export.dir`（`{艺人} - {标题}.mp3|m4a`，规范 tag，封面）。文件先写到临时名再原子落位，因为桌面端在目录项出现的那一刻就会索引文件，之后不再重读。
+2. `pending --copy` 把 URI 放进剪贴板；在 Spotify 桌面端打开歌单按一次 Ctrl+V。
+3. 下一次 `sync` 看到这些条目，按导出记录（含时长）对上号，之后就和普通歌曲一样排序和清理。
+
+如果粘贴的条目一直是灰的（"can't play this right now"），重启桌面端，或者在 *设置 → 本地文件* 里把目录关掉再打开让它重建索引。手机上播放本地文件：Premium，和桌面端在同一 Wi‑Fi，然后在手机上*下载*该歌单。
+
+如果只想让本地文件给网易云歌单里没匹配上的歌提供音频、而不是把整个目录镜像成一个歌单，设置 `local.mirror_playlist = false`。
+
+## 配置
+
+`spotifify init` 会生成带注释的模板，见 [`config.example.toml`](config.example.toml)。要点：
+
+| 键 | 说明 |
+|---|---|
+| `spotify.market` | `"from_token"`（账号所在国家）或 ISO 国家码。该地区不可播放的歌视为未匹配。 |
+| `netease.include_playlists` | 歌单名/ id；特殊值 `"liked"` 表示"我喜欢的音乐"。空 = 全部自建歌单。 |
+| `local.dirs`、`local.extensions`、`local.filename_pattern` | 扫描目录；无 tag 的文件按 `artist-title` / `title-artist` 解析文件名。 |
+| `export.dir`、`export.bitrate` | 你的 Spotify 本地文件目录；非 mp3/m4a 来源用 `libmp3lame` 编码。 |
+| `matching.auto_threshold`、`review_threshold` | 自动接受 / 进复核队列的分数阈值。 |
+| `matching.max_searches_per_run`、`max_queries_per_track`、`search_concurrency`、`search_min_interval_ms` | 搜索预算（Development Mode 配额保护）。 |
+| `matching.artist_aliases` | `"周杰倫" = "周杰伦"` 形式的别名表；`spotifify aliases --apply` 会自动填。 |
+| `sync.playlist_prefix` | 在 Spotify 上创建的歌单名前缀。 |
+
+## 定时运行
+
+```powershell
+spotifify task install --time 03:00            # 源码方式：跑 `bun run src/cli.ts sync`；npm 方式：跑安装好的包
+spotifify task install --exe D:\tools\spotifify.exe
+```
+
+运行之间用 pid 锁（`sync.lock`）串行化；Ctrl+C 会释放锁。其他平台用 cron 跑 `spotifify sync --log-file …`。
+
+## 开发
+
+```sh
+bun install
+bun run typecheck      # tsc --noEmit
+bun test               # 单元 + 端到端（e2e 需要 ffmpeg，缺失时跳过）
+bun run build          # dist/spotifify（加 --target bun-linux-x64 等可交叉编译）
+```
+
+设计文档见 [`DESIGN.md`](DESIGN.md)。提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/)；[release-please](https://github.com/googleapis/release-please) 据此生成 changelog、semver tag 和带 Windows / Linux / macOS 二进制的 GitHub Release。
+
+## 许可证
+
+[MIT](LICENSE)

package/config.example.toml

@@ -0,0 +1,61 @@
+# Spotifify 配置模板。`spotifify init` 会把它写到 ~/.spotifify/config.toml
+
+[spotify]
+# Spotify Developer Dashboard 创建的 app 的 Client ID（PKCE，无需 secret）
+# Redirect URI 必须填 http://127.0.0.1:8765/callback（端口与 redirect_port 一致）
+client_id = ""
+redirect_port = 8765
+# "from_token" = 账号所在国家；也可写 "US" / "JP" 等
+market = "from_token"
+
+[netease]
+enabled = true
+# 是否同步"我喜欢的音乐"
+include_liked = true
+# 白名单：只同步这些歌单（歌单名、歌单 id，或 "liked" 代表"我喜欢的音乐"）；空 = 全部自建歌单
+include_playlists = []
+# 按歌单名或 id 排除
+exclude_playlists = []
+# 匹配到的歌曲同时加入 Liked Songs
+like_matched = true
+
+[local]
+enabled = true
+dirs = ["D:/Music"]
+playlist_name = "Local Library"
+# false = 本地文件只作为其他歌单里未匹配歌曲的音频来源（导出/粘贴路径），不再镜像成一个 Spotify 歌单
+mirror_playlist = true
+extensions = ["mp3", "flac", "m4a", "ogg", "wav", "ncm"]
+# tag 缺失时的文件名解析模式："artist-title" 或 "title-artist"
+filename_pattern = "artist-title"
+like_matched = false
+
+[export]
+# 已在 Spotify 桌面端 设置→本地文件 中添加为来源的目录
+dir = "D:/Spotify Local Files"
+ffmpeg = "ffmpeg"
+bitrate = "320k"
+
+[matching]
+auto_threshold = 0.90
+review_threshold = 0.60
+duration_tolerance_ms = 3000
+retry_unmatched_after_days = 30
+search_cache_ttl_days = 30
+# 每次运行最多发起的 Spotify 搜索请求数（缓存命中不计）；0 = 不限。Development Mode 应用有每日配额，超出会被封 24h
+max_searches_per_run = 400
+# 每首歌最多尝试的查询数（isrc / 字段限定 / 自由文本 / 别名 / 纯标题）
+max_queries_per_track = 4
+search_concurrency = 2
+search_min_interval_ms = 120
+# 声纹识别（需要 fpcalc 二进制 + AcoustID API key）
+fingerprint = false
+fpcalc = "fpcalc"
+acoustid_key = ""
+
+[matching.artist_aliases]
+# "周杰倫" = "周杰伦"
+
+[sync]
+# Spotify 端歌单名前缀，例如 "NE · "
+playlist_prefix = ""

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "spotifify",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Idempotently sync Netease Cloud Music playlists and a local music library (incl. .ncm) to Spotify",
+  "keywords": [
+    "spotify",
+    "netease",
+    "netease-cloud-music",
+    "ncm",
+    "playlist",
+    "sync",
+    "local-files",
+    "bun"
+  ],
+  "license": "MIT",
+  "author": "FYWinds <i@fywinds.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FYWinds/Spotifify.git"
+  },
+  "homepage": "https://github.com/FYWinds/Spotifify#readme",
+  "bugs": "https://github.com/FYWinds/Spotifify/issues",
+  "engines": {
+    "bun": ">=1.2"
+  },
+  "bin": {
+    "spotifify": "./src/cli.ts"
+  },
+  "files": [
+    "src",
+    "scripts/register-task.ps1",
+    "config.example.toml",
+    "README.zh-CN.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "spotifify": "bun run src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "build": "bun run scripts/build.ts"
+  },
+  "dependencies": {
+    "NeteaseCloudMusicApi": "^4.32.0",
+    "commander": "^14.0.0",
+    "fastest-levenshtein": "^1.0.16",
+    "ink": "^5.2.0",
+    "ink-text-input": "^6.0.0",
+    "music-metadata": "^11.0.0",
+    "opencc-js": "^1.0.5",
+    "qrcode-terminal": "^0.12.0",
+    "react": "^18.3.1",
+    "smol-toml": "^1.3.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/react": "^18.3.0",
+    "typescript": "^5.7.0"
+  }
+}

package/scripts/register-task.ps1

@@ -0,0 +1,43 @@
+<#
+.SYNOPSIS
+  Register (or remove) a Windows Scheduled Task that runs `spotifify sync` daily.
+
+.EXAMPLE
+  .\scripts\register-task.ps1 -Time 03:00
+  .\scripts\register-task.ps1 -Exe D:\tools\spotifify.exe -Time 03:00
+  .\scripts\register-task.ps1 -Uninstall
+#>
+[CmdletBinding()]
+param(
+  [string]$TaskName = "Spotifify Sync",
+  [string]$Time = "03:00",
+  # Path to a compiled spotifify.exe. When omitted, runs `bun run src/cli.ts` from the repo root.
+  [string]$Exe = "",
+  [string]$LogDir = (Join-Path $env:USERPROFILE ".spotifify\logs"),
+  [switch]$Uninstall
+)
+
+$ErrorActionPreference = "Stop"
+
+if ($Uninstall) {
+  Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false
+  Write-Host "removed task '$TaskName'"
+  exit 0
+}
+
+$repo = Resolve-Path (Join-Path $PSScriptRoot "..")
+New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
+$log = Join-Path $LogDir "sync-$(Get-Date -Format yyyyMMdd).log"
+
+if ($Exe) {
+  $action = New-ScheduledTaskAction -Execute $Exe -Argument "sync --log-file `"$log`"" -WorkingDirectory $repo
+} else {
+  $bun = (Get-Command bun).Source
+  $action = New-ScheduledTaskAction -Execute $bun -Argument "run src/cli.ts sync --log-file `"$log`"" -WorkingDirectory $repo
+}
+
+$trigger = New-ScheduledTaskTrigger -Daily -At $Time
+$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable -MultipleInstances IgnoreNew -ExecutionTimeLimit (New-TimeSpan -Hours 6)
+
+Register-ScheduledTask -TaskName $TaskName -Action $action -Trigger $trigger -Settings $settings -Force | Out-Null
+Write-Host "registered task '$TaskName' daily at $Time (log: $log)"