使用指南

接入一次，任何 AI 都能排版劇本。

關於 Narracore 劇本排版器的完整說明：怎麼接入你的 AI 應用、輸入長什麼樣、會拿到什麼結果、額度與退款怎麼算，以及它與 narracore.cn 的關係。

1 · 接入

一個網址，任何 MCP 用戶端。

https://mcp.narracore.app/mcp 已複製

Claude（claude.ai / Desktop）

Settings → Connectors → Add a custom connector
貼上上方網址；免費額度無需任何驗證
在對話裡說：「把下面這段排成劇本 PDF」

ChatGPT（Developer mode）

Settings → Apps & Connectors → Developer mode
用上方網址建立 dev connector
之後直接在對話裡提出即可

Cursor

Settings → MCP → Add new global MCP server
類型 url，值填上方網址

Gemini 與所有 MCP 用戶端

Streamable HTTP 端點，免費額度不需認證標頭
工具：format_screenplay 與 check_credits

有付費金鑰？把它放進用戶端的認證設定（Authorization: Bearer NRC-… 或 X-License-Key）——放標頭裡就不會出現在對話紀錄，且優先於 license_key 工具參數。也可以直接在對話裡貼「我的授權碼：NRC-…」讓 AI 代為傳遞。

2 · 輸入格式

貼純文字，或提交結構塊。

文字模式（預設）

一行一個元素：

場景頭：第 N 場 … · N 外 … · INT. LAB - DAY
角色名單獨一行（中文原樣、英文全大寫）
對白緊接其後，每行不要太長
獨立成行的（括注）與轉場（CUT TO: / 切至：）

結構塊模式（精確）

逐行解析拿不準的文字（例如拉丁字母人名＋「V.O.」），改提交帶類型的結構塊：

對白塊帶 speaker 與可選 delivery
塊按提交原樣排版，不會被重新分類
【…】裡的批註只會被回報，不會被執行

免費結構檢查：傳 output="validate_only"——只做診斷，不收費也不佔額度。整段不分行的「文字牆」會被當成連續動作排版，並標記 UNRESOLVED_STRUCTURE。

診斷碼	含義
`UNRESOLVED_STRUCTURE`	無法有信心地拆成劇本元素（常見於一整段不分行的文字）。
`MISSING_SPEAKER`	對白塊沒有對應的角色名。
`AMBIGUOUS_ACTION_MAYBE_DIALOGUE`	某行讀起來像對白但沒有角色名——引擎保留為動作並標記。
`LABELED_HEADER_LINE`	「標籤：內容」形態的行，看起來像帶標籤前綴的場景頭。
`REVISION_NOTE_PRESENT`	【…】或（…）含修訂意圖關鍵詞——作為備註回報，不執行。
`BRACKETED_ANNOTATION`	文中其他【…】標記（提示性）。
`UNBALANCED_DELIMITER`	成對符號（括號、引號）缺了另一半。
`EMPTY_TEXT`	應有內容處出現空行或空塊。

3 · 輸出與限制

結構塊、乾淨文字、可列印 PDF。

每次呼叫都會返回結構塊、整理好的純文字劇本，以及一個 PDF 下載連結（24 小時後自動刪除）。confidence 分數告訴你的 AI 有多少輸入行是明確的——它是「明確行佔比」，不是準確率承諾。

第 1 場　實驗室　日　內約翰盯著監視器，指針穩穩爬升。　　　　　　　　　　常家青　　　　　　　　（輕聲）　　　　　　我們還在燒水。　　　　　　這是唯一的機會。　　　　　　　　　　　　　　　　　　　　　　切至： — US Letter · 中文軌 33 字 × 38 行 · 拉丁軌 61 × 55 — 場號靠右 · 嵌入 Sarasa Mono / Courier Prime 字體

字格固定是有意為之：一頁 ≈ 一分鐘戲，PDF 與 narracore.cn 的列印預覽逐行一致。文字只在記憶體中處理；劇本內容不進日誌、不用於訓練。

4 · 額度、付費與退款

每天 1 次免費排版。

免費額度 — $0

每天 1 次免費排版，無需帳號或金鑰
validate_only 結構檢查永遠免費

付費包 — $1.49／10 次 · $5.99／50 次

到 /checkout 購買（PayPal，視窗內可用信用卡）；付款後立即顯示金鑰
同一金鑰可疊加購買；未用次數不到期

誠實的規則：只對成功的排版收費——排版失敗一律不收；同 request_id 重試不會重複扣費；未使用可在 7 天內全額退款（附訂單號寫信到 huiyicd@foxmail.com）。沒有訂閱、沒有儲值、不會自動續期。我們只保存金鑰的 SHA-256 雜湊與末 4 碼。

5 · narracore.app 與 narracore.cn

兩個產品，同一套排版引擎。

narracore.cn — 工作台

瀏覽器裡的完整編劇工作台：八種劇本塊的結構化編輯器、自動保存、列印預覽與 PDF 匯出
雲端作品、版本歷史、人物／地點／道具與確定性的劇本統計（帳號功能為邀請制內測；編輯器本身無需帳號）

narracore.app — 排版器

遠端 MCP 工具：你的 AI 用戶端貼入粗稿，取回結構與 PDF
沒有編輯器、沒有作品管理——只做排版，用的正是 narracore.cn 同一套固定字格排版引擎

在 narracore.cn 用瀏覽器寫作；在 narracore.app 讓你的 AI 做排版。安裝文件與真實輸入範例也在公開倉庫。