磁带封面生成器 (J-Card Genesis) 📼

v1.5.4 Update:

🧭 Short Back 模式收口: 移除了用户侧的 AUTO 选项，左侧折页现在只保留 档案信息 / 紧凑曲目 两种明确模式，减少伪自动带来的预期偏差。

📏 紧凑曲目动态测量: Short Back (Fold-in) 的 紧凑曲目 不再固定每面显示 5 首，而是会根据标题长度、截断保留率与实际可用高度，在不同密度级别之间动态求解显示数量。

♻️ 旧项目兼容迁移: 历史项目里保存的 AUTO 会在加载时自动归一化为显式模式，避免旧数据在新版本下出现异常空态或错误分支。

🖨️ Print-First 字体调优: 围绕“打印可读性优先”做了适度增量优化，重点抬高背面、Short Back 与 Spine 的危险小字下限，避免成品里出现肉眼费劲的微型文字。

🪧 背面统一 SIDE A / SIDE B Header: 主封底两面现在采用统一的 SIDE A / SIDE B 标题系统，side 总时长不再是远端固定小号脚注，而是成为真正的分区标题组成部分。

🔢 非古典编号改为分面重置: STANDARD / COMPILATION 模式下，曲目序号改为 SIDE A 与 SIDE B 各自从 01 开始，更符合磁带按面阅读与打印后的使用语义。

⚖️ 接受更早但更合理的自动退让: 为了换取可读性，系统会更早执行局部信息折叠，例如背面更早隐藏 note / 单曲尾部时长，Short Back 在高密度时可能少显示 1 首，Spine 更容易回退到无 note 方案，古典长作品标题也可能稍早触发 fallback。

v1.5.3 Update:

🧱 古典 Short Back 布局引擎重构: 古典 Short Back (Fold-in) 的档案模式不再直接依赖固定坐标硬排，而是改为先测量再渲染的独立布局计算流程。

📉 四级自动降级防溢出: 当 label / source / credits / equipment 过长时，系统会在 FULL -> TRIM_CREDITS -> COMPACT_META -> META_ONLY 之间自动降级，优先保证不冲出、不裁切。

✂️ 档案字段限行与截断: source / credits / equipment 现在支持限行、折行和省略号收束，极端长文本下的贴边与越界风险明显降低。

v1.5.2 Update:

🧠 背面过载保护系统: Back 面板新增真实测量驱动的密度判断，不再只靠缩字号硬撑。系统会根据版面承载力自动选择更合适的信息层级。

🎼 古典模式自动折叠: 面对《Carnaval》这类多乐章/多分段作品时，背面会在 完整分曲 -> 节选分曲 -> 作品摘要 -> 仅作品名 之间逐级降级，避免曲目页视觉溢出。

🎛️ 非古典模式 Note-Aware 压缩: STANDARD / COMPILATION 模式下，背面会优先保留 标题 + 备注，再按密度逐步牺牲 artist / duration，避免一刀切丢掉听感备注。

↕️ 非古典曲目拖拽排序: 右侧编辑区新增拖拽把手。非古典模式现已支持 A / B 面内重排与跨面移动，移动后会自动重算两面时长并即时刷新预览。

🪪 稳定 Track ID 基础设施: 每条曲目现在拥有稳定 id，避免重排后输入框错位，也为后续更完整的排序与批量编辑能力打下基础。

🧩 Short Back 独立模块化: 最左侧 Short Back (Fold-in) 已从主 Back 逻辑中拆出，拥有独立渲染入口与模式解析，不再只是封底紧凑分支的附属品。

🗂️ Short Back 独立显示模式: 支持在 档案信息 / 紧凑曲目 之间独立切换左侧折页内容，并且不会影响主封底对拖拽后曲目顺序的真实渲染。

v1.5.1 Update: The Spine Fail-Safe Release!

🧭 脊部独立排版引擎: Spine 不再只靠单行缩字号硬塞，而是会在 完整标题单行 -> 完整标题双行 -> 脊部短标题 -> 自动短标题 -> 截短兜底 之间自动切换，极端长标题也不会再压住上下信息。

✂️ 硬裁切 + 真实字体测量: 脊部区域现在有独立 clipPath，并改为基于浏览器真实字体栈测量，fallback font、letter-spacing 与中英混排的误差显著降低。

🏷️ 新增脊部短标题: 右侧面板新增可选的“脊部短标题”字段，并实时显示当前脊部策略，便于手动控制磁带 spine 的最终文案。

