@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/story-creation/upstream/skills/story-deslop/scripts/normalize-punctuation.js

@@ -0,0 +1,415 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const { loadStyleWhitelist, styleSpans } = require('./style-whitelist.js');
+const path = require('path');
+
+const USAGE = `Usage: node normalize-punctuation.js [--check] [--quote-mode keep|ascii|yan] <file...>
+
+Normalize正文 punctuation deterministically:
+  - replace ellipses, em dashes, and double hyphens with Chinese punctuation
+  - remove markdown divider lines (---) from正文
+  - preserve pause punctuation covered by book-local .deslop-whitelist literals
+  - keep quote style by default; convert quotes only when explicitly requested
+`;
+
+const options = {
+  check: false,
+  quoteMode: 'keep',
+  files: [],
+};
+
+for (let i = 2; i < process.argv.length; i += 1) {
+  const arg = process.argv[i];
+  if (arg === '--check') {
+    options.check = true;
+  } else if (arg === '--quote-mode') {
+    const value = process.argv[i + 1];
+    if (!value) die('--quote-mode requires keep, ascii, or yan');
+    options.quoteMode = value;
+    i += 1;
+  } else if (arg.startsWith('--quote-mode=')) {
+    options.quoteMode = arg.slice('--quote-mode='.length);
+  } else if (arg === '-h' || arg === '--help') {
+    process.stdout.write(USAGE);
+    process.exit(0);
+  } else if (arg.startsWith('-')) {
+    die(`Unknown option: ${arg}`);
+  } else {
+    options.files.push(arg);
+  }
+}
+
+if (!['keep', 'ascii', 'yan'].includes(options.quoteMode)) {
+  die(`Invalid --quote-mode: ${options.quoteMode}`);
+}
+if (options.files.length === 0) {
+  die('No files provided');
+}
+
+let totalFindings = 0;
+let changedFiles = 0;
+let failed = false;
+
+for (const file of options.files) {
+  const fullPath = path.resolve(file);
+  let input;
+  try {
+    input = fs.readFileSync(fullPath, 'utf8');
+  } catch (error) {
+    failed = true;
+    console.error(`${file}: unable to read (${error.message})`);
+    continue;
+  }
+
+  let whitelist;
+  try { whitelist = loadStyleWhitelist(fullPath); }
+  catch (error) { die(`${file}: unable to read .deslop-whitelist (${error.message})`); }
+  const result = normalizeDocument(input, options.quoteMode, whitelist);
+  totalFindings += result.findings.length;
+
+  if (options.check) {
+    for (const finding of result.findings) {
+      console.log(`${file}:${finding.line}:${finding.column}: ${finding.type}: ${finding.message}`);
+    }
+    continue;
+  }
+
+  if (result.output !== input) {
+    fs.writeFileSync(fullPath, result.output, 'utf8');
+    changedFiles += 1;
+    console.log(`${file}: normalized (${result.findings.length} issue${result.findings.length === 1 ? '' : 's'})`);
+  }
+}
+
+if (failed) {
+  process.exit(2);
+}
+if (options.check && totalFindings > 0) {
+  process.exit(1);
+}
+if (!options.check) {
+  console.log(`Done. Changed files: ${changedFiles}`);
+}
+
+function die(message) {
+  console.error(message);
+  console.error(USAGE.trimEnd());
+  process.exit(2);
+}
+
+function normalizeDocument(input, quoteMode, whitelist) {
+  const { lines, endings } = splitLinesKeepingEndings(input);
+
+  const findings = [];
+  const outputLines = [];
+  let fence = null;
+  let inFrontMatter = hasYamlFrontMatter(lines);
+  let quoteOpen = false;
+  let commentOpen = false;
+  let commentStart = null;
+  const commentCloseAhead = new Array(lines.length + 1).fill(false);
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    commentCloseAhead[index] = lines[index].includes('-->') || commentCloseAhead[index + 1];
+  }
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const lineNo = index + 1;
+    const ending = endings[index];
+    let line = lines[index];
+    const trimmed = line.trim();
+
+    // 未闭合的 `<!--` 不能把余下整篇伪装成注释。确认 EOF 前已无 `-->` 时，
+    // 在起始位置具名报错，并从当前行恢复正文扫描；起始符所在行仍原样保护。
+    if (commentOpen && !commentCloseAhead[index]) {
+      findings.push({
+        line: commentStart?.line || lineNo,
+        column: commentStart?.column || 1,
+        type: 'html-comment-unclosed',
+        message: 'HTML 注释未闭合；后续内容仍按正文检查。',
+      });
+      commentOpen = false;
+      commentStart = null;
+    }
+
+    if (inFrontMatter) {
+      outputLines.push(line + ending);
+      if (index > 0 && trimmed === '---') inFrontMatter = false;
+      continue;
+    }
+
+    if (fence) {
+      outputLines.push(line + ending);
+      if (isClosingFence(line, fence)) fence = null;
+      continue;
+    }
+
+    const openingFence = parseOpeningFence(line);
+    if (openingFence) {
+      fence = openingFence;
+      outputLines.push(line + ending);
+      continue;
+    }
+
+    // 跨行 HTML 注释里的 `---` 是注释内容，不是正文分隔线。
+    if (trimmed === '---' && !commentOpen) {
+      findings.push({
+        line: lineNo,
+        column: line.indexOf('-') + 1,
+        type: 'markdown-divider',
+        message: '正文中不要使用 markdown 分隔线；建议移除该行。',
+      });
+      continue;
+    }
+
+    const commentOpenBefore = commentOpen;
+    const punctuationResult = normalizePausePunctuation(line, lineNo, commentOpen, whitelist);
+    findings.push(...punctuationResult.findings);
+    line = punctuationResult.line;
+    commentOpen = punctuationResult.commentOpen;
+    if (!commentOpenBefore && commentOpen) {
+      commentStart = { line: lineNo, column: Math.max(1, line.lastIndexOf('<!--') + 1) };
+    } else if (!commentOpen) {
+      commentStart = null;
+    }
+
+    const quoteResult = normalizeQuotes(line, quoteMode, quoteOpen, lineNo);
+    findings.push(...quoteResult.findings);
+    line = quoteResult.line;
+    quoteOpen = quoteResult.quoteOpen;
+
+    outputLines.push(line + ending);
+  }
+
+  if (commentOpen) {
+    findings.push({
+      line: commentStart?.line || lines.length,
+      column: commentStart?.column || 1,
+      type: 'html-comment-unclosed',
+      message: 'HTML 注释未闭合；后续内容仍按正文检查。',
+    });
+  }
+
+  return {
+    output: outputLines.join(''),
+    findings,
+  };
+}
+
+// 逐行记住原始行尾。整篇按「文件里出现过 \r\n」统一行尾会让一个孤立 CRLF 把全文
+// 行尾都翻成 CRLF——那是一次没人要求的全文件 diff，而 --check 对行尾一个 finding
+// 都不报，只改标点的这一步不该动它。
+function splitLinesKeepingEndings(input) {
+  const lines = [];
+  const endings = [];
+  let cursor = 0;
+
+  while (cursor < input.length) {
+    const newlineIndex = input.indexOf('\n', cursor);
+    if (newlineIndex === -1) {
+      lines.push(input.slice(cursor));
+      endings.push('');
+      break;
+    }
+    const crlf = newlineIndex > cursor && input[newlineIndex - 1] === '\r';
+    lines.push(input.slice(cursor, crlf ? newlineIndex - 1 : newlineIndex));
+    endings.push(crlf ? '\r\n' : '\n');
+    cursor = newlineIndex + 1;
+  }
+
+  return { lines, endings };
+}
+
+function parseOpeningFence(line) {
+  const match = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+  if (!match) return null;
+
+  const marker = match[1];
+  const rest = match[2];
+  if (marker[0] === '`' && rest.includes('`')) return null;
+
+  return { marker: marker[0], minimumLength: marker.length };
+}
+
+function isClosingFence(line, fence) {
+  const marker = fence.marker === '`' ? '`' : '~';
+  const match = line.match(new RegExp(`^ {0,3}(${marker}{3,})[\\t ]*$`));
+  return Boolean(match && match[1].length >= fence.minimumLength);
+}
+
+// 删空停顿符会把两侧的半角点/连字符粘成新的 `...`/`--`（`他.……..说` → `他...说`），
+// 一遍归一化留不干净，再跑一遍还会改已定稿的正文；所以反复归一化到不动点。
+// 每遍至少把一个 `…/./—/-` 换成非停顿字符，字符数严格递减，必然收敛。
+// findings 只留第一遍：同一处不重复计数，column 也仍然是原行的偏移。
+function normalizePausePunctuation(line, lineNo, commentOpen, whitelist) {
+  let current = line;
+  let findings = null;
+  let commentOpenAfter = commentOpen;
+
+  for (;;) {
+    const comments = htmlCommentSpans(current, commentOpen);
+    commentOpenAfter = comments.open;
+    const pass = normalizePausePunctuationPass(current, lineNo, comments.spans.concat(styleSpans(current, whitelist)));
+    if (findings === null) findings = pass.findings;
+    if (pass.line === current) break;
+    current = pass.line;
+  }
+
+  return { line: current, findings, commentOpen: commentOpenAfter };
+}
+
+function normalizePausePunctuationPass(line, lineNo, commentSpans) {
+  const findings = [];
+  const original = line;
+  const pattern = /…+|\.{3,}|——|—|--+/g;
+  let output = '';
+  let lastIndex = 0;
+  let match;
+
+  while ((match = pattern.exec(original)) !== null) {
+    const token = match[0];
+    // HTML 注释是正文里的元信息（如 `<!-- 去味:跳过 -->` 豁免标记）：`<!--`/`-->` 里的
+    // `--` 不是停顿标点，改掉它注释就散了，标记会变成读者看得见的正文。
+    if (insideSpans(match.index, match.index + token.length, commentSpans)) continue;
+    output += original.slice(lastIndex, match.index);
+    const replacement = choosePauseReplacement(original, match.index, token.length);
+    output += replacement;
+    findings.push({
+      line: lineNo,
+      column: match.index + 1,
+      type: getPauseType(token),
+      message: replacement ? `替换为「${replacement}」。` : '移除重复标点。',
+    });
+    lastIndex = match.index + token.length;
+  }
+
+  output += original.slice(lastIndex);
+  return { line: output, findings };
+}
+
+// 行内 HTML 注释区间（含 `<!--`、`-->` 本身）；注释可跨行，未闭合时把状态交给下一行。
+function htmlCommentSpans(line, openBefore) {
+  const spans = [];
+  let open = openBefore;
+  let cursor = 0;
+
+  while (cursor < line.length) {
+    if (open) {
+      const close = line.indexOf('-->', cursor);
+      if (close === -1) {
+        spans.push([cursor, line.length]);
+        return { spans, open: true };
+      }
+      spans.push([cursor, close + 3]);
+      cursor = close + 3;
+      open = false;
+      continue;
+    }
+
+    const start = line.indexOf('<!--', cursor);
+    if (start === -1) break;
+    cursor = start;
+    open = true;
+  }
+
+  return { spans, open };
+}
+
+function insideSpans(start, end, spans) {
+  return spans.some(([spanStart, spanEnd]) => start < spanEnd && end > spanStart);
+}
+
+function hasYamlFrontMatter(lines) {
+  if (!lines[0] || lines[0].trim() !== '---') return false;
+  let sawYamlField = false;
+  for (let i = 1; i < Math.min(lines.length, 40); i += 1) {
+    const trimmed = lines[i].trim();
+    if (trimmed === '---') return sawYamlField;
+    if (/^[A-Za-z0-9_-]+:\s*/.test(trimmed)) sawYamlField = true;
+  }
+  return false;
+}
+
+function getPauseType(token) {
+  if (token.startsWith('-')) return 'double-hyphen';
+  if (token.includes('—')) return 'em-dash';
+  return 'ellipsis';
+}
+
+function choosePauseReplacement(text, start, length) {
+  const before = previousNonSpace(text, start - 1);
+  const after = nextNonSpace(text, start + length);
+  const rest = text.slice(start + length).trimStart();
+
+  // 正文产物不保留 `……`、`——`、`—` 或 `--`；对话打断和数字区间不设例外。
+  if (before === '') return '';
+  // 紧跟开引号/开括号的停顿符号属于句首边界，删空即可，避免产出 `「，…」` 或 `「。」`。
+  if (isOpeningDelimiter(before)) return '';
+  if (/\d/.test(before) && /\d/.test(after)) return '到';
+  if (isClosingQuote(after)) return isSentencePunctuation(before) ? '' : '。';
+
+  if (!after) return isSentencePunctuation(before) ? '' : '。';
+  if (isSentencePunctuation(before) || isPunctuation(after)) return '';
+  if (/^(因为|原来|这是|那是|也就是|换句话|说白了|所谓|答案|原因|结果|真相|问题在于)/.test(rest)) return '：';
+  if (/(原因|答案|真相|结果|结论|问题|选择|意思)$/.test(text.slice(0, start).trim())) return '：';
+  return '，';
+}
+
+function previousNonSpace(text, index) {
+  for (let i = index; i >= 0; i -= 1) {
+    if (!/\s/.test(text[i])) return text[i];
+  }
+  return '';
+}
+
+function nextNonSpace(text, index) {
+  for (let i = index; i < text.length; i += 1) {
+    if (!/\s/.test(text[i])) return text[i];
+  }
+  return '';
+}
+
+function isSentencePunctuation(ch) {
+  return /[，,。.!！?？;；:：…]$/.test(ch || '');
+}
+
+function isPunctuation(ch) {
+  return /[，,。.!！?？;；:：、…"“”'‘’」』）)]/.test(ch || '');
+}
+
+function isClosingQuote(ch) {
+  return /["”」』]/.test(ch || '');
+}
+
+function isOpeningDelimiter(ch) {
+  return /[「『（(“‘]/.test(ch || '');
+}
+
+function normalizeQuotes(line, quoteMode, quoteOpen, lineNo) {
+  if (quoteMode === 'keep') {
+    return { line, findings: [], quoteOpen };
+  }
+
+  const findings = [];
+  let output = '';
+
+  for (let i = 0; i < line.length; i += 1) {
+    const ch = line[i];
+    if (quoteMode === 'ascii' && /[「」『』“”]/.test(ch)) {
+      output += '"';
+      findings.push({ line: lineNo, column: i + 1, type: 'quote-style', message: '按显式 quote-mode 转为半角双引号。' });
+      continue;
+    }
+    if (quoteMode === 'yan' && (ch === '"' || ch === '“' || ch === '”')) {
+      const replacement = quoteOpen || ch === '”' ? '」' : '「';
+      output += replacement;
+      quoteOpen = replacement === '「';
+      findings.push({ line: lineNo, column: i + 1, type: 'quote-style', message: '按显式 quote-mode 转为盐言引号。' });
+      continue;
+    }
+    output += ch;
+  }
+
+  return { line: output, findings, quoteOpen };
+}

package/resources/skills/story-creation/upstream/skills/story-deslop/scripts/style-whitelist.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+// Book-local only: never inherit an unrelated workspace or another book's choices.
+function loadStyleWhitelist(file) {
+  const parent = path.dirname(path.resolve(file));
+  const book = path.basename(parent) === '正文' ? path.dirname(parent) : parent;
+  try {
+    return fs.readFileSync(path.join(book, '.deslop-whitelist'), 'utf8')
+      .split(/\r?\n/).map(line => line.trim())
+      .filter(line => line && !line.startsWith('#'))
+      .sort((a, b) => b.length - a.length);
+  } catch (error) {
+    if (error.code === 'ENOENT') return [];
+    throw error;
+  }
+}
+
+function styleSpans(text, whitelist) {
+  const spans = [];
+  for (const literal of whitelist) {
+    for (let at = text.indexOf(literal); at !== -1; at = text.indexOf(literal, at + 1)) {
+      spans.push([at, at + literal.length]);
+    }
+  }
+  return spans;
+}
+
+function maskStyleText(text, whitelist) {
+  const chars = text.split('');
+  for (const [start, end] of styleSpans(text, whitelist)) {
+    chars.fill('？', start, end);
+  }
+  return chars.join('');
+}
+
+module.exports = { loadStyleWhitelist, styleSpans, maskStyleText };

package/resources/skills/story-creation/upstream/skills/story-import/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: story-import
+version: 1.0.0
+description: "逆向导入已有小说。将已写好的小说（半成品或完本）反向解析为标准项目目录结构，兼容 story-long-write / story-short-write 后续写作流程；内部复用 story-long-analyze / story-short-analyze 的拆解管道，按篇幅自动分流。触发方式：/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。"
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
+---
+# story-import：逆向导入已有小说
+
+你是小说项目逆向工程师。**交付物是写作工程**：把作者已有的书重建为可续写的工程（项目结构 + 拆文库分析资产），让作者能直接接着写。`拆文库/{导入书名}/` 是重建工程的数据源，保留不丢弃，但不是交付物本身；对作者以「建工程」为可见目标，别把「拆文」当成终点或对外标签。
+
+> Agent 兼容性：只检查当前运行时的 canonical 目录：Claude `.claude/agents/{agent}.md`、OpenCode `.opencode/agents/{agent}.md`、Codex `.codex/agents/{agent}.toml`、Antigravity `.agents/agents/agent-name/agent.md`（`agent-name` 为目标 agent 名），不得因其他端文件存在而误判。Codex 使用同名 `agent_type`；Antigravity 使用 `invoke_subagent` + `TypeName`。对应运行时未暴露 custom-agent registry / `invoke_subagent` 或返回未知 agent 时，必须降级 solo/direct。检测到 `.zcode/` 时同样直接 solo/direct，因为 ZCode 3.3.4 不执行项目 custom agents；报告 `Fallback: project custom agents unavailable -> solo`。Claude 用 `subagent_type`；OpenCode 用 `subagent` 工具的 `agent` 参数。
+>
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 并提示重新运行 `/story-setup` 后新开会话；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+
+## 名词与目录边界（全流程硬约束）
+
+- `{导入书名}`：用户自己已经写到一半或已经完本、现在要重建为工程的小说；它的分析源固定为 `拆文库/{导入书名}/`。
+- `{对标书名}`：用户另行选择的外部参考作品；它必须是独立拆解产物，来源固定为 `拆文库/{对标书名}/`，且不得指向本次导入源。
+- `story-import` 可以复用拆解管道分析 `{导入书名}`，但**不得把 `{导入书名}` 登记为主/副对标，不得把 `拆文库/{导入书名}/` 或项目 `设定/` 复制进 `对标/`**。
+- 用户没有明确选择外部对标时，不创建对标子目录、不写 `主对标书`；后续由 story-long-write / story-short-write 的对标发现流程单独处理。
+
+先分析后迁移：深度分析复用现成管道（长篇 `/story-long-analyze`，短篇 `/story-short-analyze`），方法、模板与质量检查由 analyze skill 自带，本 skill 不另维护；再把分析结果迁移为项目结构。
+
+## 时刻表与交接
+
+导入是一串时刻，每个时刻只读自己的文件；后一时刻只靠落盘文件接上前一时刻，不靠对话记忆。
+
+| 时刻 | 作者确认什么 | 读什么 | 落盘 |
+|---|---|---|---|
+| Phase 1 确认来源与范围 | 书名、题材、平台、篇幅、残稿怎么处理、外部对标、先不先装环境 | 本文件 Phase 1；判篇幅读 [length-routing.md](references/length-routing.md) | 导入记录 |
+| Phase 2 深度分析 | 不打扰作者 | [deep-analysis.md](references/deep-analysis.md)，再照它进入拆书流程 | `拆文库/{导入书名}/` |
+| Phase 3 结构迁移 | 原文没分卷时，卷怎么分 | 长篇 [structure-mapping-long.md](references/structure-mapping-long.md)；短篇 [structure-mapping-short.md](references/structure-mapping-short.md) | 项目 `设定/`、`正文/`、`大纲/`（短篇为三个单文件） |
+| 逐批反推细纲（长篇） | 不打扰作者 | 本批任务包（见 [outline-reverse.md](references/outline-reverse.md)） | `大纲/细纲_第XXX章.md` |
+| Phase 4 追踪初始化（长篇） | 不打扰作者 | [import-tracking.md](references/import-tracking.md) | `追踪/` |
+| Phase 5 汇报与激活 | 请作者核对、拍板的事 | [import-report.md](references/import-report.md) | `.active-book` |
+
+**导入记录**：`{书目录}/.story/work/导入记录.md`（书目录：长篇 `{导入书名}/`，短篇 `{短篇标题}/`），Phase 1 建立，格式见下方 Step 5。每个时刻开头先读它，不回翻对话；时刻交付前把作者在对话里新定的事（决定、偏好、红线、否掉的方案）和进度写回它，再往下走。
+**换上下文**：深度分析、每批细纲、追踪初始化读的东西多。每个时刻交付后，汇报末尾加一句「下一步建议新开一个对话，说『继续导入』，会更专注」；作者要在本对话继续也照做。作者说「继续导入」时，在项目根下找进度没勾完的 `*/.story/work/导入记录.md`，从第一个未完成的进度接着做。
+**导入续写入口顺序**：用户只问流程时先答结论再收原文——推荐先 `/story-setup`，新开对话 `/story-import`，导完 `/story-long-write 日更`；也可直接导入，缺环境时 Step 4 给选择。导入过的书、旧版追踪的书、超过 200 章的书按 [import-special-cases.md](references/import-special-cases.md) 处理。
+
+---
+
+## Phase 1：确认来源与范围
+
+### Step 1：确认意图
+
+默认目标是可续写的写作工程。意图不明时主动问：「你是想把这本书做成可续写的写作工程（设定/大纲/正文/追踪，能接着写第 N+1 章），还是只要一份拆文库分析？」只要分析 → 直接用 `/story-long-analyze`（短篇 `/story-short-analyze`），到拆文库为止，不建导入记录、不做迁移。
+
+### Step 2：拿到原文
+
+问：「你要导入哪本书？请提供文件路径或直接贴文本。」单文件（.txt/.md）按章节分隔符自动切分；目录按文件名排序合并；直接贴的文本在 Step 5 书名定下后原样存成 `{书目录}/.story/work/导入原文.md`（换对话后对话里的文本就拿不到了）；都没有就请作者提供。本时刻只确认源文件就绪，原文备份到 `拆文库/{导入书名}/原文/` 由 Phase 2 的拆解管道负责，这里不另备份。
+
+### Step 3：基本信息确认
+
+1. 自动检测书名（如有）、总章数、总字数、章节格式。
+2. 请作者确认：导入书名、题材类型、目标平台（起点/番茄/晋江/其他）、是否完本（半成品写到第 N 章）、**篇幅**（长篇/短篇，按 length-routing.md 检测：用户显式声明 > 结构信号 > 字数兜底，向作者复述结果请其确认；决定 Phase 3 走 3-L 还是 3-S）、**最后一章是否完整**——残稿时告诉作者，请他决定「接着残章写」还是「先补完再导入」，本 skill 只记录决定，不替作者选。
+3. 外部对标（可选、与导入源分离）：作者已明确指定时记录 `{对标书名}`，并确认 `拆文库/{对标书名}/` 是该参考作品的独立拆解产物；不得把 `{导入书名}` 或本次刚生成的拆文目录当候选。未指定时不追问，记为“未绑定”。
+4. 向作者展示检测到的章节范围、字数、篇幅、最后一章状态与“外部对标：{对标书名/未绑定}”，确认后往下走。
+
+### Step 4：写作环境检测
+
+先读取 `.story-deployed` 并执行顶部 Spawn 版本门禁；旧版 `chapter-extractor` 文件即使仍在磁盘上也不可复用。通过后在当前运行时的 canonical 目录检查 `chapter-extractor`（Claude/OpenCode/Antigravity 为同名 Markdown，Codex 为同名 TOML），顺带记下 `story-architect` 是否可用（逐批细纲用）。`.story-deployed` 的 `target_cli` 含 `zcode` 时项目 agents 缺失是预期状态：不提示重复部署，直接串行 solo/direct 并报告 fallback。
+
+部署标记缺失、版本无效/过期，或当前端 agent 不可用（且不是已部署 ZCode 项目）时这样问：
+
+> 「这个项目还没装好写作环境。装好后由专门的分析助手逐段拆书，主对话不会被整本书塞满；不装也能导，只是全部在主对话里做，慢一些，结果一样完整。你想：1. 先装环境（推荐）：运行 `/story-setup`，装完再说"导入" 2. 直接导入，慢一点也行」
+
+选 1 → 先按 Step 5 把已确认的信息写进导入记录（写作环境记「待装」），暂停导入，装完新开对话说「继续导入」；选 2 → Phase 2 由主会话串行处理，产物完整。
+
+### Step 5：写导入记录
+
+确认完把结果写进 `{书目录}/.story/work/导入记录.md`（目录不存在就建；贴入的原文同时存到同目录），再进入 Phase 2：
+
+```markdown
+# 导入记录：《{导入书名}》
+- 原文：{源文件或目录路径；贴入文本写 .story/work/导入原文.md}
+- 篇幅：{长篇 | 短篇}（{判定依据一句}）
+- 范围：第 1–{N} 章，约 {Y} 万字；{完本 | 半成品}；首期深拆：{全书 | 第 1–50 章，其余用简化摘要（超过 200 章）}
+- 最后一章：{完整 | 残稿：第 {N+1} 章写了一半，作者决定{接着残章写 | 先补完再导入}}
+- 题材：{题材类型}；目标平台：{平台}
+- 外部对标：{对标书名 | 未绑定}
+- 写作环境：{已装，分析助手可用{，story-architect 可用} | 待装（继续时重新检测） | 未装，作者选直接导入（主会话串行） | ZCode 串行}
+- 卷划分：{待 Phase 3 | 按原文卷界 | 作者已确认：1–40 / 41–95 / …}
+- 作者交代：{偏好、红线、否掉的方案，逐条；没有写「无」}
+
+## 进度
+- [ ] 深度分析
+- [ ] 结构迁移（卷划分已确认、卷纲已写）
+- [ ] 细纲：已验收到第 {B} 章（长篇；续跑从第 {B+1} 章整批重做）
+- [ ] 追踪初始化（长篇，检查通过）
+- [ ] 汇报与激活
+```
+
+---
+
+## Phase 2：深度分析
+
+读 [deep-analysis.md](references/deep-analysis.md)，按导入记录的篇幅与写作环境进入对应拆解管道，自动跑完本次需要的范围，不把拆书中途的停靠询问甩给作者。完成后勾进度。
+
+## Phase 3：结构迁移
+
+长篇（3-L）按 [structure-mapping-long.md](references/structure-mapping-long.md) 的迁移步骤把 `拆文库/{导入书名}/` 迁成 `{导入书名}/` 工程；原文没有明确卷界时，卷划分必须等作者确认，确认结果写进导入记录。细纲最后一步按 [outline-reverse.md](references/outline-reverse.md) 分批反推。短篇（3-S）按 [structure-mapping-short.md](references/structure-mapping-short.md) 迁成 `{短篇标题}/` 的三个单文件，**不产** `追踪/`、`大纲/`、`正文/` 等长篇目录，迁完直接到 Phase 5。
+
+## Phase 4：追踪初始化（仅长篇）
+
+读 [import-tracking.md](references/import-tracking.md)，用本 skill 自带的 `scripts/tracking_commit.py init` 一次性生成 `追踪/`，`check` 通过后勾进度。
+
+## Phase 5：汇报与激活
+
+读 [import-report.md](references/import-report.md)：自检、按模板向作者汇报、设置 `.active-book`。
+
+---
+
+## 流程衔接
+
+| 时机 | 跳转到 | 命令 |
+|---|---|---|
+| 导入完想继续写 | story-long-write / story-short-write | `/story-long-write` + "日更" / `/story-short-write` |
+| 导入完想审查质量 | story-review | `/story-review` |
+| 想拆一本外部对标书 | story-long-analyze / story-short-analyze | `/story-long-analyze` / `/story-short-analyze` |
+| 从零开新书 | story-long-write / story-short-write | `/story-long-write` + "开书" / `/story-short-write` |
+| 项目未装写作环境 | story-setup | `/story-setup` |
+
+## 语言
+
+- 跟随用户的语言回复，用户用什么语言就用什么语言回复
+- 中文回复遵循《中文文案排版指北》

package/resources/skills/story-creation/upstream/skills/story-import/references/character-state-reverse.md

@@ -0,0 +1,82 @@
+# 核心角色当前快照反推规则（长篇导入）
+
+> 仅用于 `story-import` 导入长篇。输出不是一份不断追加的角色历史，而是初始化事务里的 `character_snapshots`；`tracking_commit.py init` 会为每个核心角色生成 `追踪/角色状态/{角色名}.md`。
+
+## 一、输入来源
+
+只从已经落盘的拆书产物反推，不重读 `原文/`：
+
+| 输入 | 用途 |
+|---|---|
+| `拆文库/{书名}/角色/{角色名}.md` | 身份、能力、目标、成长弧线、出场记录 |
+| `拆文库/{书名}/角色/角色关系.md` | 截至最后完整章的关键关系 |
+| `拆文库/{书名}/章节/第N章_摘要.md` | 从 `涉及` 锁定相关章，从 `状态变化`、`信息变化`、`局面结果` 和 `章尾钩子` 提取最后位置、最新状态、已知信息与未结事项；旧摘要缺字段时回退其关键事件与情节点 |
+| `拆文库/{书名}/剧情/*.md` | 阵营/身份转折、阶段目标和长期冲突 |
+| 初始化事务中的伏笔与时间线候选 | 核对角色未结事项及其可知范围 |
+
+## 二、追踪对象
+
+只为主角、反派、核心配角建立独立快照。临时路人和只承担一次功能的角色不建文件。边界不清时优先不建，后续角色真正进入复用状态时再由逐章事务创建。
+
+## 三、反推方法
+
+对每个核心角色，以最后完整导入章 N 为截面，分别确定：
+
+1. `identity`：截至 N 章实际成立的身份/职业，不写未来晋升计划。
+2. `location`：最后落点或下一章开始前可确定的位置。
+3. `goal`：角色当前正在追求的具体目标。
+4. `state`：身体、情绪、名望、立场中会影响续写的当前状态；只写必要信息。
+5. `abilities_resources`：当前确实掌握的能力、物品、权限、作品或人脉，最多 8 条。
+6. `relationships`：与后续会复用角色的当前关系，最多 8 条。
+7. `knowledge`：角色本人已经知道、且会影响其行为的信息，最多 8 条。作者真相不能误写成角色已知。
+8. `open_threads`：角色相关的未结事项，最多 8 条；必须有已写正文证据，纯未来设计留在大纲。
+
+若同一字段有多次变化，只取截至 N 章的当前值，不把变化史塞进快照。历史变化由后续 `逐章记录/第NNN章.md` 承担；导入旧章不补造这些记录。
+
+## 四、初始化 JSON 形状
+
+以下示例来自 demo《让你管账号，你高燃混剪炸全网》第 10 章：
+
+```json
+{
+  "江晨": {
+    "identity": "火箭军文工团宣传兵；军宣爆款创作者",
+    "location": "火箭军文工团高层看片会",
+    "goal": "完成五天百万粉任务，继续做出真正能打的军宣内容",
+    "state": "专业团队重拍版反向坐实手机原版的价值，军内认可继续抬升",
+    "abilities_resources": [
+      "前世 MCN 爆款运营经验",
+      "《中国军魂》伴奏",
+      "大师级导演能力"
+    ],
+    "relationships": [
+      "钟嘉嘉持续提供军报资源",
+      "周薄森和张耀祖已明确认可其创作能力"
+    ],
+    "knowledge": [
+      "《军报》采访稿已经过审",
+      "高层决定继续采用《诸君，且听龙吟》手机原版"
+    ],
+    "open_threads": [
+      "五天百万粉任务尚未结算",
+      "钟嘉嘉所谓只猜对一半仍未解释"
+    ]
+  }
+}
+```
+
+工具据此生成的文件固定包含：截至章节、身份、位置、当前目标、身心状态、能力与资源、关键关系、已知信息、未结事项。模型不得另写一套 Markdown 模板。
+
+## 五、残稿与分批导入
+
+- 最后一章是残稿：所有快照截至残稿之前的最后完整章；残稿中的动作、获得物、关系变化不得提前生效。
+- 分批导入：快照只表示本次已导入范围的当前状态；扩大导入范围时重新执行一次完整导入，不在旧快照上追加历史段落。
+
+## 六、质量检查
+
+- [ ] 每个文件对应一个核心角色，无功能角色堆积
+- [ ] 所有字段都是截至最后完整章的当前值
+- [ ] 角色已知信息没有混入作者真相
+- [ ] 未结事项都有正文证据，未来设计仍在大纲
+- [ ] 单角色快照目标不超过 4096 字节；确有必要可放宽，但不得超过 8192 字节硬上限
+- [ ] `tracking_commit.py check` 通过