@xiaobuyu/nodesign 0.0.1 → 0.0.2

package/server/lib/task-scan.js

@@ -1,158 +1,158 @@
-/**
- * task-scan.js — 任务目录的统一扫描规则（2026-07-29）
- *
- * 站点接进真实工程形态（构建步骤 / node_modules / 源目录）后，「扫任务目录」
- * 这件事在五个地方各写各的：页面清单、整站 zip、断链检测、导出勾选、素材墙。
- * 五份跳过规则各自为政的结果是：node_modules 被整站 zip 原样打包、构建缓存
- * 触发刷新记账 —— 而且每一处都是静默的。所以收拢到这一个模块。
- *
- * 两层规则：
- *   ① 硬清单 —— 永远不看的目录（依赖 / 构建缓存 / VCS）。不可配置，
- *      因为「不小心把 node_modules 打进 zip」不该是一个能配出来的状态。
- *   ② `.ndignore` —— 任务根下的忽略档，gitignore 语法子集，agent 自己写。
- *      支持：# 注释、尾 `/`（只匹配目录）、头 `/`（锚定任务根）、`*` `?` `**`。
- *      不支持 `!` 反选（要精细控制就少写点通配）。
- */
-
-import path from 'node:path';
-import fs from 'node:fs/promises';
-
-/**
- * 工作区里**不是产物**的那些名字。形态扫描（deck / site）一律跳过。
- *
- * 2026-08-07 扁平化之后才需要这张表：以前形态扫描的根是 `tasks/<任务>/`，
- * 一个只装产物的干净目录；现在根是项目工作区，产物跟基础设施住在一起。
- * 不挡的话有两个实测会发生的假产物：
- *   - `canvas.template.html` / `site.template.html`（skill 拷进 cwd 的起手
- *     模板）会各自变成一张 deck 卡 —— deck 认"顶层任意 .html"；
- *   - `exports/` 里导出过一个站就会多出一张站点卡 —— 站点认"子目录里有
- *     index.html"，而导出包正好长这样。
- *
- * 点开头的（.claude / .nd / .git）扫描器本来就跳，不用列。
- */
-// `agent-memory` 是老符号链接时代的残骸目录名（正规位置是 .claude/agent-memory/），
-// 留在这里是为了它万一还在也不会作为一张文件夹卡出现在桌面上。
-export const RESERVED_DIRS = new Set(['assets', 'exports', 'notes', 'node_modules', 'agent-memory']);
-
-/**
- * 不当产物看的文件：起手模板（拷进来是给 agent 抄/改的，不是成品）。
- * 2026-08-15 加 js/mjs —— RP 的管线模块 `演出.template.js` 走同一条起手文件路，
- * 规则只认 html/css 的话它会当成一张产物卡上墙。
- */
-export function isReservedFile(name) {
-  return /\.template\.(html?|css|jsx?|mjs)$/i.test(name) || RESERVED_FILES.has(name);
-}
-
-/**
- * 基础设施文件：住在工作区里，但**不是用户的东西**，不该在桌面上出现。
- *
- * 2026-08-08 加。在这之前只挡起手模板，于是 `board.json`（画布自己的布局档）
- * 会作为一张 .json 文件卡上墙 —— 画布把自己的存档画在自己身上。
- */
-export const RESERVED_FILES = new Set([
-  'board.json',        // 画布布局，画布自己的存档
-  '.nd-project.json',  // 产物标记（形态兜底）
-  '.gitignore',
-  '.ndignore',
-]);
-
-/** 永远不扫的目录名（任何深度命中即剪枝） */
-export const HARD_IGNORE_DIRS = new Set([
-  'node_modules', '.git', '.wrangler', '.cache', '.next', '.astro', '.nuxt',
-  '.svelte-kit', '.output', '.parcel-cache', '.turbo', '.vite',
-  'venv', '.venv', '__pycache__', 'coverage',
-]);
-
-/** 展品目录：站点的试作放这里，单独渲染成卡，不算站点页面、不进 zip */
-export const DRAFTS_DIR = '_drafts';
-
-export const NDIGNORE_FILE = '.ndignore';
-
-/** gitignore 子集 → RegExp。认不出的行按字面量处理（转义后精确匹配）。 */
-function compilePattern(line) {
-  let pat = line.trim();
-  if (!pat || pat.startsWith('#')) return null;
-  const dirOnly = pat.endsWith('/');
-  if (dirOnly) pat = pat.slice(0, -1);
-  const anchored = pat.startsWith('/');
-  if (anchored) pat = pat.slice(1);
-  // 转义正则元字符，再还原通配语义（** → 任意层，* → 段内任意，? → 段内单字符）
-  let re = pat
-    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
-    .replace(/\*\*/g, '\uE000')
-    .replace(/\*/g, '[^/]*')
-    .replace(/\?/g, '[^/]')
-    .replace(/\uE000/g, '.*');
-  // 无斜杠的裸模式（`*.bak`）匹配任何一层的条目名；带斜杠 / 锚定的按路径匹配
-  const body = (!anchored && !pat.includes('/')) ? `(?:^|/)${re}` : `^${re}`;
-  return { re: new RegExp(`${body}(?:/|$)`), dirOnly };
-}
-
-/**
- * 读任务的 `.ndignore`，返回匹配器 `(rel, isDir) => boolean`。
- * rel 相对任务根、'/' 分隔、不带前导斜杠。没有忽略档 → 只有硬清单生效。
- */
-export async function loadIgnore(taskDir) {
-  let rules = [];
-  try {
-    const raw = await fs.readFile(path.join(taskDir, NDIGNORE_FILE), 'utf8');
-    rules = raw.split('\n').map(compilePattern).filter(Boolean);
-  } catch { /* 没有 .ndignore：正常 */ }
-  return (rel, isDir = false) => {
-    const segs = rel.split('/');
-    // 硬清单：路径里任何一段命中都算（父目录被剪枝时子路径根本走不到这，
-    // 这里再查一遍是给「直接拿 rel 来问」的调用方兜底）
-    if (segs.some(s => HARD_IGNORE_DIRS.has(s))) return true;
-    for (const r of rules) {
-      if (r.dirOnly && !isDir && !r.re.test(rel + '/')) continue;
-      if (r.re.test(rel)) return true;
-    }
-    return false;
-  };
-}
-
-/**
- * 递归列任务目录下的文件（应用硬清单 + .ndignore + 跳 dot 条目）。
- *
- * @param {string} rootDir  绝对路径（任务根或产物根）
- * @param {object} [opts]
- * @param {number}   [opts.maxDepth=6]
- * @param {Function} [opts.ignore]        loadIgnore 的返回值；不传就现读
- * @param {string}   [opts.ignoreBase]    ignore 规则的基准目录（缺省 = rootDir）。
- *                                        产物根是子目录时，.ndignore 在任务根，
- *                                        rel 要先换算回任务根视角再问匹配器。
- * @param {boolean}  [opts.includeDrafts=false]  是否进 `_drafts/`
- * @returns {Promise<Array<{rel: string, abs: string, name: string, size: number}>>}
- */
-export async function walkTaskFiles(rootDir, opts = {}) {
-  const { maxDepth = 6, includeDrafts = false } = opts;
-  const ignoreBase = opts.ignoreBase || rootDir;
-  const ignore = opts.ignore || await loadIgnore(ignoreBase);
-  const out = [];
-  const toIgnoreRel = (abs) => path.relative(ignoreBase, abs).split(path.sep).join('/');
-
-  const walk = async (dir, prefix, depth) => {
-    if (depth > maxDepth) return;
-    let entries;
-    try { entries = await fs.readdir(dir, { withFileTypes: true }); } catch { return; }
-    for (const e of entries) {
-      if (e.name.startsWith('.')) continue;
-      const abs = path.join(dir, e.name);
-      const rel = prefix ? `${prefix}/${e.name}` : e.name;
-      if (e.isDirectory()) {
-        if (HARD_IGNORE_DIRS.has(e.name)) continue;
-        if (!includeDrafts && e.name === DRAFTS_DIR) continue;
-        if (ignore(toIgnoreRel(abs), true)) continue;
-        await walk(abs, rel, depth + 1);
-        continue;
-      }
-      if (!e.isFile()) continue;
-      if (ignore(toIgnoreRel(abs), false)) continue;
-      let size = 0;
-      try { size = (await fs.stat(abs)).size; } catch { continue; }
-      out.push({ rel, abs, name: e.name, size });
-    }
-  };
-  await walk(rootDir, '', 1);
-  return out;
-}
+/**
+ * task-scan.js — 任务目录的统一扫描规则（2026-07-29）
+ *
+ * 站点接进真实工程形态（构建步骤 / node_modules / 源目录）后，「扫任务目录」
+ * 这件事在五个地方各写各的：页面清单、整站 zip、断链检测、导出勾选、素材墙。
+ * 五份跳过规则各自为政的结果是：node_modules 被整站 zip 原样打包、构建缓存
+ * 触发刷新记账 —— 而且每一处都是静默的。所以收拢到这一个模块。
+ *
+ * 两层规则：
+ *   ① 硬清单 —— 永远不看的目录（依赖 / 构建缓存 / VCS）。不可配置，
+ *      因为「不小心把 node_modules 打进 zip」不该是一个能配出来的状态。
+ *   ② `.ndignore` —— 任务根下的忽略档，gitignore 语法子集，agent 自己写。
+ *      支持：# 注释、尾 `/`（只匹配目录）、头 `/`（锚定任务根）、`*` `?` `**`。
+ *      不支持 `!` 反选（要精细控制就少写点通配）。
+ */
+
+import path from 'node:path';
+import fs from 'node:fs/promises';
+
+/**
+ * 工作区里**不是产物**的那些名字。形态扫描（deck / site）一律跳过。
+ *
+ * 2026-08-07 扁平化之后才需要这张表：以前形态扫描的根是 `tasks/<任务>/`，
+ * 一个只装产物的干净目录；现在根是项目工作区，产物跟基础设施住在一起。
+ * 不挡的话有两个实测会发生的假产物：
+ *   - `canvas.template.html` / `site.template.html`（skill 拷进 cwd 的起手
+ *     模板）会各自变成一张 deck 卡 —— deck 认"顶层任意 .html"；
+ *   - `exports/` 里导出过一个站就会多出一张站点卡 —— 站点认"子目录里有
+ *     index.html"，而导出包正好长这样。
+ *
+ * 点开头的（.claude / .nd / .git）扫描器本来就跳，不用列。
+ */
+// `agent-memory` 是老符号链接时代的残骸目录名（正规位置是 .claude/agent-memory/），
+// 留在这里是为了它万一还在也不会作为一张文件夹卡出现在桌面上。
+export const RESERVED_DIRS = new Set(['assets', 'exports', 'notes', 'node_modules', 'agent-memory']);
+
+/**
+ * 不当产物看的文件：起手模板（拷进来是给 agent 抄/改的，不是成品）。
+ * 2026-08-15 加 js/mjs —— RP 的管线模块 `演出.template.js` 走同一条起手文件路，
+ * 规则只认 html/css 的话它会当成一张产物卡上墙。
+ */
+export function isReservedFile(name) {
+  return /\.template\.(html?|css|jsx?|mjs)$/i.test(name) || RESERVED_FILES.has(name);
+}
+
+/**
+ * 基础设施文件：住在工作区里，但**不是用户的东西**，不该在桌面上出现。
+ *
+ * 2026-08-08 加。在这之前只挡起手模板，于是 `board.json`（画布自己的布局档）
+ * 会作为一张 .json 文件卡上墙 —— 画布把自己的存档画在自己身上。
+ */
+export const RESERVED_FILES = new Set([
+  'board.json',        // 画布布局，画布自己的存档
+  '.nd-project.json',  // 产物标记（形态兜底）
+  '.gitignore',
+  '.ndignore',
+]);
+
+/** 永远不扫的目录名（任何深度命中即剪枝） */
+export const HARD_IGNORE_DIRS = new Set([
+  'node_modules', '.git', '.wrangler', '.cache', '.next', '.astro', '.nuxt',
+  '.svelte-kit', '.output', '.parcel-cache', '.turbo', '.vite',
+  'venv', '.venv', '__pycache__', 'coverage',
+]);
+
+/** 展品目录：站点的试作放这里，单独渲染成卡，不算站点页面、不进 zip */
+export const DRAFTS_DIR = '_drafts';
+
+export const NDIGNORE_FILE = '.ndignore';
+
+/** gitignore 子集 → RegExp。认不出的行按字面量处理（转义后精确匹配）。 */
+function compilePattern(line) {
+  let pat = line.trim();
+  if (!pat || pat.startsWith('#')) return null;
+  const dirOnly = pat.endsWith('/');
+  if (dirOnly) pat = pat.slice(0, -1);
+  const anchored = pat.startsWith('/');
+  if (anchored) pat = pat.slice(1);
+  // 转义正则元字符，再还原通配语义（** → 任意层，* → 段内任意，? → 段内单字符）
+  let re = pat
+    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+    .replace(/\*\*/g, '\uE000')
+    .replace(/\*/g, '[^/]*')
+    .replace(/\?/g, '[^/]')
+    .replace(/\uE000/g, '.*');
+  // 无斜杠的裸模式（`*.bak`）匹配任何一层的条目名；带斜杠 / 锚定的按路径匹配
+  const body = (!anchored && !pat.includes('/')) ? `(?:^|/)${re}` : `^${re}`;
+  return { re: new RegExp(`${body}(?:/|$)`), dirOnly };
+}
+
+/**
+ * 读任务的 `.ndignore`，返回匹配器 `(rel, isDir) => boolean`。
+ * rel 相对任务根、'/' 分隔、不带前导斜杠。没有忽略档 → 只有硬清单生效。
+ */
+export async function loadIgnore(taskDir) {
+  let rules = [];
+  try {
+    const raw = await fs.readFile(path.join(taskDir, NDIGNORE_FILE), 'utf8');
+    rules = raw.split('\n').map(compilePattern).filter(Boolean);
+  } catch { /* 没有 .ndignore：正常 */ }
+  return (rel, isDir = false) => {
+    const segs = rel.split('/');
+    // 硬清单：路径里任何一段命中都算（父目录被剪枝时子路径根本走不到这，
+    // 这里再查一遍是给「直接拿 rel 来问」的调用方兜底）
+    if (segs.some(s => HARD_IGNORE_DIRS.has(s))) return true;
+    for (const r of rules) {
+      if (r.dirOnly && !isDir && !r.re.test(rel + '/')) continue;
+      if (r.re.test(rel)) return true;
+    }
+    return false;
+  };
+}
+
+/**
+ * 递归列任务目录下的文件（应用硬清单 + .ndignore + 跳 dot 条目）。
+ *
+ * @param {string} rootDir  绝对路径（任务根或产物根）
+ * @param {object} [opts]
+ * @param {number}   [opts.maxDepth=6]
+ * @param {Function} [opts.ignore]        loadIgnore 的返回值；不传就现读
+ * @param {string}   [opts.ignoreBase]    ignore 规则的基准目录（缺省 = rootDir）。
+ *                                        产物根是子目录时，.ndignore 在任务根，
+ *                                        rel 要先换算回任务根视角再问匹配器。
+ * @param {boolean}  [opts.includeDrafts=false]  是否进 `_drafts/`
+ * @returns {Promise<Array<{rel: string, abs: string, name: string, size: number}>>}
+ */
+export async function walkTaskFiles(rootDir, opts = {}) {
+  const { maxDepth = 6, includeDrafts = false } = opts;
+  const ignoreBase = opts.ignoreBase || rootDir;
+  const ignore = opts.ignore || await loadIgnore(ignoreBase);
+  const out = [];
+  const toIgnoreRel = (abs) => path.relative(ignoreBase, abs).split(path.sep).join('/');
+
+  const walk = async (dir, prefix, depth) => {
+    if (depth > maxDepth) return;
+    let entries;
+    try { entries = await fs.readdir(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries) {
+      if (e.name.startsWith('.')) continue;
+      const abs = path.join(dir, e.name);
+      const rel = prefix ? `${prefix}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        if (HARD_IGNORE_DIRS.has(e.name)) continue;
+        if (!includeDrafts && e.name === DRAFTS_DIR) continue;
+        if (ignore(toIgnoreRel(abs), true)) continue;
+        await walk(abs, rel, depth + 1);
+        continue;
+      }
+      if (!e.isFile()) continue;
+      if (ignore(toIgnoreRel(abs), false)) continue;
+      let size = 0;
+      try { size = (await fs.stat(abs)).size; } catch { continue; }
+      out.push({ rel, abs, name: e.name, size });
+    }
+  };
+  await walk(rootDir, '', 1);
+  return out;
+}

package/server/lib/tavern-json.js

@@ -1,154 +1,154 @@
-/**
- * tavern-json —— 酒馆（SillyTavern）导出 JSON 的解析与摘要（2026-08-15）
- *
- * 起因是一份真文件：`Izumi 0814.json`，464KB、210 条提示词，而**启用的只有 56 条**
- * （合计约 9.8k 字符）。agent 拿 Read 去读它 = 十几万 token 进上下文换来一堆停用
- * 的备选条目 —— 这不是"贵一点"，是把上下文烧光还看不清结构。所以搬酒馆的东西
- * 进来必须先过这一层：**先给结构摘要，再按需取正文**。
- *
- * 认三种形态（酒馆导出的 JSON 就这几类）：
- *   preset   Chat Completion 预设 —— `prompts[]` + `prompt_order[]`。管的是
- *            "每次请求怎么拼上下文 + 采样参数"，跟我们的 编排.yaml 同类。
- *            条目里那些 0 字的是 **marker**（角色描述/性格/场景/Chat History…），
- *            运行时由酒馆填真内容，搬过来一律丢掉 —— 我们由 编排.yaml 自己管。
- *   card     角色卡 V2（`spec: chara_card_v2`）或 V1。人设、开场白、示例对话，
- *            可能内嵌世界书（character_book）。
- *   lorebook 世界书单独导出 —— `entries`，每条带 keys（触发词）与 constant（常驻）。
- *
- * 只读不写：转成 编排.yaml 和设定文件是 agent 的活，它得按题材决定怎么分组、
- * 哪些不要（破甲话术在我们这条通路上没意义）。
- */
-
-/** 摘要里每条正文最多带多少字的引子 */
-const PEEK = 60;
-
-export function detectKind(doc) {
-  if (!doc || typeof doc !== 'object') return null;
-  if (Array.isArray(doc.prompts) && Array.isArray(doc.prompt_order)) return 'preset';
-  if (doc.spec === 'chara_card_v2' || doc.spec === 'chara_card_v3') return 'card';
-  if (doc.data && typeof doc.data === 'object' && typeof doc.data.first_mes === 'string') return 'card';
-  if (typeof doc.first_mes === 'string' && typeof doc.description === 'string') return 'card';
-  if (doc.entries && typeof doc.entries === 'object') return 'lorebook';
-  return null;
-}
-
-const 引 = (s) => String(s || '').replace(/\s+/g, ' ').trim().slice(0, PEEK);
-const 字 = (s) => String(s || '').length;
-
-/** 预设：启用的条目按 order 顺序排开，停用的只报个数 */
-export function digestPreset(doc) {
-  const byId = new Map((doc.prompts || []).map(p => [p.identifier, p]));
-  const order = (doc.prompt_order?.[0]?.order) || [];
-  const 启用 = [];
-  const 停用 = [];
-  for (const o of order) {
-    const p = byId.get(o.identifier);
-    if (!p) continue;
-    const 条 = {
-      id: p.identifier,
-      名字: p.name || p.identifier,
-      角色: p.role || 'system',
-      字数: 字(p.content),
-      占位: p.marker === true,                       // 运行时由酒馆填（角色卡/历史）
-      分隔: p.marker !== true && 字(p.content) === 0,  // 纯分节标题（"可选功能开始"这种）
-      深度: p.injection_position === 1 ? (p.injection_depth ?? 0) : null,
-      引子: 引(p.content),
-    };
-    (o.enabled ? 启用 : 停用).push(条);
-  }
-  const 实条 = 启用.filter(e => e.字数 > 0);
-  return {
-    形态: 'preset',
-    参数: {
-      temperature: doc.temperature, top_p: doc.top_p, top_k: doc.top_k,
-      frequency_penalty: doc.frequency_penalty, presence_penalty: doc.presence_penalty,
-      最大上下文: doc.openai_max_context, 最大输出: doc.openai_max_tokens,
-      reasoning_effort: doc.reasoning_effort, squash_system_messages: doc.squash_system_messages,
-    },
-    启用, 停用,
-    合计字数: 实条.reduce((n, e) => n + e.字数, 0),
-    占位条目: 启用.filter(e => e.占位).map(e => e.名字),
-    分隔条目: 启用.filter(e => e.分隔).map(e => e.名字),
-  };
-}
-
-/** 角色卡：字段清单 + 内嵌世界书条目表 */
-export function digestCard(doc) {
-  const d = doc.data && typeof doc.data === 'object' ? doc.data : doc;
-  const 字段 = ['name', 'description', 'personality', 'scenario', 'first_mes', 'mes_example',
-    'system_prompt', 'post_history_instructions', 'creator_notes']
-    .map(k => ({ 字段: k, 字数: 字(d[k]), 引子: 引(d[k]) }))
-    .filter(x => x.字数 > 0);
-  const book = d.character_book || doc.character_book || null;
-  return {
-    形态: 'card',
-    名字: d.name || '(无名)',
-    字段,
-    开场白备选: Array.isArray(d.alternate_greetings) ? d.alternate_greetings.length : 0,
-    世界书: book ? digestLorebook(book).条目 : [],
-  };
-}
-
-/** 世界书：每条的触发词、常驻与否、字数 */
-export function digestLorebook(doc) {
-  const raw = doc.entries;
-  const list = Array.isArray(raw) ? raw : Object.values(raw || {});
-  const 条目 = list.map((e, i) => ({
-    id: String(e.uid ?? e.id ?? i),
-    名字: e.comment || e.name || (Array.isArray(e.key) ? e.key.join('/') : '') || `条目${i + 1}`,
-    触发: Array.isArray(e.key) ? e.key : (Array.isArray(e.keys) ? e.keys : []),
-    常驻: !!(e.constant),
-    停用: e.enabled === false || e.disable === true,
-    字数: 字(e.content),
-    引子: 引(e.content),
-  }));
-  return { 形态: 'lorebook', 条目 };
-}
-
-export function digest(doc) {
-  const kind = detectKind(doc);
-  if (kind === 'preset') return digestPreset(doc);
-  if (kind === 'card') return digestCard(doc);
-  if (kind === 'lorebook') return digestLorebook(doc);
-  return null;
-}
-
-/**
- * 按名字/id 取正文。名字支持部分匹配（酒馆的条目名带 emoji，让 agent 原样抄
- * 一串 emoji 当参数是给自己找麻烦）。
- * @returns {{名字: string, 角色?: string, 正文: string}[]}
- */
-export function fetchEntries(doc, 选) {
-  const want = (选 || []).map(s => String(s).trim()).filter(Boolean);
-  if (!want.length) return [];
-  const kind = detectKind(doc);
-  let 池 = [];
-  if (kind === 'preset') {
-    池 = (doc.prompts || []).map(p => ({ id: p.identifier, 名字: p.name || p.identifier, 角色: p.role || 'system', 正文: String(p.content || '') }));
-  } else if (kind === 'lorebook' || (kind === 'card' && (doc.data?.character_book || doc.character_book))) {
-    const book = kind === 'lorebook' ? doc : (doc.data?.character_book || doc.character_book);
-    const list = Array.isArray(book.entries) ? book.entries : Object.values(book.entries || {});
-    池 = list.map((e, i) => ({
-      id: String(e.uid ?? e.id ?? i),
-      名字: e.comment || e.name || (Array.isArray(e.key) ? e.key.join('/') : `条目${i + 1}`),
-      正文: String(e.content || ''),
-    }));
-  }
-  if (kind === 'card') {
-    const d = doc.data && typeof doc.data === 'object' ? doc.data : doc;
-    for (const k of ['description', 'personality', 'scenario', 'first_mes', 'mes_example',
-      'system_prompt', 'post_history_instructions']) {
-      if (d[k]) 池.push({ id: k, 名字: k, 正文: String(d[k]) });
-    }
-    if (Array.isArray(d.alternate_greetings)) {
-      d.alternate_greetings.forEach((g, i) => 池.push({ id: `alt_greeting_${i}`, 名字: `alternate_greetings[${i}]`, 正文: String(g || '') }));
-    }
-  }
-  const 出 = [];
-  const 见 = new Set();
-  for (const w of want) {
-    const hit = 池.find(x => x.id === w) || 池.find(x => x.名字 === w) || 池.find(x => x.名字.includes(w));
-    if (hit && !见.has(hit.id)) { 见.add(hit.id); 出.push(hit); }
-  }
-  return 出;
-}
+/**
+ * tavern-json —— 酒馆（SillyTavern）导出 JSON 的解析与摘要（2026-08-15）
+ *
+ * 起因是一份真文件：`Izumi 0814.json`，464KB、210 条提示词，而**启用的只有 56 条**
+ * （合计约 9.8k 字符）。agent 拿 Read 去读它 = 十几万 token 进上下文换来一堆停用
+ * 的备选条目 —— 这不是"贵一点"，是把上下文烧光还看不清结构。所以搬酒馆的东西
+ * 进来必须先过这一层：**先给结构摘要，再按需取正文**。
+ *
+ * 认三种形态（酒馆导出的 JSON 就这几类）：
+ *   preset   Chat Completion 预设 —— `prompts[]` + `prompt_order[]`。管的是
+ *            "每次请求怎么拼上下文 + 采样参数"，跟我们的 编排.yaml 同类。
+ *            条目里那些 0 字的是 **marker**（角色描述/性格/场景/Chat History…），
+ *            运行时由酒馆填真内容，搬过来一律丢掉 —— 我们由 编排.yaml 自己管。
+ *   card     角色卡 V2（`spec: chara_card_v2`）或 V1。人设、开场白、示例对话，
+ *            可能内嵌世界书（character_book）。
+ *   lorebook 世界书单独导出 —— `entries`，每条带 keys（触发词）与 constant（常驻）。
+ *
+ * 只读不写：转成 编排.yaml 和设定文件是 agent 的活，它得按题材决定怎么分组、
+ * 哪些不要（破甲话术在我们这条通路上没意义）。
+ */
+
+/** 摘要里每条正文最多带多少字的引子 */
+const PEEK = 60;
+
+export function detectKind(doc) {
+  if (!doc || typeof doc !== 'object') return null;
+  if (Array.isArray(doc.prompts) && Array.isArray(doc.prompt_order)) return 'preset';
+  if (doc.spec === 'chara_card_v2' || doc.spec === 'chara_card_v3') return 'card';
+  if (doc.data && typeof doc.data === 'object' && typeof doc.data.first_mes === 'string') return 'card';
+  if (typeof doc.first_mes === 'string' && typeof doc.description === 'string') return 'card';
+  if (doc.entries && typeof doc.entries === 'object') return 'lorebook';
+  return null;
+}
+
+const 引 = (s) => String(s || '').replace(/\s+/g, ' ').trim().slice(0, PEEK);
+const 字 = (s) => String(s || '').length;
+
+/** 预设：启用的条目按 order 顺序排开，停用的只报个数 */
+export function digestPreset(doc) {
+  const byId = new Map((doc.prompts || []).map(p => [p.identifier, p]));
+  const order = (doc.prompt_order?.[0]?.order) || [];
+  const 启用 = [];
+  const 停用 = [];
+  for (const o of order) {
+    const p = byId.get(o.identifier);
+    if (!p) continue;
+    const 条 = {
+      id: p.identifier,
+      名字: p.name || p.identifier,
+      角色: p.role || 'system',
+      字数: 字(p.content),
+      占位: p.marker === true,                       // 运行时由酒馆填（角色卡/历史）
+      分隔: p.marker !== true && 字(p.content) === 0,  // 纯分节标题（"可选功能开始"这种）
+      深度: p.injection_position === 1 ? (p.injection_depth ?? 0) : null,
+      引子: 引(p.content),
+    };
+    (o.enabled ? 启用 : 停用).push(条);
+  }
+  const 实条 = 启用.filter(e => e.字数 > 0);
+  return {
+    形态: 'preset',
+    参数: {
+      temperature: doc.temperature, top_p: doc.top_p, top_k: doc.top_k,
+      frequency_penalty: doc.frequency_penalty, presence_penalty: doc.presence_penalty,
+      最大上下文: doc.openai_max_context, 最大输出: doc.openai_max_tokens,
+      reasoning_effort: doc.reasoning_effort, squash_system_messages: doc.squash_system_messages,
+    },
+    启用, 停用,
+    合计字数: 实条.reduce((n, e) => n + e.字数, 0),
+    占位条目: 启用.filter(e => e.占位).map(e => e.名字),
+    分隔条目: 启用.filter(e => e.分隔).map(e => e.名字),
+  };
+}
+
+/** 角色卡：字段清单 + 内嵌世界书条目表 */
+export function digestCard(doc) {
+  const d = doc.data && typeof doc.data === 'object' ? doc.data : doc;
+  const 字段 = ['name', 'description', 'personality', 'scenario', 'first_mes', 'mes_example',
+    'system_prompt', 'post_history_instructions', 'creator_notes']
+    .map(k => ({ 字段: k, 字数: 字(d[k]), 引子: 引(d[k]) }))
+    .filter(x => x.字数 > 0);
+  const book = d.character_book || doc.character_book || null;
+  return {
+    形态: 'card',
+    名字: d.name || '(无名)',
+    字段,
+    开场白备选: Array.isArray(d.alternate_greetings) ? d.alternate_greetings.length : 0,
+    世界书: book ? digestLorebook(book).条目 : [],
+  };
+}
+
+/** 世界书：每条的触发词、常驻与否、字数 */
+export function digestLorebook(doc) {
+  const raw = doc.entries;
+  const list = Array.isArray(raw) ? raw : Object.values(raw || {});
+  const 条目 = list.map((e, i) => ({
+    id: String(e.uid ?? e.id ?? i),
+    名字: e.comment || e.name || (Array.isArray(e.key) ? e.key.join('/') : '') || `条目${i + 1}`,
+    触发: Array.isArray(e.key) ? e.key : (Array.isArray(e.keys) ? e.keys : []),
+    常驻: !!(e.constant),
+    停用: e.enabled === false || e.disable === true,
+    字数: 字(e.content),
+    引子: 引(e.content),
+  }));
+  return { 形态: 'lorebook', 条目 };
+}
+
+export function digest(doc) {
+  const kind = detectKind(doc);
+  if (kind === 'preset') return digestPreset(doc);
+  if (kind === 'card') return digestCard(doc);
+  if (kind === 'lorebook') return digestLorebook(doc);
+  return null;
+}
+
+/**
+ * 按名字/id 取正文。名字支持部分匹配（酒馆的条目名带 emoji，让 agent 原样抄
+ * 一串 emoji 当参数是给自己找麻烦）。
+ * @returns {{名字: string, 角色?: string, 正文: string}[]}
+ */
+export function fetchEntries(doc, 选) {
+  const want = (选 || []).map(s => String(s).trim()).filter(Boolean);
+  if (!want.length) return [];
+  const kind = detectKind(doc);
+  let 池 = [];
+  if (kind === 'preset') {
+    池 = (doc.prompts || []).map(p => ({ id: p.identifier, 名字: p.name || p.identifier, 角色: p.role || 'system', 正文: String(p.content || '') }));
+  } else if (kind === 'lorebook' || (kind === 'card' && (doc.data?.character_book || doc.character_book))) {
+    const book = kind === 'lorebook' ? doc : (doc.data?.character_book || doc.character_book);
+    const list = Array.isArray(book.entries) ? book.entries : Object.values(book.entries || {});
+    池 = list.map((e, i) => ({
+      id: String(e.uid ?? e.id ?? i),
+      名字: e.comment || e.name || (Array.isArray(e.key) ? e.key.join('/') : `条目${i + 1}`),
+      正文: String(e.content || ''),
+    }));
+  }
+  if (kind === 'card') {
+    const d = doc.data && typeof doc.data === 'object' ? doc.data : doc;
+    for (const k of ['description', 'personality', 'scenario', 'first_mes', 'mes_example',
+      'system_prompt', 'post_history_instructions']) {
+      if (d[k]) 池.push({ id: k, 名字: k, 正文: String(d[k]) });
+    }
+    if (Array.isArray(d.alternate_greetings)) {
+      d.alternate_greetings.forEach((g, i) => 池.push({ id: `alt_greeting_${i}`, 名字: `alternate_greetings[${i}]`, 正文: String(g || '') }));
+    }
+  }
+  const 出 = [];
+  const 见 = new Set();
+  for (const w of want) {
+    const hit = 池.find(x => x.id === w) || 池.find(x => x.名字 === w) || 池.find(x => x.名字.includes(w));
+    if (hit && !见.has(hit.id)) { 见.add(hit.id); 出.push(hit); }
+  }
+  return 出;
+}