Magical Cards 0.9.1

修复删除模块时确认框背景透明、提示文字与设置页面重叠的问题。

• 确认框独立适配明暗主题，避免其他插件旧版同名样式的覆盖。
• 窄面板中的长文本与按钮自动换行，内容过长时可滚动。
• 取消或按 Esc 只关闭确认框并恢复删除入口焦点；关闭设置时正确释放原生弹窗与按键作用域。

Fix module deletion confirmations overlapping Settings. The dialog now has its own theme-aware surface, supports narrow panels, and restores focus when cancelled. Escape dismisses the confirmation without closing Settings.

已完成 Obsidian 1.14.4 独立设置窗口的明暗主题、取消及 Esc 原生验收；343px / 390px 浏览器视口检查通过。383 项自动化测试、类型检查、lint、资源检查、可复现构建与 5 MB 包体检查通过。

工程源码继续在私有仓库维护，使用许可见 LICENSE。社区用户可在 Obsidian 检查更新；手动安装只需下载下面三个附件。GitHub 自动提供的源码压缩包仅包含公开分发资料。

文件	SHA-256
main.js	d06c0bb98113ddbb7e7dd9784473ee54f8c8c72f4c64f039d85b0e1adf347955
manifest.json	2654baf51730262f340a9d4c36ef190faa5b4c3ba6b27d306cb6f879c912f384
styles.css	bdb3bbccfc42d764c9e89a8134b866d5c5d0ee15c2f2f8aaf0189909a906f197

Magical Cards 0.9.0

0.9.0 更新

• 独立模组作品 Dashboard：点击模块菜单中搜索左侧的传送图标，浏览统计、最近作品与完整封面墙，支持搜索、筛选和临时排序；返回时恢复来源位置。
• 微信读书书目导入：在设置展开「微信读书」，保存 API Key、读取书架、勾选书目并导入书籍模块。支持电子书和有声书，默认不勾选任何书目。
• 书籍模块：创建普通卡片模块时可选影视或书籍；同模块已有的微信读书书目会跳过，跨模块可保留独立副本，已有笔记和手工内容不会被覆盖。
• 更新说明：升级后在设置显示本版本说明，关闭后不重复；全新安装保留示例引导。

微信读书使用

通过官方页面获取 API Key。密钥仅存于 Obsidian SecretStorage，不写入普通插件配置或作品笔记。未选择目标时使用内置阅读模块；目标已删除时需要重新选择。此次只导入所选书目，不自动同步划线、想法或阅读时长。

源码与使用许可

从 0.9.0 起，作者工程源码在私有仓库维护，当前公开仓库继续用于安装、更新、使用文档和 Issues。个人和企业可免费正常使用，包括私人备份与修改；未经许可不得二次发布、改名分发或售卖插件及新源码。此前已授予的 MIT 权利和第三方许可保持不变，详见使用许可。

安装与校验

社区用户可在 Obsidian 内检查更新；手动安装请下载下列三个安装附件。GitHub 自动提供的 Source code 压缩包只含公开分发资料，不是插件安装包。

本次通过 382 项自动化测试、类型检查、可复现构建及 5 MB 包体检查。微信读书请求使用模拟接口验收，真实账号由用户保存授权并选择书目后操作。

文件	SHA-256
main.js	4a8b0505dfb2b5d26439b5bd9e82c94eb79a51e943a392ab068fe28c18ae2bea
manifest.json	bbb21c6e3ab5974d4ee0fbe914a86dae6d8b5211daa59d83ed4ac89dc4e4ee7c
styles.css	fc9776ad355e50517d87fd00a562bf79e675775937ef5c0a62423725e1b2d711

Magical Cards 0.7.0

Magical Cards 0.7.0 改善手机浏览与背面编辑，并提供原生卡片挂载接口。

手机操作

• 五种布局统一提供“上一张／当前位置／下一张”；按住 400ms 后连续翻页，松手即停。
• 手机卡片区不再抢占单指侧滑，保留 Obsidian 侧栏手势、页面滚动和双指缩放。
• 根据模块宽度和可视高度自适应三卡尺寸，支持现有六种比例与横／竖画廊。
• 翻面后在模块内放大背面，保留摘要／描述草稿与原卡片位置；编辑时禁用翻页。
• 桌面拖拽、键盘及触控板操作保持兼容。

集成与数据

