DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-jianying-plugin

C

dsh-jianying-plugin

Manifest valid★ 2

DeepSeek Harness plugin for safe Jianying Pro editing: subtitles, audio, transitions, export, one-shot diagnostics, readback receipts. Windows + MIT.

hasBundlePatch
dsh-jianying-plugin

dsh-jianying-plugin

让 DeepSeek Harness 真正剪得动剪映草稿

字幕 · 音频 · 转场 · 导出 · 回读 · 编辑回执

CI Pages Release License: MIT Windows

项目主页 · 快速安装 · 工具矩阵 · 安全机制 · English · 最新版本

dsh-jianying-plugin

这是一个能让 DSH 操作真实剪映草稿的开源插件。

它不直接修改加密的 draft_content.json,而是连接剪映正在运行的授权 Custom Agent host,通过官方 DraftEditing 链路完成编辑,并在写入后回读草稿、生成可审计回执。

✨ 为什么值得试试

🎬 真的编辑草稿

不是生成一段剪辑建议,也不是做一个看起来像剪映的预览。插件直接操作用户正在使用的剪映草稿。

🛡️ 两阶段写入

先读取,再规划;只有用户明确确认后才执行。计划成功不等于草稿已修改。

🔎 可回读、可追溯

写入前后采集草稿哈希,读取 canonical 状态,并生成 JSON / Markdown 编辑回执。

🩺 一键诊断

jianying_doctor 会检查安装、CLI、草稿表、剪映进程、授权 host 和 Agent 会话,并告诉你下一步怎么修。

🚀 快速开始

环境要求

项目要求
系统Windows 10 / 11 x64
DSHDSH Desktop
剪映剪映专业版,已安装并至少启动或登录过一次
剪映能力Custom Agent host 可用
开发环境Node.js 22+

一键安装

打开 PowerShell:

irm https://raw.githubusercontent.com/CN-PA/dsh-jianying-plugin/main/scripts/install.ps1 | iex

安装脚本会:

  1. 获取 GitHub 最新 Release;
  2. 校验附件 SHA-256;
  3. 下载插件;
  4. 安装到 DSH desktop profile。
自定义 profile 或 DSH 安装路径
.\scripts\install.ps1 `
  -Profile github-test `
  -DshCommand 'F:\dsh\resources\runtime\cli\bin\dsh.cmd'
手动安装

从 Releases 下载 .tgz:

dsh plugin --profile desktop add file:F:/Downloads/dsh-jianying-plugin-0.3.0.tgz

或者直接从仓库安装:

dsh plugin --profile desktop add github:CN-PA/dsh-jianying-plugin

第一次使用

  1. 启动剪映专业版。
  2. 打开一次剪映 Agent 面板,让授权 host 和会话存在。
  3. 在 DSH 中调用:
jianying_doctor
  1. 所有检查通过后,对 DSH 说:
列出我的剪映草稿,检查最新草稿,并只读回读。

🧭 工作流

flowchart LR
    A[DSH Tool] --> B[授权 Custom Agent host]
    B --> C[Director / Editing Agent]
    C --> D[DraftQuery]
    D --> E[生成可审阅计划]
    E --> F{用户确认}
    F -->|plan 阶段| G[不写入]
    F -->|apply + confirm| H[DraftEditing]
    H --> I[canonical 回读]
    I --> J[备份 / 哈希 / 回执]

🛡️ 安全机制

不碰加密草稿内部格式,不跳过剪映授权边界。

  • mode=plan 只创建计划,不写入草稿。
  • mode=apply 必须显式传入 confirm=true。
  • 运行期额外权限默认不自动批准。
  • apply 前默认备份草稿 JSON。
  • 写入后对比文件哈希并回读 canonical 状态。
  • 导出默认拒绝覆盖已有文件。
  • host token 不返回给模型、不写入日志、不保存到回执。
  • 部分完成或失败不会被报告成“成功”。
读取草稿
  → 规划最小范围修改
  → 用户确认
  → 授权 DraftEditing 应用
  → 回读核对
  → JSON + Markdown 回执

🧰 工具矩阵

工具能做什么
jianying_doctor一次检查完整环境,返回逐项状态与修复建议。
jianying_status查看剪映版本、CLI、草稿注册表、进程和能力。
jianying_drafts列出、检查或启动剪映草稿。
jianying_host查看 host、会话、草稿回读、run 状态,取消任务。
jianying_edit通用高级编辑:计划或应用。
jianying_subtitle添加、更新、删除字幕。
jianying_audio音量、裁切、淡入淡出。
jianying_transition添加、更新、删除转场。
jianying_export导出草稿,默认不覆盖已有文件。
jianying_receipt列出或读取编辑回执。
jianying_cli官方 Agent CLI 的查询、规划、校验和受保护 apply。

🎬 支持的高级操作

时间单位统一为毫秒。音频音量使用剪映范围 0..1000,100 表示原始幅度。

