# 短剧制作导演插件安装说明

版本：1.1.0

## 运行要求

- DeepSeek Harness / DSH Desktop：与插件 `peerDependencies` 兼容的 `0.2.0-rc.2` 环境。发布包按桌面版本地插件格式提供，包含 Host、Client、Preset 和随包技能。
- ComfyUI 不是安装插件的必要条件；剧本、分镜、视频提示词和 H3 转换可先使用，图片/视频生成需要本机可发现的 ComfyUI 或已配置的云端实例。
- Windows 是当前完整支持桌面安装与实例启停的目标平台；其他系统可安装并使用不需要启动本地 ComfyUI 的功能，但 `.bat` 启动器与 Windows 进程管理不可用。

## 安装

1. 将 ZIP 解压到一个固定目录，不要直接在压缩包内运行。
2. 打开 DSH 的“插件管理”，选择安装本地插件，目标为解压后的 `dsh-plugin-short-drama-director` 文件夹。
3. 安装后确认组合包 `dsh-plugin-short-drama-director` 已启用，并按 DSH 提示重启应用。
4. 新建会话时选择“短剧制作导演”预设；输入 `/drama` 可切换到短剧模式，左侧“创作台”用于分镜、资产、H3 与生成。

命令行安装时可使用：

```text
plugin_manager action=install_bundle target="<解压目录>\dsh-plugin-short-drama-director"
```

## 首次使用

- 插件不会写死 ComfyUI 路径，会按用户配置、环境变量、历史记录和本机目录现场发现实例。
- 未发现 ComfyUI 时，仍可使用分镜和提示词功能；生成前先完成本机安装或云端连接。
- 不要把 `cordis.patch.yml` 里的 `insert` 行复制到用户 profile。预设已经随插件发布，重复插入会让 DSH 进入 Recovery。

## 数据与升级

插件代码和内置技能升级时，不会覆盖 `%DSH_HOME%\short-drama\user-data\` 中的流程记忆与用户定制。发布包不包含任何用户项目、资产、生成结果或本机路径。

## 包内容

- `index.js`：Host 入口与短剧模式工具注册。
- `client.js`：左侧创作台。
- `cordis.patch.yml`：Host 行与“短剧制作导演”预设。
- `lib/`：工作流、资产、分镜、H3、媒体与持久化实现。
- `skills/`：12 个内置技能。
- `vendor/adm-zip/`：读取用户 `.docx` 提示词所需的本地运行依赖。