📦 发布链路补全: 项目版本升级到 1.5.1，补齐了 macOS arm64 .dmg 与 Windows x86 NSIS exe 的构建与发布流程。

v1.5.0 Update: The Typography & Geometry Overhaul!

⚛️ 物理级文本引擎: 深度集成 @chenglou/pretext 引擎，消除全线 Magic Numbers（硬编码系数），彻底解决跨字体溢出边界与错位问题。

🏛️ 多重防重叠建筑学: 重写了封面 (Front)、侧脊 (Spine) 和背部内页 (Back) 的碰撞测算机制。不论混排了多长的古典音乐乐章标题与大段标语文案，它都能严格坚守 1181x1748 分辨率安全区，智能等比缩放、严丝合缝绝不碾压。

🇨🇭 极简工业美学: 重构了曲目表与制作名单的视觉层级，引入微型眉批距，抹除多余括号，并启用“主题色动态真圆形 (Accent Circle)” A/B 侧边栏徽章，其随字号同步等比膨胀。

🪶 手工排版与硬换行: 底层排版支持绝对的“段落隔离隔离检测”。在 Slogan、Equipment 等框内敲击回车，即可在防撞引擎的保驾护航下，执行原生级的绝对硬换行 (Hard Break)。

🇨🇳 国产双黑体独立架构: 彻底本地化脱网运行。深度植入 17MB 的 思源黑体 (Noto Sans SC) 与 8.5MB 的 阿里普惠体 3.0，达成极简双无衬线架构；顶部导航栏全面改写为极具设计质感的 「纯中文情绪化主理名」 (现代、胶片、手记、骇客、素体、重工)，秒时零延迟切换。 v1.3.3 Update: The Reversible Layout (双拼颠倒双封面)! 这是一个极具工业感的复古设计方案：Front 面板精确五五分，上半部正向显示 Cover A，下半部倒置 180 度显示 Cover B，专为 "Flip-to-Play" 的实体交互体验设计。同时实现了"虚空填充"逻辑，完美解决正方形封面在长方形区域的宽高比冲突。

v1.3.2 Update: Spine Optimization (脊部终极优化)! 应广大收藏家需求，新增 "翻转脊部" 切换开关。您可以自由决定侧脊文字是从上往下读 (Top-Down, 默认) 还是从下往上读 (Bottom-Up)。同时重构了脊部渲染引擎，让 ID 与艺术家的位置布局稳如泰山。

v1.3.0 Update: AI Prompt Engineering Refined (画风指令升级)! 针对 "AI 生图提示词" 进行了深度优化。现在您可以获得更精准的 插画风格 指令（水彩、90年代杂志、手绘日记、平面设计），彻底告别"照片感"，确保生成的封面更具艺术性和落地感。同时修复了部分 UI 细节。

v1.2.9 Update: Smart Deep Clean (智能重置)! "新建项目"功能变得更聪明了，它能深度清理专辑数据（包括 MusicBrainz 抓取的演职员表），但会贴心地保留您的录音设备和音源设置，无需重复输入。目录编号默认留空。✨ 全新图标: 我们还换上了全新的应用程序 Logo，焕然一新！

v1.2.8 Update: MusicBrainz 深度集成! 彻底重构了古典音乐解析逻辑，支持识别 Work 实体并自动归类乐章；同时引入专业演职员表（Producer/Engineer），自动填充 Tech Specs 区域。

J-Card Genesis 是一款专为磁带收藏家和 DIY 爱好者设计的桌面应用程序。它结合了现代 AI 技术，帮助你轻松制作出专业、美观的实体磁带封面（J-Card / U-Card），并支持从搜索、导入、排版到导出的完整桌面工作流。

✨ 主要功能 (Key Features)

字体与排版系统 (Typography System):
- 四重奏风格: 提供 Moderno (现代), Analog (复古), Handwritten (手写), Digital (数码) 四种截然不同的字体组合。
- 手写体升级: Handwritten 主题引入了 Rock Salt (马克笔标题) + Shadows Into Light (圆珠笔正文) + 霞鹜文楷 (中文) 的黄金组合，手写质感大幅提升。
- 国内加速: 全线切换至国内镜像源，解决字体加载失效问题。
- 所见即所得: 顶部工具栏新增字体切换开关，实时预览变化。

2. MusicBrainz 深度集成 (Advanced Integration)

