Singer Market 歌手市场

The Singer Market is a community-driven marketplace where SXSEditor users can browse, search, upload, and download .sxssinger voice profiles. It is opened from the main toolbar via the Singer Market button. The marketplace runs on a self-hosted backend (Cloudflare Workers + Backblaze B2) — see the Developer Guide for the technical architecture.

歌手市场 是一个由社区驱动的交流平台，SXSEditor 用户可以在其中浏览、搜索、上传和下载 .sxssinger 歌手声音配置文件。可通过主工具栏上的 歌手市场 按钮打开。市场后端为自托管服务（Cloudflare Workers + Backblaze B2），技术架构详见 开发者指南。

Features at a Glance 功能概览

• Browse public singers uploaded by the community, paginated 24 per page.
• 浏览 社区用户上传的公开歌手，每页 24 项分页展示。
• Search by singer name or description (debounced 350 ms).
• 按歌手名称或描述 搜索（输入防抖 350 毫秒）。
• Filter by multiple tags using AND semantics to narrow down quickly.
• 按多标签 筛选（AND 语义），快速定位目标声音。
• Upload your own .sxssinger files to share with the community (login required).
• 上传 你的 .sxssinger 文件与社区分享（需登录）。
• Download singers to your machine for use in projects.
• 下载 歌手到本地以在项目中使用。
• Ownership — every upload is bound to your account; only you (or an admin) can edit or delete your own files.
• 所有权— 每个上传都与你的账号绑定；只有你（或管理员）能修改或删除自己的文件。

Opening the Market 打开歌手市场

From the SXSEditor main window, click the Singer Market button in the toolbar. A dedicated window opens — you can keep it open alongside your project while you browse.

在 SXSEditor 主窗口中，点击工具栏上的 歌手市场 按钮。会打开一个独立窗口——你可以在浏览时让它与项目并排保持打开。

The window has three regions:

窗口分为三个区域：

1. Toolbar — auth status, login/register/logout buttons, refresh and upload buttons.工具栏— 登录状态、登录/注册/登出按钮、刷新与上传按钮。
2. Filter bar — search input, active tag chips, and a row of popular tag suggestions.筛选栏— 搜索框、已选标签 chips、热门标签建议行。
3. Grid + pagination — singer cards (avatar, name, size, date, description, tags) with prev/next paging.网格 + 分页— 歌手卡片（头像、名称、大小、日期、描述、标签），支持上一页/下一页。

Accounts & Login 账号与登录

You can browse, search, and download public singers without an account. An account is only required to upload. To register:

你无需账号即可浏览、搜索和下载公开歌手。仅在需要上传时才要求登录。注册流程：

1. Click Register in the toolbar.点击工具栏的 注册 按钮。
2. Pick a username and password (the password is hashed with PBKDF2-SHA256 on the server, never stored in plain text).填写用户名和密码（密码在服务端用 PBKDF2-SHA256 哈希，绝不以明文存储）。
3. Submit — you are auto-logged-in and the toolbar updates to show your username.提交后即自动登录，工具栏显示你的用户名。

Returning users click Login and enter the same credentials. Self-registration can be disabled by the server admin; in that case accounts must be created for you by an admin.

已注册用户点击 登录 并输入相同凭据。服务端管理员可关闭自助注册；此时账号需由管理员为你创建。

Browsing, Searching & Filtering 浏览、搜索与筛选

The grid shows public singers in pages of 24. Use the filter bar to find what you need:

网格以每页 24 项展示公开歌手。使用筛选栏定位目标：

Viewing & Downloading a Singer 查看与下载歌手

Click any singer card to open the detail dialog. It shows the full metadata — name, size, upload date, owner, visibility, all tags, and the full description. Review the information, then click Download:

点击任意歌手卡片打开详情对话框。它会展示完整元数据——名称、大小、上传日期、所有者、可见性、全部标签及完整描述。核对信息后点击 下载：

