{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-22T00:54:13.209Z","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus","markdownUrl":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus.md","server":{"slug":"muqian-sun-xiangsu-mcp-plus","name":"像塑 MCP Plus","registryName":"io.github.Muqian-Sun/xiangsu-mcp-plus","description":"Unofficial macOS MCP for Douyin AR (像塑): assets, menus, AI combine, delivery. For learning only.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"muqian-xiangsu-mcp-plus","type":"npm","identifier":"@muqian/xiangsu-mcp-plus","withdrawn":false,"url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus","version":"0.9.0","transport":"stdio","scoredAt":"2026-11-22T00:49:47.746Z"},"score":{"total":72,"tier":"medium","status":"scored","weekDelta":3,"history":[{"date":"2026-11-22","total":72},{"date":"2026-11-21","total":71},{"date":"2026-11-20","total":71},{"date":"2026-11-19","total":71},{"date":"2026-11-18","total":70},{"date":"2026-11-17","total":70},{"date":"2026-11-16","total":69},{"date":"2026-11-15","total":69},{"date":"2026-11-14","total":68},{"date":"2026-11-13","total":68},{"date":"2026-11-12","total":67},{"date":"2026-11-11","total":67},{"date":"2026-11-10","total":67},{"date":"2026-11-09","total":66},{"date":"2026-11-08","total":40}]},"categories":[{"name":"Supply Chain Security","score":98,"verdict":"partial","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","43 of 124 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.assessed","args":{"deps":"124","unhealthy":"43"}}]},{"name":"Provenance & Transparency","score":45,"verdict":"fail","reasons":["Source repository is publicly reachable at the declared URL.","Provenance check failed: no build-provenance attestation is published.","Clear OSI-approved license (MIT).","Actively maintained (last published 10 days ago).","Disclosure check failed: no security disclosure policy was found in the source repository."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.none","args":{}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"10"}},{"code":"disclosure.absent","args":{}}]},{"name":"Schema Quality & AI Usability","score":59,"verdict":"fail","reasons":["AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 28227 tokens (~300/item across 94 items; 94 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"300","items":"94","tools":"94","tokens":"28227","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":46,"verdict":"fail","reasons":["Stability check failed: the tool surface changed between 0.7.0 and 0.9.0: 0 tool removals, 1 breaking changes, 45 additions."],"codes":[{"code":"stability.version_churn","args":{"to":"0.9.0","days":"14","from":"0.7.0","added":"45","breaks":"1","removed":"0"}}]},{"name":"Tool Coverage","score":100,"verdict":"pass","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","100% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"100"}}]},{"name":"Tool Safety","score":75,"verdict":"fail","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; \"object_remove\" implies \"remove\" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.","An AI judge read all 94 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_undeclared","args":{"pct":"0","tool":"object_remove","verb":"remove","declared":"none","annotated":"0","destructive":"2"}},{"code":"toolsafety.manipulation_clean","args":{"units":"94","judged":"94"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"muqian-xiangsu-mcp-plus","type":"npm","identifier":"@muqian/xiangsu-mcp-plus","withdrawn":false,"score":72,"current":true,"url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus","markdownUrl":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"@muqian/xiangsu-mcp-plus"},{"label":"Version","value":"0.9.0"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"ext_status","title":null,"description":"扩展自身状态：官方 MCP 连接情况；本次启动时编辑器插件的安装结果 plugin_install（action 为 installed 新装、kept 已有同版本或更新的插件未动、failed 安装失败附 error）；以及每个已加载 XiangsuMcpExt 插件的工程窗口（pid、工程路径、对应的官方 instance_id、有没有未保存的改动 unsaved_changes（读不到时为 null）、编辑器接口自检）。工具报找不到窗口、INCOMPATIBLE_EDITOR 或官方工具不可用时先调它排查；插件只在装好后新打开的工程窗口里生效。","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":147},{"name":"project_open","title":null,"description":"在新窗口打开一个已有的像塑工程（已经开着就直接返回）。返回窗口 pid 和官方 instance_id。旧版本工程可能弹出升级对话框，需要在编辑器里点确认。","inputs":[{"name":"path","type":"string","required":true,"description":"工程文件夹的绝对路径（含 effect.dyehpj）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":74},{"name":"project_new","title":null,"description":"新建一个空白像塑工程并首次保存到 path（目录须不存在或为空）。需要已有任意一个工程窗口开着。返回新窗口的 pid 和官方 instance_id。","inputs":[{"name":"path","type":"string","required":true,"description":"新工程要保存到的文件夹绝对路径。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":66},{"name":"project_close","title":null,"description":"关闭一个工程窗口（等同工具栏「回到首页」）。有未保存改动时默认拒绝，先 save_project；确实要丢弃改动才传 discard_changes=true。","inputs":[{"name":"discard_changes","type":"boolean","required":false,"description":"丢弃未保存改动直接关闭。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":124},{"name":"image_view","title":null,"description":"查看图片。列表类工具（素材、作品、灵感、任务、排行榜、音乐等）返回的是短引用 *_ref / *_refs（如 img:12），详情类工具（inspiration_detail 的 images、menu_list details 的 image_url）返回地址，都放进参数 images（数组，如 images: [\"img:12\", \"https://…\"]；没有 ref / refs / url 参数）；也可以传本机图片文件的绝对路径（如 menu_list details 的 image_file）。视频和音频引用（video:3、audio:5）看不了画面，返回它的原地址。一次最多 8 张，只认 png / jpeg / gif / webp，单张失败只在该项写明原因；图片很大（如动图）时一次给不完，没给的列在 not_returned 里，再调用一次即可。","inputs":[{"name":"images","type":"array","required":true,"description":"其它工具返回的引用（img:12）、http(s) 图片地址，或本机图片文件的绝对路径。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":226},{"name":"library_list","title":null,"description":"不传 panel_key 时列出可直接应用的分类面板（panel_key）和类型 kind：general 为普通面板（如 3d_distortion=脸部变形/3D 变形、distortion=美型、gaoguai_gan/makeup_gan=AI 实时变脸、3d_makeup=美妆、3d_filter=滤镜、sticker=跟脸贴纸）；square 为 aigc_material=素材广场（其他创作者分享的素材，含现成的 AI 图片、AI 妆容、自定义实时变脸，应用时不重新生成、不扣额度）；collection 为 collection=收藏（当前账号收藏的素材）。现生成的 AI 面板不在其中；其中「AI 3D」（图生 3D 模型、3D 动画、高精度模型重建）用 ai3d_* 工具，「AR 视频」（AR 视频贴片）用 ar_video_* 工具。传 panel_key 时分页列出该面板里的素材：子分类、素材（template_id、title、kind、封面 cover_ref 等）和翻页游标。素材广场的子分类是妆容、图片、实时变脸、跟脸贴纸、前景贴纸、画面特效、3D 模型、3D 饰品；收藏的子分类是全部、美妆、滤镜等目录。没有可应用内容的广场卡片不列出，只在 unsupported 里计数。按画面挑选时把 cover_ref 交给 image_view 看；知道要找什么时用 library_search 按关键词搜，本工具适合按面板和子分类浏览。拿到 template_id 后用 library_apply 应用，AI 图片卡片（kind=ai_image）的整组结果图用 library_images 取。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"category_id","type":"string","required":false,"description":"子分类 ID（收藏为目录名）；省略时用第一个子分类（通常是「全部」）。"},{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"cursor","type":null,"required":false,"description":"翻页游标，原样取上一页的 next_cursor（收藏是字符串）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"panel_key","type":"string","required":false,"description":"面板，取不传 panel_key 时返回的 panels 里的 panel_key；省略时只返回面板清单。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":639},{"name":"library_search","title":null,"description":"按关键词搜索官方素材库（美妆、滤镜、脸部变形、AI 实时变脸、贴纸、画面特效、音效、素材广场等）。除了标题匹配，词正好是面板名或子分类名时也带出那里的素材：「滤镜」→ 滤镜面板，「腮红」→ 美妆/腮红、跟脸贴纸/腮红（这些素材标题里多半没有这个词），「复古滤镜」→ 滤镜/复古；每个面板或子分类最多 300 条。结果按标题完全相同 > 标题开头 > 标题包含 > 分类匹配 > 其余排序，每条的 matched 说明命中方式（title、category:面板/分类、panel:面板）。queries 一次搜多个近义词（最多 8 个）并合并去重。按 offset / count 分页（结果缓存 10 分钟，翻页不重新请求），每条带 template_id、title、panel_key、kind、cover_ref，另返回 total、by_panel（各面板条数，可再用 panel_key 缩小）、matched_categories（展开了哪些分类）、related_categories（名字里含这个词、没有展开的分类，可用 library_list 列出）。kind：package 素材包、ai_image AI 图片、ai_makeup AI 妆容、custom_gan 自定义实时变脸、foreground_sticker 前景贴纸、face_sticker 跟脸贴纸、filter 滤镜。第一页（没传 panel_key / offset）还会附带「添加对象」菜单里名字匹配的项到 menu_items（如「脸蛋天才」「磨皮」「发光」——它们不在素材库里，要用 menu_add 加），并写 menu_note。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"panel_key","type":"string","required":false,"description":"只搜这个面板（library_list 不传 panel_key 时返回的 panel_key，如 aigc_material）。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"queries","type":"array","required":false,"description":"一次搜多个词并合并，如 [\"冷艳\", \"猫眼\", \"烟熏\", \"风格妆\"]。与 query 二选一。"},{"name":"query","type":"string","required":false,"description":"搜索关键词，如「芒果脸」「腮红」「复古滤镜」。与 queries 二选一。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":684},{"name":"library_images","title":null,"description":"一张 AI 图片卡片（kind=ai_image）的整组结果图 image_ref，按 image_index 编号；用 image_view 看图，应用时用 library_apply 的 image_index 选择。template_id 须来自本会话的 library_list / library_search。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"template_id","type":"string","required":true,"description":"library_list / library_search 返回的 template_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":220},{"name":"library_apply","title":null,"description":"把一个官方素材应用到目标工程，与素材库面板里点应用相同（可撤销）：素材包下载、校验 MD5、导入并默认放进场景；素材广场的卡片按 kind 走编辑器自己的应用流程（AI 图片、AI 妆容等只下载现成结果，不重新生成、不扣额度），等对象出现在场景里才返回。返回 kind、added_objects（新放进场景的对象名和 object_path）和 package_folders。template_id 须来自本会话的 library_list / library_search。应用后用 capture_preview 验收。","inputs":[{"name":"auto_instantiate","type":"boolean","required":false,"description":"是否放进场景，默认 true；false 时只导入资源面板（只有 kind=package 支持）。"},{"name":"image_index","type":"integer","required":false,"description":"kind=ai_image 时用第几张结果图，默认 0；整组图见 library_images。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"template_id","type":"string","required":true,"description":"library_list / library_search 返回的 template_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":279},{"name":"works_list","title":null,"description":"分页列出像塑首页「模板」某个分类下的作品。首页作品是完整的像塑工程（官方工程和用户投稿），可下载到本地阅读、学习其场景和脚本做法；任意一个工程窗口开着即可。每次都带上全部分类 categories（推荐、官方工程、新手必做、游戏、妆容、AI玩法等）。每条作品有 template_id、标题、标签、已发布到抖音的特效 ID 和发布量（effect_id / publish_count，没有则为 null）、使用量、工程包大小、封面 cover_ref 和动图 gif_ref（交给 image_view 看）。拿到 template_id 后用 works_download 下载工程。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"category_id","type":"string","required":false,"description":"works_list 返回的 categories 里的分类 ID；省略时用第一个分类（推荐）。"},{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"cursor","type":"string","required":false,"description":"翻页游标，原样取上一页的 next_cursor；最后一页的 next_cursor 是 null。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"sort","type":"string","required":false,"description":"排序：suggest 推荐（默认）、latest 最新、effect_usage 特效使用量、project_usage 工程使用量。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":403},{"name":"works_search","title":null,"description":"按作品名搜索首页作品（与首页搜索框同一个接口）。不给 category_id 时搜全部分类并合并去重：「推荐」翻到底只有约 300 条，「美化」「友友天地」等分类里还有它没有的作品。合并顺序是先「推荐」里的（按 sort），再按分类顺序追加只在其它分类出现的；每个分类最多 300 条。每条带 found_in（出现在哪些分类），另返回 total、by_category（各分类条数）。queries 一次搜多个词（最多 8 个）并合并，每条带 matched_queries。按 offset / count 分页，结果缓存 10 分钟，翻页不重新请求。某个分类翻页时服务端一直给同一页，会列在 incomplete 里。其余字段同 works_list。按特效 ID 查用 works_by_effect。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"category_id","type":"string","required":false,"description":"只搜这个分类（works_list 返回的 categories 里的分类 ID）；省略时搜全部分类。"},{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"queries","type":"array","required":false,"description":"一次搜多个词并合并，如 [\"头套\", \"头饰\"]。与 query 二选一。"},{"name":"query","type":"string","required":false,"description":"作品名关键词，如「合掌」「转场」「换装」。与 queries 二选一。"},{"name":"sort","type":"string","required":false,"description":"排序：suggest 推荐（默认）、latest 最新、effect_usage 特效使用量、project_usage 工程使用量。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":491},{"name":"works_by_effect","title":null,"description":"按特效 ID 查排行榜等处给出的特效（rank_list / rank_subject_detail / rank_innovation / effect_search 的 effect_id）在首页有没有工程，与首页搜索框「特效ID」搜索同一个接口。逐个返回 status：found 首页有这个特效的工程；same_style 首页没有它，但像塑移动版「做同款」按钮指向首页上的一个工程（same_style 给出那个工程所属特效的 effect_id 和名称，常常是别人的另一个特效，如「顶美精致淡妆感」指向「可可裸妆」，不是这个特效本身的工程）；same_name 首页没有它、也没有做同款工程，只有同名作品（effect_id 不同，可能是别人的同名作品，不能当成同一个特效）；not_on_homepage 拿不到工程。做同款工程不在首页时 same_style 仍会给出，status 按同名作品的查找结果。found、same_style 和 same_name 的作品在 items 里（字段同 works_list），template_id 可直接用于 works_download / works_open。默认在「推荐」里查：按特效 ID 查时「推荐」也能查到只在其它分类出现的作品，在别的分类里按 ID 查反而查不到，所以一般不用给 category_id。每个特效一到四次请求。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"category_id","type":"string","required":false,"description":"works_list 返回的 categories 里的分类 ID；省略时用第一个分类（推荐）。"},{"name":"effects","type":"array","required":true,"description":"要查的特效，最多 20 个（一页排行榜）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":495},{"name":"works_download","title":null,"description":"下载一个首页作品的完整工程并解压（与在首页点开作品同一流程，但不打开窗口），返回工程目录和文件概况：key_files 只列学做法要读的文件（effect.dyehpj、场景 .scene 及其 .extra、Graph 下的文件和作者的 .js / .ts 脚本，相对路径和大小；官方素材包 _DynamicAsset 里自带的脚本不列），其余贴图、模型只给总数 file_count 和按扩展名的计数 by_extension，要看时自己列目录。dest 给定时把工程放到该目录（须不存在或为空，跳过 Library 缓存），像塑临时目录里的那份随即删除。下载的工程（含 dest）都会登记，expires_at（24 小时）后在下次下载时自动删除；学完请立即调用 works_cleanup。同一窗口的多个下载会排队一个个下，可以一起发出。要在编辑器里看效果用 works_open。作品版权归原作者，只用于学习参考，不要复制进自己的工程或仓库。","inputs":[{"name":"dest","type":"string","required":false,"description":"工程要放到的文件夹绝对路径（须不存在或为空）；省略时留在像塑的临时目录。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"template_id","type":"string","required":true,"description":"works_list / works_search / works_by_effect 返回的 template_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":363},{"name":"works_open","title":null,"description":"下载一个首页作品并在新的编辑器窗口里打开，与在首页点开作品同一流程（不弹版本升级提示，工程处于未保存状态）。返回窗口 pid、官方 instance_id 和工程目录，之后可用 get_scene、capture_preview 等官方工具观察它的做法。看完用 project_close（discard_changes=true）关窗，再 works_cleanup 删除下载；窗口开着时工程不会被删除。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"template_id","type":"string","required":true,"description":"works_list / works_search / works_by_effect 返回的 template_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":174},{"name":"works_cleanup","title":null,"description":"删除 works_download / works_open 下载过的作品工程（像塑临时目录里的和 dest 副本）。省略 paths 时删除全部；编辑器窗口正开着的会保留并在 kept_open 里列出，关窗后再调用即可。只删登记过的下载，其它路径一律拒绝。","inputs":[{"name":"paths","type":"array","required":false,"description":"只删这些下载（works_download / works_open 返回的 project_path）；省略时删除全部。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":107},{"name":"icon_set","title":null,"description":"设置特效图标（提交特效必需）：把一张图片居中裁成正方形、缩放到 360×360 PNG，写进工程的 Icon/ 目录（与「图标制作」窗口保存的同一批文件），并和那个窗口的「完成」按钮一样把图标上传到抖音特效平台（提交窗口只认上传过的图标）。默认女性、男性两个图标位都用这张图（提交窗口要这两个）。上传失败报 ICON_UPLOAD_FAILED，重试即可。图片可以来自 generate_image 生成的资源，或 capture_preview 截图另存的文件。之后 save_project 落盘。","inputs":[{"name":"image_path","type":"string","required":true,"description":"图片的绝对路径（png / jpg / webp 等 sips 能读的格式）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"type","type":"string","required":false,"description":"写哪个图标位：both（默认，女性和男性两个位都用这张图，提交窗口要的就是这两个）、female、male，或 common 通用。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":281},{"name":"icon_open","title":null,"description":"打开编辑器的「图标制作」窗口（官方图标模板、文字模板、AI 图标），让用户在里面挑选或调整。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":96},{"name":"effect_check","title":null,"description":"特效检测，和在编辑器工具栏点「特效检测」一样：打开「特效检测」窗口，由窗口把特效包上传到抖音做云端检测（不是发布），等待结果 passed / not_passed / needs_optimization / failed。出结果后读出检测页的详情一起返回：verdict（页面结论，如「检测通过」「特效不通过」）、checks（每项检测的结论；包体积、帧率给出 figures：数值、上限、是否达标，帧率分 android / ios；没通过的项带页面给的改进建议 advice，读不到时写 advice_unavailable），然后关掉这个窗口（window_closed=true）；详情读不出来时窗口留着，返回 details_error。超过 timeout_ms 还没出结果时返回 timeout，窗口留着继续检测；之前调用留下的检测窗口会先关掉再开新的（closed_previous 是关掉的个数），所以窗口不会越叠越多。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"timeout_ms","type":"integer","required":false,"description":"最长等待时间，默认 300000（5 分钟）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":303},{"name":"submit_prepare","title":null,"description":"填好提交窗口，停在最后一步等用户点「提交审核」：先在本地检查提交流程会拒收的情况（包体上限、是否原样套用模板、登录、图标），全部通过后先关掉还开着的提交窗口（之前调用留下的，closed_previous 是关掉的个数，关不掉报 WINDOW_NOT_CLOSED），再走和工具栏「提交特效」按钮相同的入口打开一个新的，然后逐页填写：「特效基础信息」页填名称、触发提示、默认摄像头方向（图标来自工程，可先用 icon_image 设好），「特效发布设置」页选灵感和任务，再翻到「提交审核」页，等页面上的检测（包体积、性能、相似度等，一般一分钟内）跑完，返回页面摘要、各检测结果、是否已同意创作者协议、「提交审核」按钮是否可点，以及 next（用户还要做什么）。本工具不会勾选协议，也不会点「提交审核」，发布只在用户点了之后发生。每一项都从页面读回核对：页面截断、报错、没选上、或翻页被拦住时直接报错（SUBMIT_*，原样带上页面提示），窗口保持打开。页面上本工具没填的其它设置（如活动、创新声明）列在 other_sections 里，保持页面原样。本地检查未通过时不打开窗口，返回 issues。","inputs":[{"name":"camera","type":"string","required":false,"description":"默认摄像头方向：front 前置、back 后置；省略时保留页面的默认（一般是前置）。"},{"name":"icon_image","type":"string","required":false,"description":"先用这张图设图标（同 icon_set 的默认：女性、男性两个位，并上传），再打开提交窗口；省略时用工程现有的图标。"},{"name":"inspiration","type":"string","required":false,"description":"「灵感绑定」要选的灵感或热点，取它在列表里显示的名称（当前账号收藏的灵感或热点，灵感的名称同 inspiration_collected 的标题）；传「暂不绑定」解绑；省略时保留页面带出的（inspiration_bind 绑定过的会自动带出）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"name","type":"string","required":true,"description":"特效名称（必填）：最多 10 个字，两个英文字母或数字算一个字，不能有表情和特殊符号；页面截断或报错时整次调用失败。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task","type":"string","required":false,"description":"「任务绑定」要选的任务标题（已领取的任务，同 tasks_list 的 title）；传「暂不参与」解绑；省略时保留页面带出的（task_bind 绑定过的会自动带出）。"},{"name":"task_track","type":"string","required":false,"description":"任务下的赛道名称，任务分赛道时必填，否则报 SUBMIT_TASK_NEEDS_TRACK 并列出赛道。"},{"name":"trigger_hint","type":"string","required":false,"description":"特效触发提示，开拍时显示，如「张嘴试试」：最多 10 个字；省略时保留页面带出的内容，传空串清空。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":737},{"name":"mobile_preview","title":null,"description":"手机预览：按工具栏「手机预览」的方式打包当前工程并上传到抖音的预览服务，返回和编辑器弹出的一样的二维码图片（及其文本、有效期），用抖音 App 扫码即可在真机上看效果。二维码同时存成文件 qr_file，可直接给用户扫，不要另存到别处：到期（expires_at，一般 7 天）后自动删除。会把特效包上传到抖音服务器；内容审核不通过时报 MOBILE_PREVIEW_MODERATION_FAILED。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":186},{"name":"inspiration_list","title":null,"description":"分页列出某个分类下的灵感（灵感是官方和创作者发布的特效创意，首页右侧「灵感」页签就是它）：inspiration_id、标题、标签（如「激励」）、作者、收藏数、是否已收藏、是否 AI 灵感、关联热点 hotspot、封面 cover_ref（交给 image_view 看）。每次都带上全部分类 tabs。拿到 inspiration_id 后用 inspiration_detail 看详情。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"tab","type":"string","required":false,"description":"分类名，取上次返回的 tabs 里的一个（全部、热门音源、头饰、变形等）；省略时用第一个（全部）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":321},{"name":"inspiration_detail","title":null,"description":"一个灵感的详情：玩法说明、特效类型、激励说明、全部图片的地址 images（用 image_view 看）、作者、奖励（金额、说明、时间）、关联热点（热度和标签，如「66条热点相关灵感」）、关联官方工程 project（服务端只给标题、图标和「可在像塑桌面端搜索使用」，没有工程 id，2026-11-09 查了 13 个带工程的灵感都是这样；要下载就拿标题去 works_search）、已有的同灵感特效及发布量、示例视频 videos（抖音视频的播放地址 url、封面 cover_url、作者、点赞数、尺寸）、贴纸 stickers，以及当前账号是否已收藏和总收藏数。","inputs":[{"name":"inspiration_id","type":"string","required":true,"description":"inspiration_list / inspiration_collected / inspiration_search / hotspot_inspirations / growth_task_detail 返回的 inspiration_id，或像塑 / 抖音 App 灵感页里的灵感 ID。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":272},{"name":"inspiration_collect","title":null,"description":"收藏或取消收藏一个灵感（写入当前登录账号，与灵感详情页的收藏按钮相同），之后重新查询收藏状态确认生效。","inputs":[{"name":"collect","type":"boolean","required":false,"description":"true 收藏（默认），false 取消收藏。"},{"name":"inspiration_id","type":"string","required":true,"description":"要收藏的 inspiration_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":125},{"name":"inspiration_collected","title":null,"description":"分页列出当前账号收藏的灵感（和首页「灵感」页签里的「收藏」页同一接口），按收藏时间从新到旧：字段同 inspiration_list，另有收藏时间 collected_at、作品类型 artwork_type（0 特效、2 模板、5 表情）、所属征集任务 task（task_id 和标题；提交时选了别的任务，这条灵感会被挤掉）。服务端没给灵感卡片的条目只有 inspiration_id 和标题，并标 card_missing=true。只列灵感，不含收藏的热点和素材。submit_prepare 的 inspiration 按标题在这些收藏里选。按 cursor 翻页，total 是收藏总数。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20，最多 50。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标（偏移量），取上一页的 next_cursor；默认 0。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":344},{"name":"submit_close","title":null,"description":"关掉这个工程窗口里开着的提交窗口（submit_prepare 打开、用户还没点提交的），不打开新的；返回关掉的个数 closed。要改填内容不用先关，直接再调 submit_prepare，它会先关掉旧的。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":121},{"name":"inspiration_bind","title":null,"description":"按 inspiration_id 把一条创作灵感绑定到当前工程（编辑器给 agent 的同一接口），之后 save_project 落盘，打开提交窗口时会自动带出。提交窗口的下拉只列已收藏的灵感，没收藏的会带不出来，所以本工具会顺手收藏它（newly_collected=true 表示这次收藏的，不要了可用 inspiration_collect 取消）。只在提交时选灵感的话，也可以直接给 submit_prepare 传 inspiration：它在提交窗口的下拉里按名称选，只列当前账号收藏的灵感和热点。","inputs":[{"name":"inspiration_id","type":"string","required":true,"description":"要绑定的 inspiration_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":208},{"name":"tasks_list","title":null,"description":"按 offset / count 分页列出首页活动中心的活动和特效征集任务：标题、状态（如 WAIT_RECEIVE 待领取 / WAIT_SUBMIT 待提交）、是否已领取、状态说明（如「查看官方指导，帮您完成任务」）、剩余天数、收益、上下线时间、可完成次数。拿到 task_id 后用 task_detail 看详情、task_receive 领取、task_bind 绑定到工程（bindable=true 的才能绑）。成长任务用 growth_tasks_list。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":293},{"name":"growth_tasks_list","title":null,"description":"按 offset / count 分页列出活动中心里的成长任务：task_id、标题、奖励金额 bonus_yuan、标签、是否新手任务、参考工程。详情（参考工程、相关灵感、教程）用 growth_task_detail；特效师等级和每级目标进度在 growth_route。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":249},{"name":"task_detail","title":null,"description":"一个特效征集任务的详情：状态、奖励时间、下线时间、我提交到这个任务的特效 my_effects（名称、effect_id、审核状态、拍摄数、播放数、投稿峰值、获奖金额、任务评定 task_state（pending 待评定，任务页不显示标签；unfinished 任务未完成；done 任务已完成；认不出的值原样给）和 off_theme（任务页标了「主题不符合」）、赛道）、完成状态、是否分档任务、任务页推荐工程的模板 id recommended_template_ids（去重后最多前 20 个，总数在 recommended_template_total，全部见 save_to；目前没有工具能按它直接下载，只能当线索），和整理过的任务说明 content：每个内容块（参与要求、奖项详情、近期热门、任务说明等）有名称 name、条目 items 和链接 links；条目有标题 title、正文 text（页面里的链接标记已换成文字，链接放进 links）、参考图 image_refs 和参考视频 video_refs，奖项条目另有页面原样给的金额 money、发放方式 money_mode 和名额 people（unlimited 为不限）；空地址和 blob: 地址任务页里也显示不出来，只在 unusable_media 里计数；读不懂的字段原样放进 unread。要原始返回时传 save_to。task_id 来自 tasks_list 或 my_task_status（本会话没列过时自动先读一次任务列表）；活动没有详情，成长任务用 growth_task_detail。只看所有任务里自己作品的评定，用 my_task_status 一次取全。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"save_to","type":"string","required":false,"description":"把接口的原始返回另存到这个目录（绝对路径），文件名 task_detail-<task_id>.json，长期保留。"},{"name":"task_id","type":"string","required":true,"description":"tasks_list 返回的 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":559},{"name":"growth_task_detail","title":null,"description":"一个成长任务的详情：标题、奖励、标签、参考工程、相关灵感（封面 cover_ref）和教程。task_id 须来自本会话的 growth_tasks_list。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"growth_tasks_list 返回的 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":202},{"name":"task_receive","title":null,"description":"领取一个征集任务（写入当前登录账号，与活动中心的「领取」按钮相同，领取后不能撤销）。只有状态为 WAIT_RECEIVE 的任务能领，其它状态直接拒绝。返回 designer_task_id 和新状态；领取后本工具会重新读一次任务列表，接着就能 task_bind。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"tasks_list 返回的任务 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":150},{"name":"task_bind","title":null,"description":"把工程绑定到一个已领取的任务，和从任务详情页点「去创作」打开的工程一样，提交时会带上该任务。编辑器只在打开工程时写入任务信息，所以本工具会先关闭该工程的窗口（有未保存改动时拒绝，先 save_project），再带着任务信息重新打开，返回新的 pid 和 instance_id。带任务的打开要经由另一个开着的窗口发起，这个工程是唯一的窗口时，会先开一个不保存的空工程当跳板，绑完关掉。task_id 须来自本会话的 tasks_list。只在提交时选任务的话，直接给 submit_prepare 传 task（已领取任务的标题），不用重开窗口。","inputs":[{"name":"path","type":"string","required":true,"description":"工程文件夹的绝对路径。"},{"name":"task_id","type":"string","required":true,"description":"tasks_list 返回的 task_id（须 bindable=true）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":207},{"name":"growth_route","title":null,"description":"像塑移动版的「成长之路」：当前账号的特效师等级 current_level，以及每一级（新手特效师、潜力特效师……大师特效师）的现金奖励、状态（done 已完成 / in_progress 进行中 / locked 未解锁）和要达成的目标：每个目标的说明（如「绑定「灵感」上线 0/3 个作品」）、当前进度 current / 目标 target、对应奖励。最高级给的是权益 rights。任意一个工程窗口开着即可，用编辑器里登录的账号读取。活动中心里一个个带参考工程和教程的成长任务用 growth_tasks_list。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":209},{"name":"rank_list","title":null,"description":"分页读取一个排行榜（与像塑移动版排行榜页同一个接口）：名次、特效名、effect_id、等级、投稿量（峰值 / 累计）、跟拍量、男女比例、年轻喜爱度、热玩分、总收益等。可按日期、分类（每级一个，如只看「人像美化 › 美妆」）和筛选项过滤，每页都带上该榜当天的分类 categories（level 1 大类如人像美化、游戏玩法、人设扮演、AI 玩法，level 2 细类如基础头饰、测一测、不露脸壁纸；每个榜不同）。按主题的专题榜（如「热爆美妆特效榜」）见 rank_subjects。要看某个特效的工程，把 effect_id 和 name 交给 works_by_effect，查它在不在首页。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"categories","type":"array","required":false,"description":"分类名，取上一页返回的 categories，每级最多一个，可叠加，如 [\"人像美化\",\"美妆\"]（大类 + 细类）。"},{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 20）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"date","type":"string","required":false,"description":"榜单日期 YYYY-MM-DD，默认最新一期。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"levels","type":"array","required":false,"description":"特效等级，如 [\"S\",\"A+\"]。"},{"name":"panels","type":"array","required":false,"description":"面板，如 [\"头饰\",\"美妆\"]。"},{"name":"preferences","type":"array","required":false,"description":"偏好。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"rank_type","type":"integer","required":false,"description":"榜单：1 年轻喜爱榜、2 特效每日投稿榜、3 男生喜爱榜、4 女生喜爱榜、7 热玩互动榜、9 模板每日投稿榜、10 特效跟拍榜；默认 1。"},{"name":"tools","type":"array","required":false,"description":"来自工具。"},{"name":"young_like_scores","type":"array","required":false,"description":"年轻喜爱度 1–10。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":574},{"name":"rank_hotspots","title":null,"description":"热点榜（按热度排序的抖音热点，每小时更新），按 offset / count 分页：名次、topic_id、标题、说明、热度、相关灵感数、封面 cover_ref。一个热点下的灵感用 hotspot_inspirations。抖音全站的实时热点榜见 douyin_hot_list。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":257},{"name":"hotspot_inspirations","title":null,"description":"一个热点下的灵感，按热点页页签的顺序、按 offset / count 分页：每条的页签 tab、inspiration_id、标题、标签、说明、封面 cover_ref（交给 image_view 看）；tabs 是全部页签名。详情用 inspiration_detail；把这个热点下全部灵感的图片下载到本机用 hotspot_inspiration_images。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"topic_id","type":"string","required":true,"description":"rank_hotspots 返回的 topic_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":281},{"name":"hotspot_inspiration_images","title":null,"description":"把一个热点下全部灵感的图片下载到本机：逐条读灵感详情，下载详情里的全部图片（封面就是第一张；多数灵感只有 1 张，也有 3 张、6 张的），同一灵感在几个页签里出现只下一次。文件名是「序号-灵感标题-第几张.扩展名」，序号按热点页的顺序；同目录的 index.json 记下每条灵感的 inspiration_id、标题、页签、文件名和原图地址。文件是临时的：存在临时目录里，24 小时后删除（MCP 服务一直开着时到点删；服务重启过的，下次调用本工具时删），要留存就自己复制走。一个热点约 70 张图，一般一分钟左右。返回目录 dir、灵感数、存下的图片数、每条灵感的文件名，以及失败的灵感和原因 failed（详情读不出、图片下载两次都失败或不是图片）；一张都没存下时报错。topic_id 来自 rank_hotspots。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"tab","type":"string","required":false,"description":"只下这个页签的灵感（hotspot_inspirations 返回的 tabs 之一）；省略时下全部。"},{"name":"topic_id","type":"string","required":true,"description":"rank_hotspots 返回的 topic_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":358},{"name":"douyin_hot_list","title":null,"description":"抖音实时热点榜（像塑移动版「实时热点」同一接口，约 5 分钟一版）：前 20 条的 hot_id、名次、名称、分类 categories（娱乐、站内玩法、话题互动、二次元等；「站内玩法」多是正在火的梗、手势舞和跟拍玩法）、热度文字。榜单版本时间 updated_at。看一个热点的热度走势和站内已有特效数用 douyin_hot_detail，看它的热门视频用 douyin_hot_videos。像塑官方挑过、适合做特效的话题见 rank_hotspots。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":204},{"name":"douyin_hot_detail","title":null,"description":"一个抖音实时热点的详情（像塑移动版「热点详情」页同一接口）：名称、分类、上榜时间 listed_at_text、站内已有的特效数 effects_text（如「上线特效0个，等级特效0个」，0 说明还没人做）、近 7 天每天的热度 days 和今天每小时的热度 hours（heat 数值、heat_text 页面文字）。hot_id 须来自本会话的 douyin_hot_list。服务端偶尔答「网络开小差了」，隔几秒再调。","inputs":[{"name":"hot_id","type":"string","required":true,"description":"douyin_hot_list 返回的 hot_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":204},{"name":"douyin_hot_videos","title":null,"description":"一个抖音实时热点下的视频（像塑移动版「热点详情」页同一接口，按接口原样的顺序，不是按热度排的，点赞常常只有几十）：视频 ID、播放地址 video_ref、封面 cover_ref、点赞数、作者昵称，按 offset / count 分页。用来看这个梗、玩法实际怎么拍。hot_id 须来自本会话的 douyin_hot_list。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"hot_id","type":"string","required":true,"description":"douyin_hot_list 返回的 hot_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":295},{"name":"baidu_hot_list","title":null,"description":"百度热搜榜（top.baidu.com，不用登录、不用开像塑）：置顶条 pinned 和 50 条热搜，按 offset / count 分页（默认前 20 条），每条有名次、词、摘要、热度、配图 image_ref、链接 link，榜单更新时间 updated_at。看站外正在发生的社会、娱乐话题。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":209},{"name":"bilibili_popular","title":null,"description":"B 站「热门」视频（不用登录、不用开像塑）：标题、BV 号、链接、封面 cover_ref、分区、UP 主、播放 / 点赞 / 评论 / 弹幕数、时长、发布时间、上热门的理由（如「百万播放」）。按 page 翻页。看年轻人在 B 站追的梗和内容。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 50）。"},{"name":"page","type":"integer","required":false,"description":"页码，默认 1，取上一页的 next_page。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":213},{"name":"bilibili_hot_search","title":null,"description":"B 站搜索框下的热搜词（不用登录、不用开像塑）：名次、关键词、展示名、热度分，更新时间 updated_at。","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":45},{"name":"rank_subjects","title":null,"description":"像塑移动版「专题合集」里按主题的榜单，最新的在前，按 cursor 翻页：kind=effect 为特效专题榜（近 200 期，如「测一测玩法特效榜 - 11月」「热爆美妆特效榜」「熊出没IP特效榜」「主题创新优胜特效榜」、各期征集活动优质特效），kind=template 为模板专题榜（如「歌词玩法模板榜」「AI配文创意模板榜」「氛围转场模板榜」）。每个榜带前几个特效、浏览量。按榜名搜用 rank_subjects_search，一个榜的全部特效用 rank_subject_detail。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 20）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"kind","type":"string","required":false,"description":"effect 特效专题榜（默认），template 模板专题榜。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":359},{"name":"rank_subjects_search","title":null,"description":"按榜名在「专题合集」的全部期里搜索（服务端没有搜索，逐页读完再过滤），返回全部匹配的榜，不分页；每个榜带前几个特效、浏览量。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"keyword","type":"string","required":true,"description":"榜名里的词，如「美妆」「测一测」「IP」「热梗」。"},{"name":"kind","type":"string","required":false,"description":"effect 特效专题榜（默认），template 模板专题榜。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":244},{"name":"rank_subject_detail","title":null,"description":"「专题合集」里一个榜的全部特效（最多 20 个）：特效名、effect_id、app_effect_id、图标、说明。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"subject_id","type":"string","required":true,"description":"rank_subjects 或 rank_subjects_search 返回的 subject_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":200},{"name":"rank_innovation","title":null,"description":"创新计划的官方精选（像塑移动版发现页的精选列表，移动版展示的是模板）：特效名、effect_id、标签 labels（同一页里同一个特效带不同标签出现多次时合成一条）、投稿量、总收益、入选日期、封面。服务端的 offset 不按条目计，翻页时上一页的特效会再出现，返回的 date 也可能变；要全看时按 effect_id 去重。创作者月榜用 rank_creators。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20；精选由服务端过滤，实际条数可能略少。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"kind","type":"string","required":false,"description":"template 精选模板（默认），effect 精选特效。"},{"name":"offset","type":"integer","required":false,"description":"翻页偏移，取上一页的 next_offset。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":327},{"name":"rank_creators","title":null,"description":"创新计划的创作者月榜，按 offset / count 分页：名次、创作者 uid、昵称和头像 avatar_ref、上榜素材数、跟拍量、预计奖金（元）。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":226},{"name":"my_effects","title":null,"description":"当前登录账号提交过的特效，最新的在前（与像塑移动版「作品」同一个接口）：effect_id、名称、审核状态 status 和 status_text（100 审核中、101 审核未通过、111 测试中、112 测试未通过、120 测试通过、103 已上线、104 已下线、113 延后上线、118 申诉重审中、119 申诉审核未通过）、提交和上线时间、绑定的任务 / 灵感 / 热点、能否编辑 / 删除 / 申诉及申诉类型、投稿量。101、112、119 的特效带 review：最近一条审核记录，text 是去掉标记的原因正文，refuse_reasons 是分条原因，links 是正文里的链接（如审核规则）。完整审核时间线用 my_effect_reviews；把 effect_id 和 app_effect_id 交给 my_effect_data（数据卡片）、my_effect_trend（按天趋势和投稿等级）、my_effect_revenue（收益）。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 50）。"},{"name":"cursor","type":"string","required":false,"description":"翻页游标，原样取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":410},{"name":"my_effect_reviews","title":null,"description":"一个自己的特效的审核记录，与像塑移动版「审核记录」页同一组接口：名称、当前状态、绑定的任务，reviews 为「上线审核」时间线（最新的在前，提交成功、审核中、审核未通过等，每条有时间、去掉标记的正文 text、分条原因 refuse_reasons、链接 links），innovation_reviews 为「精选审核」时间线（没有时为空）。","inputs":[{"name":"effect_id","type":"string","required":true,"description":"my_effects 返回的 effect_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":171},{"name":"my_effect_data","title":null,"description":"一个自己已上线特效的数据卡片，与像塑移动版「作品详情」页同一组接口：名称、类型、各 App 上线情况 apps（抖音 app_id 184、抖音极速版 1164：上线状态、时间、投稿峰值和累计）、用到的功能 functions、标签；数据卡片 figures（页面原样的名称、值和文字：累计曝光、累计投稿、累计播放、累计跟拍、平台判定的特效类型如「技巧比拼」「玩法测试」、特效等级、跟拍等级、年轻喜爱度）；流量状态 traffic（如「流量正常」）；播放数 views（与任务页的播放数同源）；绑定的任务和灵感 related。按天的趋势和投稿等级用 my_effect_trend，收益用 my_effect_revenue。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"app_effect_id","type":"string","required":true,"description":"my_effects 返回的同一个特效的 app_effect_id（抖音上的特效 ID）。"},{"name":"effect_id","type":"string","required":true,"description":"my_effects 返回的 effect_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":373},{"name":"my_effect_trend","title":null,"description":"一个自己已上线特效的「数据趋势」和投稿等级（像塑移动版「作品详情」页同一接口）：按天的曝光 exposure 和投稿 publish（逐日累计值，数据隔天才更新，当天为空），累计曝光���试拍 trial_total、跟拍、视频播放；投稿等级 level（当前等级代码 code、当前投稿 publish、下一级代码 next_code、升到下一级还差的投稿 publish_to_next）。等级代码和字母等级的对应没有接口给出，投稿门槛见像塑 App「激励规则」页。","inputs":[{"name":"app_effect_id","type":"string","required":true,"description":"my_effects 返回的同一个特效的 app_effect_id（抖音上的特效 ID）。"},{"name":"effect_id","type":"string","required":true,"description":"my_effects 返回的 effect_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"trend","type":"string","required":false,"description":"范围：recent 近 7 日（默认），since_online 上线后。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":259},{"name":"my_effect_revenue","title":null,"description":"一个自己已上线特效的收益明细（像塑移动版「作品详情」页同一接口）：总收益、基础等级奖、年轻奖、跟拍奖、精选奖，每项的金额 amount（页面原样）、说明 note（如「暂未达到最低等级」「不符合精选标准」）和是否已解锁。","inputs":[{"name":"app_effect_id","type":"string","required":true,"description":"my_effects 返回的同一个特效的 app_effect_id（抖音上的特效 ID）。"},{"name":"effect_id","type":"string","required":true,"description":"my_effects 返回的 effect_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":183},{"name":"my_profile","title":null,"description":"当前账号的资料和数字，与像塑移动版「我的」页同一组接口：昵称、粉丝数、是否实名、特效作者 / 模板作者各自的等级 identities；数据卡片 figures（开拍总计、播放总计、本月提交、本月上线、本月收入、累计收入，页面原样的名称、值和文字）；本月数据 month（本月上线数、本月收入、前一天收入、累计收入，其余字段含义未核实，原样放在 unread）。收益明细用 my_revenue。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":183},{"name":"my_revenue","title":null,"description":"当前账号的收益，与像塑移动版「钱包」同一接口：累计和某个月的总额、按来源（投稿收益等）的占比和金额、那个月每天的收入。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"month","type":"string","required":false,"description":"月份 YYYYMM，默认本月。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":121},{"name":"messages_list","title":null,"description":"像塑移动版「消息」页的站内信，最新的在前：标题、正文、时间、是否已读、分组（服务 / 官方）、审核类消息的状态和对应的 effect_id、点开的链接 link。包括发布成功、进入测试、上线（「拍摄特效视频可获得更多冷启流量」）、审核未通过、精选审核中、任务完成、获奖公布、成长之路奖金到账等。按 cursor 翻页。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 50）。"},{"name":"cursor","type":"string","required":false,"description":"翻页游标，原样取上一页的 next_cursor。"},{"name":"group","type":"string","required":false,"description":"all 全部（默认），service 服务（任务完成、获奖公布、精选审核等），official 官方（发布、审核、上线等）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":243},{"name":"my_task_status","title":null,"description":"一次列出提交到所有已领取任务里的作品和它们的任务评定（逐个任务读任务详情页的「我的作品」，与 task_detail 的 my_effects 相同）：每条带任务 task_id 和标题、作品名、effect_id、审核状态、拍摄 / 播放 / 投稿峰值、任务评定 task_state（pending 待评定、unfinished 任务未完成、done 任务已完成）和 off_theme（任务页标了「主题不符合」）；summary 按评定计数并统计主题不符合的条数。没交过作品的任务不出现在列表里；每个已领取任务一次请求，按顺序发。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":297},{"name":"effect_detail","title":null,"description":"任意一个已上线特效或模板的详情（像塑移动版「发现」页特效详情同一接口，别人的特效也能看）：名称、类型（特效 / 模板）、effect_id、上线时间、等级代码 level_code、累计投稿 / 点赞 / 评论（页面原样文字）、年轻 / 男生喜爱度、热玩分、男女投稿比例、受众（年龄、性别）、风格（如潮酷）、平台判定的类型 category（如「社交测试」「美妆」）、来自哪个工具、流量状态、用到的编辑器能力 functions（如美瞳、屏幕液化、3D 模型动画、辉光、滤镜，看出爆款怎么组合）、作者及等级、图标 icon_ref、几条示例视频（video_ref 和封面 cover_ref）。category、functions、designer、点赞评论数这几块服务端有时不返回（同一个特效连查也会时有时无），缺的给 null，隔一会儿再查；读不懂的字段原样放 unread。用这个特效拍的视频（标题、跟拍数）用 effect_videos，工程用 works_by_effect。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"app_effect_id","type":"string","required":true,"description":"特效在抖音上的 ID：rank_list、rank_subject_detail、rank_innovation、effect_search、my_effects 返回的 app_effect_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":449},{"name":"effect_videos","title":null,"description":"用一个特效拍的抖音视频（像塑移动版「作品详情」页的视频卡片，别人的特效也能看）：累计点赞和跟拍（页面原样文字），以及几条热门视频 videos（实测 5 条）：抖音视频 ID item_id、标题、作者、点赞、跟拍、封面 cover_ref 和视频 video_ref（交给 image_view 拿地址）。看别人怎么拍、文案怎么写。自己刚上线、还没人拍的特效列表是空的。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"app_effect_id","type":"string","required":true,"description":"同一个特效的 app_effect_id。"},{"name":"effect_id","type":"string","required":true,"description":"特效 ID（rank_list、effect_search、my_effects 等返回的 effect_id）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":305},{"name":"effect_search","title":null,"description":"按关键词搜索像塑全平台已上线的特效或模板（像塑移动版搜索页同一接口）：effect_id、app_effect_id、名称、说明、等级代码、年轻喜爱度、累计投稿（页面原样文字）、图标 icon_ref。特效最多翻到 100 条。按 cursor 翻页，每页最多 20 条。顺序是服务端定的，前几名多是累计投稿很高的老特效；接口不认排序参数（2026-11-09 试了 sort_type、order_by、sort 等 12 种写法，顺序都不变），要看现在火的用 rank_list / rank_subjects。只搜首页工程用 works_search；拿到特效后用 effect_detail 看详情、effect_videos 看视频、works_by_effect 找工程。搜灵感用 inspiration_search，搜教程用 tutorial_search。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 20，更多服务端报错）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"kind","type":"string","required":false,"description":"effect 特效（默认），template 模板。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"query","type":"string","required":true,"description":"关键词，如「美妆」「测一测」「变装」。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":421},{"name":"inspiration_search","title":null,"description":"按关键词搜索灵感（像塑移动版搜索页同一接口；inspiration_list 只能按分类翻）：字段同 inspiration_list。按 cursor 翻页，每页最多 20 条。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 20，更多服务端报错）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"query","type":"string","required":true,"description":"关键词，如「美妆」「测一测」「变装」。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":254},{"name":"tutorial_search","title":null,"description":"按关键词搜索像塑官方教程（像塑移动版搜索页同一接口）：字段同 tutorials_list。按 cursor 翻页，每页最多 20 条。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 20，更多服务端报错）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"query","type":"string","required":true,"description":"关键词，如「美妆」「测一测」「变装」。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":247},{"name":"tutorials_list","title":null,"description":"像塑官方教程（移动版「教程」页同一组接口）：每次都带上全部分类 tabs（特效：新手入门、特效进阶、精选课程、PC工具、工程实操、三方工具、爆款分享、账号运营、视频教程；模板：模板入门、模板进阶等），按 tab_id 列出一个分类的教程，不传时列出全部（约 190 篇，比各分类之和多）。每篇有标题、标签（如「新手必看」「拍视频脚本」）、学习人数、作者、上线日期、是否付费、文档链接 link（飞书文档，要登录飞书才能打开，agent 读不到正文，只能看标题和标签）、封面 cover_ref 和视频 video_ref（视频教程才有，交给 image_view 拿到的地址能直接打开）。按 offset / count 分页。按关键词找教程用 tutorial_search。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"tab_id","type":"integer","required":false,"description":"分类 ID，取返回的 tabs 里的 tab_id；省略时列出全部教程。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":415},{"name":"shoot_activity","title":null,"description":"当前账号本期的「拍视频激励」活动（像塑移动版首页活动卡片同一接口，按周重置）：活动名、起止时间、本期拍摄数 shoot_count、收入 income（单位未核实，原样给）、本期任务 tasks（如「拍作品视频发布到抖音」「按照脚本拍摄同款视频」，各自的奖励文字、完成次数）、连续创作打卡 streaks（每档目标次数和奖金）、新手成长任务 newbie（每项的状态和页面文字、全部完成的奖金）、下次重置时间。状态码 status 的含义接口没给，原样给出，结合 text、finish_count 看。拍摄脚本用 shoot_scripts。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":223},{"name":"shoot_scripts","title":null,"description":"像塑官方的拍摄脚本（移动版「拍摄脚本」同一接口）：教你用特效拍什么样的视频（如「【测一测】表演有梗结果」「【美妆】带特效前后反差」），每条有脚本 ID、名称、完整说明 description（脚本解读和「尝试拍一个」的具体做法）、标签代码 tags、播放数 views、拍摄数 shoots、封面 cover_ref 和示范视频 video_ref。tag 按标签代码筛选，App 里没有标签名，实测各代码下的脚本：1 测一测、2 游戏、3 美妆为主，含两条变形、4 变形为主，含一条美妆、5 AI、6 技巧。type 是接口给的脚本类型代码，含义也没给出（1 多为技巧合集，2 多为具体演绎）。全部约 50 条，按 offset / count 分页。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（最大 50）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"tag","type":"integer","required":false,"description":"标签代码（整数，写成 \"3\" 也行）：1 测一测、2 游戏、3 美妆为主，含两条变形、4 变形为主，含一条美妆、5 AI、6 技巧；省略时全部。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":479},{"name":"music_categories","title":null,"description":"抖音音乐库的分类（像塑原创、推荐、抖音收藏、潮流心选等）的 code 和名称，交给 music_list 看分类里的歌。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":101},{"name":"music_list","title":null,"description":"抖音音乐库一个分类的一页（每页约 35 首，按 cursor 翻页）：music_id、标题、作者、时长 duration_sec、封面 cover_ref、试听 preview_ref（音频引用）和 has_copyright（音乐库给的版权标记，false 或 null 的不要用于要发布的特效），以及下一页的 next_cursor、has_more。分类 code 从 music_categories 取；按关键词找歌用 music_search。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"category_code","type":"string","required":true,"description":"music_categories 返回的分类 code。"},{"name":"cursor","type":"number|string","required":false,"description":"下一页：上一页返回的 next_cursor；省略时从第一页开始。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":283},{"name":"music_search","title":null,"description":"按关键词搜抖音音乐，一页约 35 首、按 cursor 翻页：每首的 music_id、标题、作者、时长 duration_sec、封面 cover_ref、试听 preview_ref（音频引用）和 has_copyright（false 或 null 的不要用于要发布的特效），以及 next_cursor、has_more。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"cursor","type":"number|string","required":false,"description":"下一页：上一页返回的 next_cursor；省略时从第一页开始。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"query","type":"string","required":true,"description":"搜索关键词。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":253},{"name":"music_apply","title":null,"description":"把一首抖音音乐设为特效的音乐，和音乐库里点「使用」相同：下载音频进工程、写入音乐信息，并在场景里加入抖音音乐对象（再次使用会替换上一首）。start_sec / end_sec 截取片段，默认整首。music_id 须来自本会话的 music_list 或 music_search。之后 capture_preview 验收、save_project 落盘。","inputs":[{"name":"end_sec","type":"number","required":false,"description":"片段结束（秒），默认整首时长。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"music_id","type":"string","required":true,"description":"music_list 或 music_search 返回的 music_id。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"start_sec","type":"number","required":false,"description":"片段开始（秒），默认 0。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":217},{"name":"scene_tree","title":null,"description":"把场景结构输出成紧凑的缩进文本：渲染组，以及每个对象的 guid、名称、是否隐藏、组件类型。比官方 get_scene 的 JSON 好读，适合先摸清结构再用 inspect_many 查参数；要渲染组和对象的完整 JSON 用 get_scene。subtree 只看某个对象：guid、名称，或层级路径（从渲染组名起，或只给末尾几段，如「2D 前景/2D 摄像机」；同名对象常见，重名时报 AMBIGUOUS_OBJECT 并列出各自的 guid 和路径），depth 控制展开层数（默认 6）；没展开的子对象会注明数量。传 project_dir（工程目录，如 works_download 下载的作品）时不需要打开窗口，直接读 Assets/main.scene 和 main.scene.extra，对象写成 #序号，组件类型和窗口里显示的一致（编辑器数据缺失时退回场景文件里的名称）；没有渲染组这一层，渲染组本身作为根对象列出。save_to 是目录的绝对路径，结果另存为其中的 scene_tree.txt，长期保留。","inputs":[{"name":"depth","type":"integer","required":false,"description":"展开层数，默认 6。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_dir","type":"string","required":false,"description":"不开窗口、直接读这个工程目录的场景文件；给了它就不看 project_path / instance_id。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"save_to","type":"string","required":false,"description":"另存到这个目录（绝对路径，不存在会创建），长期保留。"},{"name":"subtree","type":"string","required":false,"description":"只输出这个对象及其子对象：guid（project_dir 时是 #序号）、名称或层级路径。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":433},{"name":"inspect_many","title":null,"description":"一次查看多个对象的组件参数（逐个调用官方 inspect；只看一个对象的完整原始数据时直接用 inspect），值里的 {type, data} 包装直接展开成值，超长数组只给长度和前几项；绑定的资源写成 {resource, type, file}，引用的对象写成 {object, name}。component_types 只留某些组件（如 [\"Transform\"]），fields 只留属性名包含这些片段的属性（不分大小写，如 [\"intensity\", \"position\"]）。fields 也会留下内部某一层属性名包含这些片段的整块参数（如后处理的 bloom 块里的 pBloomThreshold）。妆容层（FaceMask / FaceMaskDY）的混合模式编号旁边加上 blendMode_name / surfaceBlendMode_name（如「正片叠底」）。preset=\"key\" 自动留下通常决定效果的参数：位置/缩放/旋转、显隐与启用、强度/不透明度/Transparency/权重/颜色类属性、AI 脸的 Channel（Texture 皮肤路 / Distortion 形变路）、内部含强度类参数的整块参数（如后处理的发光、调色）、文字内容（str）与 2D 尺寸（sizeDelta）、绑定的资源，以及场景文件里脚本组件的全部参数；空的贴图槽（编辑器的「缺失纹理」）和完全透明的黑色（妆容层没用到的珠光色等）会丢掉（这份清单是按已做过的妆容、形变、贴纸、文字效果拍的，缺的用 fields 补，可与 fields 同时用；fields 点名的属性即使空着也留下）。guids 里每一项可以是 guid、对象名称或层级路径（同 scene_tree 的 subtree：从渲染组名起，或只给末尾几段；重名时该项报 AMBIGUOUS_OBJECT 并列出候选）；不是场景对象的 guid（组件、资源）原样交给官方 inspect。传 project_dir 时不开窗口、直接读场景文件（含编辑器面板里的参数，如妆容的贴图和强度），guid 是 scene_tree 给出的 #序号；内置资源写成 {builtin: id}，组件运行时生成、工程里没有文件的资源写成 {path}。单个对象失败只在该项写明原因。save_to 是目录的绝对路径，结果另存为其中的 inspect_many.json，长期保留。","inputs":[{"name":"component_types","type":"array","required":false,"description":"只保留这些类型的组件。"},{"name":"fields","type":"array","required":false,"description":"只保留属性名包含这些片段的属性。"},{"name":"guids","type":"array","required":true,"description":"要看的对象：guid（scene_tree / get_scene 返回的；project_dir 时是 #序号）、名称或层级路径；开窗口时也可以是组件或资源的 guid。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"preset","type":"string","required":false,"description":"key：只留关键参数，见工具说明。"},{"name":"project_dir","type":"string","required":false,"description":"不开窗口、直接读这个工程目录的场景文件；给了它就不看 project_path / instance_id。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"save_to","type":"string","required":false,"description":"另存到这个目录（绝对路径，不存在会创建），长期保留。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":794},{"name":"makeup_layers","title":null,"description":"列出一个工程的全部美妆层（FaceMask 妆容层、旧版 FaceMaskDY 妆容层和 EyeColorV2 美瞳），逐层说明画在哪个部位、什么颜色、男女强度，以及是否生效（对象或上级隐藏、组件停用、男女强度都为 0 的不生效）。区域（全脸 / 眼部 / 睫毛 / 唇部 / 牙齿）取自妆容层自身的类型；部位先看层名（眉、眼线、腮红、口红等关键字），层名看不出时按贴图像素判断（part_from 注明依据），颜色是贴图上色部分按透明度加权的平均色（color 和 hsl）；层上设了着色 tint 时另给贴图色乘上着色的 tinted_color / tinted_hsl（按着色和贴图相乘算的，没有实测核对）。整张不透明的贴图（底色是白或黑、靠颜色深浅起作用）按每个像素离该混合模式下「不改变皮肤」的颜色多远来算颜色和范围，并在 texture_note 里注明；几乎全是这种中性色的层没有颜色，texture_note 说明它几乎不改变皮肤。texture_source 标出贴图从哪来：官方素材包（package_id 是这个包在素材库里的 template_id；整套美妆和部分素材包解压在按包名命名的文件夹里，这时给的是 package_folder，如「清冷_美妆」）、作者导入（file 是作者导入时的文件名）或未知，copy 为 true 表示是复制出来的副本（常是作者在官方贴图上改过）。FaceMask 的 intensity 是面板上的「不透明度」：单独加的层实际画出的浓度 opacity = intensity × 男女强度 × 外部强度；挂在整套美妆（AI 实时变脸）下的子项由 GAN 接管，改 intensity 不起作用，opacity 只按男女强度 × 外部强度算。FaceMaskDY 面板上只有一个强度（intensity），男女强度取它运行时各自的不透明度（实际渲染用的是这两个）；它的唇部质地写成 surface（混合模式和强度）。groups 按眉、眼妆、美瞳、颊、轮廓、唇、点缀汇总生效的层，absent 列出整套妆里没有的部位，用来看一套妆缺了什么、或拆解别人的作品（works_download 下载的工程）用了哪些部位和颜色。读的是工程目录里的场景文件：正在编辑的工程先 save_project。","inputs":[{"name":"project_dir","type":"string","required":true,"description":"工程目录的绝对路径（含 Assets/main.scene），如 works_download 返回的 project_path 或自己的工程。"},{"name":"save_to","type":"string","required":false,"description":"另存到这个目录（绝对路径，不存在会创建），长期保留。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":689},{"name":"makeup_compare","title":null,"description":"在同一张脸上比较几种妆容状态：重置预览、播放 at_ms 后截基线（当前状态），再依次把每个 variant 的改动临时套上、等预览画出来、截一帧、改回去，最后再截一次基线。要用静态照片做的预览视频（如「模特D清秀||女」这些模特视频，每一帧都是同一张照片）：会动的视频每次截到的是不同的帧，两次基线的平均亮度差超过 2 时返回提示。预览暂停后不再重绘，所以不能靠暂停停住画面。改动有两种，都实时生效、跑完改回原值：一是妆容层的 female / male（男女强度）和 intensity（面板上的「不透明度」，单独加的层实际画出的浓度是它 × 男女强度；整套美妆的子项由 AI 脸接管，改它不起作用）、美瞳和滤镜的 intensity；二是任意组件的一个数值属性：object_path + component（inspect 里的组件类型名，如 GanComponent、PostProcess）+ property（如 Transparency、bloom.pBloomIntensity）+ value，经官方 set_component 设置，用来比 AI 脸皮肤路强度、发光强度这类参数。换贴图、换混合模式要重载预览，不在这里比。整套妆的子项也可以这样调，强度改回原值，不会删层。regions 是按画面比例（0–1）给的区域，如眼下、脸颊、唇：每个区域返回每种状态的平均色 RGB / HSL、亮度 luma（Rec.601）、皮肤细节 detail（亮度减去 σ 2 px 高斯模糊后的平均绝对差，越高纹理越多），以及相对基线的差值；再给一张并排放大图（基线在最前，之后按 variants 顺序，像素直接放大不插值，一行放不下时换行）。给了 reference（参考图）时，区域的 ref 是同一部位在参考图上的框（按参考图的比例），每种状态另给 to_reference（相对参考图的差值），并排图最后一格是参考图的这一块（缩放到同样大小）。同一张静态照片上前后两帧在眼部的噪声约 0.5–0.8（平均，最大 13–18），差值比这个小的看不出区别。videos 依次在几个预览视频上各比一次，完了切回原视频。跑完所有改动都已改回；切换过视频或改过参数后工程会显示「已修改」。","inputs":[{"name":"at_ms","type":"integer","required":false,"description":"重置后播放多久再截基线（毫秒），默认 3000（AI 变脸要过一会儿才完全生效）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二���一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"reference","type":"string","required":false,"description":"参考图（PNG / JPEG）的绝对路径；和区域的 ref 一起用。"},{"name":"regions","type":"array","required":true,"description":"区域：按画面比例给框（模特的眼睛位置各不相同，同一个比例框在别的模特脸上会框偏，换模特时按截图重新给框）。"},{"name":"save_to","type":"string","required":false,"description":"另存到这个目录（绝对路径，不存在会创建），长期保留。"},{"name":"tracking_type","type":"string","required":false,"description":"videos 所属的 tracking_type，默认 face。"},{"name":"variants","type":"array","required":true,"description":null},{"name":"videos","type":"array","required":false,"description":"依次使用的预览视频名称（preview_videos 列出的 video_name）；不给就用当前视频。"},{"name":"zoom","type":"integer","required":false,"description":"并排图的放大倍数，默认 3。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":918},{"name":"preview_videos","title":null,"description":"可用的预览视频名，按 tracking_type 分组（face、two_person、body、hand、pet、environment），外加当前视频 current：只给名字，用来挑 preview_frames、makeup_compare 的 videos 和官方 set_preview_video 的 video_name。要地址、有没有本地文件等全部字段用官方 list_preview_videos（约 70 KB）。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"tracking_type","type":"string","required":false,"description":"只列这一类，如 face；不给就全列。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":162},{"name":"preview_frames","title":null,"description":"按时间连续截取预览画面，分辨率是预览本身的（720×1280，官方截图是缩小后的 320×569），取自预览的渲染结果，窗口在后台或最小化时也能截（截图期间临时恢复正常帧率）：默认先重置预览、等到重载后的画面出来，再每隔 interval_ms 截一张，共 count 张（一次最多 24 张），用来看动态效果、摇头时的侧脸等。videos 可依次换几个预览视频各截一组（名称取自 preview_videos，如 preview_single_shake_head||女），全部截完切回原视频，并等编辑器把视频写回工程信息，工程原来没有未保存的改动时，截完仍是干净的（note 里说明）。crop 按画面比例（0–1）裁出局部，如脸部。每帧都存成文件并随结果返回，files 里是路径，可直接贴给用户看；默认存在临时目录、24 小时后删除，save_to（目录的绝对路径）则存到那里长期保留。每帧注明实际截取时刻（相对重置完成的毫秒数）。","inputs":[{"name":"count","type":"integer","required":false,"description":"每个视频截几张，默认 4。"},{"name":"crop","type":"object","required":false,"description":"裁剪区域，按画面宽高的比例，左上角为 (0, 0)。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"interval_ms","type":"integer","required":false,"description":"相邻两张的间隔（毫秒），默认 700。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"reset","type":"boolean","required":false,"description":"每组截图前先重置预览，默认 true。"},{"name":"save_to","type":"string","required":false,"description":"另存到这个目录（绝对路径，不存在会创建），长期保留。"},{"name":"tracking_type","type":"string","required":false,"description":"videos 所属的 tracking_type，如 face、body、hand，默认 face。"},{"name":"videos","type":"array","required":false,"description":"依次使用的预览视频名称（preview_videos 列出的 video_name）；不给就用当前视频。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":510},{"name":"menu_list","title":null,"description":"列出像塑「添加对象」菜单里的全部官方功能项（工具栏美妆、美型、AI 实时变脸，及人脸/身体/2D/3D/AI 玩法/互动/宠物/音乐等），返回 menu_id、中文名、路径、类型。官方 edit_by_dsl 的 add_builtin_object 命令只覆盖其中一部分；美容（面部提拉、祛皱纹）、面部生成（烟熏妆、卡通脸）、表情生成（香肠嘴、呲牙尬笑）、性别年龄、五官处理、身体换装等用 menu_add。query 按名称、路径或 menu_id 过滤。details=true 时每项再带说明 description 和示意图（编辑器悬停提示里的图：在 CDN 上的给 image_url，随编辑器安装的给本机文件 image_file，都没有为 null），按画面挑选 AI 变脸、美容等效果时把它交给 image_view 看；details 一次最多 8 项，query 匹配更多时报错。云端 AI 生成项不在列表中；拍照后云端生图的「AI 组合效果」用 ai_combine_new / ai_combine_apply。","inputs":[{"name":"details","type":"boolean","required":false,"description":"同时返回说明和示意图，默认 false；匹配项须不超过 8 个。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"query","type":"string","required":false,"description":"按中文名、路径或 menu_id 过滤，如「表情」「美容」「烟熏妆」。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":397},{"name":"menu_add","title":null,"description":"按 menu_id 往场景添加一个官方功能对象，与在编辑器菜单里点选等效（可撤销）。kind=package 的项会先下载官方素材包再导入。返回 added_objects（新对象名和 object_path）。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"menu_id","type":"string","required":true,"description":"menu_list 返回的 menu_id。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":131},{"name":"ai_combine_new","title":null,"description":"新建一张「AI 组合效果」工作流（用户拍照后在云端按工作流出图或出视频），等同 AI 效果窗口的「新建工作流」：在本地建 AI Graph，只有「输入图」和「效果组合」两个节点且未连线；不联网、不扣额度、不建云端草稿。返回 ai_graph_id 和各节点的 node_id，交给官方 get_workflow_context / get_workflow_capabilities / apply_workflow_patch 添加生图节点、写 prompt、连线（官方 apply_workflow_patch 每次改完会把工作流保存成账号下的云端 AI 效果草稿），要看效果用官方 generate_workflow（扣额度）。改好后用 ai_combine_apply 放进场景。「添加对象」菜单里的 AI 组合效果只建空壳，不要用 menu_add。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":257},{"name":"ai_combine_apply","title":null,"description":"把一张 AI 工作流放进场景，等同 AI 效果窗口的「应用」（可撤销）：编辑器编译工作流、把工作流文件上传到特效平台，再添加「AI 组合效果」对象（场景里没有 2D 前景时一并建「2D 前景」「2D 摄像机」）。不扣额度，不新建草稿；工作流生成过预览视频时一并上传供审核。效果组合节点没有输入连线等情况下编辑器会拒绝，返回 AI_COMBINE_APPLY_FAILED 和编辑器的提示原文（如「请先连接效果组合器」）。返回 added_objects（新对象名和 object_path）和 draft_id（工作流已存成云端草稿时才有，否则为 null）。之后 save_project。","inputs":[{"name":"graph_id","type":"string","required":true,"description":"ai_combine_new 或官方 get_workflow_context 返回的 ai_graph_id。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":266},{"name":"ai3d_image_submit","title":null,"description":"素材库「AI 3D › 3D模型」（图生 3D）：上传一张参考图，在云端生成 3D 模型（静态网格，没有骨骼和动画），返回 task_id。参考图须是 PNG / JPG / JPEG、不超过 10 MB、长宽不超过 4000 像素；主体完整清晰、无遮挡，背景尽量纯色（编辑器的建议）。卡通角色可以先用官方 generate_image 出一张正面全身、纯色背景的图再交给本工具。同一类型最多同时跑 3 个任务。之后用 ai3d_tasks（带 task_id 和 wait_s）等它完成，再用 ai3d_import 放进工程。是否扣账号额度以编辑器为准，编辑器代码里没有相关提示。","inputs":[{"name":"image_path","type":"string","required":true,"description":"参考图的绝对路径。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"precision","type":"string","required":false,"description":"精度（面数）：low=1000、medium=10000、high=50000，对应编辑器的低 / 中 / 高面数；默认 medium。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":302},{"name":"ai3d_animation_submit","title":null,"description":"素材库「AI 3D › 3D动画」：把参考视频里人的动作做成动画，套到一个带标准人形骨骼的 FBX 上，返回 task_id。model 可选内置的 whole / upper_body / lower_body / arm（全身 / 上半身 / 下半身 / 手臂，编辑器自带的人形模型），或一个本地 .fbx 的绝对路径：须有骨骼（Hips、Spine、LeftUpLeg 等 20 根标准人形骨骼，名字完全一致、不带 mixamorig_ 前缀，缺了编辑器也只提醒，返回里会有 warning），骨骼和面数不超过编辑器的导入上限。参考视频须是 MP4、不超过 30 秒、20 MB、长宽不超过 1280，建议单人、全身出镜。图生 3D（ai3d_image_submit）出来的模型没有骨骼，不能直接用作 model。之后 ai3d_tasks 等完成、ai3d_import 导入（导入的是带动画的 FBX）。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"model","type":"string","required":false,"description":"whole / upper_body / lower_body / arm 之一，或本地 .fbx 的绝对路径；默认 whole。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"video_path","type":"string","required":true,"description":"参考视频的绝对路径。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":360},{"name":"ai3d_gs_segment","title":null,"description":"素材库「AI 3D › 高精度模型重建」第一步：上传一段实物 360 度环绕视频，云端识别出要重建的主体，返回 seg_task_id 和主体图 subject_image_ref（交给 image_view 看）。确认主体没问题后用 ai3d_gs_submit 正式生成 3D 高斯点云（.ply）；主体不对就换视频或重拍。视频须是 MP4 / MOV、不超过 120 秒、100 MB、长宽不超过 4000，主体清晰、光线充足、各角度都拍到。识别一般约 20 秒，最多等 wait_s 秒，超时编辑器会取消这次识别。\n\n返回里的图片、视频、音频给的是短引用（*_ref / *_refs 字段，如 img:12、video:3）。看图时把引用放进 image_view 的 images 数组（参数名就是 images，如 images: [\"img:12\", \"img:13\"]）：图片直接显示，视频和音频返回原地址；引用在 MCP 服务这次运行期间有效。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"video_path","type":"string","required":true,"description":"环绕视频的绝对路径。"},{"name":"wait_s","type":"integer","required":false,"description":"最多等待识别的秒数，默认 120。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":347},{"name":"ai3d_gs_submit","title":null,"description":"素材库「AI 3D › 高精度模型重建」第二步：按 ai3d_gs_segment 识别出的主体正式生成 3D 高斯点云，等同识别窗口里的「确认主体」，返回 task_id。之后 ai3d_tasks（kind=gs）等完成、ai3d_import 导入。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"seg_task_id","type":"string","required":true,"description":"ai3d_gs_segment 返回的 seg_task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":163},{"name":"ai3d_tasks","title":null,"description":"素材库「AI 3D」的生成任务（当前账号）。不传 task_id 时按 kind（必填）分页列出历史任务：状态（running / finished / failed）、创建和完成时间、输入（图生 3D 的精度、3D 动画的模型）、失败原因，以及结果是否已下载到本机和本机的预览图 / 预览视频（preview_image_file 交给 image_view 看）。传 task_id 时只查这一个（不用给 kind）；再给 wait_s 就一直等到它不再是 running 或时间到（最多 600 秒），status=finished 后用 ai3d_import 导入。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20（服务端上限）。"},{"name":"cursor","type":"integer","required":false,"description":"翻页游标，原样取上一页的 next_cursor。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"kind","type":"string","required":false,"description":"列历史时必填：image=3D模型（图生 3D）、animation=3D动画、gs=高精度模型重建。只查一个 task_id 时不用给。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":false,"description":"只查这个任务（不用给 kind）。"},{"name":"wait_s","type":"integer","required":false,"description":"配合 task_id：最多等多少秒，默认 0（只查一次）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":341},{"name":"ai3d_import","title":null,"description":"把一个已完成的 AI 3D 任务结果下载到编辑器的 AI 3D 缓存目录（面板里同样能看到），导入工程并放进场景（可撤销），与面板里勾选后点「导入素材」相同：图生 3D 导入 GLB（外层对象「模型大小控制」放大 15 倍）、3D 动画导入带动画的 FBX、高精度模型重建导入 PLY 点云（缩小到 0.3）。返回 added_objects（新对象名和 object_path）、package_folders 和本机预览文件。之后用 capture_preview 看大小和位置，save_project。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"kind","type":"string","required":true,"description":"任务类型，与提交时一致。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"ai3d_*_submit 或 ai3d_tasks 返回的 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":257},{"name":"ai3d_cancel","title":null,"description":"取消一个还在 running 的 AI 3D 生成任务（等同面板里的「取消生成」）。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"要取消的 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":103},{"name":"ar_video_submit","title":null,"description":"素材库「AI 素材 › AR 视频」（AR 视频贴片）：提交一次生成，等同面板上的「立即生成」，云端（Seedance）接受任务后返回 task_id。编辑器没有单独的模式开关，由输入决定：mode=direct 只抠像、不改动作，主体须是视频，不能带 prompt 和参考素材；mode=motion 由 prompt（必填）描述新动作或样式，主体可以是图片或视频，可加参考图（如给主体加道具）和一段参考动作视频。输入先交给编辑器自己的素材检查和转换（与面板上传素材相同：只认 JPG / JPEG / PNG / MP4 / MOV，包括主体最多 9 张图、3 段视频，视频每段至少 2 秒、合计不超过编辑器开关给的上限，主体视频原长须小于 60 秒；不合规格的图片自动缩放压缩、视频自动转码裁剪，转不了时报 AR_VIDEO_INPUT_INVALID 并带编辑器原话），视频还要先过编辑器的内容审核（最长 15 分钟）。动作时长 duration_s 默认 10 秒，最短 4 秒，上限由编辑器开关决定（2026-11-08 为 15 秒，以 ar_video_tasks 返回的 limits 为准）。shadow 是「添加投影」，省略时用编辑器默认（开关 dyeh_enable_ar_video_shadow，2026-11-08 为开）；开着时结果是带投影的幕底视频。同时最多 10 个任务在跑。会占用账号的 AI 模型使用次数（按特效师等级给），编辑器里查不到剩余次数和单次扣多少，用完时报「模型使用次数达到上限」。任务在哪个工程窗口提交，就在那个窗口里下载并合成结果，之后的 ar_video_tasks / ar_video_import 用同一个窗口最快；实测一段 10 秒的图片生成动作从提交到合成完约 6 分钟。","inputs":[{"name":"duration_s","type":"integer","required":false,"description":"输出动作时长（秒），默认 10，范围见 ar_video_tasks 返回的 limits。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"mode","type":"string","required":true,"description":"direct：主体视频直接生成 AR 视频贴片，只抠像不改动作；motion：按 prompt 和参考素材生成新动作。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"prompt","type":"string","required":false,"description":"动作描述（最多 2000 字），mode=motion 时必填，mode=direct 时不能给。任务文档的建议：写上「生成高清视频」这类话会出高清。"},{"name":"reference_images","type":"array","required":false,"description":"参考图的绝对路径（JPG / JPEG / PNG），如给主体加道具；仅 mode=motion。"},{"name":"reference_video","type":"string","required":false,"description":"参考动作视频的绝对路径（MP4 / MOV），动作迁移用；仅 mode=motion。"},{"name":"shadow","type":"boolean","required":false,"description":"「添加投影」，省略时用编辑器默认；前置自拍类效果一般关掉。"},{"name":"subject","type":"string","required":true,"description":"主体图片或视频的绝对路径（面板文案「上传图片或视频」）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":741},{"name":"ar_video_tasks","title":null,"description":"素材库「AR 视频」的生成任务（当前账号，与面板右侧的生成记录同一份）。不传 task_id 时按 offset / count 分页列出，最新的在前，并带上当前的输入限制 limits；传 task_id 时只查这一个，再给 wait_s 就一直等到它合成完、失败或时间到（最多 600 秒）。status：running 云端生成中、restoring 云端已完成，正在本机下载并合成、succeeded 可以导入、failed 失败（failure 里是编辑器给的原因和错误码）、unconfirmed 暂时查不到云端状态。每条带 name（工具栏后台任务里显示的名字）、mode、主体类型、参考素材类型、prompt、时长、投影；succeeded 的另有实际时长 seconds、尺寸、是否幕底 green_screen、原声 audio、本机的预览视频 preview_video_file（抠像后叠在 #1b1b1b 背景上）、要导入的视频 video_file，以及一张横排 6 帧的预览图 preview_image_file（交给 image_view 看动作，不用打开视频）。在别的窗口提交的任务，这个窗口第一次看到时要自己下载并合成，会先显示 restoring。","inputs":[{"name":"count","type":"integer","required":false,"description":"每页数量，默认 20。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"offset","type":"integer","required":false,"description":"分页起点，取上一页的 next_offset；默认 0。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":false,"description":"只查这个任务（ar_video_submit 返回的 task_id）。"},{"name":"wait_s","type":"integer","required":false,"description":"配合 task_id：最多等多少秒，默认 0（只查一次）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":426},{"name":"ar_video_import","title":null,"description":"把一个 succeeded 的 AR 视频任务导入目标工程并放进场景，等同面板上勾选它后点「导入素材」（只导这一个，面板里其它勾选的结果不受影响）：视频「混合透明.mp4」、它的视频纹理「混合透明 MP4 播放器」（Mp4Texture，.mp4Tex）和原声「原声.mp3」导入为工程资源；场景里建渲染组「AR跟踪」，其下「AR平面跟踪」（AR 平面，MeshRenderer）上挂「AR 视频主体 N」，以及「AR摄像机」；场景原来是空的时还会建「通用」组（摄像机和灯光）。「AR 视频主体」上：Image 的 texture 是那张视频纹理（播放由它负责，loopCount=-1 无限循环）；AudioComponent 播原声；ARVideoAudioController（编辑器内置组件，参数 playOriginalAudio_target、originalVolume_target、videoTexture_target）让原声跟着视频播。脚本里控制播放：texture.getControl() 的 play() / pause() / resume() / stop()，事件用 APJS.EventManager.getObjectEmitter(texture) 监听 APJS.Mp4Event.PlayBegin / PlayEnd 等；可视化脚本用内置节点「视频纹理播放器」。返回 added_objects（新对象名和 object_path）、package_folders（这次导入新建的资源）和 plane_guid（编辑器选中的「AR平面跟踪」）。之后 capture_preview 看位置和大小，save_project。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"ar_video_submit / ar_video_tasks 返回的 task_id（须 status=succeeded）。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":440},{"name":"ar_video_cancel","title":null,"description":"取消一个还在 running（或 unconfirmed）的 AR 视频生成任务，等同面板里的「取消生成」。取消确认后任务从记录里消失（cancelled=true）；取消前它已经结束时返回 cancelled=false 和结束时的 status。已经结束的任务（完成、失败、已取消）不能取消，直接报 AR_VIDEO_NOT_RUNNING。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"},{"name":"task_id","type":"string","required":true,"description":"要取消的 task_id。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":153},{"name":"face_warp_list","title":null,"description":"列出场景里所有「塑型画笔」组件（FaceWarpX，含猫脸/狗脸），返回 object_path、是否启用、每项画笔的序号与强度。官方 edit_by_dsl 的 set_component 命令改不了画笔强度，用 face_warp_set_intensity。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":135},{"name":"face_warp_set_intensity","title":null,"description":"修改「塑型画笔」强度（等同检查器强度滑块，0–100），只改强度、保留笔刷数据，可撤销。object_path 取 face_warp_list 的路径，或能唯一定位的末尾几段。省略 item_index 时改全部画笔项。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"intensity","type":"number","required":true,"description":"强度，0–100。"},{"name":"item_index","type":"integer","required":false,"description":"只改某一项画笔；省略时改全部。"},{"name":"object_path","type":"string","required":true,"description":"face_warp_list 返回的 object_path，或能唯一定位的末尾几段。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":197},{"name":"object_remove","title":null,"description":"删除一个场景对象（含子对象，可撤销），并找出只被它使用的工程资源：删除前后对比场景引用，删除前被引用、删除后不再被引用的即为孤儿（unused_paths 已合并到素材包文件夹，只含磁盘上存在的路径）。editor_only_paths 是素材放进场景时编辑器按对象名建的文件夹（如「复古清冷_滤镜」），只在编辑器里、尚未写到磁盘，对象删除后下次保存就会消失，不用删。delete_unused_resources=true 时一并删除 unused_paths（资源删除不可撤销）；默认只报告，可之后用 resource_delete_unused 删除。object_path 用完整层级路径或能唯一定位的末尾几段（渲染组本身请用官方 edit_by_dsl 的 delete_render_group 命令）。只删对象、不关心资源时官方 edit_by_dsl 也能删；要知道删完哪些资源没人用了，用本工具。","inputs":[{"name":"delete_unused_resources","type":"boolean","required":false,"description":"同时删除孤儿资源，默认 false（只报告）。"},{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"object_path","type":"string","required":true,"description":"对象的层级路径，如「面部拉伸/小屁桃_美型」，或能唯一定位的末尾几段。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":344},{"name":"resource_delete_unused","title":null,"description":"删除 object_remove 报告的 unused_paths（工程内相对路径的资源或素材包文件夹）。删除前再次核对：当前场景仍在引用的一律拒绝。资源删除不可撤销。","inputs":[{"name":"instance_id","type":"string","required":false,"description":"官方 list_instances 返回的 instance_id，与 project_path 二选一。"},{"name":"paths","type":"array","required":true,"description":"object_remove 返回的 unused_paths。"},{"name":"project_path","type":"string","required":false,"description":"目标工程的绝对路径。与 instance_id 二选一；只开了一个工程窗口时都可省略。"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":123}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-22T00:49:47.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"none","label":"No attestation","reason":null,"reasonLabel":null,"discovery":null,"discoveryLabel":null,"sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":124,"partial":false,"deprecated":null,"stale":43,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-08","recent":[{"id":"chg_01a200bb-0af9-75b4-9b8d-37f39115118c","kind":"score.total_changed","summary":"Trust score (71 → 72)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-22","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a200bb-0af9-75b4-9b8d-37f39115118c"},{"id":"chg_01a1f12f-3516-7a2c-9c02-609edebbd1ac","kind":"score.total_changed","summary":"Trust score (70 → 71)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1f12f-3516-7a2c-9c02-609edebbd1ac"},{"id":"chg_01a1e6ee-e304-7486-94fa-e2664d4ace47","kind":"score.total_changed","summary":"Trust score (69 → 70)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1e6ee-e304-7486-94fa-e2664d4ace47"},{"id":"chg_01a1dca9-bc12-71c4-997e-18d8953f6a61","kind":"score.total_changed","summary":"Trust score (68 → 69)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1dca9-bc12-71c4-997e-18d8953f6a61"},{"id":"chg_01a1d249-e3d3-7736-a0b2-a6ea7ef66fe4","kind":"score.total_changed","summary":"Trust score (67 → 68)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1d249-e3d3-7736-a0b2-a6ea7ef66fe4"},{"id":"chg_01a1cd23-622c-7317-a869-13208d2ea0b8","kind":"check.reverified","summary":"Security disclosure (unverified → fail)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1cd23-622c-7317-a869-13208d2ea0b8"},{"id":"chg_01a1c9a1-adaa-78ed-aacb-35870ea39afa","kind":"check.verdict","summary":"Stability (0.07 → fail)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c9a1-adaa-78ed-aacb-35870ea39afa"},{"id":"chg_01a1c9a1-adad-713a-bcc2-e9667b682896","kind":"check.measure","summary":"Schema quality (13609 → 28227)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c9a1-adad-713a-bcc2-e9667b682896"},{"id":"chg_01a1c9a1-adad-7e4d-afb3-f30446218732","kind":"check.unverifiable","summary":"Security disclosure (fail → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c9a1-adad-7e4d-afb3-f30446218732"},{"id":"chg_01a1c9a1-adae-7bbc-8ab3-aa8c4d998b71","kind":"package.version_changed","summary":"Package version (0.7.0 → 0.9.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c9a1-adae-7bbc-8ab3-aa8c4d998b71"},{"id":"chg_01a1c2e6-e448-7a09-a672-50d1bb8280a0","kind":"check.reverified","summary":"Stability (unverified → 0.07)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c2e6-e448-7a09-a672-50d1bb8280a0"},{"id":"chg_01a1c2e6-e44a-7f15-9fcc-3fd1062d14b5","kind":"score.total_changed","summary":"Trust score (66 → 67)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1c2e6-e44a-7f15-9fcc-3fd1062d14b5"},{"id":"chg_01a1bda4-7729-7c82-9f57-00ba5bab488a","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1bda4-7729-7c82-9f57-00ba5bab488a"},{"id":"chg_01a1bda4-7731-78d9-84c5-48c4a0607592","kind":"check.reverified","summary":"Known CVEs (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1bda4-7731-78d9-84c5-48c4a0607592"},{"id":"chg_01a1bda4-7733-70ee-a641-a249d3cdbc36","kind":"check.reverified","summary":"Dependency health (unverified → 0.83)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1bda4-7733-70ee-a641-a249d3cdbc36"},{"id":"chg_01a1bda4-7735-74d9-a2ac-4e07edcccff3","kind":"score.total_changed","summary":"Trust score (40 → 66)","materiality":"functional","direction":"improvement","scoreDelta":26,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1bda4-7735-74d9-a2ac-4e07edcccff3"},{"id":"chg_01a1b949-d638-789b-8c22-11a104870776","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-08","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1b949-d638-789b-8c22-11a104870776"},{"id":"chg_01a1b90e-7107-7774-bd5c-65e1939824e9","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-08","url":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus#chg-chg_01a1b90e-7107-7774-bd5c-65e1939824e9"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus/changelog.json"},"links":{"html":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus","markdown":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus.md","changelogJson":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus/changelog.json","changelogRss":"https://verifymcp.io/servers/muqian-sun-xiangsu-mcp-plus/muqian-xiangsu-mcp-plus.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/@muqian/xiangsu-mcp-plus"},{"label":"Socket report","href":"https://socket.dev/npm/package/@muqian/xiangsu-mcp-plus"},{"label":"Repository","href":"https://github.com/Muqian-Sun/xiangsu-mcp-plus"}]}}