古典乐结构可视化 (Classical Works): 彻底重构了古典音乐的解析逻辑。现在系统能识别 MusicBrainz 的 Work 实体，自动将曲目按 "作品-乐章" (如 Symphony No. 5 -> I. Allegro) 进行归类排版，告别冗长的重复标题。
专业演职员表 (Enhanced Credits): 自动抓取并显示 制作人 (Producer)、录音/混音师 (Engineer) 等幕后功臣。这些信息会自动填充到 J-Card 背面的 "Tech Specs" 区域，让您的磁带封面更具专业收藏质感。
智能 AI 驱动:
- 集成 阿里云 DashScope (通义千问)，自动根据曲目列表生成配色方案、心情描述和中文听感备注。
- 颗粒度 AI 控制:
  - ✨ 文案生成: 独立的 "魔法棒" 按钮，一键生成 1-3 句俳句式短诗文案 (拒绝营销词)。
  - 🎨 提示词生成: 独立的 "AI 生成提示词" 按钮，自动分析曲风并从 4 种特定画风 (水彩/杂志/日记/平面) 中锁定一种，生成可落地的绘画指令。
- 集成 通义万相 (Wanx)，一键生成高质量、富有艺术感的封面图。
主题系统 (Theme System):
- 🌑 Dark: 经典的深色模式，专业冷静。
- ☀️ Light: 纯白背景，极简主义，适合白纸打印。
- 🖼️ Cover: 沉浸式封面背景，自动应用高斯模糊滤镜。
- 🎨 Color: 智能取色，自动提取封面主色调作为背景，并智能反转文字颜色。
曲目编辑与导入:
- 支持手动编辑曲目标题、艺术家、时长和备注。
- 支持 Side A / Side B 各自增删曲目，并自动重算面时长。
- 非古典模式支持通过拖拽把手进行 同面重排 与 A/B 面跨侧移动。
- 支持从 MusicBrainz 数据库直接搜索并填充专辑信息。
- 支持 智能文本粘贴：可直接粘贴 Spotify、网易云音乐等平台的曲目文本，AI 自动解析提取。
背面智能密度控制 (Back Density Control):
- Print-First Header: 主封底现在以统一的 SIDE A / SIDE B 分区标题驱动阅读节奏，side 总时长与标题形成完整 header，而不是继续作为远端弱提示。
- 古典模式自动折叠: 当作品分段过多时，背面会在完整分曲、节选分曲、作品摘要与仅作品名之间自动降级，避免文字页溢出。
- 非古典分面编号: STANDARD / COMPILATION 模式下，SIDE A / SIDE B 的曲目编号各自从 01 开始，不再延续全专辑的一贯制编号。
- 非古典 Note-Aware 策略: 在 STANDARD / COMPILATION 模式下，系统优先保留曲名与备注，再根据空间压力逐步隐藏 artist / duration；在本轮打印优先调优后，note / 单曲尾部时长 会更早退让，以换取更可靠的成品可读性。
- 真实字体测量驱动: 所有降级决策基于实际字体折行与可用高度计算，而不是单纯按条目数粗暴裁剪。
不仅仅是 J-Card:
- 支持 4 折页布局 (U-Card)，提供比传统 J-Card 更多的展示空间，完美包裹磁带盒。
- 提供标准、古典、合辑三种排版模式。
- 最左侧 Short Back (Fold-in) 现已支持独立模式选择，可在 档案信息 / 紧凑曲目 之间切换；其中 紧凑曲目 会根据标题长度与空间压力动态调整每面显示数量，并在高密度时接受“少显示 1 首、换取更大字号”的 print-first 取舍。
专业打印适配:
- 专为 Canon SELPHY CP1500 等 6 寸 (4R, 100x148mm) 照片打印机优化。
- 支持导出 SVG (矢量) 和 PNG (高清) 格式。
- 本轮对 Back / Short Back / Spine / Reversible Front Markers 做了小字下限抬升，整体更偏向“印出来能读”而不是“信息尽量全塞满”。
档案级元数据 (Archival Metadata):
- 支持记录 音源 (Source)、录音设备 (Equipment) 和 录制日期，并持久化保存。
稳定性与安全性改进:
- Electron 已启用 contextIsolation 并关闭 nodeIntegration。
- API Key 统一迁移到 DashScope 命名，并在 Electron 环境下优先使用安全存储。
- 复杂 SVG 预览采用输入防抖，减少频繁重绘带来的卡顿。

