feat(links): 发布线上插件——接入正式HTTPS授权与七项创作技能

插件版本0.1.0,MCP服务https://43.161.201.228/mcp;仅含12个白名单文件,不包含商业源码和密钥。
源版本199bde88;分发ZIP SHA256 20d9445c28174ec29e6a97d716eb753aa52493e4b3740a7f108530112099e93f。
This commit is contained in:
Links Deployment
2026-10-27 11:31:31 +08:00
commit c1bbdab1e9
12 changed files with 287 additions and 0 deletions
@@ -0,0 +1,16 @@
---
name: links-canvas-to-treatment
description: 盘点指定画布的现有作品,组织导演阐述与版式,构建 16:9 多页可翻页 HTML 和素材 ZIP。
---
先读 [共用执行规则](../../resources/execution-rules.md)。优先整理现有作品;只在当前用户创作请求包含新增媒体时安排生成。
1. 确认账号、空间及指定项目/画布,读取 `links_get_canvas` 与授权资产,完成 handoff 并复用原画布。列出节点、文本、图片、视频、音频、成片、对应 assetId/成功步骤产物及缺失素材;不从未知链接抓取素材。
2. 识别用户提案用途、受众、页数与终点,围绕现有素材形成:封面与一句话概念、导演阐述、故事/产品主张、人物与场景、美术与影像、镜头节奏、声音设计、制作与交付。按素材实际覆盖组织页面,不把缺失内容写成已完成。
3. 输出具体页面标题、导演阐述正文与资产引用关系。锁定产品广告的参考及识别特征,标注音乐/声音缺项;明确要求配乐但缺素材/渠道时列待补充项。仅请求提案时不要先生成成片。
4. 调用 `links_build_treatment` 的持久化 treatment Job。请求使用 `title`、`pages:[{title,body,sourceRefs,design?}]`、`sourceRefs`、`missingItems` 和可选 theme。theme 的 preset 为 noir/ivory/cobalt、font 为 sans/serif;accent 仅六位 #RRGGBB,studio 最长80、credit最长160。design 支持 cover/editorial/split/moodboard/storyboard/timeline/quote,kicker最长80、notes最长500;不接收任意 CSS/HTML/URL/远程字体。无 theme/design 的旧请求仍有效。引用仅 `asset:<assetId>` 或 `step:<nodeKey>:<outputIndex>`,每页引用属于总 sourceRefs,外层项目/画布/幂等字段按实时 schema;不传文件路径、密钥或读取回调。
5. 轮询 `links_get_job` 直至完成。产物为离线16:9多页 HTML 和素材/manifest ZIP;按钮、左右键、PageUp/PageDown、Home/End、可访问缩略目录支持翻页,切页暂停音视频;打印全部页面并展开正文。manifest 保留 theme/design、素材引用、字节数、SHA-256 和缺项。长文允许页内滚动,不静默裁剪。
6. 检查页数、正文、素材引用和缺项;浏览器可读 `window.__linksTreatmentDiagnostics()` 的每页 measured/overflow,无溢出不能代表创作品质 passed。如需视觉/视听判断,最终默认最多一轮模型检查;技术、抽样视觉、连续视听证据分开,无实际证据为 unknown。
7. 交付 HTML 与 ZIP 下载结果、页数、素材数、待补充项、质量覆盖、Job/产物及原画布编辑链接。返回结果卡片(宿主支持时)并保留项目继续编辑。素材或权限失效时报告具体阻塞,不能用空包伪装成功。
资产盘点用 `links_list_assets` 的 canvasId/cursor/limit 读取全部分页;新增资产用 `links_prepare_upload` 绑定 canvasId。现有参考可按 [参考工作流](../links-reference-workflow/SKILL.md) 用 production reference_pack 整理,音乐或白模仅在用户终点需要时追加 production 步骤,通过 `links_validate_generation_plan` 预检、`links_generate_media` 提交,模型费0。特殊步骤来源仅写 request.sourceRefs/sourceRef,不设置 step.inputs。程序音非 ZenPiano、节拍估计非语义乐句、白模非产品拟真、当前任务 Blender 渲染须独立验收、公开分发/native Codex 未验。LibTV 仅比较,不运行其脚本。
@@ -0,0 +1,45 @@
---
name: links-music-ad
description: 使用本地 production 持久步骤制作程序配乐、节拍分析和三至五场景音乐广告计划,复用已有媒体并交付可编辑结果。
---
先读 [共用执行规则](../../resources/execution-rules.md)。此 Skill 是制作方法,不注册独立音乐工具。
1. 确认用户要原创程序配乐、已有音乐分析还是音乐广告计划,以及时长、节拍、场景和制作终点。盘点目标画布资产,`links_list_assets` 按 `canvasId/cursor/limit` 翻页;新音频通过携带 canvasId 的 `links_prepare_upload` / `links_complete_upload` 登记。已有音乐必须是已授权 audio,不抓取任意 URL。
2. 用户接受程序音时,在计划 steps 中加入 `category:"production"`、`request.mode:"score_music"`,调用 `links_validate_generation_plan` 预检,再用 `links_generate_media` 提交。D 写作 `durationSeconds`,2–120 秒;bpm 40–200,meter 3 或 4,key C/D/E/F/G/A,scale major/minor,style minimal_piano/ambient_pulse/warm_arpeggio/cinematic_steps,seed 非负整数,sourceRefs 必须为空。固定槽 0 audio、1 doc、2 text。这是程序合成音,非 ZenPiano、真实钢琴录音或指定演奏者;指定录音要求未满足时列待补充。
3. 对一个现有音频或 score 的槽 0 加 `analyze_music` 步骤,填写 `sourceRefs:[一个audio]`、可选 bpmHint、meter、phraseBars(2/4/8)。结果槽 0 text。报告的structure测量能量和频带变化候选,最多64点,附支持区间与阈值;无变化/静音/不足6秒保持unknown,semanticLabels始终unknown。候选不参与自动改动广告切点,不代表主歌/副歌或最优剪辑。节拍估计非语义乐句识别;人工听感和音乐版权判断不能由节拍报告替代。
4. 用 `plan_music_ad` 生成 3–5 场景计划:title、sourceRefs、music:{sourceRef,inSeconds}、durationSeconds、scenes、continuity、width/height,可附 referencePack:{sourceRef}。场景项用 id、space、action、sourceRef?、subjectIds;continuity 用 subject、cameraDirection、transitionPrinciple、immutableFeatures。所有使用的音乐、场景和参考包引用均在 request.sourceRefs 声明,step 引用必须有 dependsOn。production 的静态来源只用 request.sourceRefs/sourceRef,不设置 step.inputs;inputs 只用于后续图像/视频生成的 continuity 镜头。结果槽 0 text,是规划文本,不是自动生成的广告成片。
5. 以下仅为 `steps` 示例,asset:11 代表运行前必须查询并授权的真实图像 ID;替换 request 中的引用后补齐项目、画布和幂等字段,不添加 production step.inputs。后续广告计划依赖的是 score 槽 0 audio;不能将槽 1 doc 当音乐,也不能把 analyze 槽 0 text 当音频。
```json
{
"steps": [
{
"id": "score", "category": "production",
"request": { "mode": "score_music", "title": "山海节奏", "durationSeconds": 20, "bpm": 100, "meter": 4, "key": "C", "scale": "major", "style": "minimal_piano", "seed": 7, "sourceRefs": [] }
},
{
"id": "beats", "category": "production", "dependsOn": ["score"],
"request": { "mode": "analyze_music", "sourceRefs": ["step:score:0"], "bpmHint": 100, "meter": 4, "phraseBars": 4 }
},
{
"id": "ad_plan", "category": "production", "dependsOn": ["score", "beats"],
"request": {
"mode": "plan_music_ad", "title": "山海三景", "durationSeconds": 20,
"sourceRefs": ["step:score:0", "asset:11"], "music": { "sourceRef": "step:score:0", "inSeconds": 0 },
"bpmHint": 100, "meter": 4, "width": 1280, "height": 720,
"scenes": [
{ "id": "arrival", "space": "山间", "action": "主体进入晨光", "sourceRef": "asset:11", "subjectIds": ["product"] },
{ "id": "detail", "space": "室内", "action": "细节随节奏展开", "sourceRef": "asset:11", "subjectIds": ["product"] },
{ "id": "resolve", "space": "海边", "action": "落版留白", "sourceRef": "asset:11", "subjectIds": ["product"] }
],
"continuity": { "subject": "同一产品", "cameraDirection": "左向右", "transitionPrinciple": "动作衔接节拍", "immutableFeatures": ["轮廓比例", "品牌标识"] }
}
}
]
}
```
6. 调用 `links_validate_generation_plan` 预检,用 `links_generate_media` 提交,并通过 `links_get_job` 查询真实持久状态及每个输出槽。production 模型费 0;模型视频和媒体合成另按预检报价。已有音乐分支可省略 score,将授权 audio asset 的引用写入分析和广告计划的 request.sourceRefs/sourceRef,不添加 inputs。修改广告计划不会自动重制音乐。
7. 用户要成片时才根据计划生成/复用镜头并调用 `links_compose`。音量与淡变仅使用 manifest v7 的 `manifest.tracks[].clips[].audio:{gainDb,fadeInSeconds,fadeOutSeconds}`;legacy clips/audios 简式不接收 audio 控制。核对实际返回的可编辑 draft/时间线引用;调整声音复用成功视频。
8. 交付音频、文档、节拍文本、广告计划、真实费用、资产/Job、待补充项和质量证据。程序合成音非 ZenPiano;节拍估计非语义乐句;白模非产品拟真;当前任务 Blender 渲染须独立验收;公开分发/native Codex 未验。LibTV 只比较能力,不运行其脚本。无聆听/视听证据时质量为 unknown。
@@ -0,0 +1,34 @@
---
name: links-previs
description: 用纯数据 production 场景生成离线 Blender 白模预演包,组织镜头、对象和运镜;明确区分打包成功与本机渲染、产品拟真验证。
---
先读 [共用执行规则](../../resources/execution-rules.md)。预演使用计划中的 production 步骤,经 `links_validate_generation_plan` 预检、`links_generate_media` 提交。
1. 明确用户终点是构图/运镜预演、离线包还是已渲染成片。白模非产品拟真,不能承担品牌标识、包装细节或产品身份通过的证据。复用参考 workflow 的稳定主体与缺失视角记录。
2. production 请求仅 `{mode:"blender_previs",scene}`。scene 包含 title、durationSeconds(正数至多 60)、fps(12–60)、width/height(128–1920 偶数)、sourceRefs、objects、shots。不传 Python、脚本片段、本地路径、URL 或远程资源。对象 shape 仅 box/cylinder/sphere/plane,position 为三维坐标,size 为正三维尺寸,color 为六位十六进制;可选 keyframes 用 timeSeconds、position、rotationDeg。
3. shots 含 id、startSeconds、endSeconds、camera:{position,target,lensMm}、可选 endCamera;从零按顺序连续覆盖 durationSeconds。相机位置不能等于目标,运动中也不能穿过自身 look-at 目标;对象和镜头 ID 全部唯一。纯无素材预演 sourceRefs 用 [];授权素材仅在 request.scene.sourceRefs 声明,step 引用须有 dependsOn,不设置 production step.inputs。声明参考不能据此宣称已贴图或已重建产品。
```json
{
"steps": [
{
"id": "previs", "category": "production",
"request": {
"mode": "blender_previs",
"scene": {
"title": "三维白模推镜", "durationSeconds": 6, "fps": 24, "width": 640, "height": 360, "sourceRefs": [],
"objects": [{ "id": "hero", "shape": "box", "position": [0, 0, 1], "size": [1, 1, 2], "color": "#cccccc", "keyframes": [{ "timeSeconds": 0, "position": [0, 0, 1] }, { "timeSeconds": 6, "position": [1, 0, 1], "rotationDeg": [0, 0, 15] }] }],
"shots": [{ "id": "push", "startSeconds": 0, "endSeconds": 6, "camera": { "position": [7, -7, 4], "target": [0, 0, 1], "lensMm": 50 }, "endCamera": { "position": [4, -4, 3], "target": [1, 0, 1], "lensMm": 50 } }]
}
}
}
]
}
```
4. 示例是步骤片段,外层项目/画布/幂等字段按当前能力 schema 补齐。调用 `links_validate_generation_plan` 预检,再用 `links_generate_media` 提交,通过 `links_get_job` 查询真实状态。固定槽 0 doc、1 text,production 模型费 0;doc 是离线包,text 是说明,不存在自动成功的 video 槽。不能将槽 0 doc 绑定为后续视频输入。
5. 交付包内容、场景时长与镜头配置、Job/资产和无令牌画布链接。服务生成包不代表本机 Blender 渲染已执行;当前任务 Blender 渲染须独立验收。只有获得真实本地渲染证据才更新状态,并分别核对视频解码、尺寸、帧数和连续观看结果。此 Skill 不运行 LibTV 或用户提供脚本,不以外部脚本绕过服务。
6. 明示程序合成音非 ZenPiano、节拍估计非语义乐句、白模非产品拟真、当前任务 Blender 渲染须独立验收、公开分发/native Codex 未验;无实际视觉/视听证据标 unknown。用户只要预演包时交付即止,不自动追加付费模型或合成。
本机执行固定导出脚本成功后读取 render-evidence.json:核对 mode、renderCompleted、Blender版本、输入场景/脚本和实际产物 SHA-256。scene_only不是渲染;新运行失败不能凭旧视频报成功。证据中的requested仅是请求配置;用ffprobe/FFmpeg独立检查实际尺寸、帧数、时长与完整解码,连续观看和产品身份仍须独立证据。Windows/Blender4.5.15样例已实际验证,不替代当前业务任务。
@@ -0,0 +1,18 @@
---
name: links-product-ad
description: 从已授权产品参考及识别特征制作创意简报、广告镜头、文案与声音编排,交付成片及可编辑画布。
---
先读 [共用执行规则](../../resources/execution-rules.md)。由当前外部 Agent 承担创意规划,使用直接工具。
1. 明确产品、受众、渠道、时长、画幅、核心卖点、禁用表述和用户制作终点。读取已授权产品资产与已有画布。没有可用产品参考时先列待补充项,不凭空假设品牌外观。
2. 建立产品参考锁定表:`assetId`、正侧背参考、轮廓比例、品牌标识位置及拼写、色彩、材质、包装文字、独特结构和不可改变特征。将锁定表写入创意简报与镜头约束,所有生成步骤携带同一参考资产及关键识别特征。不能把未做视觉核验的特征写成已保持。
3. 完成账号、空间、项目与运行检查,在首次修改前打开/交接画布并复用。形成广告概念、开场钩子、产品亮点、演示镜头、行动号召、字幕文案和声音节奏。尊重“仅创意/脚本/分镜”等终点并按阶段停止。
4. 用 `links_plan_storyboard` 或明确分镜计划建立镜号、时长、参考资产、产品识别约束、镜头动作、卖点文案与声音。复用已有产品素材;按实时模型 schema 选择参数,冻结模型、参考、尺寸、时长、依赖与估价,用 `links_validate_generation_plan` 预检后再生成。
5. `links_generate_media` / `links_run_workflow` 提交明确计划,轮询 Job,将真实输出落到原画布。不要隐式调用内部 Agent 重新规划。重试只针对明确失败步骤;未知接单先查询。
6. 编排成功的视频、产品特写、配音、品牌字幕与音乐。优先已有合法音乐;用户接受程序音时,按 [音乐广告方法](../links-music-ad/SKILL.md) 将 score_music/analyze_music/plan_music_ad 加入计划的 production 步骤,通过 `links_validate_generation_plan` 预检、`links_generate_media` 提交。静态来源仅写 request.sourceRefs/sourceRef,不设置 production step.inputs。production 模型费 0,后续生成/合成按预检;程序音非 ZenPiano,节拍估计非语义乐句。指定录音缺失时仍报告待补充。
7. 用 `links_compose` 生成用户要求的版本。音量与淡变仅在 manifest v7 的 manifest.tracks[].clips[].audio 设置 gainDb、fadeInSeconds、fadeOutSeconds;legacy clips/audios 简式不接收 audio 控制。核实实际返回的可编辑 draft。调整声音或时间线复用已有视频;外观或镜头变更才新增对应生成。
8. 默认最终最多一轮模型检查。`links_review_outputs` 报告技术检查、抽样帧与时点、连续视听的各自覆盖。重点核对锁定表:轮廓、品牌标识、包装文字、色彩、结构;无模型视觉/人工证据时写 unknown,不能以文件可解码代替产品一致性通过。
9. 交付成片或用户指定阶段、已用素材及参考锁定表、可编辑时间线/画布链接、任务与费用、检查证据及待补充项。卡片与浏览器能力缺失时提供标准结构化结果和链接。
跨镜头先按 [参考工作流](../links-reference-workflow/SKILL.md) 整理 reference_pack,并将外层 continuity 与图像/视频生成镜头的真实 inputs/bindings 对齐。参考包 production 本身只用 request.sourceRefs/sourceRef。需要空间/运镜预演时用 [白模预演](../links-previs/SKILL.md) 的 production blender_previs;白模非产品拟真,当前任务 Blender 渲染须独立验收。`links_list_assets` 按 canvasId/cursor/limit 分页,`links_prepare_upload` 绑定 canvasId。公开分发/native Codex 未验,LibTV 仅比较,不运行其脚本。
@@ -0,0 +1,46 @@
---
name: links-reference-workflow
description: 将授权产品、人物和场景素材整理为本地参考包,并用真实 inputs/bindings 与计划 continuity 约束跨镜头一致性。
---
先读 [共用执行规则](../../resources/execution-rules.md)。参考包使用计划中的 production 步骤,经 `links_validate_generation_plan` 预检、`links_generate_media` 提交。
1. 用 `links_list_assets` 按 canvasId/cursor/limit 分页读取资产,核实参考授权、主体、造型版本与缺失视角。新增素材通过 `links_prepare_upload` 绑定同一 canvasId,再用 `links_complete_upload` 登记。不要从产品名推断不可见背面或包装文字。
2. 建立 subjects:id、label、kind(product/character/scene/prop)、variantId、sourceRefs、immutableFeatures(至少一条)、variableFeatures、missingViews;scenes 用 id、label、subjectIds。主体引用属于总 sourceRefs,ID 唯一,场景主体存在;缺失视角如实记录。
3. 加 production `reference_pack` 请求 `{mode,title,sourceRefs,subjects,scenes}`,静态参考只在 request.sourceRefs/sourceRef 声明,不设置 production step.inputs。固定槽 0 doc、1 text,模型费 0;它整理可审阅文档,不生成“已验证一致”的新视角。
```json
{
"steps": [
{
"id": "reference", "category": "production",
"request": {
"mode": "reference_pack", "title": "产品参考锁定表", "sourceRefs": ["asset:11"],
"subjects": [{ "id": "product", "label": "主产品", "kind": "product", "variantId": "v1", "sourceRefs": ["asset:11"], "immutableFeatures": ["保持轮廓和品牌标识位置"], "variableFeatures": ["背景照明"], "missingViews": ["背面"] }],
"scenes": [{ "id": "studio", "label": "摄影棚", "subjectIds": ["product"] }]
}
}
]
}
```
4. 示例 asset:11 仅表示运行前查询到的授权图像,必须用真实 ID 替换。跨镜头制作时,可在计划外层加以下 continuity;它与音乐广告请求内部 continuity 的 shape 不同。先从实时模型 schema 选择实际图像/视频步骤;下例 shot_front/shot_side 必须真的存在,两个步骤的 inputs 都带 assetId 11。shot_side 还需 dependsOn shot_front,并在实际模型字段放 image/video URL binding(例如 images[0] 或 frames[0].url),绑定 shot_front 的真实输出槽与 kind。不能把参考包 doc 槽当图像。
```json
{
"continuity": {
"version": 1,
"subjects": [{ "id": "product", "label": "主产品", "kind": "product", "variantId": "v1", "sourceRefs": ["asset:11"], "immutableFeatures": ["保持轮廓和品牌标识位置"], "variableFeatures": ["背景照明"], "missingViews": ["背面"] }],
"scenes": [{ "id": "studio", "label": "摄影棚", "subjectIds": ["product"] }],
"shots": [
{ "stepId": "shot_front", "sceneId": "studio", "variants": { "product": "v1" } },
{ "stepId": "shot_side", "sceneId": "studio", "variants": { "product": "v1" } }
],
"viewDependencies": [{ "stepId": "shot_side", "sourceStepId": "shot_front" }]
}
}
```
5. 每个图像/视频生成步骤都有对应 shot;subject 的每个静态引用都存在于该步骤 inputs,上游参考使用真实 bindings。viewDependencies 声明不代替 binding;immutableFeatures 文字不代替参考素材。造型版本变化应更新计划和参考,不能一边写 v1 一边换外观。
6. `links_validate_generation_plan` 冻结引用、依赖和约束,`links_generate_media` 提交后用 `links_get_job` 查询真实状态,复用成功步骤。交付参考包 doc/text、缺失视角、连续性声明及实际媒体引用,按证据分别报告产品身份与视觉检查;文字约束或技术成功不能作为一致性 passed。
7. 若接预演,白模非产品拟真,当前任务 Blender 渲染须独立验收;程序合成音非 ZenPiano,节拍估计非语义乐句;公开分发/native Codex 未验。LibTV 仅比较,不运行其脚本。
@@ -0,0 +1,18 @@
---
name: links-script-to-film
description: 将剧本整理为人物场景、分镜、参考图、视频、配音与可编辑时间线,尊重用户指定的制作终点。
---
先读 [共用执行规则](../../resources/execution-rules.md)。默认由当前外部 Agent 规划,走直接工具路径。
1. 读取剧本与已有画布,识别人物、场景、故事节奏、目标时长、画幅和用户终点。保存创意简报与待补充项;“只要分镜”时交付分镜后结束,不继续图片、视频、配音或合成。
2. 运行 `links_get_capabilities`、`links_check_runtime`、`links_list_models`,确认可用图片/视频/音频与合成能力。选择或创建项目、画布,首次修改前完成 handoff,后续始终复用该画布。
3. 用 `links_transform_text` 整理剧本、人物小传和场景清单,再用 `links_plan_storyboard` 或外部 Agent 的明确镜头计划,形成包含镜号、叙事目的、景别、动作、运镜、时长、台词和声音的分镜。工具如返回 Job,查询其持久化状态后读取产物,不把提交成功视作完成。
4. 复用已有角色/场景参考资产,锁定角色识别特征、服装与场景连续性。在画布登记稳定资产和节点引用。按用户终点逐级安排参考图、镜头视频、台词配音;模型选择基于当前 schema,执行前冻结具体模型、参数、素材引用、依赖和费用估算,调用 `links_validate_generation_plan`。
5. 通过 `links_generate_media` 或保存后运行的明确工作流执行已预检计划,轮询 `links_get_job`,报告进度、真实产物和消费。失败仅重试失败步骤;接单结果未知或 blocked 时先查询恢复,不盲目重复生成。
6. 将成功视频放入可编辑时间线,编排剪辑、配音、字幕与声音。优先复用音乐资产;用户接受程序音时,可用 [音乐方法](../links-music-ad/SKILL.md) 的 production score_music 与 analyze_music,通过 `links_validate_generation_plan` 预检、`links_generate_media` 提交。静态来源仅写 request.sourceRefs/sourceRef,不设置 production step.inputs。模型费 0,后续合成另报价。程序音非 ZenPiano,节拍估计非语义乐句;指定录音缺失时返回待补充。
7. 用户要求成片时调用 `links_compose` 并等待交付。音量与淡变仅在 manifest v7 的 manifest.tracks[].clips[].audio 设置;legacy clips/audios 简式不接收 audio 控制。核验实际返回的可编辑 draft;更换声音、字幕或时间线复用已有视频,只有实际变更镜头才新建生成记录。
8. 分开报告生成状态与质量报告。最终交付默认最多一轮模型检查;调用 `links_review_outputs` 后按技术、抽样视觉、连续视听列证据覆盖及 unknown。不能凭解码成功声称人物表演、动作或声音同步通过。
9. 交付用户要求阶段的结果、素材、Job/资产 ID、费用与待补充项、当前画布编辑链接,并用 `links_render_job` 展示可用卡片。保留同一项目继续编辑。
角色/场景连续性可先用 [参考工作流](../links-reference-workflow/SKILL.md) 生成 production reference_pack;外层 continuity 的主体/场景/shot/视图依赖须与图像/视频生成镜头的真实 inputs/bindings 对应,参考包 production 本身只用 request.sourceRefs/sourceRef。空间、构图和运镜可用 [白模预演](../links-previs/SKILL.md) 的 blender_previs;白模非产品拟真,当前任务 Blender 渲染须独立验收。`links_list_assets` 使用 canvasId/cursor/limit 分页,`links_prepare_upload` 绑定 canvasId。公开分发/native Codex 未验;LibTV 仅比较,不运行其脚本。
+18
View File
@@ -0,0 +1,18 @@
---
name: links-setup
description: 安装 Links 后连接自托管 MCP、登录灵犀账号、选择空间、检查创作能力并打开画布。
---
执行前读 [共用执行规则](../../resources/execution-rules.md)。用户要求连接、登录、选择空间或排查 Links 时使用本 Skill。
1. 确认插件的 MCP URL 为用户指定的灵犀 `${PUBLIC_ORIGIN}/mcp`。分发者用构建脚本固定 origin;源码中的 `${LINKS_PUBLIC_ORIGIN}` 只是模板,不能假装连接已成功。不要索取密码、复制网页 JWT 或把令牌放进链接。使用宿主支持的 OAuth 浏览器授权,复用灵犀账号。一个连接只绑定个人空间或一个团队空间;切换空间需切换授权连接。
2. 调用 `links_get_account` 确认当前账号、授权空间与权限;说明 `generation:execute` 允许按平台价格沿用个人余额或团队钱包及成员额度自动消费,不自行加入逐次扣费确认。
3. 调用 `links_get_capabilities`、`links_check_runtime`、`links_list_models`,逐项报告权限、模型渠道、存储、合成及审查就绪情况。能力缺失返回具体阻塞项;不要把部分可用描述为整体不可用,也不要伪造工具支持。
4. 使用 `links_list_projects` 和 `links_list_canvases` 选择或复用目标。创建操作用新的 `idempotencyKey`。首次画布写入前调用 `links_get_canvas_handoff`,宿主支持浏览器时打开或复用右侧同一标签;以宿主返回的实际打开结果为准。无浏览器支持时提供无令牌编辑链接,按已有授权继续后台执行。
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为准。