dsh-skill-filmora-2026

dsh-skill-filmora-2026

给 DeepSeek Harness 用的 万兴喵影 2026 视频剪辑 skill（Wondershare Filmora 15，Windows 中文版）。

装一次，agent 就多了一套「看屏幕 → 认界面 → 动键鼠 → 再截图核对」的剪辑能力：导入素材、在时间线上剪辑、加转场/文字/特效、导出 MP4，并在交付前核验成片。它不依赖喵影的任何 API（喵影也没有公开 API），全部走 GUI 自动化 + 视觉核对。

它能做什么

• 计划驱动剪辑：先用脚本把剪辑决策算成数据（节拍/BPM、镜头时长、时间线位置、理由），再在喵影里执行；不靠"凭手感拖拽"
• 接管已打开的喵影：自动找窗口、识别界面状态（home/editor/登录/导入/导出/保存对话框）、截图（多屏/高 DPI）
• 导入素材：Ctrl+I + 剪贴板粘贴绝对路径（中文路径也稳）
• 时间线编辑：按秒精确摆放（place）、拖素材、分割 Ctrl+B、删除、复制、撤销、逐帧、缩放
• 文字/转场/特效/音频：切面板、拖模板，按截图核对
• 导出：Ctrl+E 打开导出窗，改标题/路径/格式/分辨率；wait-file 等导出完成
• 成片 QC 质量门：qc_export.py 机械核对时长/分辨率/帧率/音轨电平/黑场/冻帧，出 9 帧接触表；不过就修，最多 3 轮
• 工程检查（只读）：wfp_probe.py 读 .wfp/.wfpx：版本、素材清单、缺失素材、时间线轨道/片段摘要、缩略图导出
• 自动探测安装位置：注册表扫描万兴喵影/Filmora（不写死盘符），区分 2026 版与旧版
• 中文输入：内置剪贴板粘贴，绕开输入法/中文输入问题

智能层（v0.2 新增）

借鉴了公开的 video-edit-agent、dsh-creative-studio、dsh-video-pipeline、guikit、FilmoraMCP/automate-filmora 的做法：

1. 规划 → 执行 → 验收 三段式，每段有机器可验的完成判据（plan.json 校验、截图差异、QC pass）
2. 能算成数据的用脚本，只有界面状态才用 GUI：转码/抽帧/时长核对不下放给点击
3. 看-判-动-验 循环：单步动作、动作后截图复验、连续 3 次无变化即停、单类操作上限 12 步
4. 状态机 + 失败→修复对照表：点击无反应、弹窗、坐标错位都有确定恢复路径
5. 质量门：导出后机械 QC + 视觉接触表，warn 要解释、fail 必修
6. 工程格式情报：实测记录 15.6 .wfpx 内部结构（project_info.json / timeline.wesproj / medias_info.json），为 v0.3「写工程」路线铺路

实测环境

官方图文教程已更新到 V16（2026-09），与本机 15.6.4 有版本差；界面/键位变化时按 skill 里的「重新校准」流程更新坐标。

安装

只想让"所有项目/所有会话"都能用 → 装到用户级技能根（推荐，无需重启）：

powershell -ExecutionPolicy Bypass -File install.ps1            # 默认 User 作用域
# 等价于把 skills/filmora-2026 复制到 %USERPROFILE%\.dsh\skills\filmora-2026

装好后任意工作区的新会话都能看到 filmora-2026；只装到某个项目的 .dsh/skills/ 则只有那个项目可见（见下表优先级）。

方式一：作为 DSH 插件（可随 profile 升级/卸载）

dsh plugin --profile web add dsh-skill-filmora-2026   # 从 npm
# 或从 GitHub 源码
dsh plugin --profile web add github:<your-name>/dsh-skill-filmora-2026

装完重启 DSH（或在设置 → 插件里确认已加载），会话技能目录里会出现 filmora-2026。

官方 Desktop 应用请在 设置 → 插件 里安装；CLI 命令用于 dsh web 等 profile。

方式二：只装 skill 文件夹（不装插件）

把 skills/filmora-2026/ 整个目录复制到任一技能根：

技能目录会被监视，新增/修改无需重启；SKILL.md 的 references/、scripts/ 子目录里的资源按需读取。

确认是否生效

1. 在任意工作区新开会话，问一句「列出你当前可用的 skill」——应该能看到 filmora-2026。
2. 看不到时依次检查：
   • DSH_HOME（默认 %USERPROFILE%\.dsh）下确实有 skills\filmora-2026\SKILL.md；
   • 会话的工作区没有同名项目级 skill 覆盖（同名时项目级优先，内容应当一致）；
   • 重启一次 DSH（正常热加载不需要，但可强制重扫）。
3. 触发方式：会话里直接说「用万兴喵影把 X 剪成 Y」，或显式说「加载 filmora-2026 skill」。

使用

在会话里说「用万兴喵影把这个素材剪成 30 秒卡点视频并导出到 D:\out」即可；或显式要求加载 skill：

用 filmora-2026 skill 打开喵影，把 video_project/卡点视频_30s.mp4 导入并加一个标题，导出到桌面

前置条件（skill 会自动检查）：

1. 用户自己先打开喵影 2026 并登录。不要让 agent 从 DSH 沙箱里启动它：低权限进程会让 WebBrowser.exe（CEF）崩溃、主程序 20–40 秒后退出（已实测）。
2. 屏幕缩放 100% 最稳；其他缩放/分辨率下 skill 会先做一次坐标校准。
3. Python 3 + pyautogui、Pillow、pywin32、psutil（脚本 doctor 会自检并提示缺什么）。