🚀 下载与安装 (Installation)

请在 Releases 页面下载适合您系统的版本。

当前仓库构建产物：

macOS: .dmg / .zip
Windows: .exe (NSIS 安装包)

📖 使用指南 (User Guide)

1. 配置 API Key (必填)

本应用使用阿里云 DashScope (通义千问 & 通义万相) 提供 AI 服务。

访问阿里云百炼控制台开通并获取 API Key (以 sk- 开头)。
在软件右上角点击 设置 (⚙️)，粘贴 Key 并保存。

2. 制作流程

输入信息:
- 文本导入 (推荐): 点击 "粘贴文本"，粘贴任意格式的曲目列表（如网易云/Spotify 歌单文本），AI 会自动识别。
- MusicBrainz: 点击搜索按钮，输入专辑名查找填入。
- 手动输入: 在右侧面板修改专辑信息、元数据与单曲字段；支持直接新增或删除曲目。
- 非古典拖拽整理: 在 标准 / 合辑 模式下，可直接拖拽右侧曲目卡片左侧把手，快速调整同面曲序，或在 A/B 面之间移动曲目。
AI 创意策划:
- 自动重塑: 点击右上角 "AI 创意总监"，补全专辑基础信息（标题、配色、听感备注）。
- Slogan: 点击"封面标语"旁的 ✨ 按钮，生成私密感短诗。
- Prompt: 点击"AI 图片提示词"旁的按钮，生成适配曲风的绘画指令。
生成封面:
- 点击 "生成封面"，AI 将根据提示词生成艺术封面（约需30-60秒）。
- 或点击 "上传 (Upload)" 使用本地图片（自动零裁剪填充）。
调整布局:
- 切换 标准 / 古典 / 合辑 模式。
- 古典模式 特性：自动归类乐章，背面展示详细录音设备与时间信息 (Tech Specs)。
- Short Back 模式 可独立控制最左侧折页显示内容，不会改写主封底的曲序来源。
- 古典模式 目前不支持拖拽排序；标准 / 合辑 模式支持拖拽重排，并会即时联动背面排版与面时长。
导出:
- 点击 "导出 SVG" (矢量打印) 或 "导出 PNG"。

3. 功能详解

Toolbar: 旋转箭头图标可一键重置项目（保留 API Key、录音设备与音源设置）。支持深浅色模式切换。
Spine Layout:
- Note Upper: 脊部顶部备注（常填 STEREO / MONO、年份、录音日期等）。
- Note Lower: 脊部底部备注（常填版权、版本信息或自定义说明）。
- 支持“极简脊部”、“强制大写”与可选的脊部短标题兜底策略。
- 为避免打印时出现过细过小的脊部说明字，系统在空间紧张时会更早进入 no-notes / artist-only 这类保守模式。
Track Ordering:
- 非古典模式下，曲目卡片左侧新增拖拽把手。
- 支持同侧排序与跨 SIDE A / SIDE B 移动。
- 拖拽后会自动重算 SIDE A / SIDE B 总时长，并实时刷新预览顺序。
Back Overflow Handling:
- 古典模式会自动折叠作品层级，避免多分曲作品挤爆背面。
- 非古典模式会优先保留 标题 + note，再视密度隐藏 artist / duration；在打印优先策略下，局部辅助信息会比以前更早退让。
- 长作品名的古典模式在极端密度下可能更早从完整分曲回退到摘要级别，但仍保持“作品结构优先”的阅读逻辑。
Data Persistence: 录音设备 (Equipment) 和音源 (Media Source) 会自动保存，方便制作系列磁带。

❓ 常见问题 (FAQ)

Q: 为什么生成图片很慢？ A: 高清图像模型 (Wanx 2.5) 计算量大，通常需要 30-60 秒，请耐心等待。

Q: 生成的图片不满意？ A: 可手动修改 "AI 图片提示词" 框中的描述（如增加“赛博朋克”等关键词），再点击生成。

Q: MusicBrainz 搜不到？ A: 建议直接 Google 搜索专辑曲目列表，复制文本后使用软件的 "粘贴文本" 功能导入，这是最高效的方式。

🖨️ 打印与规格说明

推荐设备：Canon SELPHY CP1500

相纸: 6 寸 (4R / 4x6 英寸 / 100x148mm)。
打印: 导出 PNG 后直接打印，无需裁剪，即打即用。

