Skill 是製作方法
它用 ElserStudio 原生模組組織小說到 World、Episode、Shot 的工作流，並組合鏡頭意圖、連續性、參考資產、表演、攝影、聲音、提示詞、審片、修復與交付。
不儲存專案，不直接呼叫模型，也不會自行扣費。Agent 接入檔案
把創作方法交給 Skill，
把真實執行交給 MCP。
這份指南說明 ElserStudio Skill 與本機 MCP 的職責、能力、安裝方式和實際用法。完成配置後，Codex、Claude Code 等相容 Agent 可以在不繞過桌面應用的前提下讀取專案、組織 World、生成鏡頭並同步畫布。
Skill 與 MCP
它們不是二選一，而是上下兩層。
Skill 負責理解創作目標和組織製作步驟，MCP 負責安全地執行這些步驟。只裝 Skill，Agent 知道怎麼做但無法操作專案；只連 MCP，Agent 有工具卻缺少完整製作方法。
MCP 是桌面執行介面
它把 ElserStudio 的專案、World、資產、鏡頭、生成任務和畫布能力開放給本機 Agent，並與桌面 UI 共用同一套 Provider 路由與本機資料。
所有真實讀寫與生成都通過正在執行的桌面應用完成。能力範圍
從小說輸入到畫布交付，覆蓋完整生產鏈。
桌面 MCP 當前提供 60 項工具；官方 Skill 在這些工具之上提供原生模組編排、製作判斷、引用規則和費用邊界。
小說、劇本與鏡頭拆解
提取角色、場景、道具與音色候選，把小說或創意整理成 Episode 和可編輯 Shot。
保留情節順序、對白、語言和鏡頭敘事任務。World 與規範資產
建立或複用角色、場景、道具和共享參考，避免同一身分在不同鏡頭中重複漂移。
所有引用繫結規範 ID，而不是隻把名稱寫進提示詞。導演與提示詞設計
處理景別、運鏡、表演、動作、燈光、風格、VFX、聲音和多語言提示詞。
支援中文、英文、日文、韓文、西班牙文和俄文專業詞彙。圖片與影片生成
使用雲端或本機 BYOK 路由生成角色表、場景板、道具板、運動導板和有聲影片。
單任務或 2–50 項批次提交，與桌面 UI 使用相同路由。任務、連續性與審片
批次輪詢生成任務，區分完成、失敗和取消，並管理共享錨點、順序鏡頭和重試變數。
不會因為結果不完美而擅自再次產生付費任務。畫布同步與執行證據
把故事、劇本、World 資產、Shot 影片和剪輯節點同步成可見主鏈，同時記錄 Skill 模組和質量門。
專案狀態仍以 ElserStudio 本機規範記錄為準。當前邊界：MCP 只能在執行 ElserStudio 的同一臺電腦上訪問；拿到本機令牌即擁有當前 MCP 的全部工具許可權，因此只應連線可信 Agent。
安裝與連線
先安裝 Skill，再從桌面應用複製 MCP 配置。
Skill 來自官網公開的版本化包；MCP 令牌由每臺電腦上的 ElserStudio 單獨生成，官網不會接觸或分發你的憑證。
1
安裝並啟動最新版 ElserStudio 桌面應用。
2
在設定中配置雲端帳戶或本機 BYOK Provider。
3
安裝 Node.js 18+，用於執行 npx skills。
安裝官方 ElserStudio Skill
全域性安裝後，相容 Agent 可在任意專案中發現 elser-studio。安裝器從本站 well-known 清單取得版本化 ZIP，並核對摘要。
全域性安裝
npx skills add https://elserstudio.ai -g -y確認安裝結果
npx skills ls -g更新到最新版本
npx skills update elser-studio -g -yElserStudio MCP Productionv0.7.0 · 49 KB
下載 ZIPSHA-256 07290820a7769d2d4b715e892e9c78ba08c9e89e2f904de42d84e4186a606969
連線本機 ElserStudio MCP
- 保持 ElserStudio 桌面應用執行，並開啟「設定 → 本機 MCP」。
- 確認服務已啟用，點選「複製用戶端接入配置」。
- 在可信終端執行復制的命令；其他相容用戶端可填寫下方地址、傳輸方式和 Authorization Header。
- 重新開啟 Agent 會話，讓它列出 ElserStudio 專案以驗證連線。
預設本機地址
http://127.0.0.1:8787/mcp- 傳輸方式
- Streamable HTTP
- 請求 Header
- Authorization: Bearer <token>
- 服務名稱
- elser-studio
不要把真實令牌貼上到聊天、Issue、截圖或網頁。若憑證洩露，請停止使用並聯系支援處理；使用 MCP 時必須保持桌面應用執行。
實際使用
直接描述目標、範圍和費用邊界。
不需要記住 60 個工具名。告訴 Agent 你想完成什麼、使用哪個專案或 World、是否允許生成媒體；Skill 會選擇流程，MCP 會執行規範讀寫。
提出創作目標
提供小說、章節或創意，並說明希望得到劇本、資產、鏡頭計劃還是實際媒體。
Agent 先讀取規範狀態
Skill 要求 Agent 先讀取現有 Project、World、Episode、Shot 和資產，避免猜測 ID 或重複建立。
確認生成範圍
文字規劃可以直接執行；圖片與影片應明確數量、路由和目標，開放式需求預設先給小樣方案。
在畫布驗收結果
任務完成後，Agent 報告變更的規範 ID、成功與失敗數量、審片結論，以及需要你在畫布確認的內容。
可以直接這樣說
下面的請求從不扣費規劃到受控生成逐步擴大範圍。
使用 ElserStudio Skill 分析這段小說，複用當前 World，建立 Episode 和 Shot，但先不要生成圖片或影片。
為這個 Episode 選擇 3 個代表性鏡頭，先核對角色、場景和道具引用，再用本機 BYOK 生成影片並同步畫布。
保持角色身分與對白不變，檢查第 4 鏡的運鏡、動作節拍、燈光和原生聲音，只修改一個最影響結果的變數。
列出當前專案最近的生成任務，區分已完成、失敗和取消，解釋失敗原因，不要自動重試付費任務。
故障排查
先檢查連線，再檢查任務。
大多數問題來自桌面應用未執行、舊會話未重新載入、憑證不相符或 Provider 配置異常。
Agent 看不到 elser-studio 工具
確認桌面應用仍在執行，在「設定 → 本機 MCP」重新複製接入配置，然後重啟 Agent 會話。不要改用直接讀取 SQLite 或呼叫 Provider API 的方式繞過 MCP。
出現 401、Unauthorized 或連線被拒絕
從設定頁重新複製完整接入配置，確認 Header 使用 Authorization: Bearer 加當前令牌，並確認地址仍為 127.0.0.1:8787/mcp。
npx 無法發現或安裝 Skill
先確認 Node.js 版本不低於 18，再執行全域性安裝命令。可直接下載 ZIP 並核對本頁 SHA-256；不要從未知映象下載修改過的 Skill。
生成任務超時、失敗或一直排隊
讓 Agent 通過 MCP 查詢規範任務狀態和 Provider task id，檢查 Provider 餘額、模型可用性、網路與參考素材。失敗任務不會自動重試，確認原因和新嘗試範圍後再提交。
準備開始
讓第一個任務足夠小，也足夠完整。
建議先用一段短文本建立一個 World、一個 Episode 和 2–3 個 Shot，先完成規範引用與畫布同步，再授權生成代表性鏡頭。