剧本排版器 xiaoanran0602-pixel/narracore-format

Narracore Format

免费、本地、不限量的剧本格式化工具，专为智能体打造。 开源 MCP 服务器（也是 DSH 插件），把原始或格式松散的剧本文本，转成结构专业的剧本块和排版好的纯文本——支持中文、英文或中英混排，包括日式广播剧格式和中式冒号对白剧本。排版引擎自动选择轨道：33 字 × 38 行 CJK 字格，或 61 × 55 拉丁字格，与 narracore.cn 使用同一套固定打字机字格。

- 永久免费——在你自己的机器上运行，无需账号、无需密钥、无配额、不发起网络请求
- 确定性——纯规则引擎，内部不调用 LLM；相同输入永远得到相同输出，逐字节一致
- 智能体原生——机器可读的诊断信息、锚定证据的场景评分、跨工具的 typed-blocks 链式契约

属于 Narracore 工具集——长篇协作写作工作台。想要可打印的 PDF 导出，或完整的故事连贯性工具？见下方生态。

示例

输入粗糙文本，输出排版好的剧本。下面两个方向都是引擎的真实输出。

中文（CJK 33×38 字格轨）

输入——格式松散的文本，每行一个元素：

第 1 场 内 老式放映厅 - 夜

放映机的光柱切开黑暗，尘埃在光里悬浮。
常家青坐在最后一排，手里攥着一张褪色的电影票。

常家青（低声）如果胶片还在，就能证明那晚的一切。

检票员从阴影里走出来，把手电筒照在票面上。

检票员这张票，二十年前就该作废了。

常家青站起身。光柱突然熄灭。

切至黑暗

输出——format_screenplay 返回的 plain_text（场景标题、动作、角色、括号说明、对白、右对齐转场——全部落在固定字格上）：

第 1 场 内 老式放映厅 - 夜

放映机的光柱切开黑暗，尘埃在光里悬浮。

常家青坐在最后一排，手里攥着一张褪色的电影票。

常家青（低声）如果胶片还在，就能证明那晚的一切。

检票员从阴影里走出来，把手电筒照在票面上。

检票员这张票，二十年前就该作废了。

常家青站起身。光柱突然熄灭。

切至黑暗

英文（拉丁 61×55 字格）

输入：

INT. PROJECTION BOOTH - NIGHT

The projector beam cuts through the dark.

CHANG
(quietly)
If the reel still exists,
it proves that night was real.

CUT TO BLACK.

输出：

INT. PROJECTION BOOTH - NIGHT

The projector beam cuts through the dark.

CHANG
(quietly)
If the reel still exists,

it proves that night was real.

CUT TO BLACK.

同一次调用还会返回带类型的 blocks（scene / action / character / parenthetical / 对白 / 转场 / 镜头 / 备注）、页面统计，以及机器可读的诊断信息——把这些块传回本包里的其他工具，即可做分析或转换。

安装

DSH（DeepSeek Harness）——主通道

dsh plugin add narracore-format

就这一步。你的智能体就能拿到 mcp__narracore__* 命名空间下的五个工具。

任意 MCP 客户端（Claude Code、Cursor……）

本包是标准 stdio MCP 服务器，任何 MCP 客户端都能直接运行：

// Claude Code: claude mcp add narracore-format -- npx -y narracore-format@latest
// Cursor / generic MCP config:
{
"mcpServers": {
"narracore-format": { "command": "npx", "args": ["-y", "narracore-format@latest"] }
}
}

需要 Node ≥ 22。

工具（5 个）

| 工具 | 作用 |
| format_screenplay | 把剧本文本（或已分好类型的块）解析成 8 种语义块类型，排出纯文本版式，给出页面统计和诊断信息。output="validate_only" 只检查结构，不做排版。 |
| analyze_screenplay | 确定性统计：场景清单，含结构化标题（场号 / 地点 / 时间 / INT-EXT）、每场字数、对白占比、动作密度、角色戏份表。 |
| diagnose_scenes | 场景级「可拍性」诊断：智能体逐场给出证据，工具逐字校验，算出精确的 0–100 分（按严重程度加权覆盖，BigInt 运算——绝不编造分数）。 |
| convert_fountain | 在 Narracore 类型块与 Fountain 之间互转。Fountain 是纯文本剧本交换格式。 |
| about_narracore | 生态概览——Narracore 还提供哪些东西。 |

链式调用约定： 要在同一份剧本上运行另一个工具，请把收到的 blocks 传回去（input_format="blocks"），不要传排版后的纯文本——块能确定性解析，文本则要重新解析。

生态

- narracore.cn —— 本工具包出自这里，是完整的长篇共创工作台：剧本与故事写作，排版与这里一致，另有故事窗口连续性工具，能力超出本地排版器。
- narracore.app —— 基于同一流水线的托管 MCP 服务，额外提供可印刷的 PDF 导出，内嵌字体（封面页、页眉、带签名的下载链接）。不想安装任何东西、又想要 PDF 流水线，可以在那里购买排版服务的使用次数。

引擎来源

src/format/ 里的排版引擎与 narracore.cn 用的是同一份唯一真源。它从 Narracore 代码库逐字移植（来源哈希见 src/format/README.md），快照测试逐字节锁定它——快照测试全绿，就是机器证明：本包的文本排版与 narracore.cn 网页应用完全一致。分析层（src/analysis/）是 Narracore 的 TS 移植分析器，由原始实现生成的黄金测试锁定。

开发

npm install
npm test # 162 tests: snapshots, golden samples, tool layer, stdio e2e, billing-free guard
npm run build # esbuild single-file bundle → dist/index.js
npm start # run the stdio server

守卫测试：包内不得出现任何计费 / 许可 / 支付相关代码 —— 一旦 src/ 里出现这类引用，test/tools/guard.test.ts 就会失败。

许可证

MIT。布局引擎版权归 © Narracore 所有；来源说明见上文。