纸上小导演 · Paper Director

把孩子自己的故事、照片、台词和一整段配音，做成一部可以观看、修改和导出的剪纸小电影。

v0.1.0 预览版：独立的 DSH 插件＋儿童创作工作室，面向成人监督的本机使用。支持整段录音、Agent异步制作接续、试听确认剪辑和真实MP4导出。请先读 安装步骤、版本范围 和 验证说明。发布状态与源码版本以 GitHub Releases 为准。

先看一遍，再开始

约 8 秒关键帧导览，不是实时制作耗时。真实隔离 UI＋真实 Core 渲染；全部使用匿名几何图片、合成音调和人工时间标记，没有真人麦克风录制、真实 ASR 或收费模型调用，不是“全自动 AI 真人演示”。GIF 无音轨；演示图片在仓库查看，不随安装包分发。

• 成人第一次安装：图文上手 → 完整安装与安全说明。
• 准备 Python / 模型：配置关系图与完整示例；本地 ASR 可选，没有模型也能为同一段录音人工标时。
• 陪孩子做第一部电影：构思、排图与整段录音 → 试听、看电影与修改。

由成人确认原 GUI 使用的真实 Profile 与 DSH_HOME，替换 <真实profile> 后执行（会联网并修改该 Profile 的依赖）：

dsh plugin --profile <真实profile> add github:cloga/dsh-paper-director#v0.1.0 --ignore-scripts

这只安装插件包，用户 preset 仍须从审核过的源码/解压包普通目录单独安装，不能修改 shipped preset 或覆盖已有目标。随后配置 Python、完成成人验收，重启原 Profile并刷新原 GUI；不要另起服务器冒充更新完成。详细步骤与两张解释型安装/配置图见 图文上手。

创作流程

1. 孩子先有故事构思。
2. 拍摄并排列照片。
3. 为每张图填写角色对白和必要动作说明。
4. 录制或上传一整段配音，不强制逐幕录音。
5. Agent 帮忙对齐、加漫画对白、选过场/音效、补头尾并制作视频。
6. 孩子观看后说“这里停太久”“这句是另一个人说的”，工具做可撤销的局部修改。

原则：丰富表现，不擅自改故事。 作者说明、确认台词、实际录音和ASR观察分开保存；听不清的声音不能自动当作静音删除。

项目形态

• 正式 Cordis/DSH Host 插件，持久化作品与版本。
• 独立同源儿童 Web 工作室 /paper-director/，DSH侧栏只增加轻量入口。
• 受限 Agent preset，仅能操作所绑定作品，不暴露通用终端、任意文件读取或凭据。
• 独立 Python 媒体内核：真实格式探测、可选本地ASR、共享画面渲染、H.264/AAC MP4。
• 所有插件页面、API和媒体地址都必须经过 DSH 当前 connection.requestRejection() 的鉴权/跨站检查。

开发验证

Node.js 22.19+（当前测试24.x），Python 3.11+。兼容基线为 DSH 0.1.2-rc.1 / Cordis 4.0.2。侧栏插件只使用宿主共享的 React.createElement，已分别验证 React 18.3.1 和 19.2.8；当前安装版浏览器 seed/生产依赖闭包是18.3.1，SDK根开发依赖是19.2.8，不能把两者混为同一个运行实例。

当前安装版 SDK 的 Cordis 4.0.2 尚不能从已配置的 npm registry 安装（ETARGET）。不会静默降级SDK，也不提供镜像绕过。 在已有对应 DSH 安装的开发机上，可显式链接该SDK：

node scripts/link-sdk.mjs /path/to/installed/dsh/node_modules
npm test

脚本核对每个依赖的真实版本，只写本仓库被忽略的 node_modules，不修改DSH安装。

python -m venv .venv
# Activate .venv using your platform's usual command, then:
python -m pip install -r requirements.txt
python -m unittest discover -s tests/python -v
python tests/python/synthetic_demo.py --output-dir tests/python/.artifacts/demo
# Real Node application service → Python pipeline → revised MP4:
npm run demo

Python demo 使用新生成的匿名几何图片和音调；provided transcript 是显式测试输入，不冒充识别真实语音。真实ASR需要管理员准备本地模型，程序不自动下载模型或上传孩子的录音。

浏览器 UI 测试和媒体内核验证的边界分别见 UI测试说明 与 媒体验证。正式安装/打包步骤见 安装与验证，首次使用见 图文上手，底层接入协议见 DSH集成。

隐私与素材

• 不包含开发家庭的照片、录音、电影或密钥。
• 原始媒体不可变；修改产生新版本，可恢复。
• 媒体探测、录音对齐和渲染在本地运行，不自动上传原始录音。点击“交给导演助手”后，故事、台词、分镜说明及转写文本会提供给家长配置的 DSH 模型；该模型可能是云端服务。 这不等于所有信息都离线处理。
• Azure旁白默认关闭，只在成人配置后发送批准的文本，不发送完整录音；每日5000字符保护仅针对旁白，Agent模型调用费用由DSH配置管理。
• 内置星光与提示铃是原创合成音效（生成声音数据CC0-1.0），无需联网；可用 style.soundEffects: false 关闭。导入其他声音须明确来源与授权。
• 自动技术检查不等于人工听感审核；录音时序采用已解码采样的顺序，遇到异常容器时间戳会提示核对。
• 首版用于成人监督的单家庭/本机环境。 受限Agent不等于浏览器或操作系统的儿童沙箱；共享DSH登录仍具有宿主本身的权限。不要当作独立儿童账号或公网多用户平台部署。

License

MIT。第三方运行库、字体和用户自行导入的素材各自遵守其许可。