Initial import: Music_Server, MusicFree, catalog-sync

catalog-sync/.github/ISSUE_TEMPLATE/bug_report.en.yml

@@ -0,0 +1,91 @@
+name: "🐛 Bug report"
+description: "Report a reproducible bug."
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug.
+        Please fill in the information below so we can reproduce and fix it faster.
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - "S1 - Critical (crash/data loss/security)"
+        - "S2 - High (major feature broken)"
+        - "S3 - Medium (workaround exists)"
+        - "S4 - Low (minor / cosmetic)"
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Version / Commit
+      description: "Which version are you using? (e.g., v1.2.3, commit SHA)"
+      placeholder: "v1.2.3 / 1a2b3c4"
+    validations:
+      required: false
+
+  - type: textarea
+    id: what_happened
+    attributes:
+      label: What happened?
+      description: "Describe the bug clearly."
+      placeholder: "A clear and concise description..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+      placeholder: "Expected behavior..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: "Provide minimal steps to reproduce."
+      placeholder: |
+        1. Go to ...
+        2. Run ...
+        3. See error ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs / Screenshots
+      description: "Paste logs or attach screenshots if applicable."
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: env
+    attributes:
+      label: Environment
+      description: "OS / runtime / dependencies"
+      placeholder: |
+        - OS: Windows 11 / Ubuntu 22.04 / macOS 14
+        - Runtime: Python 3.11 / Node 20
+        - Package manager: pip/conda/npm
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: "I searched existing issues and did not find a duplicate."
+          required: true
+        - label: "I can reproduce this consistently."
+          required: false

catalog-sync/.github/ISSUE_TEMPLATE/bug_report.zh.yml

@@ -0,0 +1,90 @@
+name: "🐛 缺陷反馈"
+description: "报告一个可复现的 Bug。"
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢反馈！请尽量补全信息，便于我们快速复现与修复。
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: 严重程度
+      options:
+        - "S1 - 致命 (崩溃/数据丢失/安全)"
+        - "S2 - 高 (核心功能不可用)"
+        - "S3 - 中 (有替代方案)"
+        - "S4 - 低 (小问题/界面问题)"
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: 版本 / 提交号
+      description: "你使用的版本 (例如 v1.2.3 或 commit SHA)"
+      placeholder: "v1.2.3 / 1a2b3c4"
+    validations:
+      required: false
+
+  - type: textarea
+    id: what_happened
+    attributes:
+      label: 实际发生了什么？
+      description: "清晰描述 Bug 现象。"
+      placeholder: "现象描述..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: 期望结果是什么？
+      placeholder: "期望行为..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: 复现步骤
+      description: "给出最小可复现步骤。"
+      placeholder: |
+        1. 打开 ...
+        2. 执行 ...
+        3. 出现 ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: 日志 / 截图
+      description: "粘贴日志或附上截图 (如适用)。"
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: env
+    attributes:
+      label: 环境信息
+      description: "OS / 运行时 / 依赖版本等"
+      placeholder: |
+        - OS: Windows 11 / Ubuntu 22.04 / macOS 14
+        - Runtime: Python 3.11 / Node 20
+        - 包管理: pip/conda/npm
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: 检查项
+      options:
+        - label: "我已搜索现有 issues, 未发现重复。"
+          required: true
+        - label: "我可以稳定复现该问题。"
+          required: false

catalog-sync/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 Discussions / 讨论区
+    url: https://github.com/CharlesPikachu/musicsquare/discussions
+    about: Please ask and answer questions here. / 建议在讨论区提问与交流。
+  - name: 🔒 Security / 安全问题
+    url: https://github.com/CharlesPikachu/musicsquare/security/policy
+    about: Please report security vulnerabilities privately. / 安全漏洞请私下提交。

catalog-sync/.github/ISSUE_TEMPLATE/documentation.en.yml

@@ -0,0 +1,28 @@
+name: "📚 Documentation"
+description: "Report missing/incorrect docs or propose improvements."
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: issue
+    attributes:
+      label: What's wrong / missing?
+      placeholder: "The docs are unclear about..."
+    validations:
+      required: true
+
+  - type: input
+    id: page
+    attributes:
+      label: Related page / section
+      placeholder: "Link or path to the docs page"
+    validations:
+      required: false
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested change
+      placeholder: "Proposed wording / examples..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/documentation.zh.yml

@@ -0,0 +1,28 @@
+name: "📚 文档问题"
+description: "反馈文档缺失/错误或提出改进建议。"
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: issue
+    attributes:
+      label: 哪里不对 / 缺什么？
+      placeholder: "文档在...部分不清晰/错误..."
+    validations:
+      required: true
+
+  - type: input
+    id: page
+    attributes:
+      label: 相关页面 / 章节
+      placeholder: "文档链接或路径"
+    validations:
+      required: false
+
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: 建议修改
+      placeholder: "建议的表述 / 示例..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/feature_request.en.yml

