运行时依赖
安装命令
点击复制技能文档
Markdown AI Rewriter 技能
本 技能 对应 npm 包 markdown-AI-rewriter(当前对齐 v1.2.5):在 尽量保留标题、代码块、表格、图片等结构 的前提下,用大模型改写正文(润色、降重、换风格等),并支持 图片生成(图生图)、视频生成(文生视频)和 音乐生成(文生音乐)。
🚀 安装后快速开始
安装完成后,运行以下命令查看可用功能:
md-rewrite rewrite -i article.md -o out.md -p openAI -v
输出示例:
📋 功能状态: ⬚ 文章改写 (--rewrite) ⬚ 图片生成 (--process-images) ⬚ 视频生成 (--生成-video)
⚠️ 未启用任何功能。请使用以下选项启用: --rewrite 启用文章改写 --process-images 启用图片生成 --生成-video 启用视频生成
重要:v0.5.2 起,默认不启用任何功能,需要显式指定要启用的功能。
核心特点(先看这个)
一句话定位:这是一个面向生产场景的 Markdown 改写 技能,重点是"改写质量 + 结构稳定 + 成本可控"。
结构稳定优先:尽量保留标题层级、代码块、表格、图片位置,减少"改完排版坏掉"。 双模式可切换:section 适合中长文批量与控成本,full 适合短文叙事连贯。 多模型一套命令:同一 命令行工具 只换 -p 和环境变量,就能切换 11 个 提供者。 图片生成:支持 MiniMax、OpenAI、Gemini、豆包等图片生成。 视频生成:支持 MiniMax HAIluo、豆包 种子ance、可灵、运行way 等视频生成。 音乐生成:支持 MiniMax Music 2.5+ 音乐生成(纯音乐/带歌词)。 可落地到流水线:适合接在抓取、清洗、发布前的"内容标准化"环节。 最适合的使用场景 你已经有 Markdown 初稿,要做润色/降重/统一风格; 你在做批量内容处理,希望速度和费用可控; 你需要兼顾国内外多个模型平台,在可用性和成本之间灵活切换; 你需要为文章自动生成配图、视频或背景音乐。 与旧版差异(务必知晓) 项目 当前版本 (v0.5.2) 默认行为 默认不启用任何功能,需显式使用 --rewrite、--process-images、--生成-video 启用。 改写模式 仅 section(章节,默认) 与 full(全文);已移除「按块/段落」模式。 模型 OpenAI、Anthropic、Azure OpenAI、Gemini、DeepSeek、Open路由r、Qwen、GLM、豆包、文心、MiniMax。 图片生成 支持 MiniMax、OpenAI、Gemini、豆包、Nano-Banana 等。 视频生成 支持 MiniMax HAIluo、豆包 种子ance 2.0/1.5/1.0、可灵、运行way Gen-4.5。 音乐生成 支持 MiniMax Music 2.5+(纯音乐/带歌词/自动歌词)。 章节模式 按标题分章并行改写;-c / --concurrency 对章节模式生效。 命令行工具 版本号 从安装的包的 package.json 读取,与 npm 版本一致。 安装
全局或项目内安装均可:
npm 安装 -g markdown-AI-rewriter # 或 npm 安装 markdown-AI-rewriter
使用 OpenAI 或 MiniMax 时,需安装 peer 依赖 openAI:
npm 安装 openAI
使用 Anthropic 时:
npm 安装 @anthropic-AI/sdk
可执行命令:markdown-AI-rewrite 或 md-rewrite。
环境变量 变量 用途 OPENAI_API_KEY --提供者 openAI ANTHROPIC_API_KEY --提供者 anthropic AZURE_OPENAI_API_KEY --提供者 azure-openAI GEMINI_API_KEY --提供者 gemini DEEPSEEK_API_KEY --提供者 deepseek OPEN路由R_API_KEY --提供者 open路由r QWEN_API_KEY --提供者 qwen GLM_API_KEY --提供者 glm DOUBAO_API_KEY --提供者 doubao WENXIN_API_KEY --提供者 wenxin MINIMAX_API_KEY --提供者 minimax(文本改写);--video-提供者 minimax(视频生成) KLING_API_KEY --video-提供者 kling(可灵视频生成) 运行WAY_API_KEY --video-提供者 运行way(运行way 视频生成) AZURE_OPENAI_端点 azure-openAI 可选 端点(也可用 --base-url) MINIMAX_BASE_URL 可选;默认 https://API.minimaxi.com/v1,可按 MiniMax 文档覆盖 分享D_OPENAI_KEY 可选;仅在 未传 APIKey 且代码里允许使用共享 Key 时由库内部使用(需配合 Quota管理器 等逻辑,见包内 README);常规 命令行工具 用法请直接设置上述各厂商 Key。 何时使用本 技能
适合触发:
用户要「改写 / 润色 / 降重 / 换风格」已有 Markdown,且希望 保留文档结构; 提到「章节改写」「全文改写」「技术文档 / 博客 / 公众号稿」等; 需要指定 casual / formal / technical / creative / custom 风格。
不适合:
从零「写一篇新文章」且输入不是 Markdown 改写流程; 纯格式转换(如 MD→HTML); 仅分析结构、不做改写。
触发关键词示例:「重写这篇 md」「改成正式一点」「全文连贯改写」「按章节改」「用 MiniMax / OpenAI / Claude」。
两种改写模式(命令行工具:--mode) 模式 说明 典型场景 section(默认) 按指定级别标题切分,分章调用模型;可带上下文章摘要;成本与速度较可控。 中长文档、多章节技术文 full 整篇一次请求(全文模式会对图片做占位符保护再还原);语气通常最连贯。 短文、强叙事、整篇语气统一 --section-level 1|2|3:仅章节模式有效,表示按几级标题切分(默认 1 级 #)。 --mode full 时 令牌 消耗可能更大,适合长文时谨慎使用。 标准 命令行工具 示例 文章改写 # 章节模式 + OpenAI(注意:需要 --rewrite 显式启用改写) 导出 OPENAI_API_KEY="sk-..." md-rewrite rewrite \ -i 输入.md \ -o 输出.md \ -p openAI \ --rewrite \ -s casual \ -c 3 \ -v
# 全文模式 md-rewrite rewrite -i 输入.md -o out.md -p openAI --rewrite --mode full -v
# 二级标题分章 md-rewrite rewrite -i 输入.md -o out.md -p openAI --rewrite --section-level 2
# Anthropic 导出 ANTHROPIC_API_KEY="sk-ant-..." md-rewrite rewrite -i 输入.md -o out.md -p anthropic --rewrite -s formal
# DeepSeek 导出 DEEPSEEK_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p deepseek --rewrite
# MiniMax(需 npm 安装 openAI) 导出 MINIMAX_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p minimax --rewrite -m MiniMax-M2.1 -s casual
图片生成 # 只生成图片(不改写文章) 导出 MINIMAX_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p minimax --process-images -v
# 改写 + 图片生成 md-rewrite rewrite -i 输入.md -o out.md -p openAI --rewrite --process-images -v
# 指定图片 提供者 md-rewrite rewrite -i 输入.md -o out.md -p openAI --process-images --image-提供者 doubao
视频生成 # 只生成视频(不改写文章) 导出 MINIMAX_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p minimax --生成-video -v
# 改写 + 视频生成 md-rewrite rewrite -i 输入.md -o out.md -p openAI --rewrite --生成-video -v
# 指定视频 提供者(豆包 种子ance) 导出 DOUBAO_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p openAI --生成-video --video-提供者 doubao
# 可灵视频 导出 KLING_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p openAI --生成-video --video-提供者 kling
# 运行way 视频 导出 运行WAY_API_KEY="..." md-rewrite rewrite -i 输入.md -o out.md -p openAI --生成-video --video-提供者 运行way
音乐生成 # 纯音乐(无人声)- 从 prompt 生成 导出 MINIMAX_API_KEY="..." md-rewrite music --prompt "Indie folk, melancholic, introspective" --instrumental -o bgm.mp3
# 带歌词的歌曲 md-rewrite music --prompt "Pop, upbeat, ener获取ic" --lyrics "[verse]\nHello world\n[chorus]\nLa la la" -o song.mp3
# 从文件读取歌词 md-rewr