@kienmatu/inkos-core 0.1.0

package/dist/utils/story-markdown.js

@@ -0,0 +1,320 @@
+import { localizeHookPayoffTiming, normalizeStoredHookStatus, normalizeHookPayoffTiming, resolveHookPayoffTiming, } from "./hook-lifecycle.js";
+export function renderSummarySnapshot(summaries, language = "zh") {
+    if (summaries.length === 0)
+        return "- none";
+    const headers = language === "en"
+        ? [
+            "| chapter | title | characters | events | stateChanges | hookActivity | mood | chapterType |",
+            "| --- | --- | --- | --- | --- | --- | --- | --- |",
+        ]
+        : [
+            "| 章节 | 标题 | 出场人物 | 关键事件 | 状态变化 | 伏笔动态 | 情绪基调 | 章节类型 |",
+            "| --- | --- | --- | --- | --- | --- | --- | --- |",
+        ];
+    return [
+        ...headers,
+        ...summaries.map((summary) => [
+            summary.chapter,
+            summary.title,
+            summary.characters,
+            summary.events,
+            summary.stateChanges,
+            summary.hookActivity,
+            summary.mood,
+            summary.chapterType,
+        ].map(escapeTableCell).join(" | ")).map((row) => `| ${row} |`),
+    ].join("\n");
+}
+export function renderHookSnapshot(hooks, language = "zh") {
+    if (hooks.length === 0)
+        return "- none";
+    const headers = language === "en"
+        ? [
+            "| hook_id | start_chapter | type | status | last_advanced | expected_payoff | payoff_timing | depends_on | pays_off_in_arc | core_hook | half_life | promoted | notes |",
+            "| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |",
+        ]
+        : [
+            "| hook_id | 起始章节 | 类型 | 状态 | 最近推进 | 预期回收 | 回收节奏 | 上游依赖 | 回收卷 | 核心 | 半衰期 | 升级 | 备注 |",
+            "| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |",
+        ];
+    return [
+        ...headers,
+        ...hooks.map((hook) => [
+            hook.hookId,
+            hook.startChapter,
+            hook.type,
+            hook.status,
+            hook.lastAdvancedChapter,
+            hook.expectedPayoff,
+            localizeHookPayoffTiming(resolveHookPayoffTiming(hook), language),
+            renderDependsOnCell(hook.dependsOn ?? [], language),
+            hook.paysOffInArc ?? "",
+            renderCoreHookCell(hook.coreHook === true, language),
+            renderHalfLifeCell(hook.halfLifeChapters),
+            renderPromotedCell(hook.promoted, language),
+            hook.notes,
+        ].map((cell) => escapeTableCell(String(cell))).join(" | ")).map((row) => `| ${row} |`),
+    ].join("\n");
+}
+function renderHalfLifeCell(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0)
+        return "";
+    return String(Math.trunc(value));
+}
+function renderPromotedCell(value, language) {
+    if (value === undefined)
+        return "";
+    if (language === "en")
+        return value ? "true" : "false";
+    return value ? "是" : "否";
+}
+function renderDependsOnCell(ids, language) {
+    if (ids.length === 0)
+        return language === "en" ? "none" : "无";
+    return `[${ids.join(", ")}]`;
+}
+function renderCoreHookCell(isCore, language) {
+    if (language === "en")
+        return isCore ? "true" : "false";
+    return isCore ? "是" : "否";
+}
+export function parseChapterSummariesMarkdown(markdown) {
+    const rows = parseMarkdownTableRows(markdown)
+        .filter((row) => /^\d+$/.test(row[0] ?? ""));
+    return rows.map((row) => ({
+        chapter: parseInt(row[0], 10),
+        title: row[1] ?? "",
+        characters: row[2] ?? "",
+        events: row[3] ?? "",
+        stateChanges: row[4] ?? "",
+        hookActivity: row[5] ?? "",
+        mood: row[6] ?? "",
+        chapterType: row[7] ?? "",
+    }));
+}
+export function parsePendingHooksMarkdown(markdown) {
+    const tableRows = parseMarkdownTableRows(markdown)
+        .filter((row) => (row[0] ?? "").toLowerCase() !== "hook_id");
+    if (tableRows.length > 0) {
+        return tableRows
+            .filter((row) => normalizeHookId(row[0]).length > 0)
+            .map((row) => parsePendingHookRow(row));
+    }
+    return markdown
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("-"))
+        .map((line) => line.replace(/^-\s*/, ""))
+        .filter(Boolean)
+        .map((line, index) => ({
+        hookId: `hook-${index + 1}`,
+        startChapter: 0,
+        type: "unspecified",
+        status: "open",
+        lastAdvancedChapter: 0,
+        expectedPayoff: "",
+        payoffTiming: undefined,
+        notes: line,
+    }));
+}
+export function parseCurrentStateFacts(markdown, fallbackChapter) {
+    const tableRows = parseMarkdownTableRows(markdown);
+    const fieldValueRows = tableRows
+        .filter((row) => row.length >= 2)
+        .filter((row) => !isStateTableHeaderRow(row));
+    if (fieldValueRows.length > 0) {
+        const chapterFromTable = fieldValueRows.find((row) => isCurrentChapterLabel(row[0] ?? ""));
+        const stateChapter = parseInteger(chapterFromTable?.[1]) || fallbackChapter;
+        return fieldValueRows
+            .filter((row) => !isCurrentChapterLabel(row[0] ?? ""))
+            .flatMap((row) => {
+            const label = (row[0] ?? "").trim();
+            const value = (row[1] ?? "").trim();
+            if (!label || !value)
+                return [];
+            return [{
+                    subject: inferFactSubject(label),
+                    predicate: label,
+                    object: value,
+                    validFromChapter: stateChapter,
+                    validUntilChapter: null,
+                    sourceChapter: stateChapter,
+                }];
+        });
+    }
+    const bulletFacts = markdown
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("-"))
+        .map((line) => line.replace(/^-\s*/, ""))
+        .filter(Boolean);
+    return bulletFacts.map((line, index) => ({
+        subject: "current_state",
+        predicate: `note_${index + 1}`,
+        object: line,
+        validFromChapter: fallbackChapter,
+        validUntilChapter: null,
+        sourceChapter: fallbackChapter,
+    }));
+}
+export function parseMarkdownTableRows(markdown) {
+    return markdown
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("|"))
+        .filter((line) => !line.includes("---"))
+        .map((line) => line.split("|").slice(1, -1).map((cell) => cell.trim()))
+        .filter((cells) => cells.some(Boolean));
+}
+export function isStateTableHeaderRow(row) {
+    const first = (row[0] ?? "").trim().toLowerCase();
+    const second = (row[1] ?? "").trim().toLowerCase();
+    return (first === "字段" && second === "值") || (first === "field" && second === "value");
+}
+export function isCurrentChapterLabel(label) {
+    return /^(当前章节|current chapter)$/i.test(label.trim());
+}
+export function inferFactSubject(label) {
+    if (/^(当前位置|current location)$/i.test(label))
+        return "protagonist";
+    if (/^(主角状态|protagonist state)$/i.test(label))
+        return "protagonist";
+    if (/^(当前目标|current goal)$/i.test(label))
+        return "protagonist";
+    if (/^(当前限制|current constraint)$/i.test(label))
+        return "protagonist";
+    if (/^(当前敌我|current alliances|current relationships)$/i.test(label))
+        return "protagonist";
+    if (/^(当前冲突|current conflict)$/i.test(label))
+        return "protagonist";
+    return "current_state";
+}
+export function parseInteger(value) {
+    if (!value)
+        return 0;
+    const match = value.match(/\d+/);
+    return match ? parseInt(match[0], 10) : 0;
+}
+/**
+ * Strict integer parse — only accepts cells that are purely numeric
+ * (after stripping markdown formatting). Returns 0 for cells containing
+ * prose like "第141号文明" to prevent narrative numbers from being
+ * mistaken for chapter/progress values.
+ */
+function parseStrictChapterInteger(value) {
+    if (!value)
+        return 0;
+    const stripped = normalizeHookId(value);
+    return /^\d+$/.test(stripped) ? parseInt(stripped, 10) : 0;
+}
+export function normalizeHookId(value) {
+    let normalized = (value ?? "").trim();
+    let previous = "";
+    while (normalized && normalized !== previous) {
+        previous = normalized;
+        normalized = normalized
+            .replace(/^\[(.+?)\]\([^)]+\)$/u, "$1")
+            .replace(/^\*\*(.+)\*\*$/u, "$1")
+            .replace(/^__(.+)__$/u, "$1")
+            .replace(/^\*(.+)\*$/u, "$1")
+            .replace(/^_(.+)_$/u, "$1")
+            .replace(/^`(.+)`$/u, "$1")
+            .replace(/^~~(.+)~~$/u, "$1")
+            .trim();
+    }
+    normalized = normalized
+        .replace(/-{2,}/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .trim();
+    return /[a-z0-9\u4e00-\u9fff]/iu.test(normalized) ? normalized : "";
+}
+function parsePendingHookRow(row) {
+    // Row shapes by length:
+    //   7 (legacy pre-timing): id, ch, type, status, last_adv, expected, notes
+    //   8 (Phase 5/6):          id, ch, type, status, last_adv, expected, timing, notes
+    //  11 (Phase 7 ledger):     ... + depends_on, pays_off_in_arc, core_hook, notes
+    //  12 (Phase 7 hotfix 1):   ... + depends_on, pays_off_in_arc, core_hook, half_life, notes
+    //  13 (Phase 7 hotfix 2):   ... + depends_on, pays_off_in_arc, core_hook, half_life, promoted, notes
+    //  additional trailing columns (e.g. stale/blocked diagnostic columns) are
+    //  allowed — the parser skips past them to the notes column.
+    const phase7Promoted = row.length >= 13;
+    const phase7HalfLife = row.length === 12;
+    const phase7Compact = row.length === 11;
+    const phase7 = phase7Promoted || phase7HalfLife || phase7Compact;
+    const legacyShape = row.length < 8;
+    const payoffTiming = legacyShape ? undefined : normalizeHookPayoffTiming(row[6]);
+    const notes = phase7Promoted
+        ? (row[12] ?? "")
+        : phase7HalfLife
+            ? (row[11] ?? "")
+            : phase7Compact
+                ? (row[10] ?? "")
+                : legacyShape
+                    ? (row[6] ?? "")
+                    : (row[7] ?? "");
+    const base = {
+        hookId: normalizeHookId(row[0]),
+        startChapter: parseStrictChapterInteger(row[1]),
+        type: row[2] ?? "",
+        status: normalizeStoredHookStatus(row[3] ?? "open"),
+        lastAdvancedChapter: parseStrictChapterInteger(row[4]),
+        expectedPayoff: row[5] ?? "",
+        payoffTiming,
+        notes,
+    };
+    if (!phase7)
+        return base;
+    return {
+        ...base,
+        dependsOn: parseDependsOn(row[7] ?? ""),
+        paysOffInArc: (row[8] ?? "").trim(),
+        coreHook: parseBooleanCell(row[9]),
+        halfLifeChapters: (phase7HalfLife || phase7Promoted) ? parseOptionalInt(row[10]) : undefined,
+        promoted: phase7Promoted ? parseOptionalBooleanCell(row[11]) : undefined,
+    };
+}
+function parseOptionalBooleanCell(cell) {
+    const normalized = (cell ?? "").trim();
+    if (!normalized)
+        return undefined;
+    const lower = normalized.toLowerCase();
+    if (/^(true|yes|y|是|核心|core|1|✓|✔|promoted|已升级)$/.test(lower))
+        return true;
+    if (/^(false|no|n|否|未升级|seed|0|✗|✘)$/.test(lower))
+        return false;
+    return undefined;
+}
+function parseDependsOn(cell) {
+    const trimmed = cell.trim();
+    if (!trimmed)
+        return [];
+    const lower = trimmed.toLowerCase();
+    if (lower === "none" || lower === "n/a" || lower === "-" || trimmed === "无")
+        return [];
+    // Accept [H01, H02] or H01, H02 or H01/H02.
+    const stripped = trimmed.replace(/^[\[\(]\s*/, "").replace(/\s*[\]\)]$/, "");
+    return stripped
+        .split(/[,，、\/]+/)
+        .map((item) => normalizeHookId(item))
+        .filter((item) => item.length > 0);
+}
+function parseBooleanCell(cell) {
+    const normalized = (cell ?? "").trim().toLowerCase();
+    if (!normalized)
+        return false;
+    return /^(true|yes|y|是|核心|core|1|✓|✔)$/.test(normalized);
+}
+function parseOptionalInt(cell) {
+    const normalized = (cell ?? "").trim();
+    if (!normalized)
+        return undefined;
+    const match = normalized.match(/\d+/);
+    if (!match)
+        return undefined;
+    const value = parseInt(match[0], 10);
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+function escapeTableCell(value) {
+    return String(value).replace(/\|/g, "\\|").trim();
+}
+//# sourceMappingURL=story-markdown.js.map

package/dist/utils/story-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-markdown.js","sourceRoot":"","sources":["../../src/utils/story-markdown.ts"],"names":[],"mappings":"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"}

package/dist/utils/web-search.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Web search + URL fetch utilities.
+ *
+ * searchWeb(): Tavily API search (requires TAVILY_API_KEY env var).
+ * fetchUrl(): Fetch a specific URL and return plain text.
+ */
+export interface SearchResult {
+    readonly title: string;
+    readonly url: string;
+    readonly snippet: string;
+}
+export interface WebSearchOptions {
+    readonly apiKey?: string;
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+}
+/**
+ * Search the web via Tavily API.
+ * Requires TAVILY_API_KEY environment variable.
+ * Throws if key is not set — caller should catch and fall back to regular chat.
+ */
+export declare function searchWeb(query: string, maxResults?: number, options?: WebSearchOptions): Promise<ReadonlyArray<SearchResult>>;
+/**
+ * Fetch a URL and return its text content.
+ * HTML is stripped to plain text. Output is truncated to maxChars.
+ */
+export declare function fetchUrl(url: string, maxChars?: number): Promise<string>;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/utils/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/utils/web-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,SAAI,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAkCtC;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B5E"}

package/dist/utils/web-search.js

@@ -0,0 +1,72 @@
+/**
+ * Web search + URL fetch utilities.
+ *
+ * searchWeb(): Tavily API search (requires TAVILY_API_KEY env var).
+ * fetchUrl(): Fetch a specific URL and return plain text.
+ */
+/**
+ * Search the web via Tavily API.
+ * Requires TAVILY_API_KEY environment variable.
+ * Throws if key is not set — caller should catch and fall back to regular chat.
+ */
+export async function searchWeb(query, maxResults = 5, options = {}) {
+    const apiKey = options.apiKey
+        || (options.apiKeyEnv ? process.env[options.apiKeyEnv] : undefined)
+        || process.env.TAVILY_API_KEY;
+    if (!apiKey) {
+        throw new Error(`${options.apiKeyEnv ?? "TAVILY_API_KEY"} not set. Configure Studio research search or set the env var to enable web search.`);
+    }
+    const endpoint = options.baseUrl?.trim() || "https://api.tavily.com/search";
+    const res = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            api_key: apiKey,
+            query,
+            max_results: maxResults,
+            search_depth: "basic",
+        }),
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok) {
+        throw new Error(`Tavily search failed: ${res.status} ${await res.text().catch(() => "")}`);
+    }
+    const data = await res.json();
+    return (data.results ?? []).map((r) => ({
+        title: r.title ?? "",
+        url: r.url ?? "",
+        snippet: r.content ?? "",
+    }));
+}
+/**
+ * Fetch a URL and return its text content.
+ * HTML is stripped to plain text. Output is truncated to maxChars.
+ */
+export async function fetchUrl(url, maxChars = 8000) {
+    const res = await fetch(url, {
+        headers: {
+            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
+            "Accept": "text/html, application/json, text/plain",
+        },
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok) {
+        throw new Error(`Fetch failed: ${res.status} ${res.statusText}`);
+    }
+    const contentType = res.headers.get("content-type") ?? "";
+    const text = await res.text();
+    if (contentType.includes("html")) {
+        return text
+            .replace(/<script[\s\S]*?<\/script>/gi, "")
+            .replace(/<style[\s\S]*?<\/style>/gi, "")
+            .replace(/<[^>]*>/g, " ")
+            .replace(/\s+/g, " ")
+            .trim()
+            .slice(0, maxChars);
+    }
+    return text.slice(0, maxChars);
+}
+//# sourceMappingURL=web-search.js.map

package/dist/utils/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/utils/web-search.ts"],"names":[],"mappings":"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"}

package/dist/utils/writing-methodology.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Full writing methodology for style_guide.md injection.
+ * This is the complete reference material (with examples) that the
+ * compact "craft card" in the system prompt summarizes.
+ *
+ * Injected once during initBook/generateStyleGuide, then read by
+ * writer on every chapter as part of the style_guide context.
+ */
+export declare function buildWritingMethodologySection(language: "zh" | "en"): string;
+//# sourceMappingURL=writing-methodology.d.ts.map

package/dist/utils/writing-methodology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-methodology.d.ts","sourceRoot":"","sources":["../../src/utils/writing-methodology.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAK5E"}

package/dist/utils/writing-methodology.js

@@ -0,0 +1,163 @@
+/**
+ * Full writing methodology for style_guide.md injection.
+ * This is the complete reference material (with examples) that the
+ * compact "craft card" in the system prompt summarizes.
+ *
+ * Injected once during initBook/generateStyleGuide, then read by
+ * writer on every chapter as part of the style_guide context.
+ */
+export function buildWritingMethodologySection(language) {
+    if (language === "en") {
+        return buildEnglishMethodology();
+    }
+    return buildChineseMethodology();
+}
+function buildChineseMethodology() {
+    return `---
+
+# 写作方法论参考（完整版）
+
+以下方法论是写作质量的完整参考。写作时应内化这些原则。
+
+## 一、去AI味：正反例对照
+
+### 情绪描写
+| 反例（AI味） | 正例（人味） | 要点 |
+|---|---|---|
+| 他感到非常愤怒。 | 他捏碎了手中的茶杯，滚烫的茶水流过指缝，但他像没感觉一样。 | 用动作外化情绪 |
+| 她心里很悲伤，眼泪流了下来。 | 她攥紧手机，指节发白，屏幕上的聊天记录模糊成一片。 | 用身体细节替代直白标签 |
+| 他感到一阵恐惧。 | 他后背的汗毛竖了起来，脚底像踩在了冰上。 | 五感传递恐惧 |
+
+### 转折与衔接
+| 反例 | 正例 | 要点 |
+|---|---|---|
+| 虽然他很强，但是他还是输了。 | 他确实强，可对面那个老东西更脏。 | 口语化转折 |
+| 然而，事情并没有那么简单。 | 哪有那么便宜的事。 | 角色内心吐槽替代"然而" |
+| 因此，他决定采取行动。 | 他站起来，把凳子踢到一边。 | 删掉因果连词，直接写动作 |
+
+### "了"字控制
+| 反例 | 正例 |
+|---|---|
+| 他走了过去，拿了杯子，喝了一口水。 | 他走过去，端起杯子，灌了一口。 |
+| 她笑了笑，转身离开了房间。 | 她嘴角一扬，转身出门。 |
+
+## 二、六步走人物心理分析
+
+每个重要角色在关键场景中的行为，必须经过以下六步推导：
+
+1. **当前处境**：角色此刻面临什么局面？手上有什么牌？
+2. **核心动机**：角色最想要什么？最害怕什么？
+3. **信息边界**：角色知道什么？不知道什么？对局势有什么误判？
+4. **性格过滤**：同样的局面，这个角色的性格会怎么反应？
+5. **行为选择**：基于以上四点，角色会做出什么选择？
+6. **情绪外化**：这个选择伴随什么情绪？用什么身体语言、表情、语气表达？
+
+禁止跳过步骤直接写行为。
+
+## 三、配角设计方法论
+
+- 配角必须有反击，有自己的算盘。主角的强大在于压服聪明人，而不是碾压傻子。
+- 每个配角的行为动机必须与主线产生关联。
+- 核心标签 + 反差细节 = 活人（表面冷硬的角色偷偷照顾流浪动物）。
+- 通过事件立人设，禁止通过外貌和形容词堆砌。
+- 不同角色的说话方式必须有辨识度。
+- 群戏中不写"众人齐声惊呼"，挑1-2个角色写具体反应。
+
+## 四、代入感六大支柱
+
+1. **基础信息交代**：一句话能交代身份、性格、地位——"小爷我乃镇南府世子林峰"
+2. **具体化/可视化**：描写具体到读者脑海能浮现——"搪瓷缸白汽直冒""冰镇汽水嘶嘶响"
+3. **熟悉感**：接地气的场景自带代入感——"高考后小树林的分手""医院走廊的消毒水味"
+4. **共鸣**：主角的困境必须有普遍性——被欺压、不公待遇、被低估
+5. **欲望驱动**：
+   - 基础欲望（被动）：不劳而获、高人一等、扬眉吐气
+   - 主动欲望（期待感）：作者刻意制造的情绪缺口→读者期待释放→释放超过预期
+6. **五感描写**：视觉、听觉、嗅觉、触觉、味觉——"潮湿的短袖黏在后背上"
+
+## 五、强情绪升级法（避免流水账）
+
+流水账的修法不是删掉日常，而是给日常加"料"：
+
+1. **加入前因后果**：下班回家→加上"催债电话刚打来"→日常有了紧迫感
+2. **情绪递进**：坏事叠坏事——被骂→赶不上公交→手机掉了→直播课结束了→包子噎住了。每层比上一层过分
+3. **日常必须为主线服务**：万物皆为"饵"。日常段要么埋伏笔，要么推关系，要么建立反差
+
+## 六、写前自检清单
+
+1. 本章对应卷纲中的哪个节点？是否推进了该节点？
+2. 主角此刻利益最大化的选择是什么？
+3. 冲突是谁先动手，为什么非做不可？
+4. 配角/反派是否有明确诉求和反制？
+5. 反派当前掌握了哪些信息？有无信息越界？
+6. 章尾是否留了钩子？
+7. 有没有流水账？如有，加前因后果或强情绪
+8. 本章是否推进了主线目标？`;
+}
+function buildEnglishMethodology() {
+    return `---
+
+# Writing Methodology Reference (Full Version)
+
+Complete reference material for writing quality. Internalize these principles.
+
+## 1. Anti-AI Pattern Guide
+
+### Emotion
+| Bad (AI-like) | Good (Human) | Key |
+|---|---|---|
+| He felt very angry. | He crushed the teacup in his hand. Scalding water ran through his fingers, but he didn't flinch. | Externalize through action |
+| She was very sad and tears fell. | She gripped her phone until her knuckles went white. The chat log blurred. | Body detail replaces label |
+
+### Transitions
+| Bad | Good | Key |
+|---|---|---|
+| Although he was strong, he still lost. | He was strong, sure. But the old bastard across from him fought dirtier. | Colloquial voice |
+| However, things were not so simple. | No such luck. | Character thought replaces "however" |
+| Therefore, he decided to take action. | He stood up and kicked the chair aside. | Cut causal connectors, show action |
+
+## 2. Six-Step Character Psychology
+
+For every important character action:
+1. **Situation**: What's the character facing? What cards do they hold?
+2. **Core motivation**: What do they want most? Fear most?
+3. **Information boundary**: What do they know? Not know? Misjudge?
+4. **Personality filter**: Given the same situation, how would THIS character react?
+5. **Behavioral choice**: Based on 1-4, what do they choose?
+6. **Emotional expression**: What emotion accompanies this? Body language, expression, tone?
+
+## 3. Supporting Character Design
+
+- Every side character has their own agenda. Protagonist wins by outsmarting smart people.
+- Core tag + contrast detail = alive (cold-exterior character secretly feeds strays).
+- Establish character through events, not description dumps.
+- Different characters speak differently — vocabulary, length, verbal tics.
+- In group scenes: never "everyone gasped" — pick 1-2 specific reactions.
+
+## 4. Immersion Pillars
+
+1. **Info delivery**: One line of dialogue can establish identity, status, personality
+2. **Concrete/visual**: "The back seat of a taxi stuck in traffic for forty minutes" not "a big city"
+3. **Familiarity**: Scenes readers have lived through carry natural immersion
+4. **Resonance**: Protagonist's struggle must feel universal — injustice, being underestimated
+5. **Desire engine**: Create emotional gap → reader anticipates release → release exceeds expectation
+6. **Five senses**: Wet shirt on the back, hospital disinfectant, rain puddles at the bus stop
+
+## 5. Emotional Escalation (Anti-Flowchart)
+
+Fix boring daily scenes by adding fuel:
+1. **Add causality**: Coming home → add "debt collector just called" → instant urgency
+2. **Progressive escalation**: Stack bad things — scolded → missed bus → phone fell in drain → livestream ended → choked on stale bread. Each layer worse.
+3. **Daily serves mainline**: Every quiet scene must plant a hook, advance a relationship, or build contrast.
+
+## 6. Pre-Write Checklist
+
+1. Which outline node does this chapter correspond to?
+2. What's the protagonist's optimal move right now?
+3. Who starts the conflict and why must they?
+4. Do antagonists have clear motives and countermoves?
+5. What information does each character have? Any boundary violations?
+6. Does the chapter end with a hook?
+7. Any flowchart passages? If so, add causality or strong emotion.
+8. Does this chapter advance the main plotline?`;
+}
+//# sourceMappingURL=writing-methodology.js.map

package/dist/utils/writing-methodology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-methodology.js","sourceRoot":"","sources":["../../src/utils/writing-methodology.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAAqB;IAClE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,uBAAuB,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,uBAAuB,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA8EO,CAAC;AACjB,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAgEuC,CAAC;AACjD,CAAC"}