1. A native save dialog opens with the singer's filename pre-filled (you can rename it).弹出原生保存对话框，文件名已预填（可重命名）。
2. The file bytes are streamed from the backend and written to the path you chose.文件字节从后端流式传输并写入你选择的路径。
3. A toast confirms the saved path. The downloaded .sxssinger can be loaded into the Singer Creator or imported into a project.Toast 提示已保存路径。下载的 .sxssinger 可在歌手创建器中加载或导入项目使用。

Uploading a Singer 上传歌手

You must be logged in to upload. Once logged in, the Upload button appears in the toolbar. The upload dialog lets you:

上传需先登录。登录后工具栏会出现 上传 按钮。上传对话框允许你：

• Pick a file — click the drop area or drag a .sxssinger file onto it. Only the .sxssinger extension is accepted.
• 选择文件— 点击拖放区域或将 .sxssinger 文件拖入。仅接受 .sxssinger 扩展名。
• Singer name — auto-detected from the singerName field inside the file; falls back to the filename if absent.
• 歌手名称— 自动从文件内的 singerName 字段读取；缺失时回退为文件名。
• Description — free text shown in the card and detail dialog.
• 描述— 自由文本，显示在卡片与详情对话框中。
• Tags — comma-separated (e.g. vocal, female, pop). Used by the search and filter.
• 标签— 逗号分隔（如 vocal, female, pop）。用于搜索与筛选。
• Visibility — public (default, anyone can browse/download) or private (only you and admins can see it).
• 可见性— public（默认，任何人可浏览/下载）或 private（仅你和管理员可见）。

Click Upload to submit. The file is streamed from disk through the main process to the backend, so large .sxssinger files (multi-megabyte) work without loading the entire file into renderer memory. A success toast appears when the upload completes, and the list refreshes automatically.

点击 上传 提交。文件从磁盘经由主进程流式传输到后端，因此大型 .sxssinger 文件（数 MB）也无需将整个文件载入渲染进程内存。上传完成后弹出成功提示，列表自动刷新。

Managing Your Uploads 管理你的上传

Every file you upload is bound to your account. The ownership model is:

你上传的每个文件都与你的账号绑定。所有权模型如下：

• You can read, edit metadata (description, visibility, tags), and delete your own files.
• 你可以读取、修改元数据（描述、可见性、标签）并删除自己的文件。
• Other logged-in users can download your public files but cannot modify them.
• 其他登录用户可以下载你的公开文件，但无法修改。
• Admins can manage all files regardless of owner.
• 管理员可管理所有文件，不论所有者是谁。

Edits and deletes are performed via the backend's REST API — the SXSEditor Market window currently focuses on browse/upload/download. If you need to edit or remove an upload, ask an admin (or run the API calls directly — see the Developer Guide).

编辑与删除通过后端 REST API 完成——SXSEditor 市场窗口当前聚焦于浏览/上传/下载。若需编辑或删除自己的上传，请联系管理员（或直接调用 API，详见 开发者指南）。

Rate Limits & Quotas 速率限制与配额

The backend enforces per-IP rate limits and daily quota caps to keep the service on the Cloudflare / Backblaze free tiers. From a user's perspective, you may occasionally see these errors:

后端对每个 IP 实施速率限制与每日配额上限，以维持服务在 Cloudflare / Backblaze 免费层运行。从用户视角，你偶尔会遇到以下错误：

Under normal use these limits are essentially invisible — you would need to upload hundreds of files in a day or script thousands of requests per minute to trip them.

正常使用下这些限制几乎无感——通常需要一天内上传数百个文件或脚本化每分钟数千次请求才会触发。

Licensing & Disclaimer 许可与免责声明

When you download a singer from the market, a confirmation dialog displays the following notice:

当你从市场下载歌手时，确认对话框会显示以下声明：

This Singer file is licensed to you by its owner. SXSEditor is not responsible for, nor does it grant any licenses to, third-party singers. For details, see the Singer Market Terms of Use.

By downloading a singer, you acknowledge that the file is provided by its uploader, not by SXSEditor. SXSEditor acts only as a hosting and discovery platform and does not verify the legality, quality, or ownership of any uploaded content. In particular:

