@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/docvideoer/SKILL.md

@@ -1,139 +0,0 @@
----
-name: docvideoer
-description: "文档转视频技能。用于把文档 URL、网页文章、Markdown 或粘贴文本转换成带中文旁白的 AICUT 讲解视频，包含正文提取、分镜生成、免费 TTS、视频项目搭建和 MP4 渲染。 Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: MIT
-source: "coding-ax/docvideoer"
----
-
-# docvideoer
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-Use this skill when the user asks to turn a document, article, URL, Markdown
-file, or pasted text into a narrated explainer video. Trigger phrases include
-`/docvideo`, "把这个文档转成视频", "根据这篇文章生成视频", and similar requests.
-
-## External Skill Dependency
-
-This skill depends on Remotion's official `remotion-best-practices` skill for
-Remotion-specific implementation guidance. When creating, debugging, or changing
-the Remotion project, scene components, timeline, animation, audio sync,
-captions, assets, or rendering flow:
-
-- Use the installed `$remotion-best-practices` skill if it is available.
-- If it is not available, tell the user to install it with:
-  `npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices`.
-
-## Output Layout
-
-Create each generated project under:
-
-```text
-docvideo-output/<project-name>/
-```
-Expected files:
-```
-```text
-source.md
-storyboard.json
-tts-batch.json
-audio/
-video/
-output.mp4
-output-with-subtitles.mp4
-```
-Use a short, filesystem-safe project name derived from the document title or
-topic.
-```
-
-## Workflow
-
-1. Get document content.
-   - For URLs, run `node scripts/fetch-doc.mjs <url> --out docvideo-output/<project-name>/source.md`.
-   - For pasted text, write it to `source.md`.
-2. Generate `storyboard.json`.
-   - Extract the document's core points.
-   - Use concise scenes, each focused on one idea.
-   - Estimate Chinese narration at about 4 characters per second.
-   - Use scene types: `title`, `content`, `bullet`, `image`, `end`.
-3. Synthesize TTS.
-   - Prefer `npm run docvideoer -- tts --storyboard docvideo-output/<project-name>/storyboard.json --audio-dir docvideo-output/<project-name>/audio`.
-   - Default backend is Edge TTS; on macOS, `say` can be used as fallback.
-4. Set up the Remotion project.
-   - Run `npm run docvideoer -- setup --storyboard docvideo-output/<project-name>/storyboard.json --audio-dir docvideo-output/<project-name>/audio --video-dir docvideo-output/<project-name>/video`.
-5. Render the video.
-   - Run `npm run docvideoer -- render --video-dir docvideo-output/<project-name>/video --out docvideo-output/<project-name>/output.mp4 --install`.
-6. Report the result.
-   - Provide the final MP4 path.
-   - Provide `storyboard.description`.
-   - Mention any optional step that failed, such as subtitle generation.
-
-## Storyboard Contract
-
-Scene IDs must match audio filenames. For example, `scene-1` expects
-`audio/scene-1.mp3`.
-
-```json
-{
-  "title": "视频标题",
-  "description": "视频简介",
-  "totalDuration": 120,
-  "scenes": [
-    {
-      "id": "scene-1",
-      "type": "title",
-      "title": "场景标题",
-      "narration": "讲解文案",
-      "duration": 8,
-      "visuals": {
-        "type": "title",
-        "title": "大标题",
-        "subtitle": "副标题"
-      }
-    }
-  ]
-}
-
-## Defaults
-
-- Resolution: 1920x1080
-- Aspect ratio: 16:9
-- FPS: 30
-- Codec: H.264
-- Remotion composition ID: `DocVideo`
-- Default Edge TTS voice: `zh-CN-XiaoxiaoNeural`
-
-## Source
-
-Rewritten for AICUT from [`coding-ax/docvideoer`](https://github.com/coding-ax/docvideoer)
-(MIT), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/draftcut/SKILL.md

@@ -1,104 +0,0 @@
----
-name: draftcut
-description: "Turn natural speech into a refined original-voice narration and a polished video. Review the full spoken manuscript in the conversation, then automatically deliver a clean original-voice video after explicit approval. Graphic packaging is a separate stage with its own director-script approval. Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: MIT
-source: "PoetCoderJun/MotionTalk"
----
-
-# DraftCut
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-自然说话 → 对话中审核完整文稿 → 批准后自动交付干净成片 → 按需审核导演脚本 → 包装成片。输入一份录音或一支口播视频，可选素材和参考片；保留用户声音，不用 TTS 补词。所有工作放入新的独立项目目录，原片不覆盖。
-
-## 从一句请求开始
-
-用户只需说“请使用 DraftCut 的 Skill，把这个文件做成一个视频。我想要的样式和风格是……”。以下流程、独立目录、原声保护、两道审核由本 Skill 默认负责，不要求用户补写操作步骤。Agent 自选新的项目目录；风格缺少细节时结合内容提出一个方案，不为可选偏好连续追问。已有可靠转写和健康依赖优先复用。
-
-DraftCut 是本次专用工作流的负责人，HyperFrames 用作底层制作与渲染。按需要读取 HyperFrames 的结构、动画和 CLI 规范；没有外部 HyperFrames Skill 时，使用本仓库 references 与锁定 CLI 的 `--help`，不依赖作者安装的私有 Skill，不另启一套重复的用户创意访谈；将本次已有素材/风格写入工程 brief，后续问题集中在可读提案的必要取舍上。
-
-直接在当前命令行／Codex 对话正文中输出完整可读稿件、简短删改理由和导演方案，不能只给文件路径或下载链接代替正文。用户以自然语言确认具体版本；不另建展示网页或操作平台，不把内部 hash、JSON、目录规划、测试签名命令当作用户的制作工作。内部证据由 Agent 管理。干净成片阶段按宿主 Agent 读取到的真实、直接用户消息确认：完整文稿已展示后，用户明确批准当前版本，就在同一任务继续生成干净成片，不再要求终端签名或额外“开始／继续”指令。含修改条件、含糊回复、历史无关批准、Agent自审或模拟用户均不算批准。工程中的对话审计记录仅供追溯，不是加密回执，不能宣称为可信宿主签名。现有签名版 HyperFrames 包装路径仍按[审批设置](docs/approvals.md)和[对话批准边界`conversational-approvals.md`处理，不伪造其回执，也不把干净成片审计记录冒充为那条路径的签名。
-
-默认以**完整文稿审核**推进：通读逐词转写，输出精炼口播全文、删改依据、纠错疑点与完整重映射字幕。试听是可选辅助，不是审核包输出、用户文稿批准或后续制作的前置条件。没有音频感知能力时记录 `hearing=not-tested` 和真实的零试听时长，按全文文字复核与时间线检查继续；不得反复要求用户听完整原片或代理，也不得虚构试听。词语疑点结合已有草稿、授权范围内的ASR结果及用户确认解决，未解决的明确标注。用户只要求文稿审核输出且明确不制作时，在输出完整文稿后停止；普通视频制作任务则在文稿获批后自动交付干净成片。用户只需要文稿时，必须把完整候选口播、简短删改理由和未解决词语直接输出到当前命令行／对话，不为展示另存一份文稿文件，不用文件路径或链接代替正文，不要求用户打开文件；内部审核包、SRT、代理与证据可按工程需要保存，不作为用户的阅读入口。
-
-## 明确授权的模拟用户测试
-
-仅在用户明确要求模拟使用者进行可用性测试、且工作环境提供独立 `draftcut.simulation-run.v1` 清单时启用。读取[隔离交互测试`simulation-testing.md`。真实素材仍只在本机处理；测试清单绑定该素材、run 和项目根目录。不要给真实录音加 `example_only`，也不要使用合成 fixture 身份。
-
-执行者仍从最简请求开始，按本文自行组织工作。向测试者提出普通用户能回答的问题，并在两道门分别停下；测试控制器记录模拟用户自然回复并签发独立模拟回执。回执始终标 `simulated-user`、`owner_approval=false`，不能用于生产导出。没有音频输入时可明确记 `hearing=not-tested`，继续测试交互、剪辑、制图和导出；不得伪称听过。默认只使用视频的原声音轨；仅选用人物画面时才在批准稿件中设置 `include_presenter=true`，人物画面仍使用同一时间线。
-
-测试视频必须使用 `--purpose simulation`，保存到本 run 内的 `TEST-*.mp4`，保留全程测试水印。技术报告、交互日志和完成答复均写明模拟用户/听感未测，不得称作真实 owner 批准或内容质量验收。生产、合成 fixture 和模拟用户测试三种来源分别验证，不互相转换批准。
-
-## 从仓库链接安装
-
-用户只需把仓库链接交给 Agent。安装或环境未知时，先读 [Agent 安装与健康检查](docs/agent-bootstrap.md)：检查并复用已有环境，在安全副本安装缺失依赖，运行本地健康检查并如实报告结果。由 Agent 执行配置，不向用户罗列终端安装命令或多个安装入口。按[配置与能力边界](docs/configuration.md) 区分本地依赖、可选 ASR 凭据、owner 签名及当前通道的真实视听能力；默认自动复用固定用户级 ASR 配置；先读取无密钥状态，只有缺配置且需要云转写时才引导一次安全输入，已有配置不再索取 key。`--env-file` 仅作可选覆盖，不扫描项目或父目录。沿用健康报告的 Python、PATH 和 `DRAFTCUT_CHROME`。系统权限、密钥及素材上传／费用仍须安全处理，不能因用户要求安装就代签审批或自动调用付费 ASR。
-
-## 文稿批准后自动交付，包装另行审核
-
-**口播稿审核 → 自动交付干净成片 → 按需审核视频脚本 → 包装成片**。干净成片不等待导演脚本，不自动进入包装。
-
-1. 读取 [口播精剪`00-audio.md`，通读全部逐词转写，结合全文上下文处理无意义口头禅、口误、改口、失败重说、冗余重复及停顿。默认保留最后一次完整自然表达；保留否定、数字、专名、有意重复、强调和思考停顿。机械候选不是自动删除清单。
-2. 每个词都有保留／删除决定和理由；改口、重说、移序及 ASR 纠错明确列出依据。字幕只能对应原声实际保留的词，不能总结、补写或靠改字幕伪装音频已编辑。剪点保留完整词级区间，以整数样本映射和字幕边界检查验证；可选试听不构成门槛。
-3. 生成明确标为审听用途的代理，完成全文文字语义复核与时间线检查，再生成完整口播稿、前后差异与重映射字幕。在当前命令行／对话直接展示完整精炼口播稿、简短删改理由和疑点，内部保留审核包，并停在第一道门。代理仅供可选核对，不能作为已批准的精炼音频或进入视觉制作。
-4. 用户明确批准已展示的完整文稿后，自动按[干净成片`04-clean-cut.md`生成同一时间线的原声精剪视频与外置字幕，不再要求终端签名或额外出片指令。画面保留原片构图和比例，不加MG、配乐、标题、滤镜或烧录字幕。音频只拼接原声，不变速、不做TTS。只有明确要求仅交文稿、不制作时才停止。
-5. 完成完整解码、音视频流／时长、帧分配、字幕边界、音频波形与必要视觉抽查后，交付 `edited-video.mp4` 与 `final-clean.srt`。这是可独立使用的干净成片，不是试听代理。
-6. 用户要求包装时，才在这版干净音视频与字幕时间线上生成完整导演脚本并在对话中展示，取得第二道批准后制作包装。现有签名版HyperFrames实现不能把对话审计记录当签名回执；独立干净交付不依赖这条旧包装入口。
-
-素材、转写、口播稿或文稿复核证据变化使第一道批准及下游失效；导演脚本、计划、素材变化使第二道批准失效。所有入口重新验证内容 hash、项目与修订代次；旧签名包装入口另外验证签名，重试不能复用过期批准。保留旧审核包与产物；改变后创建新版本。
-
-## 旧签名版包装路径的批准来源
-
-干净成片使用上一节的真实对话批准。以下仅描述仍保留的签名版包装工具链，不能反向阻止干净成片交付。
-
-`review_approval.py` 使用用户在 Agent 可写项目以外配置的公钥，验证用户保管的加密私钥签发的回执。Agent 不创建生产身份、不读取口令、不代签、不将 fixture 批准当生产批准。用户在自己的终端审阅完整审核包、确认精确摘要并签名；没有生产信任配置时可完成提案，不能声称批准或越过门禁。见 [审批设置](docs/approvals.md)。签名验证完整性与签发者，不证明听感或语义已正确。
-
-当前工程验证不得新增付费 API 调用。合成示例仅接受仓库规定的合成 PCM 与转写，使用独立测试签名，始终标 example；真实素材不走该路径。旧项目须按 [迁移](docs/audio-first-migration.md) 显式重新审核，旧布尔批准不继承。
-
-## 转写与语义复核
-
-内置 DashScope ASR 会上传音频且可能收费，运行前须有明确上传／费用授权；已有用户授权覆盖当前素材、有效期与预算时直接沿用，不为每个视频反复索取；超范围才补问。key 存在不代表授权；`--allow-cloud-asr` 不是授权来源。已有逐词转写可本地导入，必须核对源素材与内容。完整语义复核默认使用 `text-review`：通读原片与候选口播全部文字，逐词检查删改和字幕映射，并披露未试听。已有同模型代理转写时可用 `same-model-asr` 辅助比较，不自动新增调用，也不要求填满试听时长。用户确认的词语可作为纠错依据；试听只作为可选证据。具体数据与命令见 [口播精剪`00-audio.md`。
-
-## 画面创作
-
-逐步解决发布版式、核心创意、可选素材、风格与参考片。画面随论证展开，用 MG、图解、比较、演示解释重点，不只重复字幕。没有人物素材可全屏视觉叙事。参考用于理解表达，不复用未经许可的资产；数字、事实须有来源。
-
-使用锁定 Hyperframes 0.8.30、GSAP 3.14.2，Node >=22，Python 3.10+、FFmpeg 与本机完整 Chrome。主入口 `hyperframes/index.html`，单一批准音频 `assets/narration.wav`；DOM/SVG 字幕图形可编辑。GSAP 暂停、可 seek，注册 `window.__timelines.master`，不使用系统时钟、随机状态或远程字体。初始化只是 scaffold，完成内容创作和真实连续预览后才能 production 导出。固定单 worker；软件编码须明确选择。
-
-本机 `check`/`snapshot` 使用 `scripts/hf.mjs`，由入口自动配置完整 Chrome 与导航预算，见[制作`02-build.md`。私有素材的 snapshot 显式关闭外部图片分析。
-
-技术检查、视觉连续观看与可选试听分别记录；未试听标 not-tested，不阻断文稿审核或出片，不宣称听感已验收。保留全链路原声采样映射、完整词、SRT 毫秒边界、视频帧分配和解码报告。最终交付 MP4，可编辑工程和审核证据留在项目目录。其他私有业务不在本 Skill 范围内，不复制其代码、素材或凭据。
-
-## Source
-
-Rewritten for AICUT from [`PoetCoderJun/MotionTalk`](https://github.com/PoetCoderJun/MotionTalk)
-(MIT), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/draftcut/docs/agent-bootstrap.md

@@ -1,64 +0,0 @@
-# Agent 安装与健康检查 / Agent bootstrap
-
-**给执行 Agent 阅读。** 用户的唯一安装入口是把 https://github.com/PoetCoderJun/DraftCut 发给 Agent，要求安装配置并制作口播视频。不要让用户逐条执行下面的技术命令，也不要改成多个安装选项。安装结束后继续读取 [SKILL.md](../SKILL.md)；两次内容审核仍由用户完成。
-
-## 1. 找到安全的工作副本
-
-先读仓库 README、此文档和 SKILL。检查当前目录、已有安装、Git remote、分支与工作区。复用属于用户且版本合适的现有安装；有未提交改动或并行任务时，使用新的隔离副本，不能 reset、覆盖旧 Skill 或污染用户视频工程。不要仅凭目录名字判断仓库。
-
-需要新副本时，由 Agent 在选定的空路径执行：
-
-```bash
-git clone https://github.com/PoetCoderJun/DraftCut.git /chosen/empty/path/DraftCut
-cd /chosen/empty/path/DraftCut
-```
-
-记住实际安装路径；随后直接读取该路径的 `SKILL.md`。不要求用户理解安装目录、手工配置 Skill 发现机制或先运行另一个安装器。Agent 平台有自己的技能注册机制时，遵循该平台已知约定，并保留可直接读取 SKILL 的路径，不编造所有平台都已测试。
-
-## 2. 探测已有环境，补齐缺失项
-
-当前工作流使用 macOS/Linux POSIX、Python 3.10+、Node.js 22+、FFmpeg/ffprobe 和本机完整 Google Chrome。已实际验证 macOS，未认证所有操作系统／Agent。Apple Silicon 需要原生 ARM64 Node/Chrome。Hyperframes **0.8.30** 与 GSAP **3.14.2** 按锁文件安装；不升级，不自动下载 managed/headless-shell 浏览器。
-
-Agent 先用本机可用工具确认 Python/Node/FFmpeg/Chrome 的位置和版本，复用健康依赖。缺少系统组件时，沿用机器已有的可信软件管理方式安装或选择已有的正确版本；只对确实需要的系统权限／管理员操作请用户接手。不要自动安装新的系统包管理器、运行来源不明的下载脚本、换平台或让用户手工拼凑依赖。没有可用安装权限时准确报告缺少的组件与失败动作，继续完成不受影响的工作。
-
-由 Agent 运行：
-
-```bash
-python3 scripts/bootstrap.py --install
-```
-
-脚本使用项目 `.venv`，复用通过版本与依赖检查的 Python/Node 包；缺失或不符时执行项目内 `venv`、`pip install -r requirements.txt` 和锁定的 `npm ci`。不写全局 Python，不删除旧环境；已有不完整或伪装的 `.venv` 必须保留并改用安全副本。系统组件缺失会明确 blocked，交回 Agent 处理后重试。
-
-`--browser-executable /absolute/path/to/GoogleChrome` 只选择已经安装的完整 Chrome。脚本不会下载浏览器、创建审批身份、输出密钥或调用转写服务。安装命令可能访问 Python/npm 软件仓库，需要按执行环境的正常网络授权路径操作；不能把网络失败写成安装完成。
-
-ASR 配置是可选能力，不是安装前提。`capabilities.asr` 安全报告缺配置、配置无效或配置存在，不会登录、上传或验证余额。默认自动复用固定用户级配置；已有配置不再索取 key。确实缺少且用户需要云转写时，只引导一次平台安全注入或本地 `configure_asr.py setup` 隐藏输入，之后跨项目复用；安装不会写入或覆盖凭据。`--env-file` 仅为可选 override，不是每次制作的步骤。见 [API key 一次配置](configuration.md)。
-
-## 3. 检查能否实际工作
-
-安装后的脚本会检查包版本／依赖、运行锁定 CLI、在临时目录实际编码并完整解码 H.264/AAC，并用锁定渲染器相同的 CDP 自动化路径让本机完整 Chrome 加载本地 GSAP、执行变换并正常关闭。只绑定临时用户目录，不复用用户浏览器配置，不降低浏览器沙箱保护；检查结束清理自己的临时文件。环境限制阻止 Chrome 启动时，按正常工具授权路径处理，不能绕过安全设置或静默跳过检查。
-
-再次执行只检查、复用依赖的路径：
-
-```bash
-python3 scripts/bootstrap.py
-```
-
-读取 JSON 的 `status/actions/checks/blockers/runtime/capabilities`，不能只看命令启动。`ready` 只说明本机依赖与基础媒体检查通过，不代表云 ASR 可用、人类审批已配置、真实声音自然或视频创作已经完成。失败为非零退出和 blocked。执行后向用户简要报告实际安装位置、复用／安装了什么、通过的检查与尚需授权的步骤。
-
-后续命令使用报告中的 Python，并让 Node 调用 Python 子进程时沿用同一环境，例如由 Agent 设置：
-
-```bash
-export PATH="/actual/DraftCut/.venv/bin:/actual/native-node/bin:$PATH"
-```
-
-上面的路径必须换成健康报告给出的真实路径。不要把这个配置任务转交给用户。同时沿用 `runtime.environment` 的 `DRAFTCUT_CHROME`，使自定义 Chrome 路径在 check/snapshot/导出时保持一致。
-
-## 4. 进入口播制作
-
-环境就绪后按 [SKILL](../SKILL.md) 接收真实录音与效果要求。已有可信逐词转写可以本地导入。内置 ASR 使用 DashScope，需要针对素材的上传／费用授权；环境通过不等于获得这项授权。先复用已配置状态；确实缺少时才引导一次安全输入，不在聊天中要求粘贴密钥，不写入 Git 或日志，也不替用户开通付费账户。用户文件由脚本自动加载，不读取或打印配置正文到模型上下文。已有明确上传／费用授权覆盖当前素材时沿用，超范围才补问；key 存在本身不构成授权。
-
-没有素材和云授权时可运行 [完整合成 fixture](../examples/full-workflow/README.md) 作为本地流程证明。它不证明真实 ASR 或人类审批。真实素材先在当前对话审核完整口播稿；明确获批后自动按[干净成片](../references/04-clean-cut.md)出片，不要求终端签名或额外继续指令。包装另行审核导演脚本。旧签名包装工具链的身份与口令按[审批说明](approvals.md)由本人保管，Agent不代创建或代签。
-
-先按 [配置与能力边界](configuration.md) 检查当前通道的实际视听能力，并一次说明缺项。`capabilities` 中 owner 签名与 Agent 视听能力默认 `not_checked`，不能从依赖通过推断它们已就绪。真实直接用户对当前完整文稿的明确批准可触发独立干净出片；无音频感知能力或未配置签名不阻止该阶段。旧签名包装入口仍须本人设置与签发回执；对话确认不自动产生加密签名，不宣称已具备可信宿主签发器。
-
-干净成片已使用真实对话中的文稿确认；仍保留的签名包装后备路径有额外用户操作，属于该路径的使用缺口。见[对话批准接入边界](conversational-approvals.md)，不要用模拟回执或 Agent 复制的回复掩盖这一差异。

package/skills/draftcut/docs/approvals.md

@@ -1,45 +0,0 @@
-# 旧签名版包装路径 / Signed packaging approvals
-
-干净成片现使用真实对话中的文稿批准，获批后自动交付，不要求终端签名；见[干净成片](../references/04-clean-cut.md)。以下为仍保留的签名版包装实现，不作为独立干净出片的前置条件。
-
-DraftCut 使用 **口播稿审核 → 视频脚本审核 → 成片**。Agent 准备提案与审核包；用户批准准确版本。为了使模型不能仅写 `approved=true` 自批，生产入口要求由用户保管的加密 Ed25519 私钥签发的回执。Node 内置 crypto 实现签名，不新增云服务、账号或付费依赖。
-
-本页是生产身份流程。明确授权的隔离模拟用户测试使用[独立测试身份](simulation-testing.md)，控制器在内部记录自然语言回复，不能要求模拟普通用户设置生产密钥或运行签名命令，也不能把测试身份提升成 owner 身份。两种回执不互相接受。
-
-用户要求的是两次普通对话确认。下面的终端签名是**当前实现的后备路径**，仍增加了用户操作；这项使用缺口没有因补充文档而消失。既有自然语言 E2E 验证的是隔离模拟用户路径。实现无需手工 CLI 的生产确认，需要[可信宿主对话适配器](conversational-approvals.md)，不能直接接受 Agent 自填的聊天记录。
-
-## 一次设置，由用户本人执行
-
-在你自己的终端，从仓库目录运行：
-
-```bash
-python3 scripts/review_approval.py setup
-```
-
-输入至少 12 字符的私有口令并确认。身份文件保存在 `~/.config/draftcut/`，私钥以口令加密；生产验证读取这里的公钥，不接受项目内任选的公钥或 Agent 提供的替代信任。不要向 Agent、提示词、仓库、日志或其他人提供口令，不要让 Agent 代运行此设置。
-
-本次开发和合成示例不会创建你的生产身份。只有在你要批准真实项目时才需要本人设置。
-
-## 每一道审核，由用户本人确认
-
-Agent 会给出本次审核包的 `request.json` 与 `review.md`。阅读完整审核稿、差异和字幕；试听代理／批准音频是可选辅助，不是签名批准的前提。在自己的终端运行：
-
-```bash
-python3 scripts/review_approval.py approve --request /绝对路径/本次审核包/request.json
-```
-
-工具再次检查请求是否仍为当前版本，展示完整审核文档和内容摘要。明确同意后输入提示中的 `APPROVE <摘要前12位>`，再输入私有口令。回执写入同目录 `approval.json`。口令通过隐藏终端输入，只经进程管道传给本机 crypto，不出现在参数、环境变量或文件中。
-
-Agent 随后可以继续工作。口播稿批准只允许生成该版本正式原声音频；视频脚本另需一次批准。没有回复、模糊回复、模型自评、旧布尔值、伪造回执和错误签名都不能通过。
-
-## 绑定与失效
-
-第一道请求绑定源素材与转写 hash、全部词的决定／顺序、字幕、差异稿、代理、语义复核证据、项目 ID 与修订代次。第二道请求还绑定正式音频／字幕、导演脚本、完整结构化计划及素材 hash。
-
-口播稿或语义证据变化后需重新生成审核包，两道下游批准失效。导演脚本／计划／素材变化后需重审第二道。恢复旧稿也不会恢复已被流程观察到失效的旧代次。重试只重用完全相同、仍有效的已批准产物；不覆盖旧版本。旧项目须显式迁移重新批准。
-
-签名证明批准来自配置的持钥者且内容未变，不证明内容与听感已正确。与所有本机工具一样，它依赖你保管口令和生产公钥配置，以及运行代码未被替换；无法防御拥有你全部系统权限、口令或能改写执行器的攻击者。文稿复核、视觉检查及可选试听分别如实记录，未试听不阻断文稿审核。
-
-## 合成示例
-
-`examples/full-workflow/run.py` 使用公开定义的音调 PCM 和手写词时间戳，以及独立临时测试密钥。它演示状态转换，**不代表真实人类批准或真实 ASR／听感验收**。即使项目设置 `example_only`，验证器仍会核对源 PCM 和词表是否严格等于仓库合成 fixture；它不能授权真实录音或任意人物视频。测试身份不能进入生产信任路径。

package/skills/draftcut/docs/audio-first-migration.md

@@ -1,35 +0,0 @@
-# 完整口播流程迁移 / Full spoken-workflow migration
-
-当前 DraftCut 从自然录音或一支口播视频开始：完整口播精剪 → **口播稿审核** → 正式精炼原声 → **视频脚本审核** → 视觉制作与成片。保留原声，用同一整数采样时间线生成音频与字幕；人物视频使用同剪辑顺序和累计帧分配。公开集成聚焦这条原声精剪与视觉制作流程。
-
-## 原完整能力与补齐范围
-
-MIT clean-talking-video 源提交 `598c95d` 的 Skill 包括：口头禅、口误、改口、失败重说、连续／跨句重复、停顿与首尾静音整理；只修正识别错误、术语、标点和断句；全文 Agent 判断、局部试听、用户完整字幕确认、统一音视频/SRT 映射。机械规则只标候选，不自动决定语义删除。本地工作版本另加第一次字幕确认前的精剪代理与语义复核；本集成将对应要求纳入审核包。
-
-本次保留原项目 MIT 声明，导入保守候选生成与纯时间线／字幕助手，并在其上增加逐词完整记账、词级采样保护、可审查差异、移序映射、两次用户签名、内容变更失效和可重试事务。不复制无关私有业务、素材或凭据；原私有仓库可见性不变。
-
-## Legacy 项目必须显式迁移
-
-旧 `motiontalk.*.v1` 报告可以保留阅读；旧的 `approved=true`、`approval_text`、无人值守自批或气口批准不能继承到新生产流程。旧 `prepare_audio.py` CLI 拒绝直接作为正式音频入口。原项目与产物保留，不在原目录就地重写。
-
-提供原始素材与逐词转写，导入新的空工作目录：
-
-```bash
-python3 scripts/spoken_workflow.py migrate --legacy-plan /path/old-plan.json \
-  --source /path/original.wav --transcript /path/original-transcript.json \
-  --project-dir /path/new-workflow-project
-```
-
-迁移记录旧计划路径与 hash，明确 `inherited_approvals=false`。重新完成全文编辑、语义复核、口播稿批准和视频脚本批准，再制作。没有原始素材／可信词级转写时停止，不能把旧成片或旧字幕当作已审核原稿静默过关。
-
-## DraftCut compatibility
-
-DraftCut 原名 MotionTalk；仓库为 [PoetCoderJun/DraftCut](https://github.com/PoetCoderJun/DraftCut)，新 Skill 名为 `draftcut`。中文默认 `README.md`，英文 `README_EN.md`，旧 `README.zh-CN.md` 保留切换入口。旧本地副本和 Skill 不自动改名或覆盖；确认后自行重新安装。
-
-项目的生产契约升级到 `draftcut.workflow.v2`；旧 `motiontalk.*.v1` 质量报告名称保留兼容，不能作为新批准。内部 `.motiontalk-render.lock` 与 `MOTIONTALK_CHROME` 浏览器交接保留，以维持已有机器环境。依赖版本与根许可保持原设置；第三方代码继续遵循 MIT 等各自许可。
-
-## Integration scope evidence
-
-此前 `9f7fbdd` 音频集成只导入 ASR 和选中气口，其 [历史迁移说明](https://github.com/PoetCoderJun/DraftCut/blob/9f7fbddb09c588c43ac29944a851c5ac5f7bd9da/docs/audio-first-migration.md#L7-L9) 明确没有继承完整语义精剪。本次补齐这部分，不再把那份历史说明当作当前功能边界。
-
-当前实现见 [spoken_edit.py](../scripts/spoken_edit.py)、[spoken_workflow.py](../scripts/spoken_workflow.py) 和 [签名审批](approvals.md)。源清单、逐词决定与审听证据进入第一道请求；正式原声与导演内容进入第二道请求。初始化、渲染和交付验证均检查当前签名链；所有例外都不能靠旧状态布尔值触发。

package/skills/draftcut/docs/configuration.md

@@ -1,54 +0,0 @@
-# API key 一次配置，后续自动复用
-
-这是给安装 Agent 的说明。用户仍从 README 的仓库链接开始；不用为每个视频创建 `.env` 或重复提供 key。默认只用一个用户级文件，位于 checkout 与视频工程之外，重装／升级仓库不会覆盖它。
-
-## 第一次与之后
-
-1. Agent 先执行 `python3 <skill-root>/scripts/configure_asr.py status`（或读取 bootstrap 的 `capabilities.asr`），只获取状态与配置路径，不读取密钥正文到模型上下文。
-2. 已有有效格式的用户配置或平台安全注入变量时直接复用，不再问 key。`configured_not_verified` 表示尚未联网验证账号，不能因此要求重新配置一次。
-3. 只有确实缺配置时，优先复用 Agent 平台已有的安全密钥注入；否则请用户在自己的本地终端运行一次 `python3 <skill-root>/scripts/configure_asr.py setup`。Agent 应给出实际安装路径，不让用户猜目录。工具用隐藏输入接收 key，私有保存；不要让用户把 key 发到聊天、作为命令参数，或由模型代输。
-4. 以后用户只给录音与风格要求。脚本从同一用户配置自动读取，不需要 `--env-file`。失效密钥、权限或格式错误给出一次有针对性的修复动作；网络失败不等于要再次索取 key。用户明确要求更换配置时才使用 setup 的 `--replace`；指定账号区域／模型可用 `--base-url`／`--model`。
-
-本轮开发不替真实用户执行 setup、不读取或迁移现有真实 key，也不创建新的账号访问。实际首次保存凭据由用户本人明确执行。
-
-## 固定路径与优先级
-
-| 系统 | 默认用户配置 |
-| --- | --- |
-| macOS | `~/Library/Application Support/DraftCut/asr.env` |
-| Linux | `${XDG_CONFIG_HOME:-~/.config}/draftcut/asr.env` |
-| Windows | `%APPDATA%/DraftCut/asr.env`（仅路径选择测试，完整制作仍受 POSIX 平台限制） |
-
-选择规则明确且不扫描项目：进程环境变量优先；文件来源按显式 `--env-file`、环境变量 `DRAFTCUT_ASR_CONFIG`、默认用户文件三者顺序选一个。override 文件替代默认文件，不混合两个文件；`DRAFTCUT_ASR_CONFIG` 必须是绝对路径。进程中的密钥或 base URL 会覆盖文件中的对应两种别名，避免旧 ASR 专用名反压新进程配置。
-
-不会搜索 CWD、checkout、父目录或随意的 HOME `.env`；切换项目不会改变默认配置来源。可选 override 用于临时账号或特殊执行环境，普通用户不需要每次传参。
-
-setup 新建用户目录权限为 700、文件为 600；POSIX 加载前检查 owner 与私有权限。已有配置默认原样保留，安装／健康检查只读，显式 `--replace` 才原子替换。权限不正确时按状态提示在自己的终端修复选定文件（例如 chmod 600），不要打印内容。Windows 文件 ACL 尚未认证，当前完整流程不支持 Windows。
-
-## 安全状态与可选字段
-
-`configure_asr.py status` 和 `transcribe_audio.py --check-config` 都不联网、不鉴权、不上传、不产生费用、不输出密钥或服务 URL。`needs_configuration` 是缺 key；`invalid_configuration` 给出不含原值的格式／权限错误；`configured_not_verified` 是配置可读取且格式有效，账号、额度及模型权限仍由真实调用验证。
-
-安装 Agent 只需要调用状态或加载脚本。不要用 cat、读取文件工具、打印环境变量或调试日志，把私有文件正文带入模型上下文。不要为诊断索取密钥正文。
-
-高级用户可参考 [`.env.example`](../.env.example)。文件支持 UTF-8 的字面 `KEY=VALUE`、可选 export、单／双引号和注释，不执行 shell，不展开变量。只读取以下 ASR 设置，其他文件变量不传入子进程：
-
-| 变量 | 默认值／含义 |
-| --- | --- |
-| `DASHSCOPE_API_KEY` | 内置云 ASR 凭据；兼容旧 `DASHSCOPE_ASR_API_KEY`；同一来源内旧 ASR 专用名优先 |
-| `DASHSCOPE_ASR_BASE_URL` | 默认 `https://dashscope.aliyuncs.com`；兼容 `DASHSCOPE_BASE_URL`，按账号区域设置 HTTPS 服务 |
-| `DASHSCOPE_ASR_MODEL` | 默认 `qwen3-asr-flash-filetrans`，需提供逐词时间戳 |
-| `DASHSCOPE_ASR_POLL_SECONDS` | 默认 2，最少 0.5 秒；有限正数 |
-| `DASHSCOPE_ASR_TIMEOUT_SECONDS` | 默认 3600，最少 30 秒；有限正数 |
-
-Agent 自己的模型登录或 OpenAI key 不能替代 DashScope key。只有内置云转写需要它；安装、本地精剪／渲染、导入可信完整逐词转写无需 DraftCut API key。图形与 GSAP 在本地制作，不需要额外素材服务凭据；没有外部 HyperFrames Skill 时用本仓库 references 和锁定 CLI 的帮助。
-
-## key 与上传／费用授权分别处理
-
-保存 key 不构成上传或费用授权。首次确有云转写需求时，说明发送的内容、供应商、可能费用，并按用户选择记录仅本素材或指定目录／项目范围、有效期和预算的持续授权。保留用户原话与来源、范围，已有明确授权覆盖当前素材时直接沿用，不为每个视频重问；超范围或授权不清时才补问。`--allow-cloud-asr` 只是内部执行参数，不是授权证据。本轮没有签发或保存任何真实授权。
-
-## 其他能力边界
-
-当前实际验证 macOS Apple Silicon，Linux 运行与 CJK 字体仍需本机检查；Windows 制作流程明确 blocked。沿用 bootstrap 给出的 Python、PATH 和 `DRAFTCUT_CHROME`；不要硬编码作者路径。中文需实际截图核对，技术检查不证明全文听审或连续观看。
-
-API 配置与内容审核互不替代。干净成片按真实对话中的当前文稿批准自动交付，无需终端签名。旧签名包装路径保留，独立可验证的宿主签发接口缺口见[对话批准边界](conversational-approvals.md)。签名口令不应存入 ASR 文件，临时 HOME 也不能重定向生产信任锚。