• 提供版本化的原生卡片挂载接口及编辑保存保护，供兼容宿主复用。
• 本次手机适配不修改作品、图片、分类或已保存的外观设置。
• 安装仍只需 main.js、manifest.json、styles.css；离线示例封面随包提供。

验证与已知范围

• 300 项自动化测试、类型检查、lint、离线资源校验和可复现构建通过。
• 浏览器已检查 320 / 360 / 390 / 430px 竖屏及横屏、五种布局、六种比例、长按清理、背面编辑及 WebGL 降级。
• iOS、Android、鸿蒙的真实手机 Obsidian 尚未完成实机验收；浏览器模拟不代表实机通过。Windows 亦未实机验证。
• 三个安装文件附 GitHub 产物证明。main.js 为 4,957,281 字节。

English

Mobile layouts now have Previous / position / Next controls, hold-to-repeat paging, adaptive three-card sizing and an expanded in-module editor. Single-finger carousel dragging is disabled on mobile to leave gestures to Obsidian. Desktop controls and saved library data remain compatible. This release also exposes a versioned native card-mounting API.

All 300 automated tests and reproducible builds pass. Real-device validation on iOS, Android and HarmonyOS is still pending; browser emulation is not a substitute. Install the three attached files in the magical-cards plugin folder, then reload Obsidian.

0.6.1

Magical Cards 0.6.1 adds mobile support while preserving existing card notes, images, module settings and Dashboard membership.

• Enable loading on iOS/iPadOS and Android Obsidian. Replace the Node-only cover decoder with bounded JavaScript decoding; all six original offline covers retain their SHA-256 hashes.
• Improve touch controls, narrow-screen forms, menu labels and editable card backs. Fix a blank reverse face covering images in mobile WebKit.
• Swipe Dashboard tabs to browse categories; use the Dashboard menu to move the selected category forward or backward.
• Keep the existing three-file installation, SVG safety checks and original data formats. main.js is 4,937,973 bytes.

HarmonyOS devices that run Android Obsidian use the same files. Native HarmonyOS hosts and compatibility containers remain unverified. No physical iOS, Android, HarmonyOS or Windows acceptance is claimed; validation uses WebKit/Chromium mobile emulation and 284 automated tests, type checks, lint and reproducible clean builds. This release does not claim to resolve the earlier desktop whole-tab black screen.

手机端支持已开放，保留原有资料与配置。手机请从命令面板执行「打开 Magical Cards」；批量导入 SVG 时可使用系统文件选择器。同步资料时，请先完成笔记及附件同步。

鸿蒙以设备能运行 Obsidian 为前提；三种手机系统均尚未实机验证。共用卡片运行时的桌面用户请同时更新兼容插件至 0.1.40。

Magical Cards 0.6.0

普通卡片模块现可一次导入多张图片或安全 SVG，每张建立独立卡片和作品笔记。作品信息默认展开名称、摘要，其他资料放在“更多信息”；影视卡片的“导演”标签可逐张改名。新增 32:15 宽幅横图，正面使用不遮挡封面的透明翻面区域，同时保留 F 快捷键。

现有作品、正文、观看日期／状态和未知属性保持兼容；失败导入可重试，不覆盖后来编辑。安装仍只需要 main.js、manifest.json、styles.css，升级时保留 data.json。

Ordinary modules now import multiple images or safe SVGs into separate cards and work notes. Name and Summary appear first, additional fields stay in More Information, and each film card can rename its Director label. The new 32:15 wide ratio and accessible transparent flip area keep artwork visible.

Validation: 278 automated plugin tests and 16 independent card-view UI/reload/loading-order checks passed. The macOS UI checks use synthetic input events. Windows has not been tested on physical hardware. Import File retry queues last for the current application process; saved notes and images remain. This release does not claim a black-screen fix or a new community review.

与可选配套插件共同使用时，请升级配套版本至 0.1.40。独立安装 Magical Cards 即可单独运行。

When using the optional companion plugin, use version 0.1.40. Magical Cards also runs independently.

Magical Cards 0.5.0

Dashboard 分类与界面精简：取消固定“全部”页及隐藏操作，所有分类同等，支持标签拖动排序。模块的加入、移出和删除统一在设置操作；创建模块可同时新建分类并加入。删除模块保留作品笔记和图片。

卡片、图片橱窗及分类工具栏采用横向动画菜单，设置按用途区分样式。旧隐藏状态一次迁移为未分类，相关嵌入和兼容宿主恢复展示。成功提示四秒后消失，错误和排序草稿保留。

