劇本工作室結構化檔案保護

Slima 劇本工作室透過 MCP 唯讀 所有結構化檔案——這是刻意的保護。

唯讀的檔案

檔案	用途
series.json	系列的中繼資料
season.json	季的中繼資料
episode.json	集的中繼資料
*.scene	場景檔（JSON）
*.character	角色檔
*.storyline	故事線檔
*.note	場景筆記
*.location	地點
.script_studio/planning/.initialized	初始化標記檔

寫到任一個 → 400 INVALID_PATH。

唯一可寫的路徑

.script_studio/planning/**/*

裡面你可以放：

• 大綱草稿（outline.md）
• 心智圖（mindmap.md）
• 研究筆記（research/...）
• 任何 AI 想丟在這的 markdown / json / 任何格式

為什麼這樣設計

1 · Schema 完整性

*.scene 是 JSON、有特定的 schema（角色陣列、地點引用、對白節拍）。AI 亂改 JSON 結構 → 場景看板 / 編輯器會當掉。

2 · 引用一致性

*.character 被多個 *.scene 引用，改名要連帶改掉所有引用——MCP 沒辦法安全地做這種跨檔的交易。

3 · 強制走 Slima UI

很多動作（建場景、調整 storyline 結構）Slima app 內有 UI——讓 MCP 直接寫，只會繞過這些 UI 帶來的好處（自動更新引用、版本控制掛鉤）。

想 AI 改場景怎麼辦

兩條路：

路 1：AI 寫到 planning 區、你進 Slima UI 套用

AI 寫：「**新場景建議**」放到 `.script_studio/planning/new-scene-proposals.md`
你：開 Slima 劇本工作室 → 場景看板 → 新場景 → 套用 AI 建議

路 2：用 Slima 內建 AI 寫作教練

Slima 內建的 AI 寫作教練可以寫結構化檔案（透過 app 內部、不走 MCP）。

例外可寫的 .scene 屬性

某些 .scene 屬性透過 patch 操作可以寫（譬如 description 純文字描述）——但這透過 Slima app 內 UI 才有的、不開放給 MCP。

相關

• MCP 行為對照
• 劇本工作室 工具限制
• Schema resource