劇本工作室特定工具的限制

有兩個 MCP 工具在劇本工作室的書上有特定限制。

search_content：預設排除結構化檔案

呼叫 search_content 在劇本工作室書上，預設只搜純 markdown —— 排除 .scene / .character 等結構化檔案。

為什麼

結構化檔案是 JSON——文字命中常常是內部 schema 的欄位名、不是真實內容。譬如搜「name」會命中所有 *.character 的「name」欄位名。

補救

要包含結構化檔案：

search_content({
  book_token: "...",
  query: "lighthouse",
  include_structured: true
})

加上 include_structured: true，它就會深入結構化檔案的文字屬性裡搜尋。

analyze_chapter：不支援 .scene

呼叫 analyze_chapter 把 .scene 檔當輸入 → 回 400 UNSUPPORTED_FILE_TYPE。

為什麼

analyze_chapter 是給敘事散文設計的（小說章節）。一個場景 JSON 不能當成「章節」來分析——節奏、行文、對白節拍這些概念對應不上。

補救

兩條：

1 · 用場景級分析

.scene 是場景，多個場景組成一集。AI 工具的分析以單一場景為單位；目前沒有整集層級的分析工具。

2 · 把場景轉成 prose

如果你要分析「這個場景的情緒節奏」：

1. 拿場景 → 用 AI 把場景 JSON 改寫成 prose markdown
2. 對 prose 跑 analyze_chapter

這需要兩步、但能達到目的。

預期上限的 token 限制

劇本檔案常常單個很長（一個 storyline 可以幾萬字）—— read_file 對單檔有 token 上限：

• 純 markdown：~100K tokens
• 結構化檔案：~50K tokens（JSON 更佔 token）

超過 → 回 416 FILE_TOO_LARGE，並附上建議的分段（chunking）方式。

相關

• MCP 行為對照
• 劇本工作室 結構化保護
• 檔案操作工具