@xia-sc/dsh-cc-studio 0.9.0 → 0.9.1

package/README.md

@@ -14,7 +14,7 @@ DSH（DeepSeek Harness）插件：输入框上方的胶囊 → 全屏融合工
 
 | 项目 | 值 |
 | --- | --- |
-| 包名 / 版本 | `@xia-sc/dsh-cc-studio` `0.9.0` |
+| 包名 / 版本 | `@xia-sc/dsh-cc-studio` `0.9.1` |
 | 兼容 | DSH `>=0.4.5-rc.4`（含**桌面版**）、Node `>=22`、**零运行依赖**；逐版本实测见 [兼容与权限](#兼容与权限) |
 | 落盘位置 | `<DSH_HOME>/cc-library/`（角色卡）、`<DSH_HOME>/cc-drafts/`（会话草稿）；`DSH_HOME` 默认 `~/.dsh`，旧位置仍读得到 |
 | 文档 | 用户文档＝本文件；改代码前必读 [AGENTS.md](./AGENTS.md)；完整历史 [CHANGELOG.md](./CHANGELOG.md) |
@@ -42,7 +42,7 @@ DSH（DeepSeek Harness）插件：输入框上方的胶囊 → 全屏融合工
    dsh --profile <profile> --dump-config
    期望在 `# == @xia-sc/dsh-cc-studio` 那一层下看到两行：`id: dsh-cc-studio`（宿主行）与 `id: preset-cc`（CC 预设行）。
 4. 告诉用户重启：宿主行只在启动时组合 —— CLI 重启 `dsh web`，桌面版退出并重新打开应用。
-5. 重启后可选自检：在「CC 模式」会话里调任意一个 cc_* 工具，返回里带 "build": "0.9.0" 即说明新代码已加载
+5. 重启后可选自检：在「CC 模式」会话里调任意一个 cc_* 工具，返回里带 "build": "0.9.1" 即说明新代码已加载
    （这也是判断「改了但没重启」的唯一可靠依据）。
 6. 不要做的事：
    - 不要手工把 presets/ 拷进 ~/.dsh/.agent-presets/（dsh >= 0.4.7-alpha.4 已不读该目录，拷了也不生效）；
@@ -58,9 +58,9 @@ DSH（DeepSeek Harness）插件：输入框上方的胶囊 → 全屏融合工
 ```bash
 # 从 npm 安装（推荐）
 dsh plugin --profile web add @xia-sc/dsh-cc-studio
-dsh plugin --profile web add @xia-sc/dsh-cc-studio@0.9.0    # 锁定版本
+dsh plugin --profile web add @xia-sc/dsh-cc-studio@0.9.1    # 锁定版本
 
-# 从 GitHub 源安装（可加 #v0.9.0 / #master 指定 tag / 分支）
+# 从 GitHub 源安装（可加 #v0.9.1 / #master 指定 tag / 分支）
 dsh plugin --profile web add github:xia-sc/dsh-cc-studio
 
 # 从本地仓库安装（开发 / 调试）：装出来是 link:，改 lib/*.js 重启即生效
@@ -128,7 +128,7 @@ dsh plugin --profile web remove @xia-sc/dsh-cc-studio       # 卸载（同时移
 | 条目管理 | `cc_update_lorebook_entry` / `cc_delete_lorebook_entries` |
 | 导出与起点 | `cc_preview_export`（体积、估算 token、字段清单、重复内容量）/ `cc_new_card`（破坏性，须用户同意后带 `confirm:true`） |
 | 人物关系（0.8.0） | `cc_get_relations` / `cc_patch_relations` / `cc_render_relations` / `cc_group_check` |
-| 共享世界书（0.9.0） | `cc_get_shared_book` / `cc_patch_shared_book` / `cc_promote_shared_entries` / `cc_apply_shared_book` |
+| 共享世界书（0.9.0） | `cc_get_shared_book` / `cc_patch_shared_book` / `cc_promote_shared_entries` / `cc_apply_shared_book` —— 工坊导出页给两种形态：**CCv3 独立世界书**（`lorebook_v3`）与 **SillyTavern 世界书**（`{entries:{…}}`；ST 只认后者）。导卡时（JSON / PNG / CHARX）自动在导出副本上写 ST 的世界书绑定（`data.extensions.world`），PNG 同时带 `ccv3`（纯 CCv3）与 `chara`（V2 回填）两个块 |
 | 分组管理（0.8.0） | `cc_list_groups` / `cc_create_group` / `cc_rename_group` / `cc_delete_group` / `cc_set_card_group` |
 | 已存库 CRUD | `cc_list_library` / `cc_save_to_library` / `cc_load_from_library` / `cc_delete_from_library` / `cc_rename_in_library` / `cc_get_library_entry` |
 
@@ -185,6 +185,8 @@ node tests/tools-contract.test.mjs          # 只跑 CC 工具链契约（97 项
 
 完整历史见 [CHANGELOG.md](./CHANGELOG.md)。最近几版大多是「另一个 LLM 以工具使用者身份跑回归」挖出来的问题：
 
+- `0.9.1` **共享世界书导不进 SillyTavern**：把 CCv3 独立 lorebook（`{spec:"lorebook_v3", data}`）拖进「世界信息 → 导入」只会得到 `Error importing world info: … Bad Request`。根因有两层（对着本地 ST 1.19.0 源码 + 实测复现）：服务端 `/api/worldinfo/import` 拿到文件第一句就是 `if (!('entries' in worldContent)) throw` —— 顶层没有 `entries` 一律 **400**；而 ST 客户端 `importWorldInfo()` 只转 Novel / Agnai / Risu，整份 `world-info.js` 里搜不到 `lorebook_v3`（**它不是「换个后缀」能解决的**）。另外 ST 的 `parseDecorators()` 只认 `@@activate` / `@@dont_activate`，其余 `@@` 行会**连同正文一起被丢掉**。修法是多一种形态而非改掉原来那种：共享书页与导出页各多一枚「⬇ SillyTavern 世界书」，导出 `{entries:{"<uid>":{…}}}`，字段照抄 ST 自己的 `convertCharacterBook()`，`@@position` / `@@depth` 翻译成 ST 的 `position` / `depth` 并从正文删掉（`@@activate` 原样留给 ST），文件名 = 书名（ST 用上传文件名当世界名）；**CCv3 那份一个字节没动**。实测：同一本真书导出的 ST 文件导入返回 **200 + `{"name":…}`**、ST 落盘、条目 uid 与源 `id` 一致、「年表」落在 `position:1`。测试 647 → 683 项（16 个文件）。**同一版还补齐了 SillyTavern 兼容层**：PNG 现在同时写 `ccv3`（纯 CCv3）与 `chara`（诚实的 V2 投影，按规范摘掉装饰器）两个块，读取器改成**按载荷里的 spec 判并优先 `ccv3`**（此前是「取第一个命中的块」，而 ST 导出的 PNG 是 `chara` 在前，于是把 ST 导出的卡拖进工坊会报「spec 需为 chara_card_v3」）；导出 PNG / CHARX / JSON 时若该卡所属分组有共享书，会**只在导出副本上**写 ST 的世界书绑定（`data.extensions.world = 书名`）—— ST 里的顺序是先导世界书、再导卡，绑定就自动接上（卡内私有条目还要点一次 Import Card Lore）。规范同样明文禁止往卡片里加应用私有字段，所以卡片顶层一个 ST 私有键都不加。实测：我们导出的双块 PNG 进 ST 返回 **200**，ST 回读 `data.extensions.world`、卡内 3 条书条目与 V3 独有字段俱在且世界名可解析；ST 落盘的「V2 在前」PNG 我们也能读了。测试 683 → **718 项（17 个文件）**。**同一版还有第三步：V2 卡现在能进工坊了** —— SillyTavern 里绝大多数存量卡是 V2（ST 界面新建的就是 V2 形状，只是 `spec` 被改写成 v3 标签），此前拖 PNG/JSON 进来只会得到「spec 需为 chara_card_v3」。现在 `upgradeCardToV3()` 一份实现管 PNG / CHARX / JSON 三条导入路径（规则照 ST 的 `readFromV2()`：顶层 V1 平铺字段只在 `data` 缺值时补、`creatorcomment`→`creator_notes`、`talkativeness`/`fav`→`data.extensions`、纯 V1 整份包成 `data`），导入返回带 `upgradedFrom`、界面明说「V2 卡已升级为 CCv3」（不静默变换）；JSON 导入也收口到宿主的新端点 `cc_importFromJson`（客户端不再自己 parse 卡 JSON）。`cc_setDraft` 故意不升级（它是工坊自己草稿的镜像）。测试 718 → **735 项（17 个文件）**。**需重启 dsh（桌面版重启应用）→ 刷新页面**。
+
 - `0.9.0` **「共享世界书」的收口版**：0.8.2 把世界设定从「每张卡一份」挪到了「组上一本」，但**所有读数、判定与质量检查还按「卡里」算** —— 五轮 LLM 侧回归把它逐个补平：四个读数工具（`simulate` / `lint` / `group_check` / `preview_export`）全部拆成「**卡内 / 共享书 / 合计**」三段（`simulate` 此前会把「会命中」报成「不会命中」，实测低估约 3 倍）；**提升去重后自动同步草稿**（否则下一次保存会把重复原样写回卡里）；`cc_validate` 的「世界书 ≥5 条」改走合计口径（按最佳实践去重过的卡此前**必然判不合格**）；重复检测补上「**卡 ↔ 共享书**」一类（`bookDuplicates` / `wouldClean`）；`constant` 与 `@@decorator` 的存在性检查两端统一；**共享书自己的逐条质量检查**补上（此前「共享书质量走 `cc_get_shared_book`」只是一句没实现的说明 —— 那条线上只有重复检测）。口径与质量各收口成一个纯函数（`lorebookMetrics` / `auditLoreEntries`），以后改口径只动一处。测试 604 → 647 项（15 个文件）。
 
 - `0.8.2` **群聊卡这一整段迭代的正式发版**：关系图谱（`<DSH_HOME>/cc-groups/`，三维 = 方向 × 类型 × 强度；节点分「有独立卡的角色」与「卡内 NPC」）+ `cc_render_relations` 把关系渲染进 `description` 的固定标记区让卡自包含（幂等、可 `dryRun`、空图谱 = 清空）；随后补齐**模型侧的分组增删改查**（`cc_list_groups` / `cc_create_group` / `cc_rename_group` / `cc_delete_group` / `cc_set_card_group`）、新增**组级共享世界书**（`<DSH_HOME>/cc-books/`，一组一本、文件本身就是 CCv3 官方 `lorebook_v3` JSON，`cc_promote_shared_entries` 一键把成员卡里逐字重复的条目提升进去并从各卡删除），并把工坊左侧改成**卡片结构导航**（总览 / 角色 / 世界观 / 世界书 / 开场与示例 / 关系与分组 / 共享世界书，每项带三态进度徽章）。工具 19 → 32。修的既有问题：**B4** 工具半保存一次就把卡踢出分组（两半 `makeLibraryEntryMeta` 漂移）、**B5** `mutual` 对等边完全不渲染、**关系视图「关系 · 0」与导航 0 条**（客户端读错宿主返回形状 —— 边在 `group` 里）、**换卡后关系视图不换组**。测试 509 → 604 项（14 个文件）。**需重启 dsh（桌面版重启应用）→ 刷新页面**。

package/lib/agent.js

@@ -12,7 +12,7 @@ const name = "dsh-cc-studio-agent";
 // 由来：第五轮实测里测试者第一遍跑出「四项全无变化」，其实只是**没重启 dsh** —— LLM 侧完全无法
 // 分辨「代码没改」和「改了但没加载」。有了这个字段，任何一次调用都能先确认自己测的是哪一版。
 // 发版时与 package.json 的 version 同步。
-const BUILD = "0.9.0";
+const BUILD = "0.9.1";
 const inject = ["tools", "agents"];
 
 function nowSec(){ return Math.floor(Date.now()/1000); }
@@ -2285,11 +2285,13 @@ function apply(ctx){
 
   // ———————————————— 组级共享世界书（0.9.0）————————————————
   // 一组一份：世界设定（年表/势力/地理/力量/日常）提到共享书，成员卡里只留角色私有条目。
-  // 导出后是 CCv3 官方 lorebook_v3 JSON，在客户端里绑成全局世界书即可，多卡共用、零重复。
+  // 导出后有两种形态，各有各的读者（0.9.1 补）：CCv3 官方 lorebook_v3 JSON 给认这个规范的客户端；
+  // **SillyTavern 只认它自己的 `{entries:{…}}`**（ST 的 /api/worldinfo/import 首句就查顶层 entries，
+  // 拖 lorebook_v3 进去实测 400）—— 工坊导出页两枚按钮分别对应，别混着说。
 
   tool({
     name: "cc_get_shared_book",
-    description: "【共享书·查】读当前（或指定）分组的**组级共享世界书**（一组一份、整组共用），并报出「成员卡之间有多少条重复条目」—— 那些就是该提升到共享书的。共享书是独立文件（CCv3 官方 lorebook_v3 格式），导出后可在客户端里绑成全局世界书，于是每张成员卡里不必再存这些设定。",
+    description: "【共享书·查】读当前（或指定）分组的**组级共享世界书**（一组一份、整组共用），并报出「成员卡之间有多少条重复条目」—— 那些就是该提升到共享书的。共享书是独立文件，工坊导出页给两种形态：**CCv3 独立世界书**（`{spec:\"lorebook_v3\", data}`，给支持该规范的客户端绑成全局世界书）与 **SillyTavern 世界书**（`{entries:{…}}`）。⚠️ SillyTavern 的导入接口只认后者（它连 `lorebook_v3` 都不认，直接拖前者进去会被判 400 Bad Request）—— 所以「交给客户端」时要说清是哪种，别让用户拿到 CCv3 那份去导 ST。",
     parameters: {
       type:"object",
       properties:{
@@ -2501,14 +2503,14 @@ function apply(ctx){
         lorebookTokens: cardTokens + sharedTokens,
         lorebookSplit: { card: cardTokens, shared: sharedTokens, total: cardTokens + sharedTokens },
         sharedBook: shared.length ? { groupId: scope.groupId, name: scope.bookName, entries: shared.length, tokens: sharedTokens,
-          hint: "独立一本，可用工坊「导出共享世界书」单独导出；若客户端不支持全局世界书，可在导出时并入本卡" } : null,
+          hint: "独立一本，工坊导出页可单独导出（CCv3 客户端拿「CCv3 独立世界书」，**SillyTavern 拿「SillyTavern 世界书」**）；若客户端不支持全局世界书，可在导出时并入本卡。导卡时（JSON / PNG / CHARX）会**自动在导出副本上**写 `data.extensions.world = <书名>`（ST 的角色↔世界书绑定），PNG 里同时写 `ccv3`（纯 CCv3）与 `chara`（V2 回填）两个块 —— 草稿与库里的卡一个字节都不动" } : null,
         exportedFields, extensionsExported: Object.keys(d.extensions || {}),
         worldDuplicatedChars: dupChars,
         loreCount: entries.length, manualLoreCount: entries.filter(e => !isAutoEntry(e)).length,
         message: "预计导出 " + bytes + " 字节（约 " + estimateTokens(json) + " token），其中本卡世界书 " + cardTokens + " token"
           + (shared.length
             ? "；**本卡所属组另有共享世界书「" + (String(scope.bookName||"").trim() || "未命名") + "」" + shared.length + " 条 / 约 " + sharedTokens
-              + " token** —— 客户端实际加载时两者叠加（合计 " + (cardTokens + sharedTokens) + " token），可单独导出该文件或导出时并入本卡"
+              + " token** —— 客户端实际加载时两者叠加（合计 " + (cardTokens + sharedTokens) + " token），可单独导出该文件（**SillyTavern 要用「SillyTavern 世界书」那份**）或导出时并入本卡"
             : "")
           + "；五维（extensions.cc_world）会一起导出，与条目内容重复约 " + dupChars + " 字符。" };
     }
@@ -2540,7 +2542,7 @@ function apply(ctx){
       } else if(wf.loreCount < 5){
         // 达标靠的是组里那本共享书（第二轮报告 P0 的正解）：**不阻塞**，但必须把「导出时要带上它」说清楚 ——
         // 否则用户把这张「卡内只有 3 条」的卡发出去，对方客户端没有共享书就等于世界书缺失。
-        warnings.push("本卡内只有 "+wf.loreCount+" 条世界书，达标靠的是本组共享世界书「"+(wf.sharedBook && String(wf.sharedBook.name||"").trim() ? wf.sharedBook.name : "未命名")+"」的 "+wf.sharedLoreCount+" 条（合计 "+wf.loreTotal+" 条）。**共享书不会跟着卡走**：导出时请把它一并交给客户端（工坊导出页可单独导出这本 `lorebook_v3`；对方客户端不支持全局世界书时，在导出页勾选「并入本卡」）。");
+        warnings.push("本卡内只有 "+wf.loreCount+" 条世界书，达标靠的是本组共享世界书「"+(wf.sharedBook && String(wf.sharedBook.name||"").trim() ? wf.sharedBook.name : "未命名")+"」的 "+wf.sharedLoreCount+" 条（合计 "+wf.loreTotal+" 条）。**共享书不会跟着卡走**：导出时请把它一并交给客户端（工坊导出页有两枚按钮 —— 支持 `lorebook_v3` 的客户端拿「CCv3 独立世界书」，**SillyTavern 必须拿「SillyTavern 世界书」**，ST 的导入接口只认 `{entries:{…}}` 形态）；对方客户端不支持全局世界书时，在导出页勾选「并入本卡」。导卡时若该组有共享书，会**自动在导出副本上**写上 ST 的世界书绑定（`data.extensions.world = 书名`），PNG 里同时带 `ccv3` 与 `chara` 两个块。");
       }
       // —— 质量（P1-5：此前 valid=true 只代表「四件套非空」，给用户「卡没问题了」的错觉）——
       if(!String(d.data.scenario||"").trim()) warnings.push("scenario 为空，建议补充（缺失时模型只能靠 description 猜场景）");

package/lib/client.js

@@ -60,7 +60,7 @@ window.__ModuleLoader__.load({
       "workshop.rel.dirLabel":"方向",
       "workshop.rel.myCard":"当前卡",
       "book.title":"共享世界书",
-      "book.hint":"一组一份：世界设定（年表/势力/地理/力量/日常）放这里，成员卡里只留角色私有条目。导出后是 CCv3 官方的 lorebook_v3 JSON —— 在聊天客户端里绑成全局世界书，多张卡共用一本，卡里就不必再重复存。",
+      "book.hint":"一组一份：世界设定（年表/势力/地理/力量/日常）放这里，成员卡里只留角色私有条目。导出有两种：CCv3 独立世界书（lorebook_v3，给支持该规范的客户端绑成全局世界书）与 SillyTavern 世界书（ST 的导入接口只认 {entries:{…}} 形态，直接把 CCv3 那份拖进去会报 Bad Request）。",
       "book.noGroup":"共享世界书是按分组存放的：先在右侧「已存角色」里建一个分组，并把成员卡拉进去。",
       "book.empty":"这个分组还没有共享世界书。",
       "book.name":"书名",
@@ -82,6 +82,7 @@ window.__ModuleLoader__.load({
       "book.promoteSyncedDraft":"已同步当前草稿，删掉 {n} 条重复（否则保存时会把它们写回去）",
       "book.exportBook":"导出共享世界书 JSON",
       "book.exported":"已导出 {name}",
+      "book.exportedSt":"已导出 SillyTavern 世界书「{name}」—— 在 SillyTavern 里「世界信息 → 导入」选它即可",
       "book.applyCard":"合并进当前卡",
       "book.applyDone":"已往当前卡补了 {n} 条",
       "book.applyNone":"当前卡已包含这本共享书的全部条目。",
@@ -92,9 +93,11 @@ window.__ModuleLoader__.load({
       "book.saved":"已保存（rev {rev}）",
       // —— 0.9.0 导出页的共享书块 ——
       "export.book.title":"共享世界书",
-      "export.book.hint":"当前卡所属分组的共享设定可以单独导出（CCv3 lorebook_v3 格式）：在客户端里把它绑成全局世界书，多张成员卡共用一本。",
+      "export.book.hint":"当前卡所属分组的共享设定可以单独导出：CCv3 独立世界书给支持 lorebook_v3 的客户端当全局世界书；SillyTavern 世界书是 ST 原生形态（{entries:{…}}）—— ST 的导入接口只认这一种，拖 CCv3 那份进去会报 Bad Request。ST 里的顺序是**先导世界书、再导卡**：卡会自动带上绑定（data.extensions.world）；卡内私有条目还要在 ST 里点一次 Import Card Lore 才生效。",
+      "export.stWorldBound":"已写入 SillyTavern 世界书绑定「{name}」",
       "export.book.none":"当前卡不在任何分组里，或这个分组还没有共享世界书。",
-      "export.book.button":"⬇ 导出共享世界书",
+      "export.book.button":"⬇ CCv3 独立世界书",
+      "export.book.buttonSt":"⬇ SillyTavern 世界书",
       "export.book.merge":"导出 JSON 时把共享条目并入这张卡（给不支持全局世界书的客户端）",
       "export.book.merged":"（已并入 {n} 条共享条目）",
       "action.expand":"✦ AI 扩写",
@@ -272,11 +275,10 @@ window.__ModuleLoader__.load({
       "store.validateFailed":"校验未通过",
       "store.importedOk":"已导入 {k}：{name} · {n} lore（可在侧边栏 ★ 保存）",
       "store.importedSaved":"已导入并自动保存：{name}",
-      "store.errNotCcJson":"不是合法的 CCv3 JSON（缺少 spec）",
-      "store.errSpecMismatch":"spec 需为 chara_card_v3，当前为 {v}",
-      "store.errNoData":"缺少 data",
+      "store.importedUpgraded":"{v} 卡已升级为 CCv3",
       "store.errImportFailed":"导入失败：{msg}",
       "store.errReadFileFailed":"读取文件失败",
+      "store.parsingJson":"正在解析 JSON…",
       "store.parsingPng":"正在解析 PNG…",
       "store.errPngImportFailed":"PNG 导入失败：{msg}",
       "store.errReadPngFailed":"读取 PNG 失败",
@@ -374,7 +376,7 @@ window.__ModuleLoader__.load({
       "workshop.rel.dirLabel":"Direction",
       "workshop.rel.myCard":"current card",
       "book.title":"Shared lorebook",
-      "book.hint":"One book per group: put the world setting (timeline / factions / geography / power / daily) here and keep only character-private entries in each member card. The export is CCv3's standalone lorebook_v3 JSON — bind it as a global lorebook in your client and every member card shares one copy instead of repeating it.",
+      "book.hint":"One book per group: put the world setting (timeline / factions / geography / power / daily) here and keep only character-private entries in each member card. Two export formats: the CCv3 standalone lorebook (lorebook_v3, for clients that support the spec) and the SillyTavern lorebook (ST's importer only accepts the {entries:{…}} shape — feeding it the CCv3 file answers Bad Request).",
       "book.noGroup":"Shared lorebooks live on a group: create one under “Saved characters” on the right and put the member cards in it.",
       "book.empty":"This group has no shared lorebook yet.",
       "book.name":"Book name",
@@ -396,6 +398,7 @@ window.__ModuleLoader__.load({
       "book.promoteSyncedDraft":"Current draft synced — removed {n} duplicates (saving would have written them back)",
       "book.exportBook":"Export shared lorebook JSON",
       "book.exported":"Exported {name}",
+      "book.exportedSt":"Exported the SillyTavern lorebook “{name}” — pick it in SillyTavern via World Info → Import",
       "book.applyCard":"Merge into the current card",
       "book.applyDone":"Added {n} entries to the current card",
       "book.applyNone":"The current card already contains every entry of this book.",
@@ -405,9 +408,11 @@ window.__ModuleLoader__.load({
       "book.refresh":"Refresh",
       "book.saved":"Saved (rev {rev})",
       "export.book.title":"Shared lorebook",
-      "export.book.hint":"The shared setting of this card's group can be exported on its own (CCv3 lorebook_v3 format): bind it as a global lorebook in your client and every member card shares one copy.",
+      "export.book.hint":"The shared setting of this card's group can be exported on its own: the CCv3 standalone lorebook for clients that support lorebook_v3, and the SillyTavern lorebook in ST's native shape ({entries:{…}}) — ST's importer accepts nothing else, so feeding it the CCv3 file answers Bad Request. In ST, import the lorebook first and the card second: the card carries the binding automatically (data.extensions.world); the entries inside the card still need one “Import Card Lore” click.",
+      "export.stWorldBound":"SillyTavern world binding written: “{name}”",
       "export.book.none":"This card is in no group, or its group has no shared lorebook yet.",
-      "export.book.button":"⬇ Export shared lorebook",
+      "export.book.button":"⬇ CCv3 standalone lorebook",
+      "export.book.buttonSt":"⬇ SillyTavern lorebook",
       "export.book.merge":"Merge the shared entries into this card when exporting JSON (for clients without a global lorebook)",
       "export.book.merged":"({n} shared entries merged in)",
       "action.expand":"AI Expand",
@@ -585,11 +590,10 @@ window.__ModuleLoader__.load({
       "store.validateFailed":"Validation failed",
       "store.importedOk":"Imported {k}: {name} · {n} lore (★ Save in the sidebar)",
       "store.importedSaved":"Imported and auto-saved: {name}",
-      "store.errNotCcJson":"Not a valid CCv3 JSON (missing spec)",
-      "store.errSpecMismatch":"spec must be chara_card_v3, got {v}",
-      "store.errNoData":"missing data",
+      "store.importedUpgraded":"{v} card upgraded to CCv3",
       "store.errImportFailed":"Import failed: {msg}",
       "store.errReadFileFailed":"Failed to read the file",
+      "store.parsingJson":"Parsing JSON…",
       "store.parsingPng":"Parsing PNG…",
       "store.errPngImportFailed":"PNG import failed: {msg}",
       "store.errReadPngFailed":"Failed to read the PNG",
@@ -809,7 +813,11 @@ window.__ModuleLoader__.load({
         for(var i=0;i<bin.length;i++) bytes[i]=bin.charCodeAt(i);
         return bytes;
       }
-      function handleImportedDraft(obj, label){
+      /**
+       * 导入结果的统一收尾。`upgradedFrom` 非空 = 这份卡原来是 V2/V1（0.9.1 B2 自动升级成 CCv3），
+       * 必须在提示里说出来 —— 静默把一张 V2 卡变成 V3 形状不算「什么都没发生」。
+       */
+      function handleImportedDraft(obj, label, upgradedFrom){
         obj.spec_version=obj.spec_version||"3.0";
         obj.data.character_book=obj.data.character_book||{name:"",description:"",scan_depth:4,token_budget:1200,recursive_scanning:false,extensions:{},entries:[]};
         if(!Array.isArray(obj.data.character_book.entries)) obj.data.character_book.entries=[];
@@ -818,7 +826,9 @@ window.__ModuleLoader__.load({
         if(!Array.isArray(obj.data.tags)) obj.data.tags=[];
         if(!Array.isArray(obj.data.assets)) obj.data.assets=[{type:"icon",uri:"ccdefault:",name:"main",ext:"png"}];
         setDraftFromHost(obj);
-        set({currentLibraryId:null, lastMsg:t("store.importedOk",{k:label.trim(), name:(obj.data.name||t("workshop.library.unnamed")), n:(obj.data.character_book.entries.length||0)})});
+        var msg=t("store.importedOk",{k:label.trim(), name:(obj.data.name||t("workshop.library.unnamed")), n:(obj.data.character_book.entries.length||0)});
+        if(upgradedFrom) msg += " · " + t("store.importedUpgraded",{v:(String(upgradedFrom)==="chara_card_v1"? "V1":"V2")});
+        set({currentLibraryId:null, lastMsg: msg});
         setTimeout(pushDraftToHost,80);
         if(state.autoValidate) rpc("validate",{card:obj}).then(function(r){ if(r&&r.ok) set({valid:r.value}); }).catch(function(){});
         if(state.autoSaveOnImport){
@@ -846,16 +856,22 @@ window.__ModuleLoader__.load({
               else isJson=true;
             }
             if(isJson){
+              // 0.9.1（B2）：JSON 也交给宿主升级 —— 客户端以前自己 parse 且只认 chara_card_v3，
+              // 于是 ST 里导出的 V2 卡一张都进不来。现在三条导入路径（JSON/PNG/CHARX）共用宿主那份
+              // upgradeCardToV3，客户端只负责把文本递过去、把「已升级」说出来。
               var reader=new FileReader();
               reader.onload=function(){
                 try{
                   var text=String(reader.result||"");
-                  var obj=JSON.parse(text);
-                  if(obj && obj.draft && obj.draft.spec) obj=obj.draft;
-                  if(!obj || typeof obj!=="object" || !obj.spec) throw new Error(t("store.errNotCcJson"));
-                  if(obj.spec!=="chara_card_v3") throw new Error(t("store.errSpecMismatch",{v:String(obj.spec)}));
-                  if(!obj.data || typeof obj.data!=="object") throw new Error(t("store.errNoData"));
-                  handleImportedDraft(obj, " JSON");
+                  var sid=state.currentSessionId||null;
+                  var args=sid?{json:text, sessionId:sid}:{json:text};
+                  set({lastMsg:t("store.parsingJson"), busy:"importJson"});
+                  rpc("cc_importFromJson", args).then(function(res){
+                    set({busy:null});
+                    if(res && res.ok && res.value && res.value.draft){
+                      handleImportedDraft(res.value.draft, " JSON", res.value.upgradedFrom);
+                    } else set({lastMsg:t("store.errImportFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
+                  }).catch(function(e){ set({busy:null, lastMsg:t("store.errImportFailed",{msg:String(e&&e.message||e)})}); });
                 }catch(e){ set({lastMsg:t("store.errImportFailed",{msg:String(e&&e.message||e)})}); }
               };
               reader.onerror=function(){ set({lastMsg:t("store.errReadFileFailed")}); };
@@ -871,7 +887,7 @@ window.__ModuleLoader__.load({
                   rpc("cc_importFromPng", args).then(function(res){
                     set({busy:null});
                     if(res && res.ok && res.value && res.value.draft){
-                      handleImportedDraft(res.value.draft, " PNG");
+                      handleImportedDraft(res.value.draft, " PNG", res.value.upgradedFrom);
                     } else set({lastMsg:t("store.errPngImportFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
                   }).catch(function(e){ set({busy:null, lastMsg:t("store.errPngImportFailed",{msg:String(e&&e.message||e)})}); });
                 }catch(e){ set({lastMsg:t("store.errPngImportFailed",{msg:String(e&&e.message||e)})}); }
@@ -889,7 +905,7 @@ window.__ModuleLoader__.load({
                   rpc("cc_importFromCharx", args2).then(function(res){
                     set({busy:null});
                     if(res && res.ok && res.value && res.value.draft){
-                      handleImportedDraft(res.value.draft, " CHARX");
+                      handleImportedDraft(res.value.draft, " CHARX", res.value.upgradedFrom);
                     } else set({lastMsg:t("store.errCharxImportFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
                   }).catch(function(e){ set({busy:null, lastMsg:t("store.errCharxImportFailed",{msg:String(e&&e.message||e)})}); });
                 }catch(e){ set({lastMsg:t("store.errCharxImportFailed",{msg:String(e&&e.message||e)})}); }
@@ -907,9 +923,20 @@ window.__ModuleLoader__.load({
         var norm=function(e){ return String((e&&e.content)!=null? e.content : "").replace(/\s+/g," ").trim(); };
         var x=norm(a); return !!x && x===norm(b);
       }
+      /**
+       * ST 兼容层（0.9.1）：当前分组的共享书名 —— SillyTavern 的「角色↔世界书」绑定就是
+       * `data.extensions.world = <世界书文件名>`（`characters.js:391,617`），而我们导出的那本世界书
+       * 就叫 `<书名>.json`，所以把书名写进去即可。没有共享书时返回 ""（**不写**绑定，免得留一个悬空的名字）。
+       */
+      function stWorldName(){
+        var bk=state.book;
+        if(!bk || !bk.exists) return "";
+        return String((bk.book && bk.book.data && bk.book.data.name) || "").trim();
+      }
       /**
        * 导出 JSON。0.9.0：若在导出页勾了「并入共享条目」，则**只在导出的副本上**把该组的共享世界书
        * 里卡里还没有的条目补进去（给不支持全局世界书的客户端兜底）——草稿本身一个字节都不动。
+       * 0.9.1：同样只在副本上写 ST 的世界书绑定（`data.extensions.world`）。
        */
       function exportJSON(){
         var out=state.draft, merged=0;
@@ -924,13 +951,22 @@ window.__ModuleLoader__.load({
             merged=add.length;
           }
         }
+        var bound=stWorldName();
+        if(bound){
+          if(out===state.draft) out=JSON.parse(JSON.stringify(state.draft));
+          out.data.extensions=Object.assign({}, out.data.extensions);
+          out.data.extensions.world=bound;
+        }
         var blob=new Blob([JSON.stringify(out,null,2)],{type:"application/json"});
         var a=document.createElement("a"); a.href=URL.createObjectURL(blob); a.download=(state.draft.data.name||"card")+".json"; a.click(); setTimeout(function(){ URL.revokeObjectURL(a.href); },800);
-        set({lastMsg: merged? t("store.exportedJson") + " " + t("export.book.merged",{n:String(merged)}) : t("store.exportedJson")});
+        set({lastMsg: (merged? t("store.exportedJson") + " " + t("export.book.merged",{n:String(merged)}) : t("store.exportedJson"))
+          + (bound? " · " + t("export.stWorldBound",{name:bound}) : "")});
       }
       function exportPNG(){
         var sid=state.currentSessionId||null;
+        var bound=stWorldName();
         var args=sid?{sessionId:sid}:{};
+        if(bound) args.stWorld=bound;
         set({busy:"exportPng", lastMsg:t("store.generatingPng")});
         rpc("cc_exportPng", args).then(function(res){
           set({busy:null});
@@ -939,7 +975,7 @@ window.__ModuleLoader__.load({
               var bytes=b64ToBytes(res.value.b64);
               var blob=new Blob([bytes],{type:"image/png"});
               var a=document.createElement("a"); a.href=URL.createObjectURL(blob); a.download=res.value.filename||((state.draft.data.name||"card")+".png"); a.click(); setTimeout(function(){ URL.revokeObjectURL(a.href); },800);
-              set({lastMsg:t("store.exportedPng",{name:(res.value.filename||"card.png")})});
+              set({lastMsg:t("store.exportedPng",{name:(res.value.filename||"card.png")}) + (bound? " · " + t("export.stWorldBound",{name:bound}) : "")});
             }catch(e){ set({lastMsg:t("store.errPngExportFailed",{msg:String(e&&e.message||e)})}); }
           } else set({lastMsg:t("store.errPngExportFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
         }).catch(function(e){ set({busy:null, lastMsg:t("store.errPngExportFailed",{msg:String(e&&e.message||e)})}); });
@@ -956,7 +992,9 @@ window.__ModuleLoader__.load({
               try{
                 var b64=arrayBufferToB64(reader.result);
                 var sid=state.currentSessionId||null;
+                var bound=stWorldName();
                 var args=sid?{sessionId:sid, imageB64:b64}:{imageB64:b64};
+                if(bound) args.stWorld=bound;
                 set({busy:"exportPng", lastMsg:t("store.writingPng",{name:f.name})});
                 rpc("cc_exportPng", args).then(function(res){
                   set({busy:null});
@@ -965,7 +1003,7 @@ window.__ModuleLoader__.load({
                       var bytes=b64ToBytes(res.value.b64);
                       var blob=new Blob([bytes],{type:"image/png"});
                       var a=document.createElement("a"); a.href=URL.createObjectURL(blob); a.download=res.value.filename||((state.draft.data.name||"card")+".png"); a.click(); setTimeout(function(){ URL.revokeObjectURL(a.href); },800);
-                      set({lastMsg:t("store.wrotePng",{name:(res.value.filename||f.name)})});
+                      set({lastMsg:t("store.wrotePng",{name:(res.value.filename||f.name)}) + (bound? " · " + t("export.stWorldBound",{name:bound}) : "")});
                     }catch(e){ set({lastMsg:t("store.errWritePngFailed",{msg:String(e&&e.message||e)})}); }
                   } else set({lastMsg:t("store.errWritePngFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
                 }).catch(function(e){ set({busy:null, lastMsg:t("store.errWritePngFailed",{msg:String(e&&e.message||e)})}); });
@@ -979,7 +1017,9 @@ window.__ModuleLoader__.load({
       }
       function exportCharx(){
         var sid=state.currentSessionId||null;
+        var bound=stWorldName();
         var args=sid?{sessionId:sid}:{};
+        if(bound) args.stWorld=bound;
         set({busy:"exportCharx", lastMsg:t("store.generatingCharx")});
         rpc("cc_exportCharx", args).then(function(res){
           set({busy:null});
@@ -988,7 +1028,7 @@ window.__ModuleLoader__.load({
               var bytes2=b64ToBytes(res.value.b64);
               var blob2=new Blob([bytes2],{type:"application/zip"});
               var a2=document.createElement("a"); a2.href=URL.createObjectURL(blob2); a2.download=res.value.filename||((state.draft.data.name||"card")+".charx"); a2.click(); setTimeout(function(){ URL.revokeObjectURL(a2.href); },800);
-              set({lastMsg:t("store.exportedCharx",{name:(res.value.filename||"card.charx")})});
+              set({lastMsg:t("store.exportedCharx",{name:(res.value.filename||"card.charx")}) + (bound? " · " + t("export.stWorldBound",{name:bound}) : "")});
             }catch(e){ set({lastMsg:t("store.errCharxExportFailed",{msg:String(e&&e.message||e)})}); }
           } else set({lastMsg:t("store.errCharxExportFailed",{msg:(res&&res.error?String(res.error.message):t("common.unknownError"))})});
         }).catch(function(e){ set({busy:null, lastMsg:t("store.errCharxExportFailed",{msg:String(e&&e.message||e)})}); });
@@ -1183,6 +1223,152 @@ window.__ModuleLoader__.load({
           set({lastMsg: t("book.exported",{name:String(b.data.name||"")})});
         }catch(e){ set({lastMsg:String(e && e.message || e)}); }
       }
+      /**
+       * 共享世界书 → **SillyTavern 原生世界书**（`{ entries: { "<uid>": {...} } }`）。
+       *
+       * 为什么要另出一份文件（0.9.1，用户实机报告）：ST 服务端 `/api/worldinfo/import` 拿到文件后
+       * 第一件事就是 `if (!('entries' in worldContent)) throw`（SillyTavern `src/endpoints/worldinfo.js`），
+       * 而 CCv3 独立 lorebook 的顶层是 `{spec, data}` —— 于是用户把 `.lorebook.json` 拖进 ST，看到的是
+       * `Error importing world info: … Bad Request`。ST 客户端那条 `importWorldInfo()` 也只转
+       * Novel / Agnai / Risu 三种格式，1.19.0 的整份 `world-info.js` 里**搜不到 `lorebook_v3`** ——
+       * 所以这不是「换个后缀」能解决的，是规范本身 ST 不认，必须按它的形态另导一份。
+       *
+       * 条目映射照抄 ST 自己的 `convertCharacterBook()`（ST 唯一权威的 CC 书转换器，1.19.0）：
+       * uid←id、key←keys、keysecondary←secondary_keys、comment←comment/name、content←content、
+       * order←insertion_order、disable←!enabled、addMemo←有没有标题，其余可调项一律从
+       * `extensions.*` 取（`cc_auto` / `cc_world_ref` 也随 `extensions` 原样带过去 —— ST 的条目本来
+       * 就有这个自由字段）。
+       *
+       * 唯一 ST 自己做不到、必须我们补的是 **`@@position` / `@@depth` 装饰器**：ST 的
+       * `parseDecorators()` 只认 `@@activate` / `@@dont_activate`（`KNOWN_DECORATORS`），其余 `@@` 行
+       * **连同正文一起被丢掉**（它从第一个非 `@@` 行开始截取正文）—— 不翻译的话，自动生成的 5 条会
+       * 全部落在默认插入位置、装饰器静默消失。所以这两类翻译成 ST 字段并删掉该行；`@@activate`
+       * 留给 ST 自己认（它本来就有这个语义，硬翻成 constant 只是多一层猜测）。
+       */
+      var ST_ENTRY_TEMPLATE = { key:[], keysecondary:[], comment:"", content:"", constant:false, vectorized:false, selective:true, selectiveLogic:0, addMemo:false, order:100, position:0, disable:false, ignoreBudget:false, excludeRecursion:false, preventRecursion:false, matchPersonaDescription:false, matchCharacterDescription:false, matchCharacterPersonality:false, matchCharacterDepthPrompt:false, matchScenario:false, matchCreatorNotes:false, delayUntilRecursion:0, probability:100, useProbability:true, depth:4, outletName:"", group:"", groupOverride:false, groupWeight:100, scanDepth:null, caseSensitive:null, matchWholeWords:null, useGroupScoring:null, automationId:"", role:0, sticky:null, cooldown:null, delay:null, triggers:[] };
+      /** ST 的 `world_info_position`：before=0 / after=1 / ANTop=2 / ANBottom=3 / atDepth=4 / EMTop=5 / EMBottom=6。 */
+      var ST_POSITION = { before:0, before_char:0, before_desc:0, after:1, after_char:1, after_desc:1, an_top:2, antop:2, an_bottom:3, anbottom:3, at_depth:4, atdepth:4, em_top:5, emtop:5, em_bottom:6, embottom:6 };
+      /** ST 的 `??` 语义：`extensions.<key>` 优先，缺省才用默认值（与 convertCharacterBook 逐行对应）。 */
+      function stExt(ext, key, dflt){ var v = ext[key]; return (v === undefined || v === null)? dflt : v; }
+      /**
+       * 解析正文**开头连续**的 `@@` 行（与 ST 的 `parseDecorators` 同构：只认开头那一段）。
+       * 只翻译 ST 认不出的 `@@position` / `@@depth`；`@@activate` / `@@dont_activate` 与未知写法
+       * 原样留下 —— ST 或者自己有语义、或者自己会丢，我们不猜。
+       */
+      function unfurlBookDecorators(content){
+        var text = String(content == null? "" : content);
+        var lines = text.split("\n");
+        var drop = [], pos = null, depth = null;
+        for(var i=0;i<lines.length;i++){
+          var line = lines[i];
+          if(line.slice(0,2) !== "@@") break;                    // 装饰器区到头
+          if(line.slice(0,3) === "@@@") break;                   // ST 的转义写法：后面全当原文，不碰
+          var m = /^@@([a-z_]+)(?:\s+(.*))?$/.exec(line.trim());
+          if(!m) break;                                          // 语法可疑：整段交给 ST 自己处理
+          var name = m[1], arg = String(m[2] == null? "" : m[2]).trim();
+          if(name === "position"){
+            // ST 没有「scenario」之类插入点；ST 自己的 convertCharacterBook 对除 before_char 之外的
+            // 一律当 after —— 认不出的值就跟它的回退走，不自己发明位置。
+            var p = ST_POSITION[arg.toLowerCase().replace(/[\s-]+/g,"_")];
+            pos = (typeof p === "number")? p : 1;
+            drop.push(i);
+          } else if(name === "depth"){
+            var n = parseInt(arg, 10);
+            if(isFinite(n) && n >= 0){ depth = n; pos = 4; drop.push(i); }   // atDepth
+          }
+        }
+        if(!drop.length) return { position:null, depth:null, content:text };
+        var kept = lines.filter(function(_, i){ return drop.indexOf(i) < 0; });
+        while(kept.length && !String(kept[0]).trim()) kept.shift();          // 删掉装饰器后留下的空行
+        return { position:pos, depth:depth, content: kept.join("\n") };
+      }
+      /** 单条共享书条目 → ST 条目（字段映射与优先级见上面那段注释）。 */
+      function bookEntryToSt(entry, index){
+        var e = entry || {};
+        var ext = (e.extensions && typeof e.extensions === "object")? e.extensions : {};
+        var dec = unfurlBookDecorators(e.content);
+        var title = String(e.comment || e.name || "");
+        var pos = dec.position;
+        if(pos === null) pos = (typeof ext.position === "number")? ext.position : null;  // ST 自己的位置偏好
+        if(pos === null) pos = (String(e.position || "") === "before_char")? 0 : 1;      // ST convertCharacterBook 的判据
+        var id = (e.id === undefined || e.id === null || e.id === "")? index : e.id;
+        var out = Object.assign({}, ST_ENTRY_TEMPLATE, {
+          uid: id,
+          key: Array.isArray(e.keys)? e.keys.map(String) : [],
+          keysecondary: Array.isArray(e.secondary_keys)? e.secondary_keys.map(String) : [],
+          comment: title,
+          content: dec.content,
+          constant: e.constant === true,
+          selective: e.selective === true,
+          selectiveLogic: stExt(ext, "selectiveLogic", 0),
+          addMemo: !!title,
+          order: (typeof e.insertion_order === "number")? e.insertion_order : 100,
+          position: pos,
+          disable: e.enabled === false,
+          ignoreBudget: ext.ignore_budget === true,
+          excludeRecursion: stExt(ext, "exclude_recursion", false),
+          preventRecursion: stExt(ext, "prevent_recursion", false),
+          matchPersonaDescription: stExt(ext, "match_persona_description", false),
+          matchCharacterDescription: stExt(ext, "match_character_description", false),
+          matchCharacterPersonality: stExt(ext, "match_character_personality", false),
+          matchCharacterDepthPrompt: stExt(ext, "match_character_depth_prompt", false),
+          matchScenario: stExt(ext, "match_scenario", false),
+          matchCreatorNotes: stExt(ext, "match_creator_notes", false),
+          delayUntilRecursion: stExt(ext, "delay_until_recursion", 0),
+          probability: stExt(ext, "probability", 100),
+          useProbability: stExt(ext, "useProbability", true),
+          depth: stExt(ext, "depth", 4),
+          outletName: stExt(ext, "outlet_name", ""),
+          group: stExt(ext, "group", ""),
+          groupOverride: stExt(ext, "group_override", false),
+          groupWeight: stExt(ext, "group_weight", 100),
+          scanDepth: stExt(ext, "scan_depth", null),
+          caseSensitive: stExt(ext, "case_sensitive", null),
+          matchWholeWords: stExt(ext, "match_whole_words", null),
+          useGroupScoring: stExt(ext, "use_group_scoring", null),
+          automationId: stExt(ext, "automation_id", ""),
+          role: stExt(ext, "role", 0),
+          vectorized: stExt(ext, "vectorized", false),
+          sticky: stExt(ext, "sticky", null),
+          cooldown: stExt(ext, "cooldown", null),
+          delay: stExt(ext, "delay", null),
+          displayIndex: stExt(ext, "display_index", index),
+          extensions: ext,
+          triggers: Array.isArray(ext.triggers)? ext.triggers.slice() : [],
+        });
+        if(dec.depth !== null && typeof dec.depth === "number") out.depth = dec.depth;
+        return out;
+      }
+      /**
+       * 整本书 → ST 世界书。顶层只留 `entries`：ST 的世界文件就是这个形状，多一个 `spec` 就 400；
+       * `data.extensions.cc`（rev / groupId / lastPromote）是插件自己的状态，不往外带。
+       */
+      function bookToStWorldInfo(data){
+        var d = data || {};
+        var out = { entries: {} };
+        (Array.isArray(d.entries)? d.entries : []).forEach(function(e, i){
+          var st = bookEntryToSt(e, i);
+          out.entries[String(st.uid)] = st;
+        });
+        return out;
+      }
+      /**
+       * 导出 SillyTavern 世界书。文件名 = ST 里的世界书名（ST 用**上传文件名**建世界），所以这里
+       * 不能再挂 CCv3 那份的 `.lorebook` 后缀，否则导入后书名会变成「锁天司·共享设定.lorebook」。
+       */
+      function exportBookStFile(){
+        var b = state.book && state.book.book;
+        if(!b) return;
+        try{
+          var name = String((b.data && b.data.name) || "").trim() || "shared-lorebook";
+          var blob = new Blob([JSON.stringify(bookToStWorldInfo(b.data), null, 2)], {type:"application/json"});
+          var a=document.createElement("a"); a.href=URL.createObjectURL(blob);
+          a.download = name.replace(/[\\/:*?"<>|]/g,"_") + ".json";
+          a.click();
+          setTimeout(function(){ URL.revokeObjectURL(a.href); }, 800);
+          set({lastMsg: t("book.exportedSt",{name:name})});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+      }
       function setBookMerge(v){ set({bookMerge: !!v}); }
       async function createGroup(nameArg){
         // 0.8.1：不再依赖 window.prompt（内嵌 webview 会拦掉原生对话框 → 用户看到的是「点了没反应」）。
@@ -1408,7 +1594,7 @@ window.__ModuleLoader__.load({
       // 0.4.1：这里原本还有一个 exportLibraryEntry —— 直接下载某张已存角色的 JSON。
       // 三个导出入口归一之后，卡片上的「导出」改成切到导出页，导出动作只剩导出页那一套实现，
       // 这条旁路就没有调用者了（留着它等于「同一次导出有两套行为」），故删除。
-      return { getSnapshot:getSnapshot, subscribe:subscribe, setCur:setCur, setPanel:setPanel, setSideExpanded:setSideExpanded, setIsCcMode:setIsCcMode, setDraftFromHost:setDraftFromHost, setSessionId:setSessionId, setSlotWarn:setSlotWarn, setAlternateSlots:setAlternateSlots, migrateSlot:migrateSlot, checkIsCcMode:checkIsCcMode, setPollEnabled:setPollEnabled, setPollInterval:setPollInterval, setAutoValidate:setAutoValidate, setAutoSaveOnImport:setAutoSaveOnImport, updateDraft:updateDraft, validate:validate, exportJSON:exportJSON, exportPNG:exportPNG, embedIntoPng:embedIntoPng, exportCharx:exportCharx, importJSON:importJSON, importAny:importAny, setWorldPatch:setWorldPatch, setEditingWorld:setEditingWorld, cancelEditingWorld:cancelEditingWorld, setEditingText:setEditingText, clearEditingText:clearEditingText, cancelEditingText:cancelEditingText, updateEditingText:updateEditingText, addEntry:addEntry, setLibraryQuery:setLibraryQuery, toggleLibraryCollapsed:toggleLibraryCollapsed, refreshLibrary:refreshLibrary, saveCurrentToLibrary:saveCurrentToLibrary, saveAsNewToLibrary:saveAsNewToLibrary, clearCurrentLibraryId:clearCurrentLibraryId, clearDraft:clearDraft, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, renameCurrentInLibrary:renameCurrentInLibrary, setCurrentGroupId:setCurrentGroupId, refreshGroups:refreshGroups, createGroup:createGroup, loadGroup:loadGroup, assignGroup:assignGroup, deleteGroup:deleteGroup, patchRelations:patchRelations, checkGroupNow:checkGroupNow, renderRelationsToCard:renderRelationsToCard, openRelations:openRelations, openRelationsFor:openRelationsFor, loadBook:loadBook, patchBook:patchBook, promoteBook:promoteBook, applyBook:applyBook, exportBookFile:exportBookFile, setBookMerge:setBookMerge };
+      return { getSnapshot:getSnapshot, subscribe:subscribe, setCur:setCur, setPanel:setPanel, setSideExpanded:setSideExpanded, setIsCcMode:setIsCcMode, setDraftFromHost:setDraftFromHost, setSessionId:setSessionId, setSlotWarn:setSlotWarn, setAlternateSlots:setAlternateSlots, migrateSlot:migrateSlot, checkIsCcMode:checkIsCcMode, setPollEnabled:setPollEnabled, setPollInterval:setPollInterval, setAutoValidate:setAutoValidate, setAutoSaveOnImport:setAutoSaveOnImport, updateDraft:updateDraft, validate:validate, exportJSON:exportJSON, exportPNG:exportPNG, embedIntoPng:embedIntoPng, exportCharx:exportCharx, importJSON:importJSON, importAny:importAny, setWorldPatch:setWorldPatch, setEditingWorld:setEditingWorld, cancelEditingWorld:cancelEditingWorld, setEditingText:setEditingText, clearEditingText:clearEditingText, cancelEditingText:cancelEditingText, updateEditingText:updateEditingText, addEntry:addEntry, setLibraryQuery:setLibraryQuery, toggleLibraryCollapsed:toggleLibraryCollapsed, refreshLibrary:refreshLibrary, saveCurrentToLibrary:saveCurrentToLibrary, saveAsNewToLibrary:saveAsNewToLibrary, clearCurrentLibraryId:clearCurrentLibraryId, clearDraft:clearDraft, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, renameCurrentInLibrary:renameCurrentInLibrary, setCurrentGroupId:setCurrentGroupId, refreshGroups:refreshGroups, createGroup:createGroup, loadGroup:loadGroup, assignGroup:assignGroup, deleteGroup:deleteGroup, patchRelations:patchRelations, checkGroupNow:checkGroupNow, renderRelationsToCard:renderRelationsToCard, openRelations:openRelations, openRelationsFor:openRelationsFor, loadBook:loadBook, patchBook:patchBook, promoteBook:promoteBook, applyBook:applyBook, exportBookFile:exportBookFile, exportBookStFile:exportBookStFile, setBookMerge:setBookMerge };
     }
 
     var S={
@@ -1974,6 +2160,7 @@ window.__ModuleLoader__.load({
             h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", marginBottom:10, lineHeight:1.7}}, t("export.book.hint")),
             h("div",{style:{display:"flex", gap:8, flexWrap:"wrap"}},
               h("button",{type:"button", style:S.btn, onMouseDown:stopFocusSteal, onClick:function(){ store.exportBookFile(); }}, t("export.book.button")),
+              h("button",{type:"button", style:Object.assign({}, S.btn, S.btnGhost), onMouseDown:stopFocusSteal, onClick:function(){ store.exportBookStFile(); }}, t("export.book.buttonSt")),
               h("button",{type:"button", style:Object.assign({}, S.btn, S.btnGhost), onMouseDown:stopFocusSteal, disabled: s.bookBusy==="apply", onClick:function(){ store.applyBook(); }}, s.bookBusy==="apply"? "…" : t("book.applyCard")),
               h("button",{type:"button", style:Object.assign({}, S.btn, S.btnGhost), onMouseDown:stopFocusSteal, onClick:function(){ store.loadBook(); }}, t("book.refresh"))),
             s.lastMsg? h("div",{style:{marginTop:10, fontSize:12, color:"var(--dsw-alias-label-secondary)"}}, s.lastMsg):null) : null
@@ -2059,6 +2246,7 @@ window.__ModuleLoader__.load({
                 h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", margin:"6px 0 8px", lineHeight:1.7}}, t("export.book.hint")),
                 h("div",{style:{display:"flex", gap:8, flexWrap:"wrap", alignItems:"center"}},
                   h("button",{type:"button", style:S.btn, onMouseDown:stopFocusSteal, onClick:function(){ store.exportBookFile(); }}, t("export.book.button")),
+                  h("button",{type:"button", style:Object.assign({}, S.btn, S.btnGhost), onMouseDown:stopFocusSteal, onClick:function(){ store.exportBookStFile(); }}, t("export.book.buttonSt")),
                   h("label",{style:{display:"flex", alignItems:"center", gap:6, fontSize:11, color:"var(--dsw-alias-label-secondary)", cursor:"pointer"}},
                     h("input",{type:"checkbox", checked:!!s.bookMerge, onChange:function(ev){ store.setBookMerge(ev.target.checked); }}),
                     t("export.book.merge"))));

package/lib/index.js

@@ -743,11 +743,65 @@ async function readLibraryRaw(id){
   throw lastErr || new Error("找不到角色卡: " + String(id));
 }
 // ========== PNG / CHARX 共享 ==========
+/** tags 在 V1/ST 那边可能是逗号分隔的字符串；V2/V3 要数组。 */
+function normTags(v){
+  if(Array.isArray(v)) return v.map(function(x){ return String(x); });
+  if(typeof v==="string") return v.split(",").map(function(s){ return s.trim(); }).filter(Boolean);
+  return [];
+}
+/**
+ * V2（乃至 V1）卡 → CCv3 升级（0.9.1 的 B2）。返回 `{card, from}`，`from` 为 null = 本来就是 V3。
+ *
+ * 为什么做：SillyTavern 里**绝大多数存量卡是 V2**（ST 界面新建的就是 V2 形状，ST 只是把 `spec` 改写成
+ * 了 v3 标签），而工坊此前只收 `chara_card_v3` —— 用户把 ST 里那张卡的 PNG/JSON 拖进来，只会得到
+ * 一句「spec 需为 chara_card_v3」。升级规则照 ST 自己的 `readFromV2()`（`characters.js:504-556`）：
+ * 顶层那些 V1 平铺字段并进 `data`（**只在 `data` 里没有该值时**，不覆盖 V2 自己的值），其余不认识
+ * 的字段原样留着。`from` 交给调用方，用来**明确告诉用户「这份是升上来的」**（不静默变换）。
+ */
+function upgradeCardToV3(obj){
+  if(!obj || typeof obj!=="object") throw new Error("卡必须是对象");
+  if(obj.spec==="chara_card_v3" && obj.data && typeof obj.data==="object") return { card: obj, from: null, copied: [] };
+  const out=JSON.parse(JSON.stringify(obj));
+  const copied=[];
+  const hasData=!!(out.data && typeof out.data==="object");
+  if(!hasData){
+    // 纯 V1：整份包成 data
+    const flat={};
+    ["name","description","personality","scenario","first_mes","mes_example"].forEach(function(k){ if(out[k]!==undefined) flat[k]=out[k]; });
+    flat.creator_notes = out.creator_notes!==undefined? out.creator_notes : (out.creatorcomment!==undefined? out.creatorcomment : "");
+    flat.system_prompt="";
+    flat.post_history_instructions="";
+    flat.alternate_greetings=Array.isArray(out.alternate_greetings)? out.alternate_greetings : [];
+    flat.tags=normTags(out.tags);
+    flat.creator=out.creator!==undefined? out.creator : "";
+    flat.character_version=out.character_version!==undefined? out.character_version : "";
+    flat.extensions={};
+    if(out.talkativeness!==undefined) flat.extensions.talkativeness=out.talkativeness;
+    if(out.fav!==undefined) flat.extensions.fav=out.fav===true;
+    out.data=flat;
+  } else {
+    out.data.extensions=(out.data.extensions && typeof out.data.extensions==="object")? out.data.extensions : {};
+    ["name","description","personality","scenario","first_mes","mes_example"].forEach(function(k){
+      if(out.data[k]===undefined && out[k]!==undefined){ out.data[k]=out[k]; copied.push("data."+k); }
+    });
+    if(out.data.tags===undefined && out.tags!==undefined){ out.data.tags=normTags(out.tags); copied.push("data.tags"); }
+    if(out.data.creator_notes===undefined){
+      if(out.creator_notes!==undefined){ out.data.creator_notes=out.creator_notes; copied.push("data.creator_notes"); }
+      else if(out.creatorcomment!==undefined){ out.data.creator_notes=out.creatorcomment; copied.push("data.creator_notes"); }
+    }
+    if(out.talkativeness!==undefined && out.data.extensions.talkativeness===undefined){ out.data.extensions.talkativeness=out.talkativeness; copied.push("data.extensions.talkativeness"); }
+    if(out.fav!==undefined && out.data.extensions.fav===undefined){ out.data.extensions.fav=out.fav===true; copied.push("data.extensions.fav"); }
+  }
+  const from=String(out.spec || (hasData? "chara_card_v2" : "chara_card_v1"));
+  if(typeof out.data.name!=="string" || !out.data.name.trim()) throw new Error("不是可识别的卡片（没有名称，spec="+from+"）");
+  out.spec="chara_card_v3";
+  out.spec_version="3.0";
+  return { card: out, from: from, copied: copied };
+}
 function normalizeDraft(d){
   if(!d || typeof d!=="object") throw new Error("draft 必须是对象");
-  if(!d.spec) throw new Error("缺少 spec");
-  if(d.spec!=="chara_card_v3") throw new Error("spec 需为 chara_card_v3，当前 "+String(d.spec));
-  if(!d.data || typeof d.data!=="object") throw new Error("缺少 data");
+  // V2/V1 一律**升级**而不是拒绝（B2）；本来就是 V3 时 up.card 就是原对象
+  d=upgradeCardToV3(d).card;
   d.spec_version=d.spec_version||"3.0";
   d.data.character_book=d.data.character_book||{name:"",description:"",scan_depth:4,token_budget:1200,recursive_scanning:false,extensions:{},entries:[]};
   if(!Array.isArray(d.data.character_book.entries)) d.data.character_book.entries=[];
@@ -777,8 +831,7 @@ function b64DecodeBytes(b64){ return new Uint8Array(Buffer.from(String(b64),"bas
 function extractCardFromPngBytes(bytes){
   if(bytes.length<8 || bytes[0]!==0x89 || bytes[1]!==0x50) throw new Error("不是合法 PNG（缺少 PNG 签名）");
   let off=8;
-  let found=null;
-  let lastError=null;
+  let v3=null, v2=null, sawCardChunk=false, lastError=null;
   while(off+8 <= bytes.length){
     const len=(bytes[off]<<24)|(bytes[off+1]<<16)|(bytes[off+2]<<8)|bytes[off+3];
     if(len<0 || len> 20*1024*1024) break;
@@ -789,15 +842,19 @@ function extractCardFromPngBytes(bytes){
       try{
         const zero=data.indexOf(0);
         if(zero>=0){
-          const keyword=bytesToStr(data.slice(0,zero));
-          const text=bytesToStr(data.slice(zero+1));
-          const kw=String(keyword).trim().toLowerCase();
+          const kw=String(bytesToStr(data.slice(0,zero))).trim().toLowerCase();
           if(kw==="ccv3" || kw==="ccv3_card" || kw==="chara" || kw==="chara_card_v3"){
-            let jsonStr=text.trim();
+            sawCardChunk=true;
+            let jsonStr=bytesToStr(data.slice(zero+1)).trim();
             try{ const decoded=bytesToStr(b64DecodeBytes(jsonStr)); if(decoded.trim().startsWith("{")) jsonStr=decoded; }catch{}
             const obj=JSON.parse(jsonStr);
-            if(obj && obj.spec){ found=obj; break; }
-            if(obj && obj.data){ found={spec:"chara_card_v3",spec_version:"3.0",data:obj}; break; }
+            const cand=(obj && obj.spec)? obj : ((obj && obj.data)? {spec:"chara_card_v3",spec_version:"3.0",data:obj} : null);
+            // 判据用**载荷里的 spec**，不用块名：规范允许 `chara` 块里放回填用的 V2 对象，但现实里
+            // 也有工具把 V3 卡塞进 `chara`（我们自己历史上就写过 `chara_card_v3` 这个块名）。
+            if(cand && cand.data){
+              if(String(cand.spec)==="chara_card_v3"){ if(!v3) v3=cand; if(v3) break; }
+              else if(!v2) v2=cand;
+            }
           }
         }
       }catch(e){ lastError=e; }
@@ -807,33 +864,103 @@ function extractCardFromPngBytes(bytes){
     if(type==="IEND") break;
     off+=12+len;
   }
-  if(!found) throw new Error(lastError? String(lastError.message):"PNG 未找到 ccv3/chara 块（tEXt ccv3），请确认是否为 CCv3 PNG");
-  if(found.data) return found;
+  // 两个块都在时**必须**取 ccv3 —— 规范原文：「if the application detects both `chara` and `ccv3` chunk,
+  // the application *SHOULD* use the `ccv3` chunk」。SillyTavern 自己导出的 PNG 就是 chara 在前、ccv3 在后，
+  // 旧实现「取第一个命中的块」于是读到 V2 那份，再把 spec=chara_card_v2 的卡交给 normalizeDraft 直接报错。
+  if(v3) return v3;
+  // 只有 V2 块（ST 里那张卡的 `chara` 块、或只写过 chara 的老工具）：照样交出去，
+  // 由 normalizeDraft → upgradeCardToV3 升级成 CCv3（B2：升级而不是拒绝）。
+  if(v2) return v2;
+  if(!sawCardChunk) throw new Error(lastError? String(lastError.message):"PNG 未找到 ccv3/chara 块（tEXt ccv3），请确认是否为 CCv3 PNG");
   throw new Error("PNG 内卡格式错误");
 }
-function buildTEXtChunk(cardJson){
+// ========== SillyTavern / V2 兼容层（0.9.1）==========
+// 原则：**底层永远是纯 CCv3**，兼容层只在「导出的那一份副本」上生成（草稿与库里的卡一个字节都不动）。
+// 两个落点，都是规范允许的位置：
+//   ① PNG 的 `chara` 块 = 诚实的 CharacterCardV2 投影（见 pngCardChunks 注释）；
+//   ② `data.extensions.world` = ST 的「角色↔世界书」绑定（ST 只认这个字符串，`characters.js:391,617`）。
+// 规范明文禁止的是「往 CharacterCard 对象里加应用私有字段」（那张卡顶层加 V1 平铺字段就是这一类），所以
+// 我们**不**学 ST 那么干 —— ST 需要的东西全部落在 `extensions` / `chara` 块 / CHARX 资源里。
+/** V2 的 data 字段集（V3 独有的 nickname / creator_notes_multilingual / source / group_only_greetings /
+ *  assets / creation_date / modification_date 一个都不进 —— 那些字段在 V2 里不存在）。 */
+const V2_DATA_FIELDS=["name","description","personality","scenario","first_mes","mes_example","creator_notes",
+  "system_prompt","post_history_instructions","alternate_greetings","character_book","tags","creator","character_version","extensions"];
+/** 摘掉正文**开头连续**的 `@@` 装饰器行（含其后遗留的空行）—— 规范要求回填 V2 时移除全部装饰器。 */
+function stripDecorators(content){
+  const lines=String(content==null? "" : content).split("\n");
+  let i=0;
+  while(i<lines.length && String(lines[i]).slice(0,2)==="@@") i++;
+  while(i<lines.length && !String(lines[i]).trim()) i++;
+  return lines.slice(i).join("\n");
+}
+/** 整张卡 → CharacterCardV2 对象（PNG 的 `chara` 块用；只做投影，不改调用方传进来的对象）。 */
+function stV2Projection(card){
+  const src=(card && typeof card==="object")? card : {};
+  const d=(src.data && typeof src.data==="object")? src.data : {};
+  const data={};
+  V2_DATA_FIELDS.forEach(function(k){
+    if(d[k]===undefined) return;
+    if(k==="character_book"){
+      const book=JSON.parse(JSON.stringify(d[k]));
+      if(book && Array.isArray(book.entries)) book.entries.forEach(function(e){ if(e && typeof e==="object") e.content=stripDecorators(e.content); });
+      data[k]=book;
+      return;
+    }
+    data[k]=d[k];
+  });
+  return { spec:"chara_card_v2", spec_version:"2.0", data };
+}
+/**
+ * 导出副本上写 ST 的世界书绑定。ST 的绑定就是 `data.extensions.world = <世界书文件名>`；
+ * 我们的共享书导出成 `<书名>.json`，所以这里直接写书名 —— 用户在 ST 里导完那本世界书，
+ * 再导这张卡，绑定就自动接上了（没导书时它只是个悬空字符串，ST 不会报错）。
+ * ⚠️ 只在导出副本上做（同「并入本卡」的家规）：草稿与库里的卡不许被这个 ST 专有字段污染。
+ */
+function withStWorld(card, world){
+  const name=String(world==null? "" : world).trim();
+  if(!name) return card;
+  const out=JSON.parse(JSON.stringify(card));
+  out.data=out.data||{};
+  out.data.extensions=Object.assign({}, out.data.extensions);
+  out.data.extensions.world=name;
+  return out;
+}
+function buildTEXtChunk(cardJson, keyword){
   const jsonStr=JSON.stringify(cardJson);
   const b64=Buffer.from(jsonStr,"utf8").toString("base64");
-  const keyword=strToBytes("ccv3");
+  const kwBytes=strToBytes(keyword||"ccv3");
   const textBytes=strToBytes(b64);
-  const chunkData=concatBytes([keyword, new Uint8Array([0]), textBytes]);
+  const chunkData=concatBytes([kwBytes, new Uint8Array([0]), textBytes]);
   const typeBytes=strToBytes("tEXt");
   const crc=crc32(concatBytes([typeBytes, chunkData]));
   return concatBytes([u32be(chunkData.length), typeBytes, chunkData, u32be(crc)]);
 }
+/**
+ * 一张卡要写进 PNG 的两个 tEXt 块：`chara`（V2 投影，给只认 V2 的读取器回填）+ `ccv3`（纯 CCv3，规范里的 MUST）。
+ *
+ * 规范（SPEC_V3「PNG/APNG」节，0.9.1 实测对齐）：
+ * ① `ccv3` 块 MUST 存在，值是 CharacterCardV3 对象的 utf-8→base64；
+ * ② 应用 MAY 用 `chara` 块回填 V2 对象；两个块都在时读取方 **SHOULD** 用 `ccv3`；
+ * ③ 「On backfilling V2, the application SHOULD remove all decorators」—— 所以投影里要摘掉 `@@` 装饰器行。
+ * SillyTavern 自己也是两个块都写（`src/character-card-parser.js:15-46`），且 `chara` 在前 —— 这里保持同样顺序。
+ * ⚠️ 卡片 JSON 的**顶层**绝不许加 ST 的私有字段（V1 平铺那套）：规范同节写着应用 MUST follow the
+ * specification、私有数据只能放 `extensions` —— 兼容层只活在 `chara` 这一块与 `extensions.world` 里。
+ */
+function pngCardChunks(cardJson){
+  return [buildTEXtChunk(stV2Projection(cardJson), "chara"), buildTEXtChunk(cardJson, "ccv3")];
+}
 function buildPngWithCard(cardJson){
-  const chunk=buildTEXtChunk(cardJson);
   const baseB64="iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+ip1sAAAAASUVORK5CYII=";
   const base=new Uint8Array(Buffer.from(baseB64,"base64"));
   const iendOff=base.length-12;
   const head=base.slice(0,iendOff);
   const tail=base.slice(iendOff);
-  return concatBytes([head, chunk, tail]);
+  return concatBytes([head].concat(pngCardChunks(cardJson), [tail]));
 }
 function embedCardIntoPngBytes(pngBytes, cardJson){
   if(pngBytes.length<8 || pngBytes[0]!==0x89 || pngBytes[1]!==0x50) throw new Error("不是合法 PNG（缺少 PNG 签名）");
   if(pngBytes.length > 15*1024*1024) throw new Error("PNG 过大（>15MB）");
-  const newChunk=buildTEXtChunk(cardJson);
+  const newChunks=pngCardChunks(cardJson);
   let off=8;
   const parts=[pngBytes.slice(0,8)];
   let inserted=false;
@@ -845,7 +972,7 @@ function embedCardIntoPngBytes(pngBytes, cardJson){
     const data=pngBytes.slice(off+8, off+8+len);
     const chunkBytes=pngBytes.slice(off, off+12+len);
     if(type==="IEND"){
-      parts.push(newChunk);
+      newChunks.forEach(function(c){ parts.push(c); });
       parts.push(chunkBytes);
       inserted=true;
       break;
@@ -1854,29 +1981,54 @@ function apply(ctx, config){
           const b64 = args.b64;
           if(typeof b64!=="string" || !b64) return fail("invalid-b64","b64 必填");
           if(b64.length > 20*1024*1024) return fail("too-large","PNG 过大（>20MB base64）");
-          let draft;
+          let draft, upgradedFrom = null;
           try{
             const bytes = b64DecodeBytes(b64);
             if(bytes.length > 15*1024*1024) return fail("too-large","PNG 过大（>15MB）");
             draft = extractCardFromPngBytes(bytes);
+            // B2：只有 V2 块时也能进（升级而不是拒绝）—— upgradedFrom 让界面把这件事说出来
+            upgradedFrom = upgradeCardToV3(draft).from;
             draft = normalizeDraft(draft);
           }catch(e){ return fail("parse-failed", String(e.message)); }
           const k = draftKeyFrom(ctx, args);
           setDraftFor(k, draft);
-          return ok({ draft, key:k, draftStatus: draftStatusFor(k, draft) });
+          return ok({ draft, key:k, draftStatus: draftStatusFor(k, draft), upgradedFrom });
+        }
+        case "cc_importFromJson":{
+          // 工坊拖进来的 .json 走这里（0.9.1，B2）：V2/V1 卡**升级**成 CCv3，而不是让界面报「spec 不符」。
+          // 客户端此前自己 parse + 只认 chara_card_v3 —— 于是 ST 里导出的卡一张都进不来。
+          const raw = args.json;
+          let obj = null;
+          try{
+            obj = (raw && typeof raw === "object")? raw : JSON.parse(String(raw==null? "" : raw));
+          }catch(e){ return fail("parse-failed", "不是合法 JSON："+String(e.message)); }
+          // 自家草稿文件 / 导出包是 `{key, updatedAt, rev, draft}`，先脱一层
+          if(obj && typeof obj==="object" && obj.draft && typeof obj.draft==="object" && !obj.data) obj = obj.draft;
+          let draft, upgradedFrom = null;
+          try{
+            upgradedFrom = upgradeCardToV3(obj).from;
+            draft = normalizeDraft(obj);
+          }catch(e){ return fail("invalid-card", String(e.message)); }
+          const k = draftKeyFrom(ctx, args);
+          setDraftFor(k, draft);
+          return ok({ draft, key:k, draftStatus: draftStatusFor(k, draft), upgradedFrom });
         }
         case "cc_exportPng":{
           const k = draftKeyFrom(ctx, args);
           const draft = JSON.parse(JSON.stringify(getDraftFor(k)));
           draft.data.modification_date = nowSec();
+          // ST 兼容层（0.9.1）：① 每个 PNG 都写两个块（ccv3 纯 CCv3 + chara 的 V2 投影，见 pngCardChunks）；
+          // ② stWorld 非空时，只在**导出副本**上写 `data.extensions.world`（ST 的角色↔世界书绑定）。
+          // 返回给客户端的 draft 仍是「草稿本身」（多一个 ST 专有字段都不带），与「并入本卡」同一条家规。
+          const exportCard = withStWorld(draft, args.stWorld);
           try{
             let pngBytes;
             if(args.imageB64 && typeof args.imageB64==="string" && args.imageB64.length>0){
               if(args.imageB64.length > 20*1024*1024) return fail("too-large","底图 PNG 过大（>20MB base64）");
               const baseBytes = b64DecodeBytes(args.imageB64);
-              pngBytes = embedCardIntoPngBytes(baseBytes, draft);
+              pngBytes = embedCardIntoPngBytes(baseBytes, exportCard);
             } else {
-              pngBytes = buildPngWithCard(draft);
+              pngBytes = buildPngWithCard(exportCard);
             }
             return ok({ b64: Buffer.from(pngBytes).toString("base64"), filename: (draft.data.name||"card")+".png", draft });
           }catch(e){ return fail("build-failed", String(e.message)); }
@@ -1885,7 +2037,7 @@ function apply(ctx, config){
           const b64 = args.b64;
           if(typeof b64!=="string" || !b64) return fail("invalid-b64","b64 必填");
           if(b64.length > 30*1024*1024) return fail("too-large","CHARX 过大（>30MB base64）");
-          let draft;
+          let draft, upgradedFrom = null;
           try{
             const bytes = b64DecodeBytes(b64);
             if(bytes.length > 22*1024*1024) return fail("too-large","CHARX 过大（>22MB）");
@@ -1895,20 +2047,21 @@ function apply(ctx, config){
             if(!cardEntry) return fail("parse-failed","CHARX 未找到 card.json");
             const jsonStr = bytesToStr(cardEntry.data);
             const obj = JSON.parse(jsonStr);
-            draft = obj && obj.spec ? obj : (obj && obj.data ? obj : null);
-            if(!draft) throw new Error("card.json 格式错误");
-            draft = normalizeDraft(draft);
+            upgradedFrom = upgradeCardToV3(obj).from;
+            draft = normalizeDraft(obj);
           }catch(e){ return fail("parse-failed", String(e.message)); }
           const k = draftKeyFrom(ctx, args);
           setDraftFor(k, draft);
-          return ok({ draft, key:k, draftStatus: draftStatusFor(k, draft) });
+          return ok({ draft, key:k, draftStatus: draftStatusFor(k, draft), upgradedFrom });
         }
         case "cc_exportCharx":{
           const k = draftKeyFrom(ctx, args);
           const draft = JSON.parse(JSON.stringify(getDraftFor(k)));
           draft.data.modification_date = nowSec();
+          // ST 兼容层（0.9.1）：只在**导出副本**上写世界书绑定，草稿/库里的卡不动（同「并入本卡」家规）
+          const exportCard = withStWorld(draft, args.stWorld);
           try{
-            const zipBytes = buildZipCharx(draft);
+            const zipBytes = buildZipCharx(exportCard);
             return ok({ b64: Buffer.from(zipBytes).toString("base64"), filename: (draft.data.name||"card")+".charx", draft });
           }catch(e){ return fail("build-failed", String(e.message)); }
         }
@@ -1976,6 +2129,14 @@ function apply(ctx, config){
 // 存储：<主根>/cc-books/<groupId>.json —— **一本书对一个分组**；文件本身就是可直接发布的
 // lorebook_v3 JSON（拷出去别人就能用），插件自己的状态放 `data.extensions.cc`（规范允许）。
 // 条目字段与卡内 `character_book.entries` **完全同构** —— 提升/回填都是零转换搬运。
+//
+// ⚠️ 0.9.1：这个文件是给**认 CCv3 的客户端**的，**SillyTavern 不认** —— ST 服务端
+// `/api/worldinfo/import` 拿到文件第一件事就是 `if (!('entries' in worldContent)) throw`
+// （用户实机：拖 `.lorebook.json` 进去 = `Error importing world info: … Bad Request`；
+// 1.19.0 的客户端 `importWorldInfo()` 也只转 Novel / Agnai / Risu，整份 `world-info.js`
+// 搜不到 `lorebook_v3`）。所以工坊导出页另给一枚「SillyTavern 世界书」：ST 原生形态
+// `{entries:{…}}`，条目字段按 ST 自己的 `convertCharacterBook()` 映射 —— 两枚按钮各有读者，
+// **别把其中一个说成「就是给客户端的通用格式」**（这正是 0.9.0 那轮写错边界的同一个毛病）。
 // ——————————————————————————————————————————————————————————————
 const BOOK_SPEC = "lorebook_v3";
 const BOOK_MAX_ENTRIES = 200;
@@ -2212,6 +2373,10 @@ export { apply, inject, name, planPresetInstall, installCcPreset, supportsDeclar
   // 0.9.0 组级共享世界书：落盘 + 纯函数（扫描/提升/回填），两半同构、条目与卡内 character_book 同形
   BOOK_SPEC, bookDirs, bookDir, bookPath, makeBookEntry, normalizeBook, bookRevOf, readBookRaw, writeBook, deleteBook,
   contentKeyOf, bookCardsFor, scanSharedEntries, mergeBookEntries, applyBookPromotion,
+  // 0.9.1 SillyTavern 兼容层：PNG 双块（chara 的 V2 投影 + 纯 CCv3）、ccv3 优先读取、ST 世界书绑定
+  stV2Projection, stripDecorators, withStWorld, pngCardChunks, buildTEXtChunk, buildPngWithCard, embedCardIntoPngBytes, extractCardFromPngBytes,
+  // 0.9.1 B2：V2/V1 卡升级成 CCv3（PNG/CHARX/JSON 三条导入路径共用这一份实现）
+  upgradeCardToV3, normTags,
   REL_TYPES, REL_TYPE_LABELS, REL_BEGIN, REL_END };
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xia-sc/dsh-cc-studio",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "CCv3 角色卡工坊：融合工坊 + CC 模式 + JSON/PNG/CHARX + 中英双语（跟随全局）",
   "keywords": [
     "dsh",
@@ -38,7 +38,7 @@
     "presets"
   ],
   "scripts": {
-    "test": "node tests/rpc-channel.test.mjs && node tests/preset-install.test.mjs && node tests/cc-detection.test.mjs && node tests/client-greetings.test.mjs && node tests/draft-slot-sync.test.mjs && node tests/nav-highlight.test.mjs && node tests/clear-card.test.mjs && node tests/export-entry.test.mjs && node tests/close-button.test.mjs && node tests/tools-contract.test.mjs && node tests/relations.test.mjs && node tests/relations-view.test.mjs && node tests/shared-book.test.mjs && node tests/promote-draft-sync.test.mjs && node tests/data-root.test.mjs",
+    "test": "node tests/rpc-channel.test.mjs && node tests/preset-install.test.mjs && node tests/cc-detection.test.mjs && node tests/client-greetings.test.mjs && node tests/draft-slot-sync.test.mjs && node tests/nav-highlight.test.mjs && node tests/clear-card.test.mjs && node tests/export-entry.test.mjs && node tests/close-button.test.mjs && node tests/tools-contract.test.mjs && node tests/relations.test.mjs && node tests/relations-view.test.mjs && node tests/shared-book.test.mjs && node tests/shared-book-st-export.test.mjs && node tests/st-compat.test.mjs && node tests/promote-draft-sync.test.mjs && node tests/data-root.test.mjs",
     "prepublishOnly": "npm test"
   },
   "dsh": {