验证：244 项独立测试、254 项兼容版测试、22 项原生检查、3 项重载恢复与3项双插件检查通过；干净克隆、可复现构建和三个安装文件证明完成。兼容宿主需 0.1.38。Windows 尚未实机验证，本轮不包含黑屏修复。

安装：下载 main.js、manifest.json、styles.css，替换配置目录 plugins/magical-cards/ 中对应文件，保留 data.json 和恢复文件。内置六张封面仅作示例，版权归各权利人。

Dashboard categories now replace the fixed All view. Manage module membership and deletion in Settings, drag category tabs to reorder, and use compact horizontal action menus. Notes and images remain intact when a module is deleted. Compatible host: 0.1.38. The existing vault is not updated automatically.

Magical Cards 0.4.2

Magical Cards 0.4.2

• 隐藏模块仍可恢复；移出此 Dashboard只取消当前分类引用。
• 移除模块现在经确认删除模块配置、全部 Dashboard 引用及模块位置，不再提供模块恢复入口。作品笔记、橱窗笔记和图片保留；原有笔记嵌入会提示模块已移除。
• 移除前检查未保存编辑与排序；保存失败、源码冲突或旧共享运行时不支持时保留原模块和草稿。
• 整理 README 的英文开头，保留中文主文档和作者开发思路。此次不提交社区重审。

独立使用 Magical Cards 无需工作台；同时使用两个插件时，请更新工作台兼容版 0.1.37。安装或更新时下载 main.js、manifest.json、styles.css 三个文件。

干净构建通过 212 项卡片测试和 254 项兼容版宿主测试、类型检查、lint（0 错误、3 项已有警告）、资源检查和可复现构建。两个版本的发布 CI 通过，三个安装文件与测试构建逐字节一致。Windows 未实机验证，本次未重新调查标签页黑屏。

0.4.1

模块移出或隐藏只改变展示，不再需要删除卡片资料。

• 自定义 Dashboard 的“移出此 Dashboard”仅移除当前分类引用。
• “全部”页的“隐藏模块”只影响卡片标签页，笔记嵌入继续显示；可从“已隐藏模块”恢复。
• 保护输入法、未保存编辑、排序草稿及并发冲突，保留旧全局隐藏行为。

验证：185 项卡片测试、251 项兼容宿主测试、类型检查、lint、可复现构建与 10 项原生双插件兼容检查通过。发布仅含三个安装文件。

原生弹出窗口测试记录到 Obsidian 本体 getZoomFactor 状态异常，模块操作和配置恢复成功；Windows 未实机验证。本版本不声明修复整页黑屏。

Magical Cards 0.4.0

Magical Cards 0.4.0 adds Dashboard categories to the cards tab and a separate image showcase creator in Settings.

• Keep the fixed All / 全部 page; manually assign existing modules to one or more Dashboards. Each Dashboard keeps its own order.
• Create, rename, edit members, and delete categories without copying or deleting cards, notes, or images.
• Use separate, collapsed Add card module and Add image showcase settings, each with its own draft and one Save action.
• Preserve edits before switching Dashboards, report conflicts, and keep failed sorting drafts isolated by Dashboard. Existing note embeds retain their current behavior.

Download only main.js, manifest.json, and styles.css for manual installation in .obsidian/plugins/magical-cards/. Six bundled starter covers remain available offline.

Validation: 168 automated tests, type checks, lint (0 errors; 3 existing compatibility warnings), lossless starter asset checks, reproducible build, release size check, and native macOS Dashboard/cold restart tests. Full evidence is in VERIFICATION.md.

Windows has not been tested on physical hardware. The previously reported whole-tab black screen was not reproduced during this regression; this does not establish that every cause has been fixed.

Code is MIT licensed. Third-party starter covers retain their original rights; see examples/SOURCES.md.

Magical Cards 0.3.1

首次说明页采用作者修订的正文；新建橱窗选项改为“添加图片橱窗”。已有说明页、作品、图片及外观保留。

弯曲画廊退出时释放 WebGL 上下文，比例和方向更新复用原画布；外观修改保存后增加黑屏恢复提示。尚未确定用户整页黑屏的全部原因，遇到异常请等待保存后重启 Obsidian 并打开原库。

安装：下载 main.js、manifest.json、styles.css，放入 .obsidian/plugins/magical-cards/，保留 data.json 和恢复草稿，按原启用状态使用。