类型操作
字幕subtitle.add、subtitle.update、subtitle.remove
音频audio.set_volume、audio.trim、audio.fade
转场transition.add、transition.update、transition.remove
导出export
查看一次组合编辑示例
[
  {
    "kind": "subtitle.add",
    "text": "欢迎观看",
    "start_ms": 0,
    "duration_ms": 2000
  },
  {
    "kind": "audio.set_volume",
    "segment_id": "audio-segment-id",
    "volume": 65
  },
  {
    "kind": "transition.add",
    "segment_id": "video-segment-id",
    "transition_name": "叠化",
    "duration_ms": 500
  }
]
先规划,不写入
{
  "draft_id": "DRAFT-ID",
  "mode": "plan",
  "operations": [
    {
      "kind": "subtitle.add",
      "text": "测试字幕",
      "start_ms": 0,
      "duration_ms": 1500
    }
  ]
}
用户确认后应用并回读
{
  "draft_id": "DRAFT-ID",
  "mode": "apply",
  "confirm": true,
  "operations": [
    {
      "kind": "subtitle.add",
      "text": "测试字幕",
      "start_ms": 0,
      "duration_ms": 1500
    }
  ]
}

更完整的字幕、音频、转场、导出和回执示例见 中文详细文档。

📋 编辑回执

默认保存在:

F:/Codex/.dsh-jianying-plugin/
├── backups/       # 写入前草稿 JSON 备份
└── receipts/      # JSON + Markdown 编辑证据

每次 apply 会记录:

  • 草稿 ID、名称和路径;
  • 修改前后 revision hash;
  • 备份位置;
  • 请求的操作;
  • host task / run / plan ID;
  • canonical 回读结果;
  • 警告、失败和时间;
  • 实际操作的片段 ID 与时间范围。

⚙️ 配置

installDirs:
  - E:/JianyingPro
  - F:/JianyingPro
tempRoot: F:/Codex/.dsh-jianying-plugin
allowApply: false
allowHostApply: true
createBackup: true
hostPollIntervalMs: 2000
hostWorkflowTimeoutMs: 300000
  • allowApply:只控制旧版 jianying_cli apply-patch。
  • allowHostApply:控制新版高级编辑和导出。
  • createBackup:是否在 apply 前备份草稿 JSON。
  • hostWorkflowTimeoutMs:默认等待时间。

也可以手动指定 instanceId 和 sessionId,通常不需要。

💻 兼容性

已验证:

环境版本
系统Windows 11 x64
DSH Desktop26.1111.2228.0
剪映专业版11.7.0.14652
剪映专业版11.8.0.14778
Node CI22 / 24
CI 平台Windows / Linux

剪映 Custom Agent host 是否可用会受到版本、账号和灰度发布影响。提交兼容性问题前,请先运行 jianying_doctor。

[!NOTE] 独立运行 lyra-cli.exe 会被剪映以 unauthorized host process 拒绝。这是上游安全限制,插件不会绕过它。

🧪 开发与测试

npm.cmd test
npm.cmd run check
npm.cmd run validate:manifest
npm.cmd run smoke
npm.cmd run smoke:host
npm.cmd run pack:release

当前覆盖:

  • 22 项自动化测试;
  • 模拟授权 host 的端到端 plan → confirm → apply → readback → receipt;
  • 真实剪映只读集成测试;
  • Windows / Linux、Node 22 / 24 公共 CI。

更多文档:

❤️ 参与项目

如果这个插件节省了你的时间:

  • ⭐ 给仓库一个 Star;
  • 🐛 提交剪映版本兼容、安装或编辑问题;
  • 💡 分享真实剪辑场景;
  • 🔧 提交字幕、音频、转场和导出相关改进。

反馈问题 · 参与讨论 · 查看项目主页

Built with care for DSH × 剪映专业版

MIT License · Windows only

Comments

Loading…

From the same category

awesome-dsh-plugin

by awesome-dsh-plugin

A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表

Development & Infrastructure

★ 25.1k

CC0-1.0

Python

Nov 18, 2026

Index only — not installable

by woniuniuniu

DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜

Workflow & AutomationTools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1.5k

↓ 8.2k/wk

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add dsh-media-desk

by 0xsline

DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from dsh-external/hub and the public dsh-plugin topic.

Development & Infrastructure

★ 1.4k

CC0-1.0

Python

Nov 6, 2026

Index only — not installable

by keli-wen

Hire Google's Antigravity CLI (agy) as a fast Gemini staffer for Claude Code, OpenAI Codex, and DeepSeek Harness.

Development & InfrastructureManifest valid

★ 893

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile agent add agy-staff

by Roland0511

MarkText (muya) WYSIWYG Markdown editor for the DeepSeek Harness right sidebar

Tools & CapabilitiesUI & ExperienceDevelopment & InfrastructureManifest valid

★ 840

↓ 2.8k/wk

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-marktext

by SAOS-3624

Scene-aware storyboard for DeepSeek Harness: 9-16 numbered cells with timestamps + transcript + an audio envelope, packed into ONE image (384 tokens). Two tools: video_storyboard and video_zoom.

Tools & CapabilitiesVision & MultimodalDevelopment & InfrastructureManifest valid

★ 575

↓ 17k/wk

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-video-storyboard