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

19 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: links-setup
description: 安装 Links 后复用 MCP 授权、选择空间并检查创作能力,在聊天中完成连接排查。
---
执行前读 [共用执行规则](../../resources/execution-rules.md)。用户要求连接、登录、选择空间或排查 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为准。