package/skills/draftcut/docs/getting-started.md

@@ -1,63 +0,0 @@
-# DraftCut 安装与使用 / Setup and usage
-
-[中文首页](../README.md) · [English](../README_EN.md)
-
-## Installation through your Agent
-
-把 https://github.com/PoetCoderJun/DraftCut 发给 Agent，要求它安装配置、检查环境，然后进入口播制作。Agent 按 [安装与健康检查说明](agent-bootstrap.md) 探测本机、复用健康依赖、补齐缺失项并报告实际结果；本页不提供另一套用户安装入口。
-
-<a id="environment"></a>
-<a id="skill-installation"></a>
-
-当前完整流程验证环境为 macOS，事务锁使用 POSIX `flock`。不声称所有 Agent／平台都已认证。旧 Skill 或项目保留，按 [显式迁移](audio-first-migration.md) 处理。
-
-## Transcription configuration and consent
-
-内置 DashScope 转写会上传音频且可能收费。配置 `DASHSCOPE_API_KEY`；也接受旧 `DASHSCOPE_ASR_API_KEY`。默认 base URL 是 `https://dashscope.aliyuncs.com`，`DASHSCOPE_ASR_BASE_URL` 优先于 `DASHSCOPE_BASE_URL`。默认模型在现有适配器中为 `qwen3-asr-flash-filetrans`，可配置 `DASHSCOPE_ASR_MODEL`。核对服务账号的区域、模型权限与价格，不静默切换供应商。
-
-通过安全执行环境提供密钥，不放进提示词、日志或 Git；默认自动复用用户级私有配置，首次由安全输入提供一次；`--env-file` 只是可选覆盖，不需要每个项目重复设置。见 [API key 一次配置](configuration.md)。转写前须有明确上传／费用授权，已有持续授权覆盖当前录音时直接沿用，`--allow-cloud-asr` 本身不构成授权。云端上传压缩音频代理、异步识别并取回词级结果。已有可信逐词转写可本地导入。语义复核可沿用同模型审听代理识别，也可在审核包中明确披露完整人工试听方式，由用户批准；不会自动增加付费调用。
-
-## Full spoken editing
-
-逐词检查整份原稿，处理无意义口头禅、失败重说、改口、口误、冗余重复和停顿，保留否定、数字、专名、有意重复与论证结构。完整原稿、精炼稿、逐词差异和保留／删除依据一起交给用户。模型提出编辑方案；审核前的代理只用于听审，正式精炼原声必须等用户批准后生成。
-
-[实际编辑字段与命令](../references/00-audio.md) · [用户审批设置](approvals.md)。源素材、稿件和证据按 hash 与修订代次绑定；变更令下游批准失效。输出逐采样拼接原声，不靠 TTS 添加内容。
-
-## Video input
-
-可以直接把一支口播视频作为 `spoken_workflow.py init --source` 的输入。程序保留原文件，抽取未剪辑原声作为规范化源；正式批准后按同一时间线剪原声与人物视频。音视频时间原点不同时显式停止，不能盲目拿未剪人物视频配剪后音轨。
-
-素材文件夹和参考片仍可选。此流程聚焦现有录音或口播视频的精剪。
-
-## What you review
-
-1. **口播稿审核：**原稿／精炼稿、逐词保留删除依据、纠错、重排、停顿与全文听审证据。用户签名批准此版本后，才生成正式精炼音频与字幕。
-2. **视频脚本审核：**在批准音频时间线上规划画面、MG、素材、重点与节奏。用户再次签名批准后，才初始化视觉工程、渲染与交付。
-
-[两次批准的操作与信任边界](approvals.md)。Agent 自审、没有回复、旧批准和无人值守措辞不能代替其中任何一次。批准后连续完成当前版本，不反复索要“继续”。
-
-## Delivery and validation
-
-主交付是 MP4，可编辑工程与审核证据留在项目目录。每个正式精炼音频样本必须来自批准源区间；字幕和词级时间共用采样映射。人物视频使用累计帧边界防止多剪口累积漂移。导出后完整解码并对 AAC 解码波形与批准音频进行比较，防止字幕变化但声音未改、音轨被换或时序漂移。
-
-技术验证不证明语义自然和审美正确。Agent 仍需连续预览与实际试听首、中、尾和所有剪口，分开记录判断；没有执行的标 pending。ASR 误识别和不准确词边界需先复核修订。
-
-## Local verification
-
-```bash
-python3 -m unittest discover -s tests -v
-python3 -m unittest discover -s scripts/tests -v
-node --test tests/*.test.mjs
-python3 examples/plan-validation/run.py
-python3 examples/full-workflow/run.py --output-dir /tmp/draftcut-full-example --initialize-composition
-```
-
-最后一个命令使用已知音调 PCM、手写词时间戳与独立临时测试签名，通过两道模拟审核并实际生成精炼音频、字幕与可初始化项目。它不伪装人类批准或实际 ASR／自然听感验收，也不会调用云模型。示例生产门只能处理这份已知合成输入，不能用 `example_only` 标签绕过真实项目审核。
-
-## Examples and validation
-
-首页的两个 GIF 来自作者既有成片，均为 6 倍速无声视觉展示：Vibe Working 原片 00:39–01:27，具身 AI 为原片最后 30 秒。它们不是新流程的端到端验收。
-
-Opus 5.5、ChatGPT 6 Astra、Kimi k3 是作者推荐，Agent 实际能力取决于本地文件、命令、视觉与试听工具；没有逐一认证所有平台。首页的 100 倍是减少人工剪辑投入的愿景，尚无对照基准或普遍实测保证。
-
-SVG 为原创可编辑示意，不是实际产品界面、音频实测或客户结果。测试与真实生产结果分别记录；技术、听感与视觉结论各有适用范围。

