luoyuejun9/dsh-cinematic-workflow

项目介绍Project Overview

本地优先、人工把关的电影工作流插件,将旅行影片导演流程转为DSH插件:媒体清单、创意方向、粗剪交付、FCPXML、Resolve交接、字幕与QC。每个阶段须人工确认才能推进。适合剪辑师或导演管理影片项目。注意:不自动导入NLE,需手动交接。

A local-first, human-gated cinematic workflow plugin for DeepSeek Harness. It structures a travel-film directing process into stages—media inventory, creative direction, rough cut, grade, finishing, and delivery—each requiring explicit human confirmation via /cinema continue before advancing. Use it to manage film projects with clear deliverables and provenance tracking. Note: it generates FCPXML and Resolve handoff files but does not auto-import into NLEs.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:luoyuejun9/dsh-cinematic-workflow

luoyuejun9/dsh-cinematic-workflow 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-cinematic-workflow

Local-first, human-gated authorial film workflow for DeepSeek Harness.

It turns a cinematic travel-film directing workflow into a real DSH plugin: media inventory, creative direction, rough-cut deliverables, import-ready FCPXML, Resolve handoff, restrained copy/subtitles, QC and delivery records. It is intentionally not a mouse macro for Final Cut Pro or DaVinci Resolve.

The central rule is enforced in code: a stage never advances unless a human runs /cinema continue <project-id> and the current stage has its required deliverables. Models cannot approve, skip, merge, or pre-run future stages.

Install

dsh profile install npm:dsh-cinematic-workflow

Restart or reload the DSH profile after installation. The package targets DSH 0.1.0-rc.6; Harness is a developer preview, so pin compatible versions when upgrading.

Quick start

/cinema doctor
/cinema start "/path/to/footage" --title "My film" --preset travel-authorial
/cinema run <project-id>

Review the current stage. Record creative choices without moving forward:

/cinema choose <project-id> theme "freedom"
/cinema choose <project-id> arc "arrival → release → quiet afterglow"
/cinema continue <project-id>

Workflow

Stage Required human-reviewed deliverables
Sample (optional) Style database
Analysis Media inventory, director notebook, creative baseline, chosen arc
Rough cut EDL, FCPXML, sound plan, director review
Grade Grade brief, Resolve return artifact
Finishing Copy script, subtitles, finishing timeline
Delivery QC report, delivery manifest

Use /cinema status, /cinema validate, /cinema revise, and /cinema attach at any time. /cinema run queues only the current stage; it cannot advance the project.

Media and NLE integration

  • The base inventory is automatic metadata collection only; it never claims to have viewed complete footage.
  • Install FFmpeg/FFprobe if you want to add external contact-sheet or QC helpers in your own workflow. The plugin remains usable without it.
  • cinema_build_fcpxml generates FCPXML 1.14 from a reviewed EDL. It does not import it into Final Cut Pro.
  • Resolve v0.1 produces a handoff brief; you import/export in Resolve and attach the returned file with /cinema attach.
  • Source media is never moved, renamed, transcoded, overwritten, or uploaded.

Privacy and provenance

Project records live in <workspace>/.dsh/cinematic/ and are intended to be gitignored. Artifact observations are labelled automatic, model-inference, human-confirmed, or unresolved. Do not publish project folders containing private absolute paths, GPS data, face metrics, or personal media.

Creative principle

Priority is: creator expression > story > audience emotion > shot language > sound > colour > editing technique > software operation. The bundled travel-authorial preset prefers first-person observation, breathing room, environmental sound and restrained copy over tourism, advertising, flashy transitions or constant music.

Development

npm install
npm run check
npm pack --dry-run

MIT licensed. Chinese documentation: README.zh.md.

上一个 Prev dsh-launcher 下一个 Next dsh-word-complete