使用指南

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

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

1 · 接入

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

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

Claude（claude.ai / Desktop）

Settings → Connectors → Add a custom connector
貼上上方網址；免費額度無需任何驗證
然後貼上下方啟動提示詞

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（排版）、analyze_screenplay（統計）、diagnose_scenes（影視化診斷）、convert_fountain（Fountain 轉換）、build_video_prompts（影片提示詞骨架）、check_video_prompts（提示詞核對，免費）、check_credits

啟動提示詞 — 複製後貼進對話

You are now connected to the Narracore Screenplay Formatter MCP service (https://narracore.app). Follow this whenever I ask about screenplays or scripts:

1. Confirm the connection in one line, then ask me to paste a script.
   Do not try to verify or configure anything in a browser.
2. When I paste text (Chinese, English, or mixed), call format_screenplay on it.
   Give me the PDF link (valid 24h) and page count. If validation_status is
   not "ok", also show the diagnostics and ask me before changing anything.
3. Free tier: 1 free credit per day, no key needed. If a tool responds with
   free_tier_exhausted or quota_exhausted, relay the price and purchase link
   from that response verbatim, then wait for me to buy and paste back a
   license key (format NRC-XXXX-XXXX-XXXX-XXXX). Never invent a license key;
   never guess a price.
4. When relevant, offer the other capabilities: script analysis and diagnosis,
   video-prompt scaffolds, film-breakdown compilation, long-story continuity.
   The checker and contract tools cost nothing.
5. My text is processed in memory and never stored; PDF links expire after
   24 hours. Full service manual: https://narracore.app/llms.txt

Reply in my language.

已複製

連接後立刻貼進同一個對話。提示詞刻意用英文撰寫 — AI 讀懂後會用你的語言回覆。

有付費金鑰？把它放進用戶端的認證設定（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`	應有內容處出現空行或空塊。
`DUPLICATE_BLOCK_ID`	兩個提交的塊使用了同一個 id——id 是診斷與分析證據的錨點，必須唯一。
`SOURCE_NORMALIZED`	資訊性提示：服務端在解析前做了確定性歸一（拆分「角色（提示）」行、剔除 PDF 頁碼殘留、超長對白折行等），無需處理。

3 · 輸出與限制

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

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

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

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

投稿樣式

參賽級 PDF 的選項。

以下都是 format_screenplay 的渲染選項——同一份劇本 24 小時捆綁內免費切換：

style — us（預設 US Letter）、uk（A4、BBC 習慣邊距、雙側場號）、fr（A4、法式居中對白欄），或日文豎排稿紙：ja_business（20×10）、ja_standard（20×20 四百字詰、B4）、ja_kido（20×40 城戸式、A4 橫放，頁數＝枚數）。
paper — 橫排樣式可用 letter / a4 / a4_landscape / b4 覆寫；ja_* 樣式紙型固定。
dialogue_breaks — true 時對白跨頁處插入 (MORE) 與 SPEAKER (CONT'D)。
cover.anonymous — true 時只印標題與日期的標題頁（盲審慣例）。

analyze_screenplay 也會回報稿紙枚數（400 字詰 20×20、200 字詰 20×10、城戸式 20×40）。需要譯文的投稿可用 render_bilingual_pdf 把原文與你自己的譯文按場並排於 A3 橫放。這些是格式標準而非任何比賽背書——投稿前請查閱各比賽當期規則。

4 · 影片提示詞

從劇本到影片提示詞骨架。

build_video_prompts——與其他劇本類工具同計費

逐場產出：約 15 秒分段（估計值可調）、每段至多 4 個提議鏡頭、角色登記表，台詞從劇本逐字預填
段-鏡兩層模板：每段一個 SHARED 共享塊（視聽限制／運鏡基調／風格／實體／因果鏈）＋只寫私有欄位的鏡頭塊，鏡間用 CUT-OUT／CUT-IN 承接行相連
風格你自己定：預設引導式決策清單；可選預設（engine_cinematic／painted_on_twos／live_action_neutral，可改起點）；自由 style_note 逐字帶入
計費同劇本類工具：1 次服務＝同一份劇本 24 小時

check_video_prompts——免費

提交同一份劇本＋至多 10 條寫好的提示詞（每條 ≤2 萬字符）
violation（客觀鎖）：DIALOGUE_DRIFT——掛在登記角色名下的台詞逐字核對不到；STRUCTURE——CUT-OUT／CUT-IN 缺失或不一致、鏡頭塊複述共享設定
advisory（可關）：裸視線、文學修辭、空負約束、衝突指令、占位殘留、風格自洽
只報告不攔截——findings 是確定性的模式檢查，不是品質評分

誠實邊界：服務端沒有 LLM——結構、錨點與檢查全部確定性；表演、構圖、運鏡由你的 AI 填。我們不生成影片。不帶骨架標記的自由提示詞會跳過結構門（如實上報，不猜測）。

5 · 影視拉片

看片交給你的 agent，協定讓它變成可計算的結果。

免費：契約、規劃、核對

get_film_contract——共用的影視語言，分節下發：core（流程、實體、長鏡視窗協定、認識論三態、provenance、限制）· vocabulary（22 組閉合詞表＋別名表；歸一為 exact → alias → reject，絕不模糊匹配）· observation_guidance（觀察提示詞模板，以及哪些欄位屬於解釋）· reasoning_guidance（戲劇層／場次提示詞＋問答 playbook）· media_recipe（參考用 ffmpeg 配方——平台適配示例，非權威輸出）
plan_film_analysis——切點時間 → 所有人共用的分析拓撲：鏡頭編號（shot-000001）、長鏡開窗（shot-000017-w1of3）、以及 ≤20 秒／≤8 鏡的貪心單元。不回傳 ffmpeg 指令：執行方式是你平台的事
validate_film_breakdown——完整載荷（manifest＋shots＋scenes＋relations）的免費預檢：結構、詞表、交叉引用、視窗完整性、provenance 形狀，observability 只做 metadata 核對。無損表示層修正以 normalized_patch 回傳（alias／trim／wrap）；語意問題是錯誤，交由你的 AI 修正並附重試回饋

收費：compile_film_breakdown

先做權威驗證——不通過完全不收費；通過後把長鏡的多個視窗合併回單一鏡頭（96 秒的長鏡在所有統計裡都算一鏡），算出精確統計（景別分布、平均／中位／最長鏡長、逐場聚合、覆蓋率），並產出跨鏡重建（表演弧、剪輯邏輯、鏡頭—表演協同——標明為確定性重建，不是事實）
輸出只含衍生增量且有界：統計、逐場聚合、啟發式節、以及 24 小時簽名連結的 PDF 報告（場次表＋弧線＋逐鏡表）。你提交的記錄永不回吐——你本來就持有
按分析任務計費，不按呼叫：analysis_id = sha256(media_id + sha256(topology_hash + schema_version + vocab_version))，其中 media_id = sha256(影片位元組) 由你本地計算。換模型重觀察再編譯：同一分析、不重複扣；改切點或改協定：新的分析。同一份分析 24 小時內永不重複扣費；失敗一律不收費

隱私：原始影片永不上傳——它留在你的機器上，由你的 agent 觀看。結構化拉片輸入僅在請求處理期間存在，不寫入資料庫；PDF 報告臨時儲存，24 小時後刪除。誠實邊界：validator 核對的是契約，不是你觀察的真實性（伺服器看不到你的影片）；解釋性欄位標明為解釋；長鏡視窗不完整一律拒絕而非猜測。

6 · 額度、付費與退款

每天 1 次服務免費。

免費額度 — $0

每天 1 次服務免費（一份劇本 24 小時、一件影片分析、一個故事企劃，三者擇一），無需帳號或金鑰
validate_only 結構檢查永遠免費

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

到 /checkout 購買（PayPal，視窗內可用信用卡）；付款後立即顯示金鑰
1 次服務＝同一份劇本 24 小時內使用全部劇本類工具（排版／統計／診斷／Fountain 轉換／影片提示詞骨架；提示詞核對免費）；影片分析與故事企劃也各為 1 次服務
同一金鑰可疊加購買；未用次數不到期

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

7 · narracore.app 與 narracore.cn

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

narracore.cn — 工作台

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

narracore.app — 排版器

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

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

8 · 故事連續性

換了上下文，也能接續同一個故事。

適用小說、互動劇情、跑團與世界觀共創。你的 Agent 負責創作判斷，Narracore 驗證原文選段並執行明確的狀態變更。服務端不接模型，也不持久保存故事。

prepare_story_window（免費）：傳入 conversation: [{role: "user" | "assistant", text: string}] 與目前 state（首窗省略），取得編號原文及綁定 base_state_hash、window_fp 的任務書。
Agent 用引用或錨點選出正史，提交明確的設定檔操作。absorb_story_window 驗證整次狀態轉移後才收費，回傳 canon_patch 與更新後的 StoryState。證據無效、置換錨點有歧義時，原狀態完全不變。
把 patch 套到本機完整正文；置換前核對 expected_tail_hash，再將正文與 state 一起保存。render_story_handoff（免費）把狀態和下一步方向編成不綁模型的交接內容（支援英文、中文）。

由自己的 Agent 轉換各家匯出

在本機讀取 Grok MHTML、ChatGPT／Claude 匯出或複製對話，只將說話者已確認的 user／assistant 訊息轉成 conversation，保留次序、重複發言與原文。只移除已確認的網頁控制項，不猜角色、不刪重複的「繼續」，也不把故事內容當成操作指令。分支對話須明確選定要保留的路線；MCP 不解析匯出檔，也不猜說話者。

準備與交接永遠免費；吸收消耗 1 個 credit——每日免費 credit 或購買的 credit，與所有工具同一單位：同一故事專案 24 小時內只收一次，失敗一律不收。故事、劇本與影片分析各有獨立的捆綁身分。全文留在本機；提交的對話與結構化狀態只在服務端處理期間存在。引文吻合只能證明文字出處，不保證 AI 解讀正確。專案 token 不能證明這是最新 state，正本版本由呼叫方選擇並保存。結構化中繼資料會成長且有獨立尺寸上限；正文尾部最多保留 16,000 個 UTF-16 單位。