markdown-ai-rewriter 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.0] - 2026-03-27
+
+### Added
+- **MiniMax** provider (`provider: 'minimax'` / `-p minimax`): OpenAI-compatible API via `openai` package; configure `MINIMAX_API_KEY` and optional `MINIMAX_BASE_URL` or `minimaxBaseUrl` / `--minimax-base-url`.
+- `prepublishOnly` build and explicit `files` field for npm package contents.
+
+### Changed
+- README 中文版与 CLI、章节/全文模式说明更新。
+- OpenAI / Anthropic Provider 复用客户端实例；章节模式尊重 `concurrency`。
+- CLI 版本号从 `package.json` 读取。
+
+### Removed
+- **Breaking:** Paragraph-level rewrite mode (`paragraph`) removed. Use `section` (default) or `full` via `mode` in config or `--mode` on the CLI.
+
+## [0.1.0] - 2026-03-23
+
+### Added
+- Initial release
+- Markdown structure parser that preserves document structure
+- AI rewriter with OpenAI and Anthropic support
+- Multiple writing styles (casual, formal, technical, creative)
+- CLI tool for command-line usage
+- Programmatic API for integration
+- Concurrent processing for better performance
+- Comprehensive documentation and examples

package/README.md

@@ -0,0 +1,298 @@
+# markdown-ai-rewriter
+
+面向 **Markdown 长文与文档** 的 AI 改写工具：在 **保留标题层级、代码块、表格、图片等结构** 的前提下，对正文进行润色、降重或换表述，适合博客、技术文档、公众号稿、新闻稿整理等场景。
+
+---
+
+## 核心特点与优势
+
+| 维度 | 说明 |
+|------|------|
+| **结构优先** | 不是简单「全文扔给模型」，而是按文档结构处理，减少标题错乱、代码被改写、版式被打乱的风险。 |
+| **双模式可切换** | **章节模式**（默认）按标题切块并行，成本与连贯性平衡好；**全文模式**整篇一次生成，语气最连贯，适合短文或强叙事。 |
+| **多模型** | 支持 **OpenAI**、**Anthropic**、**MiniMax**（OpenAI 兼容接口），也可接入 **自定义 Provider**。 |
+| **风格可控** | 内置 casual / formal / technical / creative / custom，并支持温度、长度倾向、`--prompt` 自定义指令。 |
+| **工程化友好** | 提供 **CLI**（`markdown-ai-rewrite` / `md-rewrite`）与 **TypeScript API**，可嵌入脚本、CI 或内容流水线。 |
+| **并发可配** | 章节模式下可配置并发请求数，在长文档场景下兼顾速度与 API 限流。 |
+
+**一句话**：把「能改的部分」交给模型，把「必须稳的结构」留在本地解析与重组逻辑里，**更适合严肃内容生产**，而不是聊天式随意生成。
+
+---
+
+## 两种改写模式
+
+| 模式 | CLI | 适用场景 | 优势 |
+|------|-----|----------|------|
+| **章节** `section` | `--mode section`（默认） | 中长篇、多小节、技术文档 | 按标题分章改写，可带上下文章摘要，**调用次数可预期、成本更可控**。 |
+| **全文** `full` | `--mode full` | 短文、强叙事、整篇语气统一 | **一次请求覆盖全文**，连贯性通常最好；全文模式会先用占位符保护图片再还原。 |
+
+章节模式可通过 `--section-level 1|2|3` 指定按几级标题切分（默认 1 级 `#`）。
+
+---
+
+## 安装
+
+```bash
+npm install markdown-ai-rewriter
+```
+
+按需安装官方 SDK（至少其一）：
+
+```bash
+npm install openai
+# MiniMax 使用与 OpenAI 相同的 SDK + 兼容 Base URL，见下文
+# 或
+npm install @anthropic-ai/sdk
+```
+
+---
+
+## 快速开始
+
+### 命令行
+
+```bash
+# OpenAI
+export OPENAI_API_KEY="your-api-key"
+markdown-ai-rewrite rewrite \
+  --input article.md \
+  --output article-rewritten.md \
+  --provider openai \
+  --style casual
+
+# Anthropic
+export ANTHROPIC_API_KEY="your-api-key"
+markdown-ai-rewrite rewrite \
+  --input article.md \
+  --output article-rewritten.md \
+  --provider anthropic \
+  --style formal
+
+# MiniMax（需已安装 openai；密钥在 MiniMax 开放平台创建）
+export MINIMAX_API_KEY="your-minimax-api-key"
+# 可选：国内/国际 endpoint 不同可设置 MINIMAX_BASE_URL，见下方说明
+markdown-ai-rewrite rewrite \
+  -i article.md \
+  -o out.md \
+  -p minimax \
+  -m MiniMax-M2.1 \
+  --style casual
+
+# 全文模式示例
+markdown-ai-rewrite rewrite -i article.md -o out.md -p openai --mode full -v
+```
+
+### 在代码中使用
+
+```typescript
+import { MarkdownRewriter } from 'markdown-ai-rewriter';
+
+const rewriter = new MarkdownRewriter({
+  provider: 'openai',
+  apiKey: process.env.OPENAI_API_KEY,
+  model: 'gpt-4o-mini',
+  mode: 'section',       // 或 'full'
+  sectionLevel: 1,
+  verbose: true,
+  concurrency: 3,
+  options: {
+    style: 'casual',
+    temperature: 0.7,
+    maxTokens: 2000,     // 未传时 Provider 侧有默认值；CLI 默认常为 4000，以实际调用为准
+  },
+});
+
+const result = await rewriter.rewrite(markdown);
+console.log(result.rewritten);
+```
+
+---
+
+## 常用 CLI 参数
+
+| 参数 | 含义 |
+|------|------|
+| `-i, --input` | 输入 Markdown 文件（必填） |
+| `-o, --output` | 输出 Markdown 文件（必填） |
+| `-p, --provider` | `openai`、`anthropic` 或 `minimax`（必填） |
+| `-k, --api-key` | API Key；也可使用 `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `MINIMAX_API_KEY` |
+| `-m, --model` | 模型名（MiniMax 示例：`MiniMax-M2.1`、`MiniMax-M2.7`，以官方文档为准） |
+| `--minimax-base-url` | 仅 MiniMax：API Base URL（默认 `https://api.minimax.io/v1`，也可用环境变量 `MINIMAX_BASE_URL`） |
+| `-s, --style` | `casual` \| `formal` \| `technical` \| `creative` \| `custom` |
+| `--prompt` | 自定义系统提示补充（常与 `custom` 风格配合） |
+| `-t, --temperature` | 采样温度 0～1，默认约 0.7 |
+| `--max-tokens` | 单次回复上限（CLI 默认 4000） |
+| `--preserve-length` | 尽量保持与原文相近篇幅 |
+| `-c, --concurrency` | 并发数，默认 3（主要影响章节模式） |
+| `-v, --verbose` | 打印详细日志 |
+| `--mode` | `section`（默认）或 `full` |
+| `--section-level` | 章节模式下的标题级别 1～3，默认 1 |
+
+完整说明可执行：`markdown-ai-rewrite rewrite --help`。
+
+---
+
+## 写作风格（`--style`）
+
+- **casual**：轻松、口语化  
+- **formal**：正式、商务或书面语  
+- **technical**：偏术语与准确性  
+- **creative**：更有表现力  
+- **custom**：配合 `--prompt` 自行描述要求  
+
+---
+
+## 改写时大致会发生什么
+
+- **章节 / 全文** 两种模式都会在「尊重结构」的前提下改写正文；标题、代码块、表格等会按实现策略尽量保留或由占位符保护（全文模式下的图片采用占位符机制）。  
+- 具体列表、引用等是否逐条保留，与模型输出有关；若你需要强保留列表结构，可在 `--prompt` 中明确要求。
+
+---
+
+## 示例
+
+###  casual 风格（片段）
+
+**输入：**
+
+```markdown
+# Product Launch
+
+The new product will be released next month. It features advanced technology.
+
+- High performance
+- Low cost
+- Easy to use
+```
+
+**输出（示意）：**
+
+```markdown
+# Product Launch
+
+Hey, exciting news! Our new product drops next month and it's packed with some seriously cool tech.
+
+- Lightning-fast performance
+- Won't break the bank
+- Super simple to get started
+```
+
+### formal 风格（引用块）
+
+**输入：** `> This is an important announcement.`  
+
+**输出（示意）：** `> We wish to inform you of a significant development that requires your attention.`
+
+---
+
+## 与内容流水线配合（示例）
+
+可与抓取、转换工具串联，例如先得到 Markdown，再改写，最后发布：
+
+```bash
+convert-url --url "https://news.com/article" --output article.md
+
+markdown-ai-rewrite rewrite \
+  --input article.md \
+  --output article-rewritten.md \
+  --provider openai \
+  --style casual
+```
+
+---
+
+## 自定义 AI 后端
+
+实现 `BaseProvider`，即可对接自有网关或其它兼容接口：
+
+```typescript
+import { MarkdownRewriter, BaseProvider, RewriteOptions } from 'markdown-ai-rewriter';
+
+class MyCustomProvider extends BaseProvider {
+  name = 'my-provider';
+
+  async rewrite(text: string, options: RewriteOptions): Promise<string> {
+    // 调用你的模型 API，返回改写后的纯文本
+    return rewrittenText;
+  }
+}
+
+const rewriter = new MarkdownRewriter({
+  provider: 'custom',
+  customProvider: new MyCustomProvider(),
+});
+```
+
+---
+
+## API 摘要
+
+### `MarkdownRewriter`
+
+```typescript
+constructor(config: RewriterConfig)
+async rewrite(markdown: string): Promise<RewriteResult>
+```
+
+### `RewriterConfig`（节选）
+
+```typescript
+interface RewriterConfig {
+  provider: 'openai' | 'anthropic' | 'minimax' | 'custom';
+  apiKey?: string;
+  model?: string;
+  minimaxBaseUrl?: string;
+  options?: RewriteOptions;
+  customProvider?: AIProvider;
+  verbose?: boolean;
+  concurrency?: number;
+  mode?: 'section' | 'full';
+  sectionLevel?: 1 | 2 | 3;
+}
+```
+
+### `RewriteResult`
+
+```typescript
+interface RewriteResult {
+  original: string;
+  rewritten: string;
+  blocksProcessed: number;
+  blocksRewritten: number;
+  tokensUsed?: number;
+  cost?: number;
+}
+```
+
+---
+
+## 环境变量
+
+```bash
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+export MINIMAX_API_KEY="..."
+# export MINIMAX_BASE_URL="https://api.minimax.io/v1"
+```
+
+---
+
+## 费用参考（量级）
+
+以约 **1000 英文单词** 的文章为量级（实际随结构、`--mode`、模型与并发变化）：
+
+- **OpenAI GPT-4o-mini**：约 \$0.01～0.02  
+- **Anthropic Claude 3.5 一类模型**：约 \$0.05～0.10  
+- **MiniMax**：以 [MiniMax 定价说明](https://platform.minimax.io/docs/guides/pricing) 为准  
+
+请以各厂商定价与实测为准。
+
+---
+
+## 许可证
+
+MIT
+
+## 作者
+
+Ping Si <sipingme@gmail.com>

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const rewriter_1 = require("./core/rewriter");
+const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new commander_1.Command();
+program
+    .name('markdown-ai-rewrite')
+    .description('AI-powered Markdown content rewriter that preserves document structure')
+    .version(pkg.version);
+program
+    .command('rewrite')
+    .description('Rewrite a Markdown file using AI')
+    .requiredOption('-i, --input <file>', 'Input Markdown file')
+    .requiredOption('-o, --output <file>', 'Output Markdown file')
+    .requiredOption('-p, --provider <provider>', 'AI provider: openai, anthropic, minimax')
+    .option('-k, --api-key <key>', 'API key (or env: OPENAI_API_KEY, ANTHROPIC_API_KEY, MINIMAX_API_KEY)')
+    .option('-m, --model <model>', 'Model (OpenAI default gpt-4o-mini; Anthropic claude-3-5-sonnet; MiniMax MiniMax-M2.1)')
+    .option('--minimax-base-url <url>', 'MiniMax API base URL (default: https://api.minimax.io/v1 or MINIMAX_BASE_URL)')
+    .option('-s, --style <style>', 'Writing style: casual, formal, technical, creative, custom', 'custom')
+    .option('--prompt <prompt>', 'Custom rewrite prompt')
+    .option('-t, --temperature <number>', 'Temperature (0-1)', parseFloat, 0.7)
+    .option('--max-tokens <number>', 'Max tokens per request', parseInt, 4000)
+    .option('--preserve-length', 'Try to preserve original length')
+    .option('-c, --concurrency <number>', 'Concurrent API requests', parseInt, 3)
+    .option('-v, --verbose', 'Verbose output')
+    .option('--mode <mode>', 'Rewrite mode: section (按标题分章，默认), full (整篇一次，最连贯)', 'section')
+    .option('--section-level <level>', 'Section level for section mode (1-3)', parseInt, 1)
+    .action(async (options) => {
+    try {
+        if (!['section', 'full'].includes(options.mode)) {
+            console.error('❌ 错误：mode 必须是 section 或 full');
+            process.exit(1);
+        }
+        if (options.mode === 'full') {
+            console.log('ℹ️  使用全文改写模式（最连贯，但token消耗较大）\n');
+        }
+        const apiKey = options.apiKey ||
+            (options.provider === 'openai'
+                ? process.env.OPENAI_API_KEY
+                : options.provider === 'anthropic'
+                    ? process.env.ANTHROPIC_API_KEY
+                    : process.env.MINIMAX_API_KEY);
+        if (!apiKey) {
+            console.error('❌ 错误：需要 API key');
+            console.error('   设置环境变量: OPENAI_API_KEY、ANTHROPIC_API_KEY 或 MINIMAX_API_KEY（与 --provider 对应）');
+            process.exit(1);
+        }
+        const markdown = (0, fs_1.readFileSync)(options.input, 'utf-8');
+        const config = {
+            provider: options.provider,
+            apiKey,
+            model: options.model,
+            minimaxBaseUrl: options.minimaxBaseUrl,
+            verbose: options.verbose,
+            concurrency: options.concurrency,
+            mode: options.mode,
+            sectionLevel: options.sectionLevel,
+            options: {
+                style: options.style,
+                prompt: options.prompt,
+                temperature: options.temperature,
+                maxTokens: options.maxTokens,
+                preserveLength: options.preserveLength,
+            },
+        };
+        const modeLabel = options.mode === 'section' ? '章节级' : '全文';
+        console.log(`🚀 开始${modeLabel}改写 (${options.provider})...`);
+        const rewriter = new rewriter_1.MarkdownRewriter(config);
+        const result = await rewriter.rewrite(markdown);
+        (0, fs_1.writeFileSync)(options.output, result.rewritten, 'utf-8');
+        console.log('\n✅ 改写完成！');
+        console.log('📊 统计：');
+        console.log(`   - 处理单元: ${result.blocksProcessed}`);
+        console.log(`   - 已改写: ${result.blocksRewritten}`);
+        console.log(`   - 输出文件: ${options.output}`);
+    }
+    catch (error) {
+        console.error(`❌ 错误：${error.message}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/full-rewriter.d.ts

@@ -0,0 +1,28 @@
+import { RewriteResult, RewriteOptions, AIProvider } from '../types';
+export declare class FullRewriter {
+    private provider;
+    private verbose;
+    constructor(provider: AIProvider, verbose?: boolean);
+    rewrite(markdown: string, options: RewriteOptions): Promise<RewriteResult>;
+    /**
+     * 保护图片：替换为占位符
+     */
+    private protectImages;
+    /**
+     * 构建带图片保护的提示词
+     */
+    private buildProtectedPrompt;
+    /**
+     * 验证占位符是否都保留了
+     */
+    private validateAnchors;
+    /**
+     * 尝试修复丢失的占位符
+     */
+    private fixMissingAnchors;
+    /**
+     * 恢复图片
+     */
+    private restoreImages;
+}
+//# sourceMappingURL=full-rewriter.d.ts.map

package/dist/core/full-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-rewriter.d.ts","sourceRoot":"","sources":["../../src/core/full-rewriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAElF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,OAAO,CAAU;gBAEb,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAE,OAAe;IAKpD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAwCzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkDrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2DzB;;OAEG;IACH,OAAO,CAAC,aAAa;CAsBtB"}

package/dist/core/full-rewriter.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FullRewriter = void 0;
+class FullRewriter {
+    constructor(provider, verbose = false) {
+        this.provider = provider;
+        this.verbose = verbose;
+    }
+    async rewrite(markdown, options) {
+        // 1. 提取并保护图片
+        const { content, anchors } = this.protectImages(markdown);
+        if (this.verbose) {
+            console.log(`🖼️  检测到 ${anchors.length} 张图片`);
+            console.log(`📝 准备改写全文 (${content.length} 字符)`);
+        }
+        // 2. 构建强约束提示词
+        const enhancedPrompt = this.buildProtectedPrompt(options, anchors.length);
+        // 3. AI 改写
+        const rewritten = await this.provider.rewrite(content, {
+            ...options,
+            prompt: enhancedPrompt,
+        });
+        // 4. 验证占位符是否保留
+        const validation = this.validateAnchors(rewritten, anchors);
+        if (!validation.success) {
+            if (this.verbose) {
+                console.warn(`⚠️  警告：${validation.missing.length} 个图片占位符丢失，尝试修复...`);
+            }
+            // 尝试修复
+            const fixed = this.fixMissingAnchors(rewritten, anchors, validation.missing);
+            return this.restoreImages(fixed, anchors, markdown);
+        }
+        // 5. 恢复图片
+        const final = this.restoreImages(rewritten, anchors, markdown);
+        if (this.verbose) {
+            console.log('✅ 改写完成，图片位置已恢复');
+        }
+        return final;
+    }
+    /**
+     * 保护图片：替换为占位符
+     */
+    protectImages(markdown) {
+        const anchors = [];
+        const lines = markdown.split('\n');
+        const result = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 检测图片行
+            const imageMatch = line.match(/^!\[([^\]]*)\]\(([^)]+)\)/);
+            if (imageMatch) {
+                const anchorId = `IMAGE_ANCHOR_${String(anchors.length + 1).padStart(3, '0')}`;
+                const placeholder = `{{${anchorId}}}`;
+                // 获取上下文（前后各2行）
+                const contextBefore = lines.slice(Math.max(0, i - 2), i)
+                    .join('\n')
+                    .trim();
+                const contextAfter = lines.slice(i + 1, Math.min(lines.length, i + 3))
+                    .join('\n')
+                    .trim();
+                anchors.push({
+                    id: anchorId,
+                    syntax: line,
+                    placeholder,
+                    contextBefore: contextBefore.substring(0, 100),
+                    contextAfter: contextAfter.substring(0, 100),
+                });
+                result.push(placeholder);
+                if (this.verbose) {
+                    console.log(`   🔒 保护: ${imageMatch[1] || imageMatch[2]} → ${anchorId}`);
+                }
+            }
+            else {
+                result.push(line);
+            }
+        }
+        return {
+            content: result.join('\n'),
+            anchors,
+        };
+    }
+    /**
+     * 构建带图片保护的提示词
+     */
+    buildProtectedPrompt(options, imageCount) {
+        const basePrompt = options.prompt || '改写以下内容，保持核心信息但改变表达方式。';
+        if (imageCount === 0) {
+            return basePrompt;
+        }
+        return `${basePrompt}
+
+⚠️ 重要约束：
+文中包含 ${imageCount} 个图片占位符，格式为 {{IMAGE_ANCHOR_XXX}}
+
+**你必须严格遵守以下规则：**
+1. ✅ 保留所有 {{IMAGE_ANCHOR_XXX}} 占位符，一个都不能删除或修改
+2. ✅ 占位符必须独立成行，前后都有空行
+3. ✅ 占位符的顺序不能改变（001, 002, 003...）
+4. ✅ 可以调整占位符前后的文字内容，但占位符本身必须完整保留
+5. ❌ 不要在占位符中添加任何文字说明或解释
+
+示例正确格式：
+"""
+改写后的段落内容。
+
+{{IMAGE_ANCHOR_001}}
+
+继续改写的内容。
+"""
+
+现在开始改写：`;
+    }
+    /**
+     * 验证占位符是否都保留了
+     */
+    validateAnchors(content, anchors) {
+        const missing = [];
+        for (const anchor of anchors) {
+            if (!content.includes(anchor.placeholder)) {
+                missing.push(anchor);
+            }
+        }
+        return {
+            success: missing.length === 0,
+            missing,
+        };
+    }
+    /**
+     * 尝试修复丢失的占位符
+     */
+    fixMissingAnchors(content, allAnchors, missingAnchors) {
+        let fixed = content;
+        for (const missing of missingAnchors) {
+            // 策略1: 在上下文附近查找合适位置
+            if (missing.contextAfter) {
+                const afterMatch = fixed.indexOf(missing.contextAfter.substring(0, 30));
+                if (afterMatch !== -1) {
+                    // 在找到的上下文之前插入占位符
+                    fixed =
+                        fixed.substring(0, afterMatch) +
+                            `\n\n${missing.placeholder}\n\n` +
+                            fixed.substring(afterMatch);
+                    if (this.verbose) {
+                        console.log(`   🔧 修复: ${missing.id} (通过下文上下文)`);
+                    }
+                    continue;
+                }
+            }
+            // 策略2: 根据相对位置估算
+            const index = allAnchors.indexOf(missing);
+            if (index > 0 && index < allAnchors.length - 1) {
+                const prevAnchor = allAnchors[index - 1];
+                const nextAnchor = allAnchors[index + 1];
+                const prevPos = fixed.indexOf(prevAnchor.placeholder);
+                const nextPos = fixed.indexOf(nextAnchor.placeholder);
+                if (prevPos !== -1 && nextPos !== -1) {
+                    // 在两个占位符之间插入
+                    const middlePos = prevPos + Math.floor((nextPos - prevPos) / 2);
+                    fixed =
+                        fixed.substring(0, middlePos) +
+                            `\n\n${missing.placeholder}\n\n` +
+                            fixed.substring(middlePos);
+                    if (this.verbose) {
+                        console.log(`   🔧 修复: ${missing.id} (通过相对位置)`);
+                    }
+                    continue;
+                }
+            }
+            // 策略3: 追加到末尾（最后的手段）
+            if (this.verbose) {
+                console.warn(`   ⚠️  无法精确定位 ${missing.id}，追加到末尾`);
+            }
+            fixed += `\n\n${missing.placeholder}\n`;
+        }
+        return fixed;
+    }
+    /**
+     * 恢复图片
+     */
+    restoreImages(content, anchors, original) {
+        let restored = content;
+        // 按顺序替换占位符为原始图片语法
+        for (const anchor of anchors) {
+            restored = restored.replace(new RegExp(anchor.placeholder.replace(/[{}]/g, '\\$&'), 'g'), anchor.syntax);
+        }
+        return {
+            original,
+            rewritten: restored,
+            blocksProcessed: 1,
+            blocksRewritten: 1,
+        };
+    }
+}
+exports.FullRewriter = FullRewriter;
+//# sourceMappingURL=full-rewriter.js.map

package/dist/core/full-rewriter.js.map

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