shiyan688/evidence-video

Evidence Video / 证据型视频制作

把选题材料变成有来源的中文动态图解视频：分镜、自然解说、TTS、字幕、封面及可审核的多平台发布包。

Turn source materials into Chinese evidence-led explainer videos with animated diagrams, narration, captions and publication packages.

下载 v0.1.0 · 问题反馈 · 版本记录 · 开源隐私审核

同一份 Skill，三个发行入口：独立 Skill → Codex 插件 → DeepSeek Harness 插件。 编辑与研究由宿主大模型完成，文件生成、配音缓存、时间轴和渲染由同一套本地工具执行。

第一版不需要另建云服务。你的输入是材料与需求；多模态模型/API 在 Codex 或 DSH 中配置一次，TTS API 在项目中配置一次。它不是输入任意大模型 Key 就能脱离宿主运行的独立 GUI 应用。

第一版提供什么

| 环节 | 交付与边界 |
|---|---|
| 材料和证据 | 注册本地文件/URL，由宿主实际读取；分镜中逐条关联来源、结论和推断边界 |
| 编辑审核 | 可编辑 storyboard.json、解说稿、字幕、结论表和 HTML 审核页 |
| 原创图解 | 七种 Remotion 版式：开场、卡片、流程、数字、对比、时间线、关系图 |
| 配音 | DashScope、OpenAI 兼容语音接口；片段缓存、逐次请求收据、中断恢复 |
| 对齐与验收 | 用真实片段长度生成字幕；成片哈希、时长、帧率、解码及非静音检查 |
| 发布准备 | B站、抖音、小红书、视频号、快手文案；3:4 / 1:1 / 4:3 / 16:9 封面；离线发布包 |
| 发布执行 | 对接另行配置的本地浏览器发布器；明确账号与内容指纹；当前仅支持立即执行 |

固定输出 1080×1920、30fps。不是逐字强制对齐，也不包含素材抓取、图生视频模型、自动账号注册或云端发布服务。来源校验检查引用结构，事实真伪仍需阅读原文。

本地快速体验

需要 Node.js 24+ 和 npm。以下  是本仓库目录， 是任意独立空目录的绝对路径；有空格的路径请加引号。

git clone https://github.com/shiyan688/evidence-video.git
cd evidence-video

node /skills/evidence-video/scripts/video.mjs doctor
node /skills/evidence-video/scripts/video.mjs init --project  --example
node /skills/evidence-video/scripts/video.mjs prepare --project
node /skills/evidence-video/scripts/video.mjs setup --project
node /skills/evidence-video/scripts/video.mjs render --project  --mode stills
node /skills/evidence-video/scripts/video.mjs render --project  --mode covers
node /skills/evidence-video/scripts/video.mjs publish-package --project  --preview

样例明确标为虚构，不会调用模型/TTS 或发布平台。setup 下载锁定的 npm 依赖，首次渲染可能下载 Chromium。打开项目的 output/review.html、output/stills 与 output/publication/preview.html 检查结果。

制作真实选题时省略 --example，让宿主读取你的材料并编写分镜。空项目默认不可渲染，避免把演示内容当成真实素材。用户可以直接说：

使用 $evidence-video，把这些材料做成中文图解视频。先整理证据和分镜，使用我配置好的 TTS，输出成片、封面和发布准备包。

语音配置在 /config.json；真实 Key 留在本地环境或私有 .env，不进入对话或配置 JSON。用 tts --dry-run 查看请求计划，已授权合成时才用 tts --allow-api。详情见 配音与恢复。

三种安装方式

用 npm run package 生成下表的发行文件；release/latest.json 记录本次包的目录、文件清单和哈希，release/SHA256SUMS.txt 可用于校验。

| 入口 | 发行物 | 使用方法 |
|---|---|---|
| 独立 Skill | release/evidence-video-0.1.0-skill.zip | 解压其中的 evidence-video 到宿主的用户 Skill 目录；Codex 通常是 ~/.codex/skills。支持 SKILL.md 的其他宿主需同时支持本地脚本执行。 |
| Codex 插件 | release/evidence-video-0.1.0-codex.zip | 解压到 ~/plugins/evidence-video，加入 Codex 的个人插件市场，然后 codex plugin add evidence-video@personal。本仓库提供 scripts/install-codex.mjs 完成本机安装。 |
| DSH 插件 | release/dsh-evidence-video-0.1.0.tgz | 在匹配的 DSH 环境运行 dsh plugin --profile web add ，再检查 dsh --profile web --dump-config。见 DSH 安装说明。 |

Codex 插件已经包含 Skill，一台宿主选择一种安装入口即可。更新后在新任务中加载；本仓库不会替你创建任务。DSH 使用原生 bundled skill provider，保留包内脚本/资源路径；第一版未增加自定义 DSH 前端面板。

本机 Codex 安装器需要 Codex 自带的 plugin-creator 脚本、Python 和 Codex CLI。它先校验发行清单，再使用官方脚手架更新个人市场，保留其他条目，不覆盖同名的已有插件。工作区之外的写入遵从宿主正常权限提示。

node scripts/install-codex.mjs

视频如何发布

publish-package 和 publisher-plan 都是离线操作。准备好实际成片、平台文案、封面及用户选择的账号后，生成 publisher-preview.html 供审核。只有发布任务已有明确授权时才执行对应计划。

upload-preview 的执行会上传到真实平台，只是要求跳过最后发布动作。正式发布需要对应计划指纹及 --allow-upload --allow-publish。HTTP 200 没有平台回执，工具保留 requires_verification，不能据此声称已公开发布。请求结果不确定时停止，避免重复投稿。定时计划目前只能审核，不能执行。

实际检查平台后，可用 publisher-record 留下人工核查记录；确认未发布才能再授权重试，确认已发布则继续拦截重复投稿。工具不会把人工记录包装成自动验证结果。

本地发布器需单独安装、登录，默认 loopback 端口 5409；本项目不打包旧发布器、cookies、账号或生产队列。具体命令与账号 JSON 见 发布交接说明。

Skill / 插件如何分发

源码在本仓库维护，GitHub Releases 提供三个安装包与 SHA256SUMS。仓库默认忽略 validation、release 构建目录、node_modules、缓存及私有环境文件。npm run package 只在本地构建，不会发布到 GitHub、npm 或官方插件目录。

Codex 公共插件目录需要实际的开发者身份、支持渠道、网站/隐私/条款页面及功能验证材料，按官方提交说明准备。本地版本没有伪造这些信息。DSH 可以先用 tarball 分发；发布 npm 前确定属于你的包名/作用域，若改名须同步 package.json 与 cordis.patch.yml。

源代码先采用 MIT；Remotion 等依赖保留自己的许可证，见 第三方说明。这为后续开源 Skill、付费托管、模板或团队服务保留空间；第一版未加入收费或账号系统。

开发与验证

npm test
npm run validate
npm run package
npm run validate

测试使用虚构材料、生成的短 PCM 和随机本机模拟接口，不调用真实模型、TTS 或社交平台。验证包括不重复付费、过期媒体拦截、发布状态持久化和 DSH 包内资源寻址；实际画面需要单独目视检查。当前实测结果见 验证记录。

只在 skills/evidence-video 维护工作流，构建时复制到三个发行物。adapters 只保留入口配置。项目输出始终写到用户指定的独立目录，不写入已安装 Skill / 插件缓存。