@@ -0,0 +1,49 @@
+name: "✨ Feature request"
+description: "Suggest an idea or improvement."
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: "What problem are you trying to solve?"
+      placeholder: "I'm frustrated when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: "What would you like to happen?"
+      placeholder: "It would be great if..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      placeholder: "Other approaches..."
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      options:
+        - "P0 - Must have"
+        - "P1 - Should have"
+        - "P2 - Nice to have"
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: "Mockups, references, related issues/PRs."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/feature_request.zh.yml

@@ -0,0 +1,49 @@
+name: "✨ 功能需求"
+description: "提出新功能或改进建议。"
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: 需求背景 / 痛点
+      description: "你想解决什么问题？"
+      placeholder: "目前困扰是..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 期望方案
+      description: "你希望系统如何改进？"
+      placeholder: "希望可以..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 备选方案
+      placeholder: "其他可能的实现方式..."
+    validations:
+      required: false
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 优先级
+      options:
+        - "P0 - 必须"
+        - "P1 - 应该"
+        - "P2 - 可选"
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 补充信息
+      description: "原型图、参考链接、相关 issue/PR 等。"
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/performance.en.yml

@@ -0,0 +1,39 @@
+name: "🚀 Performance"
+description: "Report a performance issue or regression."
+title: "[Perf]: "
+labels: ["performance"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      placeholder: "What is slow and where?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: baseline
+    attributes:
+      label: Baseline vs Current
+      placeholder: |
+        Baseline: 120ms
+        Current: 600ms
+        Regression since: v1.2.0
+    validations:
+      required: false
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce / benchmark
+      placeholder: "Command / script / dataset / input size..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: profiling
+    attributes:
+      label: Profiling info
+      placeholder: "Profiler output, flamegraph, timing breakdown..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/performance.zh.yml

@@ -0,0 +1,39 @@
+name: "🚀 性能问题"
+description: "反馈性能下降或耗时过长的问题。"
+title: "[Perf]: "
+labels: ["performance"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: 问题概述
+      placeholder: "哪里慢？慢到什么程度？"
+    validations:
+      required: true
+
+  - type: textarea
+    id: baseline
+    attributes:
+      label: 基线 vs 当前
+      placeholder: |
+        基线: 120ms
+        当前: 600ms
+        从哪个版本开始变慢: v1.2.0
+    validations:
+      required: false
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: 复现步骤 / benchmark
+      placeholder: "命令 / 脚本 / 数据集 / 输入大小..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: profiling
+    attributes:
+      label: Profiling 信息
+      placeholder: "Profiler 输出、火焰图、耗时拆分..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/question.en.yml

@@ -0,0 +1,28 @@
+name: "❓ Question"
+description: "Ask a question or request support."
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: textarea
+    id: question
+    attributes:
+      label: Your question
+      placeholder: "How do I..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: "What are you trying to achieve?"
+    validations:
+      required: false
+
+  - type: textarea
+    id: tried
+    attributes:
+      label: What you've tried
+      placeholder: "I tried..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/question.zh.yml

@@ -0,0 +1,28 @@
+name: "❓ 问题 / 支持"
+description: "提问或寻求使用帮助。"
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: textarea
+    id: question
+    attributes:
+      label: 你的问题
+      placeholder: "我想知道如何..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 背景说明
+      description: "你想达成什么目标？"
+    validations:
+      required: false
+
+  - type: textarea
+    id: tried
+    attributes:
+      label: 你已经尝试过什么
+      placeholder: "我尝试了..."
+    validations:
+      required: false

catalog-sync/.github/ISSUE_TEMPLATE/task.en.yml

@@ -0,0 +1,33 @@
+name: "🧹 Task"
+description: "Engineering task / refactor / maintenance."
+title: "[Task]: "
+labels: ["task"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      placeholder: "What needs to be done and why?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope / checklist
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: risk
+    attributes:
+      label: Risk level
+      options:
+        - "Low"
+        - "Medium"
+        - "High"
+    validations:
+      required: true

catalog-sync/.github/ISSUE_TEMPLATE/task.zh.yml

@@ -0,0 +1,33 @@
+name: "🧹 任务 / 杂项"
+description: "工程任务 / 重构 / 维护。"
+title: "[Task]: "
+labels: ["task"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: 目标
+      placeholder: "需要做什么？为什么要做？"
+    validations:
+      required: true
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: 范围 / checklist
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: risk
+    attributes:
+      label: 风险等级
+      options:
+        - "低"
+        - "中"
+        - "高"
+    validations:
+      required: true