J-Card 布局 (U-Card)

本生成器采用四折页布局：

Front: 封面 (正方形)。
Spine: 脊部。
Back: 封底 (A面曲目)。
Extension: 扩展折页 (B面曲目/歌词/详情)。

🛠️ 开发与构建 (Development)

# 克隆仓库
git clone https://github.com/epochaudio/J-Card-Generator.git
npm install

# 启动开发
npm run electron:dev

# 构建前端
npm run build

# 构建 Electron 安装包
npm run electron:build

# 单独构建 macOS arm64 DMG
npm run electron:build:mac-arm64:dmg

# 单独构建 Windows x86 安装包
./node_modules/.bin/electron-builder --win nsis --ia32 --config.win.signAndEditExecutable=false -c.directories.output=dist_electron_win_x86

构建说明

当前版本号为 1.5.4，界面底部版本号由 package.json 通过 Vite 注入。
在 macOS 沙箱或受限环境中，electron-builder 直接构建 Windows 包可能因 wine 权限受限失败；必要时可追加 --config.win.signAndEditExecutable=false。
在某些 arm64 macOS 环境中，electron-builder 生成 .dmg 可能失败，此时可回退为系统 hdiutil 手工封装。

版权声明与使用许可（正式版）

1. 许可范围（个人免费使用）

在遵守本声明条款的前提下，允许任何个人用户免费下载、安装、使用、学习与研究本软件，用于非商业目的的个人使用。

2. 禁止商业化用途（明确禁止）

未经著作权人/权利人书面授权，任何组织或个人不得以任何形式将本软件用于商业目的，包括但不限于：

在淘宝、闲鱼、拼多多等平台或任何渠道售卖软件/安装包/激活服务；
以本软件提供有偿服务，例如：有偿打印、代处理、代制作、收费出图/出片等；
将本软件打包为商品、付费下载、会员权益、课程赠品或“资源包”进行变相收费；
以广告、引流、赞助、导流分成等方式对软件使用进行直接或间接变现；
将本软件用于企业/门店/工作室等经营场景，或作为对外收费服务链条的一部分。

如需商业授权（含合作、定制、集成、二次分发、渠道上架等），请联系授权方获取书面许可。

3. 修改、二次开发与再发布（开源友好）

允许对本软件进行修改、二次开发与再发布（包括源代码与编译后的二进制发布），但必须同时满足以下条件：

不得用于任何商业化用途（含直接/间接收费与变相变现）；
再发布时必须完整保留本版权声明与使用许可（以及原作者署名信息与仓库信息，如有）；
若发布修改版/衍生版，建议在显著位置标注“已修改”并说明主要改动，且不得暗示获得原作者背书或官方认证。

4. 非商业转载/镜像分发（允许，但有条件）

允许任何个人或组织在非商业目的下转载、镜像或分享本软件安装包及相关文件，但必须同时满足以下条件：

必须完整保留本版权声明与使用许可，不得删改、遮挡或拆分；
转载/分发过程及下载入口不得收取任何费用，不得设置付费门槛或捆绑收费；
不得将转载/分发作为引流或变现手段（包括但不限于：会员专享、打赏解锁、付费社群下载、广告分成导流等）；
不得植入广告、恶意代码或进行其他损害用户权益的修改。

5. 免责声明

本软件按“现状”提供，不提供任何明示或默示担保。作者不对因使用或无法使用本软件导致的任何直接或间接损失承担责任。用户应自行评估风险并承担使用后果。

6. 违约处理

如发现违反本声明的行为，权利人有权要求立即停止侵权、下架相关内容，并保留追究法律责任及索赔的权利。

Made with ❤️ for Cassette Culture.

Name		Name	Last commit message	Last commit date
Latest commit History 49 Commits
.agent/rules		.agent/rules
build		build
electron		electron
scripts		scripts
src		src
.gitignore		.gitignore
BACK_SIDE_HEADER_REDESIGN_TODO.md		BACK_SIDE_HEADER_REDESIGN_TODO.md
HELP.md		HELP.md
README.md		README.md
app.jsx		app.jsx
index.html		index.html
logo.png		logo.png
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
vite.config.js		vite.config.js

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

磁带封面生成器 (J-Card Genesis) 📼

✨ 主要功能 (Key Features)

2. MusicBrainz 深度集成 (Advanced Integration)

🚀 下载与安装 (Installation)