Character Card Manager (for Silly Tavern) v1.3.0：重新授权后，同步不再「卡死」
如果你用 Silly Tavern 或手机上的 MiniTavern，又习惯把 PNG 角色卡同步到本机文件夹，Character Card Manager (for Silly Tavern) 多半已是日常工具之一。
久未打开插件后再回来，有时会碰到一种很挫败的情况：浏览器提示同步文件夹权限好像「过期」了；你按指引重新选了目录，界面也显示配对成功——但「立即同步」仍是灰色，或者点了也没有反应。本地列表空空如也，文件夹里明明躺着很多 PNG，却怎么都导不进来。
这不是操作失误。v1.3.0 之前版本里藏着一个逻辑死锁：上一版已在尝试修，但链路没完全打通；本次更新把它从根上拆掉了。
哪些用户会最有感
- 把同步文件夹当作角色卡的主文件夹。
- 插件不是天天开，隔几周或几个月才回来整理一次。
- 曾遇到「重新选文件夹之后，同步按钮还是不能用」的无解循环。
如果你也发现了 v1.3.0 更新之前的这个致命问题，可以尽快更新到最新版本。
长时间不用之后，为什么会「卡死」？
Chrome 扩展访问本地文件夹，依赖浏览器授予的文件系统权限。长时间不打开插件，或系统、浏览器清理过权限后，原先保存的授权可能失效。这时插件提示你重新选择同步文件夹——这一步本身是正常的。
问题出在重新授权之后，旧逻辑把几条本可并行的路串成了一条死胡同：
- 权限恢复时，若本地 IndexedDB（浏览器里存放插件内角色卡列表与数据的本地数据库）是空的，而文件夹里已有 PNG，插件会认为「磁盘上已经有这张卡」，于是不会在本地再插入一份。界面上一张卡都没有，文件夹里却很多。
- 旧逻辑接着推断：本地没有角色卡 → 不需要同步 → 把「立即同步」按钮关掉；点击同步的处理也会在「本地 0 张卡」时直接退出，根本不会去扫描文件夹里的文件。
- 之前的版本就会陷入死循环。
这就是在历史版本中有用户会发现的问题：重新授权后插件还是不能用——不是权限没给上，而是授权成功后，同步入口被逻辑关死了。
v1.3.0 改了什么
本次更新从三条链路上拆掉死锁：
- 文件夹里有可导入的 PNG 时，即使本地库为空，也会启用「立即同步」。重新授权后，你可以立刻把文件夹里的角色卡批量导回来。
- 允许「只导入、不导出」的同步：本地没有卡时，同步不再提前退出，而是正常扫描文件夹并导入。
- 重新选择文件夹时，重置同步状态，避免旧的「已同步」标记误判为「无需再同步」，让你在重授权后能走一遍完整同步流程。
修完以后，典型路径变成：
权限失效 → 重新选择文件夹 → 点击「立即同步」→ 角色卡从文件夹回到插件 → 继续正常使用
如何更新到 v1.3.0
- 打开插件主页面（全页管理界面）。
- 在左侧边栏左下角，找到版本号（例如
v1.3.0）旁边的「检查更新」链接。 - 点击后会跳转到 Chrome 网上应用店的插件页面。
- 在商店页查看是否已有新版本；若有，按页面提示完成更新即可。
若你已在 v1.3.0，且曾遇到授权失效问题：重新选择同步文件夹后，点击「立即同步」，即可把文件夹中的角色卡导回本地。
还没装扩展的用户，可直接从 Chrome 应用商店 安装。更多说明见 mini-tavern.com/manager.html。
为何值得单独发一版说明
在新版本安装的时候，浏览器会提示该插件有编辑本地文件的权限，请点击允许即可。这是使用本插件势必会遇到的权限提示问题，通过插件来编辑角色卡就会使用到这个权限。目前 v1.3.0 版本的提示会更加明显。
作者简介
常见问题（FAQ）
应用商店里还看不到 v1.3.0 怎么办？
可在插件主页面左下角点「检查更新」跳转到商店，或在浏览器扩展管理里检查更新；以本机扩展内显示的版本号为准。
重新选文件夹后，「立即同步」还是灰色？
请先确认已更新到 v1.3.0 或更高版本。旧版在本地库为空时可能仍禁用同步按钮；更新后重选文件夹，再点「立即同步」。
文件夹里有 PNG，但插件列表一直是空的？
这往往是 v1.3.0 之前死锁的典型表现：权限恢复后本地库为空，同步入口被关掉。更新到 v1.3.0 后重新选择同步文件夹并执行「立即同步」，应能把磁盘上的卡批量导回。
发布日期：2026 年 5 月 28 日
最后更新：2026 年 5 月 28 日