已知限制

• 仅 Windows；仅针对万兴喵影 2026 / Filmora 15 实测，其他版本需重新校准坐标。
• GUI 自动化本质脆弱：喵影更新界面、换主题、改快捷键预设都可能失效；skill 里写明了「先截图再操作、每步核对、失败回退」的流程。
• 会员/云端/AI 付费功能不代操作、不代登录、不代付款。
• 不修改用户源素材，不覆盖导出文件（导出前会核对路径）。
• 截图与坐标基于 1920×1050 最大化窗口；其他尺寸用比例坐标或重新校准。

目录结构

dsh-skill-filmora-2026/
├── package.json                # DSH 插件清单（dsh.bundle.patch 指向 cordis.patch.yml）
├── cordis.patch.yml            # 把插件插入 profile 的补丁
├── lib/index.js                # ctx.skills.registerProvider 注册 skill（零依赖）
├── skills/filmora-2026/
│   ├── SKILL.md                # 主干：三条主线 / 路线选择 / 状态机 / 交付清单
│   ├── references/
│   │   ├── editing-workflow.md # 决策顺序 + 卡点/口播/批量/精修配方
│   │   ├── automation-protocol.md # 看-判-动-验、坐标、状态机、失败→修复
│   │   ├── qc-checklist.md     # 质量门判据、修复循环、报告模板
│   │   ├── ui-map.md           # 实测 UI 地图（区域/按钮/对话框）
│   │   ├── shortcuts.md        # 官方快捷键总表
│   │   ├── export.md           # 导出参数与常见坑
│   │   └── wfp-and-interchange.md # 工程格式实测 + 写工程路线 + FCPXML
│   ├── scripts/
│   │   ├── filmora_gui.py      # 截图/点击/按键/粘贴/拖拽/状态机/校准/按秒摆放
│   │   ├── edit_plan.py        # 测 BPM、生成/校验剪辑计划
│   │   ├── media_probe.py      # 素材探测、接触表、音频分析
│   │   ├── qc_export.py        # 成片质量门
│   │   ├── wfp_probe.py        # 只读检查 .wfp/.wfpx
│   │   └── fcpxml.py           # plan → FCP7 XML（实验）
│   └── evals/cases.md          # 触发/质量/恢复测试用例与实测证据
├── docs/
│   ├── publish.md              # 发布到 GitHub / npm / 插件市场的步骤
│   └── screenshots/            # 实测截图
├── install.ps1                 # 用户级/项目级安装脚本
├── scripts/sync-from-local.ps1 # 开发用：同步本机 skill 进本包
└── scripts/verify-local.mjs    # 本地模拟技能注册表校验

开发

本包的 skills/filmora-2026/ 由本地安装态同步而来（开发时直接改工作区 .dsh/skills/filmora-2026/，然后）：

pwsh -File scripts/sync-from-local.ps1

同步时会排除 .shots/、把本机绝对路径替换成占位符，避免把个人路径带进仓库。

调研与借鉴（v0.2）

• Agent Skill 写法：Anthropic《Equipping agents for the real world with Agent Skills》、agentskills.io 的 skill 最佳实践与脚本设计、Claude Code skills 文档：description 即触发指针、SKILL.md 精简到 <500 行、细节按需放 references/、确定性逻辑固化为脚本、用评估用例对比开/关基线。
• GUI 操作可靠性：Claude Code computer-use 文档、OpenAI/Azure computer-use 工具契约：优先非 GUI 工具、截图→单步动作→再截图验证、坐标与截图同源、max_iterations 防死循环、失败后重新观察而不是重试、窗口隔离。
• 视频剪辑 skill：公开的 video-edit-agent（素材清点 → 计划 → 校验 → 渲染 → QC → 修复循环 → 交付报告）、dsh-creative-studio（--json、能力分层、硬闸门）、dsh-video-pipeline（质量门通过才发布）。
• Windows GUI 插件：dsh-guikit（防幻觉七态、gui_verify 三态）、deepseek-computer-use（快照 TTL、失败强制重观测）。
• 喵影专用自动化：FilmoraMCP（从素材生成 .wfp、打开验证、内容体检）、automate-filmora（filmora_wfp validate/map/diff、explain-plan→apply→复验）——本 skill 的 v0.3「写工程」路线即按此方法论规划。

上架技能中心（awesome-dsh-plugin）

https://github.com/awesome-dsh-plugin/awesome-dsh-plugin 收录方式：一个 PR 只加一个 YAML 文件（data/plugins/<owner>__<repo>.yml），README 由官方脚本生成，不要手改。

仓库满足官方硬性要求：package.json 声明 dsh.bundle + 根目录 cordis.patch.yml + 真实代码；另带 screenshots.json（1 张编辑器截图）供市场详情页展示。

投稿步骤、可直接复制的 YAML、CI 逐条对照，见工作区的 submission-awesome-dsh-plugin/。要点：

1. GitHub 建 public 仓库 dsh-skill-filmora-2026，push 本包，加 topic dsh-plugin
2. 仓库创建满 1 天后才能提 PR（官方 CI 硬门槛）
3. fork 官方列表仓库 → 加 data/plugins/<你的用户名>__dsh-skill-filmora-2026.yml → 提 PR
4. npm 可选：npm publish --access public（能显示下载量；repository 字段要指回 GitHub 仓库）

许可证

MIT，见 LICENSE。

免责声明：本包为第三方社区项目，与万兴科技（Wondershare）无隶属关系。安装插件等于运行第三方代码，权限与本人相同；GUI 自动化可能误操作，请先在小工程上试跑，重要工程先备份。