package/skills/draftcut/docs/harness-case-study.en.md

@@ -1,23 +0,0 @@
-# DraftCut: inspectable edits and two human approvals
-
-[中文](harness-case-study.md) · [Setup](getting-started.md)
-
-The workflow is **spoken-manuscript approval → video-script approval → production**. The Agent proposes semantic edits and reviews the full recording; deterministic code checks source integrity, word accounting, media timing and signed decisions.
-
-[spoken_edit.py](../scripts/spoken_edit.py) reuses clean-talking's conservative candidates and pure timeline helpers. Every word has one keep/delete decision and a reason. Negation, numbers and names have conservative protection; sensitive changes require explicit justification. Reordering is disclosed. Every retained word maps once to an intact source sample interval, and no deleted word may remain in kept audio. Audio is spliced from 48 kHz source PCM and compared byte-for-byte; SRT comes from the same sample map. ASR corrections are disclosed, never synthesized as new speech.
-
-A source video follows the same cuts. Cumulative frame allocation bounds rounding rather than accumulating an independent error at every splice. Complete media decoding and timing checks are required. Incorrect ASR boundaries can still harm perceived speech, so actual listening remains necessary.
-
-[spoken_workflow.py](../scripts/spoken_workflow.py) creates a review-only proxy, source/refined text, word decisions, reasons, corrections and the complete mapped subtitles. Semantic review evidence is bound to the current draft and proxy. Only a valid human manuscript receipt unlocks the formal refined master. The second review binds that master, subtitles, visual script, machine plan and assets. Observed input changes burn the previous generation; reverting an observed changed draft does not resurrect its receipt. Builds use preserved transactions and safe same-version retries.
-
-[Human approval](approvals.md) uses an encrypted Ed25519 key held by the user, with a production trust anchor outside the editable project. Model-written booleans and fixture signatures cannot authorize real sources. This protects the configured workflow; it does not defend against an attacker who controls the host, code and signing passphrase. A signature proves a specific decision by its key holder, not creative or semantic quality.
-
-The pure `validate_plan` function checks structure only. Its production CLI, initialization, rendering and delivery all verify the current two-stage signature chain. Initialization copies the approved WAV unchanged and creates a scaffold; actual visual production and continuous preview remain separate work. Exported AAC is decoded and compared against the approved voice waveform, including explicit mono/stereo handling. Codec tolerance is not semantic listening certification.
-
-Run the commands in the [local verification guide](getting-started.md#local-verification). Fixtures use known tones and authored timestamps, no private recordings, live ASR, paid API or genuine human approvals. Coverage includes semantic edit selections, intentional repetition, protected terms, reorder/sample/SRT integrity, A/V cuts, both gates, stale/forged approvals and explicit legacy migration. Real speech accuracy, naturalness and visual quality still require authorized media and actual review. The efficiency ambition is not benchmarked.
-
-## Repository-link setup verification
-
-An independent execution Agent read the public repository entry, then the bootstrap guide and Skill, and installed a fresh project virtual environment and locked Node packages on this macOS Apple Silicon host. A second check reused those packages. Both runs executed full local Chrome with GSAP and an H.264/AAC encode/full-decode check. Using the reported runtime, it initialized the synthetic composition and linted it with zero errors or warnings.
-
-Existing system Python, Node, FFmpeg and Chrome were reused. This validates the isolated project setup path on this host, not a fresh OS installation, every Agent, cloud ASR or production approvals. The [Agent setup guide](agent-bootstrap.md) owns the technical steps; the user only sends the repository link.

package/skills/draftcut/docs/harness-case-study.md

@@ -1,47 +0,0 @@
-# DraftCut：从可审查提案到两次人工批准
-
-[English](harness-case-study.en.md) · [使用方法](getting-started.md)
-
-DraftCut 将语义判断交给 Agent 与人，将来源、时间线与批准完整性放到确定性代码中。正式流程是口播稿审核、视频脚本审核、成片。
-
-## 口播编辑
-
-[spoken_edit.py](../scripts/spoken_edit.py) 复用原 clean-talking 的保守候选和纯时间线助手，要求逐词完整记账。Agent 通读全文并听审，明确删除口头禅、口误／改口、失败重说、冗余重复、停顿的依据。否定、数字和名称有保守保护；敏感变更须写出具体理由供人审核。
-
-每个保留词恰好进入输出一次，移序需说明。代码按整数采样拼接 48 kHz 原声，逐块比较输出 PCM 与源区间；所有保留词的完整采样范围都必须存在，删除词不能残留。字幕由保留词及同一映射生成，不能仅删字幕。词组断句和 ASR 字面纠错都在审核包中披露，不用 TTS 添加声音。
-
-输入为视频时，同一采样区间决定视频片段；累计帧舍入将边界误差限制在帧精度，避免逐段舍入累积漂移。正式媒体完整解码。ASR 边界本身仍需听审，采样正确不能证明识别或自然度。
-
-## 两次批准与失效
-
-[spoken_workflow.py](../scripts/spoken_workflow.py) 先生成 REVIEW-ONLY 代理和完整差异稿，语义复核证据绑定稿件与代理。口播稿请求由用户签名后才可生成正式精炼音频。导演请求绑定正式音频、字幕、完整脚本、计划及素材，再次由用户签名。
-
-[review_approval.py](../scripts/review_approval.py) 在用户本人终端审阅并确认当前摘要，用用户保管的加密 Ed25519 私钥签发回执。生产验证信任项目外公钥，不接受模型布尔值、自签测试身份、错误阶段或过期版本。内容变化在实际检查中被观察到时烧掉旧代次，即使恢复旧稿也需新的批准。失败构建保留在暂存事务目录，不当作已批准成品；同版本重试只返回已验证产物。
-
-这依赖用户保管口令与主机信任配置，不能防御掌握整个执行环境和口令的攻击者。签名证明持钥者批准过具体内容，不证明审美、语义与听感。详情见 [审批边界](approvals.md)。
-
-## 制作与交付
-
-`validate_plan.py` 的纯函数只做结构检查；生产 CLI、初始化、导出和交付入口都重新校验两道签名链。`init_project.mjs` 按字节复制批准 WAV，生成的仍是 scaffold。Agent 必须实际创作 MG 并连续预览。
-
-导出前后验证当前批准与工程音轨，导出后由 [verify_output_audio.py](../scripts/verify_output_audio.py) 比较解码波形和批准原声，检查音轨误换或时序不一致。mono→stereo 显式复制声道，避免隐式 downmix 造成虚假的增益差异。波形比较有 AAC 编码容差，不代替语义试听。
-
-依赖继续锁定 Hyperframes 0.8.30、GSAP 3.14.2；默认单 worker、本机 Chrome、硬件 H.264，软件编码显式选择。技术元数据、实际听感和视觉判断分开报告。
-
-## 可复查的本地验证
-
-```bash
-python3 -m unittest discover -s tests -v
-python3 -m unittest discover -s scripts/tests -v
-node --test tests/*.test.mjs
-python3 examples/plan-validation/run.py
-python3 examples/full-workflow/run.py --output-dir /tmp/draftcut-full-example --initialize-composition
-```
-
-合成源为按词标记的音调、手写时间戳与独立 fixture 签名，不是实际 ASR 或真实人类批准。测试覆盖语义删改、敏感词和有意重复保留、移序、PCM完整性、SRT映射、人物音视频同剪辑、两道批准阻塞、变更失效、伪造与旧项目迁移。真实口播准确率、自然剪口、视觉质量和效率收益仍须用获授权录音与实际视听评估，未建立 100 倍基准。
-
-## 从仓库链接安装的实跑范围
-
-独立执行 Agent 从公开仓库链接读取 README → Agent bootstrap → SKILL，在 macOS Apple Silicon 的全新副本实际创建 `.venv` 并安装锁定 Node 包，随后重复检查并复用依赖。两次均执行了本机完整 Chrome + GSAP 与 H.264/AAC 编码、完整解码；再按健康报告的运行环境初始化合成工程，lint 为零错误零警告。
-
-这证明当前机器上的隔离项目安装路径；已有系统 Python、Node、FFmpeg 和 Chrome 被复用，不代表在全新操作系统上安装全部系统软件，也不代表所有 Agent、云 ASR 或生产审批已认证。具体执行方法由 [Agent 安装说明](agent-bootstrap.md) 负责，用户仍只需发送仓库链接。