Files
links-mcp-plugin/plugins/links/skills/links-setup/SKILL.md
Links Deployment f0d014108d fix(links): 默认聊天内生成——取消强制网页交接与重复登录
插件版本 0.1.1;来源提交 998275ceb98c5ab733329bcdbd4fc9dbc5c140d1。仅发布白名单插件文件,后台生成不依赖 Studio 网页会话。
2026-10-28 14:14:35 +08:00

3.2 KiB
Raw Permalink Blame History

name, description
name description
links-setup 安装 Links 后复用 MCP 授权、选择空间并检查创作能力,在聊天中完成连接排查。

执行前读 共用执行规则。用户要求连接、登录、选择空间或排查 Links 时使用本 Skill。

  1. 确认插件的 MCP URL 为用户指定的灵犀 ${PUBLIC_ORIGIN}/mcp。分发者用构建脚本固定 origin;源码中的 ${LINKS_PUBLIC_ORIGIN} 只是模板,不能假装连接已成功。不要索取密码、复制网页 JWT 或把令牌放进链接。先调用 links_get_account 复用已有 MCP 授权,凭据由宿主自动刷新;仅宿主确认凭据缺失、刷新失败或授权撤销/到期时使用 OAuth 浏览器授权。网页 Studio 登录态与 MCP 授权独立,不以网页要求登录为由重新授权。一个连接只绑定个人空间或一个团队空间;切换空间需切换授权连接。
  2. 调用 links_get_account 确认当前账号、授权空间与权限;说明 generation:execute 允许按平台价格沿用个人余额或团队钱包及成员额度自动消费,不自行加入逐次扣费确认。
  3. 调用 links_get_capabilities、links_check_runtime、links_list_models,逐项报告权限、模型渠道、存储、合成及审查就绪情况。能力缺失返回具体阻塞项;不要把部分可用描述为整体不可用,也不要伪造工具支持。
  4. 使用 links_list_projects 和 links_list_canvases 选择或复用目标。创建操作用新的 idempotencyKey。默认通过 MCP 在聊天中继续工作,首次画布写入无需打开网页。仅用户明确要求查看/编辑网页时调用 links_get_canvas_handoff 并打开对应链接;网页未登录不阻断已授权 MCP 流程,也不让用户手动点击生成。
  5. 返回账号、空间、项目/画布的稳定 ID、可用专业流程、阻塞项与编辑链接。不要为连接检查提交生成、预占余额或启动内部 Agent。

完成标准:真实能力调用成功才写“已连接”;真实宿主确认打开才写“画布已可见”。缺少 Codex Desktop/CLI 实测环境时明确记录“宿主交互未测”。

当前协议 1.10.0 公开33个工具。能力盘点包括 production 的 score_music/analyze_music/reference_pack/plan_music_ad/blender_previs:这些是计划步骤的 request.mode,通过 links_validate_generation_plan 预检、links_generate_media 提交,没有额外独立工具。模型费0不代表后续生成/合成免费。links_list_assets 按 canvasId/cursor/limit 分页,links_prepare_upload 绑定 canvasId;links_compose 音量与淡变仅使用 manifest v7 的 manifest.tracks[].clips[].audio,legacy clips/audios 简式不接收 audio 控制,可编辑 draft 须以实际响应为证。程序合成音非 ZenPiano、节拍估计非语义乐句、白模非产品拟真、当前任务 Blender 渲染须独立验收、公开分发/native Codex 未验;LibTV 仅比较,不运行其脚本。

视觉审片通过review.request.visual启用,需实际支持图像的text2text模型;技术检查无模型费,视觉审片一轮收费并经过预检。subjects支持产品/人物参考及固定特征比对;连续视听仍未覆盖。以共用执行规则和实时schema为准。