下载歌手即表示你知悉：该文件由上传者提供，而非 SXSEditor。SXSEditor 仅作为托管与发现平台，不对任何上传内容的合法性、质量或所有权进行审核。具体而言：

• Do not upload voices you do not have the right to share (e.g. copyrighted vocal recordings, voices cloned without consent).
• 请勿上传你无权分享的声音（例如受版权保护的录音、未经同意克隆的声音）。
• Treat downloaded voices as licensed to you by their uploader — respect any usage terms stated in the description.
• 下载的声音视为上传者授权给你使用——请遵守描述中注明的任何使用条款。
• If you believe a file infringes your rights, report it via the GitHub issue tracker (see below).
• 如果你认为某个文件侵犯了你的权利，请通过 GitHub Issue 报告（见下文）。

Full Disclaimer & Agreement 完整免责声明与协议

The complete and legally controlling Singer Market disclaimer, terms of use, and uploader authorization is available as a standalone document. The English version is the legally controlling version; the Chinese translation is provided for convenience only.

完整且具有法律效力的歌手市场免责声明、使用条款及上传者授权以独立文档形式提供。英文版本为具有法律效力并优先适用的版本；中文翻译仅为阅读便利而提供。

• Singer Market Terms of Use — English (Controlling) — the full English version of the Disclaimer, Terms of Use and Uploader Authorization.
• 歌手市场使用条款 — 英文版（控制版本）— 完整英文版免责声明、使用条款及上传者授权。
• Singer Market Terms of Use — Chinese (Reference Only) — Chinese translation, provided for convenience only.
• 歌手市场使用条款 — 中文版（仅供参考）— 中文翻译，仅为阅读便利而提供。

If you believe a singer file infringes your copyright or other rights, please contact the project maintainer via the GitHub issue tracker with details and we will review the report promptly.

如果你认为某个歌手文件侵犯了你的版权或其他权利，请通过 GitHub Issue 联系项目维护者并附上详细信息，我们会尽快审核处理。

Troubleshooting 常见问题排查

Login fails with “Authentication failed”登录提示 “Authentication failed”

Check the username and password. If your account was created by an admin, it may have been deactivated — ask the admin to re-enable it. If self-registration is disabled on the server, you cannot create your own account.

请核对用户名与密码。若账号由管理员创建，可能已被停用——请联系管理员重新启用。若服务端关闭了自助注册，你无法自行创建账号。

Upload fails with “Not logged in”上传提示 “Not logged in”

Your session may have expired (default 30 days). Click Logout then Login again. If the problem persists, the saved token file may be corrupt — log out, manually delete userData/singer-market-token.json, and log in fresh.

会话可能已过期（默认 30 天）。请先 登出 再 登录。若仍无效，可能是本地令牌文件损坏——登出后手动删除 userData/singer-market-token.json 再重新登录。

Upload fails with “quota_exceeded”上传提示 “quota_exceeded”

The server hit a daily free-tier safety cap. Wait until UTC midnight (counters reset) and retry. If it persists past midnight, the storage cap may be full — only an admin can free space.

服务端当日触及免费层安全上限。请等待 UTC 午夜（计数器重置）后重试。若午夜后仍失败，可能是存储上限已满——需管理员清理空间。

Download produces an empty or corrupt file下载得到空文件或损坏文件

Network hiccup or the backend's B2 object went missing. Try the download again. If it fails repeatedly, the file may have been soft-deleted by its owner — the card may still appear in the list until the next refresh.

可能是网络抖动或后端 B2 对象丢失。请重试下载。若反复失败，可能是文件已被所有者软删除——卡片在下次刷新前可能仍显示在列表中。

I can't see my own private upload in the list看不到自己上传的私有歌手

The Market window only lists public singers (it forces visibility=public on the list query). Private files are visible only via the API with your token. To see them in the Market, re-upload as public, or check them via the admin UI / API.

市场窗口仅列出 public 歌手（列表查询强制 visibility=public）。私有文件只能通过 API 携带你的令牌查看。若想在市场中看到，请重新以 public 上传，或通过管理员界面 / API 查看。