Skill 是制作方法
它包含小说到 World、Episode、Shot 的工作流，以及 Seedance 镜头、运镜、动作、灯光、角色、风格、音频、特效、连续性、审片和交付方法。
不保存项目，不直接调用模型，也不会自行扣费。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 当前提供 50 项工具；官方 Skill 在这些工具之上提供制作判断、引用规则、费用边界和 Seedance 2.0 专业方法。
小说、剧本与镜头拆解
提取角色、场景、道具与音色候选，把小说或创意整理成 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.4.1 · 18.7 MB
下载 ZIPSHA-256 30173e3dcdc506a259ac383265515833a756d88228fe17771400892ebb4721ee
连接本机 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 时必须保持桌面应用运行。
实际使用
直接描述目标、范围和费用边界。
不需要记住 50 个工具名。告诉 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，先完成规范引用与画布同步，再授权生成代表性镜头。