Skip to content

About

Fill-in-your-own-data framework for YouTube / short-form video automation: CapCut JSON + ffmpeg tooling + an onboarding questionnaire. Ships with zero private data.

Topics

Resources

Contributing

Security policy

Stars

2.3k stars

Watchers

9 watching

Forks

Latest commit

 

History

93 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 video-autopilot-kit

Current version: v0.28.1

一句話架構:VA(這個 kit)負責規劃、判斷與檢查;Editkin 負責所有渲染。 素材證據 → edit-plan/v4 → audit → 原子套用 → render → 審片 → 成效學習,整條路只認一份執行合約 src/workflow_contract.py。v0.25.0 起,舊的 Python/FFmpeg 渲染器全部退役 (見下方〈已退役〉)。

🧩 先裝 Editkin(必要)

VA 只負責規劃和檢查,真正剪片、渲染的是 Editkin。沒裝 Editkin,什麼都剪不出來。請照這個順序:

  1. 安裝 Editkin:到 Editkin 0.16.0 下載 Windows 安裝檔(約 1.5 GB)。這版沒有數位簽章,出現「Windows 已保護您的電腦」時,點「其他資訊」→「仍要執行」。 → 詳細步驟
  2. 接上你的 AI:Editkin 首頁「AI 協助剪輯」→「連接 AI 助手」→「連接 Claude Code」或「連接 Codex」(一鍵設定)。 重新開啟 Claude Code/Codex 後,/mcp 要看得到 editkin。從 0.15.0 升級的人請再按一次「連接」。 手寫 MCP 設定的人要在 env 加上 EDITKIN_MCP_PROFILE = "va"(省 token)。→ 詳細步驟
  3. 安裝這個 Kit:下載 Kit 的 install_or_upgrade.py,先跑 python install_or_upgrade.py --install-root <資料夾> --check, 再改用 --apply --install-skill 跑一次。Skill 會裝到 %USERPROFILE%\.codex\skills\video-autopilot\, Editkin 的「複製開工指令」就找得到它。→ 詳細步驟

只想先試試?Editkin 內建的簡單模式不需要任何 AI 帳號,放一支有人講話的橫式影片就能自動粗剪。 Editkin 0.16.0 目前只有 Windows、沒有自動更新;新版本請回 Editkin releases 下載。

Editkin 的授權:Editkin 是免費的閉源軟體(freeware),依它的 EULA 可永久用於個人與商業用途 (EULA.txt 附在 release 與安裝資料夾裡)。GPL-3.0 原始碼停在 0.15.0-preview.20261029,不再更新; 0.16.0 起只提供安裝檔。本 Kit 仍是 MIT,不打包、不內嵌、也不會更新 Editkin。

一套框架式的 YouTube/短影音自動化工具 + 方法論模板。 給你可續跑、可稽核的 Editkin 剪輯流程與一組品質閘門,加上一份「問卷」—— 你回答關於你自己頻道的問題,它就變成屬於你的系統。

⚠️ 不含任何人的私人數據 —— 後台讀數(自己的與別人的)/個人檔案一律不進 repo(profiles/、config.py 是 gitignored 本機檔)。 兩類具名例外,兩類都是公開資訊不是私人數據:① LICENSE 與各 README 的作者署名; ② knowledge/ 引用第三方公開創作者/頻道時會直接寫名字(例如演算法檔引用的公開戰術、 teaching-niche-playbook.md 的參考頻道列),規矩是 citation-first:沒有可點的出處連結就不給數字。 voice 詞表、KPI 門檻與社群欄位要嘛是空白模板(<fill in> / ______ / 產出檔的 {你的…} 佔位字樣),要嘛標示為「範例值」,你填你的。 反過來說:knowledge/ 裡的方法論是原作者的實戰結論,那是刻意開源的部分 —— 是「怎麼想」,不是「他的數字」。

誠實邊界:公開控制器只涵蓋媒體素材的 Editkin 工作流程。離線測試與 CI 用的是合成 fixture, 不等於真實 Editkin 成片、第三方帳號操作或主觀美術驗收。更新由你手動執行並確認;未宣稱簽章更新或全面資安驗證。

🧭 架構:VA 規劃與檢查,Editkin 渲染

一次剪輯的完整路徑:

你的素材 → VA 證據收據 → VA 寫 edit-plan/v4 → Editkin audit → Editkin 原子套用 → Editkin render → VA 交付 QA → 你 審片 → VA 發布包與成效學習

VA(本 kit,MIT) Editkin(桌面剪輯器,免費閉源軟體,另行安裝)
每份素材的證據鏈:prepare → 關鍵幀 → 逐字稿窗口 → 語意紀錄 讀素材、抽關鍵幀與逐字稿
寫 hao.video-autopilot.edit-plan/v4,綁齊所有收據 audit 與一次性原子套用
腳本、Shorts 結構與字幕、節奏、旁白覆蓋、交付 QA 等閘門 所有渲染:動態圖形、模板、Looks/濾鏡、追蹤、roto 與主體遮罩
審片伺服器、發布中樞、成效學習 存成你可以繼續手動編輯的專案檔

VA 不直接操作 Editkin:你的 AI agent(任何支援 MCP 的 agent)照 workflow_contract.py 給的下一步呼叫 Editkin 的 MCP 工具,再把原始回應交回 controller 驗證。一頁版說明 → docs/ARCHITECTURE.md。

🆕 v0.28.1 重點

公開版清理,沒有新的流程功能;run 綁定的東西(SKILL.md、執行合約、workflow 執行原始碼)都沒動,進行中的 run 不受影響。

  • 模組改成中性名稱:高資訊密度剪輯規劃是 src/high_information_editing.py,效果來源對照是 src/effect_source_map.py;import 舊模組名的程式要改成新名稱。
  • 資料夾預設改中性名稱:發布中樞只看 videos/_INBOX/vertical、videos/_INBOX/landscape-longform、 videos/_ready-shorts;沿用舊預設的人請在升級前把 Shorts 收件匣、長片收件匣與舊的待發布資料夾改成這些名稱 (videos/_READY_TO_PUBLISH 不受影響,留在原處)。 審查證據綁定檔案路徑,所以搬移後尚未發布的已認證項目要重新審查、舊的審片包要重建;已發布的套件仍記著舊路徑, publish_hub.py audit 會照樣列出。自動更新會停在這版之前,手動升級前請先看 CHANGELOG 的遷移段落。
  • 公開同步更乾淨:sync-receipt.json 只記公開輸出的 hash; 隱私規則改成結構式,維護端專用詞只在同步時從私有控制檔讀取。 公開 reference 裡指向 kit 沒有的檔案或模組的段落會整段拿掉(清單、表格只拿掉該項目或列,編號清單重新編號); 程式碼區塊只拿掉執行這類模組的指令,沒有指令剩下就整塊拿掉,所以幾份 reference 變短。

🆕 v0.28.0 重點

這版是維護清理,沒有新功能;v0.27.0 沒有另外發版,由這版取代。執行合約(revision 6)與 workflow 執行原始碼都沒動。 內建 Skill 改了兩個檔(SKILL.md 與選鏡 reference):run 會綁定已安裝 SKILL.md 的 hash,所以 v0.26/v0.27 開的 run 請先跑完再重新同步 Skill,或同步後開新的 run。

  • 選鏡 reference 精簡成一般規則:references/shot-selection-language.md 改成一份固定的一般選鏡規則, SKILL.md 改成指向這些規則。公開同步一律發布這份固定內容,若輸出不是這份內容就停止同步(有測試)。

  • canonical Skill 不會再被副本蓋掉:manifest 宣告為 canonical(source_authority)的 Skill,project_kernel.py sync apply 遇到來源是另一份副本時直接回 REFUSED、一個檔都不寫(加 --accept-source-conflicts 也一樣),工作區裡的副本也不能當 canonical;skill_sync.py sync 不會從別的資料夾覆寫 ~/.codex/skills/video-autopilot。新增 project_kernel.py sync record: 只從 canonical 本身重記 hash,從不複製。公開版內建的 manifest 沒有宣告 canonical Skill,所以 project_kernel.py 的預設行為不變。

  • manifest 路徑可以指向 Skill 內的檔案:required_paths、knowledge 行數預算和原始碼掃描接受 @<skill-id>/<相對路徑>, 解析到那個 Skill 的資料夾:有 source_authority 的是它的 canonical 資料夾(canonical 放在工作區外時用),工作區 自己的 Skill 則是它的 source 資料夾(公開版的 manifest 目前沒用到)。

  • 專案根目錄集中判斷:asset_license_governance.py 改用 project_paths.discover_project_root(),退回值是 kit 根目錄。

  • 經營檢查改成按需執行:knowledge/ops-automation.md 改成需要時手動跑一次 channel_tracker.py;順便修正過時路徑(狀態檔是 data/channel_state.json;交付 QA 是 media_delivery_qa.py 的 final_delivery_qa())。

  • 不在這版:VA 初剪品質的改進還在進行中,不在這版。

🆕 v0.27.0 重點

這版只改文件與安裝說明,程式、執行合約與 Skill 都沒動。

  • 改裝 Editkin 0.16.0:安裝連結改指向 Editkin 0.16.0 (Windows x64,標成 Latest)。Editkin 現在是免費的閉源軟體,EULA 允許永久個人與商業使用;GPL-3.0 原始碼停在 0.15.0-preview.20261029。
  • 省 token 的 MCP profile:Editkin 的一鍵「連接 AI 助手」會寫入 EDITKIN_MCP_PROFILE=va;手寫的 Codex/Claude Code editkin 設定請在 env 加上 EDITKIN_MCP_PROFILE = "va"。沒設定時 Editkin 用 compat,每回合約 5.4 萬 token 的工具定義, va 約 4 千(約略值,依 Editkin 自己的 profile 位元組預算)。→ SETUP.md 0-3
  • Editkin 0.16.0 值得知道的新工具:
    • make_video/revise_video(實驗性,要自己選用,列在 full profile):一次呼叫把工作資料夾的素材加一句話 做成只用已認證項目的草稿,回傳一張 contact sheet 和一段約 2 KB 以內的摘要;revise_video 一次最多改三處。 這條路不產生 workflow_contract.py 要驗的 v4 收據;VA 的預設流程仍是 Editkin v4 workflow(合約 revision 6)。
    • 美感底線:render、seal 與交付核准可能回 BLOCK_AESTHETIC;要到 READY 還需要一份視覺審片評分收據。 → TROUBLESHOOTING.md

🆕 v0.26.0 重點

  • 長片流程補進公開 Kit:python src/workflow_contract.py create-longform --session <session.json> (其餘旗標與 create 相同)建立「一支長片=一個 Editkin 專案、每章一份 edit-plan/v4、一次原子 set apply、 一次 render」的 run。session 最多 16 章、96 份素材(每章 32 份);章節 plan 的每個影格都必須落在該章範圍內, plan set 由 controller 決定性封存,章節檔一改就拒絕。DAG 來自 workflow_longform_contract.json(revision 1), revision 6 的 workflow_contract.json 位元組不變,create 與 Shorts 流程照舊。 → editkin-workflow-execution.md
  • 需要支援長片 set 的 Editkin:Editkin 的 get_autopilot_contract 必須帶 contract.longformPlanSet (audit_longform_plan_set/apply_longform_plan_set);沒有就在分析素材前以 LONGFORM_CAPABILITY_MISSING 停下。
  • 升級後請同步 Skill:已安裝的 Skill 必須含 workflow_longform_contract.json (install_or_upgrade.py --apply --install-skill 或 python src/release_manager.py install-skill), 否則 create-longform 會以 LONGFORM_CONTRACT_MISSING 拒絕。升級前建立、尚未跑完的 run 綁定舊版程式, 升級後會被擋下,請先跑完或開新 run。

🆕 v0.25.0 重點

  • 節奏場景規劃器 src/rhythm_templates.py:把 story JSON 加上 Editkin 當下的 Motion Library catalog, 排成逐幀精確的場景計畫 —— 只選已認證的項目、完整覆蓋每一幀、每景 2–5 秒預算(30 秒片預設 8–12 景, 可明確覆寫)。它只規劃與檢查,不渲染、也不改 Editkin 專案,純 Python 標準函式庫。 → rhythm-scene-templates.md
  • 2D/3D 混合動態海報規劃:editorial-hybrid-motion.md 定義每景的 scene job、追蹤與遮擋分級、實際操作路徑;context router 會把「2D/3D 混合」「動態海報」類需求導到這份文件。
  • Editkin Motion Library:160 個原創效果(80 個文字動畫、40 個轉場、40 個背景),VA 透過 Editkin 模組 graphic.text_motion、transition.motion_pair、background.motion_loop 呼叫。需要內含 Motion Library 的 Editkin 版本:Editkin 公開預覽版 v0.15.0-preview.20261022 已內含(仍是預覽版,會遇到 bug)。模組不存在時 VA 會記錄 NEW_MOTION_RUNTIME_REQUIRED,不會默默退回舊效果。
  • 直式 Shorts 對齊 Editkin 預覽版:Kit 現在接受 Editkin 預設的 kinetic 節奏;這版 Kit 搭配上面的 Editkin 預覽版,直式 Shorts 可以從頭跑到尾。
  • 審片伺服器安全修正:已授權的審片儲存在寫入當下會再驗一次;讀取 request body 期間 session 過期或被撤銷, 就無法再寫入 review.json。

▶️ 60 秒看它跑(不用素材、不用 Editkin)

python examples/02_caption_broll_match.py # Editkin v4 合約自測:完整 DAG + fail-closed 回歸
python examples/04_shorts_gate.py         # Shorts 閘門:壞剪法被擋 → 修好放行 → 換平台也放行
python examples/05_interview_plan.py      # 訪談來賓閘門:沒來源的數據在「錄影之前」就被擋下

只需要 Python 3.9+:不用 ffmpeg、不用 pip install、不用真素材。細節見 examples/README.md。

🎬 一次 Editkin v4 run 怎麼跑

python src/workflow_contract.py create --project <你的專案.editkin.json> \
  --material clip-a=<真實素材.mp4> --material clip-b=<另一份素材.mov>
python src/workflow_contract.py next <run>              # 下一批可執行步驟(可平行的會一起列)
python src/workflow_contract.py claim <run> <step>      # 取得 token 與要呼叫的 Editkin 工具/參數
python src/workflow_contract.py complete <run> <step> --token <token> --receipt <receipt.json>
python src/workflow_contract.py verify <run>            # 交付前驗整條收據鏈
  • 合約步驟:contract → session → 每份素材 prepare → keyframes → context → semantics → route+plugin discovery → plan v4 → audit → apply → render → visual review → outcome。
  • 每份素材以 CLIP_ID=SOURCE_FILE 綁真實 bytes(SHA-256);run 只放專案內 videos/_AUTOPILOT/editkin-v4/。
  • apply 中斷且無法證明已提交 → 進 reconcile(resume --apply-resolution ...),禁止自動重套。
  • 技術 QA 全綠仍要真人審片;機器不能代填 approved/certified。

完整狀態轉移 → editkin-workflow-execution.md; 卡住時 → TROUBLESHOOTING.md。

🧱 生產線與閘門

每條線都是同一個形狀:知識層(為什麼)→ 機械閘門(不靠記憶)→ Editkin v4 run(執行)。

生產線 知識層 機械閘門 執行
教學長片 script-style-framework.md、script-retention-craft.md、premium-motion-fx.md plan_gate → script_gate → pace_gate → editkin_voiceover_gate → final_delivery_qa(profile="teaching_longform") Editkin v4 run
直式 Shorts/Reels shorts-mastery-2026.md、vertical-teardown-method.md shorts_gate:結構與字幕規則,片長帶依平台(YT 死區不套到 IG/FB) Editkin v4 run
節奏場景/品牌 Motion rhythm-scene-templates.md、editorial-hybrid-motion.md rhythm_templates.py check:逐幀覆蓋、閱讀時間、已認證項目 Editkin Motion Library 模組 + v4 run
線上訪談 interview-show-playbook.md interview_gate(沒來源的來賓數據不上鏡)+ plan_gate interview_autopilot.py invite → plan 產 7 件套;剪輯走 v4 run
  • 閘門共用外殼 src/longform_maker/gate_core.py:回傳結構、assert 訊息、self-test 印法一致; 你自己加的閘門 import 三個函式就跟內建的行為一樣(判定規則各自留在自己的檔)。
  • 經營層:src/channel_tracker.py D2/D7/D28 快照排程+待辦、src/system_health.py 一鍵 GREEN/RED 健檢 → knowledge/ops-automation.md;爆款定義框架 → knowledge/viral-playbook-framework.md。
  • ⚠️ 閘門裡的門檻數字都是範例校準值,不是宇宙常數 —— 請用你自己的 3-5 支片重算(做法見 SETUP.md「Shorts 規則校準」)。

📦 內容一覽

層 模組 做什麼
Editkin v4 controller src/workflow_contract.py + workflow_contract.json + workflow_state.py/receipts source-byte 綁定、逐素材證據、plan v4、audit、原子 apply、render、審片與成效的可續跑 DAG
節奏場景規劃 src/rhythm_templates.py story + Motion Library catalog → 逐幀精確場景計畫;plan / check
Context router src/context_router.py 每個工作只組一個小而穩定的 context packet,按需求導到對應參考文件
品質閘門 src/longform_maker/:gate_core、plan_gate、pace_gate、script_gate*、shorts_gate*、editkin_voiceover_gate、music_engine 包裝先行、腳本、節奏、Shorts 結構與字幕、旁白覆蓋、BGM beat 分析
字幕品質 src/longform_maker/:word_captions、caption_grouping、caption_timeline 依字級時間戳斷句與分組,用於字幕品質掃描
交付 QA src/media_delivery_qa.py + src/delivery_media_ops.py 頻閃、死空檔、字幕同步、全幀掃描、音訊/A-V、斷句、BGM 覆蓋
審片與發布 src/review_loop.py、src/publish_hub.py、src/outcome_learning.py、src/channel_tracker.py 審片伺服器、唯一發布包、成效學習、D2/D7/D28 排程
訪談企劃 src/interview_autopilot.py + src/interview_gate.py + templates/interview/ 邀約、主持稿、訪綱、準備包、授權、錄製 checklist、發布包與 Shorts 切條
競品量測 src/teardown.py 刀速、刀距分布、換句÷剪點、LUFS;OCR 選配,缺套件只降級
健檢與更新 src/system_health.py、src/release_manager.py、install_or_upgrade.py 一鍵健檢;雜湊驗證的安裝、升級與回滾
知識與合規 knowledge/ 避坑原則、剪輯 craft、演算法、AI 內容合規與來源分級;索引 → knowledge/README.md
Codex Skill codex-skill/video-autopilot/ 給 AI agent 的公開 Skill 與參考文件
個人化入口 ⭐ SETUP.md + templates/ + config.example.py 只填自己的 voice、品牌、素材/匯出路徑;不帶任何人的私人設定

套件邊界與「完整」的定義 → docs/OPEN_SOURCE_SUITE.md。

🪦 已退役(v0.25.0)

這些舊機制已由 Editkin 取代,v0.25.0 起不再隨公開 kit 出貨:

  • 純 FFmpeg 的 vlog/Shorts 渲染器(src/silent_vlog_maker/)與舊 Shorts 直出流程(shorts_autopilot.py 等)
  • src/longform_maker/ 的渲染半邊(動態特效、螢幕錄影清理、品牌卡、調色、轉場、素材鍛造、縮圖模板等)
  • Python 合成、濾鏡、3D、模板編譯、tracked graphics、roto/keyer runtime 與舊 visual director
  • 內附的 Cleanup 工具 → 改用獨立 repo claude-skill-code-cleanup
  • v6 架構文件、範例 01/03 與部分舊參考文件

需要舊 FFmpeg pipeline 的人,請留在 tag v0.24.1。 完整清單與遷移說明 → CHANGELOG。

🚀 快速開始

  1. 先裝 Editkin、接上 AI、裝好這個 Kit:照上方〈先裝 Editkin(必要)〉三步,細節見 SETUP.md 步驟 0
  2. 讀 SETUP.md → 照問題把 templates/*.template.md 填成 profiles/*.md (或把整個 repo 丟給 Claude / ChatGPT,說「照 SETUP.md 問我問題,幫我生成 profiles/」)
  3. cp config.example.py config.py → 填你的專案、素材與匯出路徑
  4. 裝好 Python 3.9+ 與 ffmpeg(交付 QA 用)
  5. python src/system_health.py --quick 驗證乾淨安裝
  6. python src/workflow_contract.py create ... 建 run,照 next 一步步完成收據,audit 後再 apply / render

♻️ 安裝、舊版升級與更新

這個 repo 把完整可執行核心+公開 Codex Skill+更新/回滾系統當作同一個產品發布。 不論你是第一次安裝,或還停在沒有 updater 的舊版,都從同一支 bootstrap 開始:

Invoke-WebRequest https://github.com/Hao0321/video-autopilot-kit/releases/latest/download/install_or_upgrade.py -OutFile install_or_upgrade.py
python install_or_upgrade.py --install-root . --check
python install_or_upgrade.py --install-root . --apply --install-skill

macOS/Linux 可用:

curl -fLO https://github.com/Hao0321/video-autopilot-kit/releases/latest/download/install_or_upgrade.py
python3 install_or_upgrade.py --install-root . --check
python3 install_or_upgrade.py --install-root . --apply --install-skill

第一次採用舊資料夾必須明確執行 --apply;不能用 --auto 靜默接管。採用完成並建立管理檔清單後, 之後的相容版本才能以 --auto 套用。

更新改為手動:v0.24.x 的 24 小時自動檢查掛在已退役的 Shorts 入口上;v0.25.0 起沒有任何入口會自己檢查更新。 想更新時自己跑:

python install_or_upgrade.py --install-root <你的資料夾> --check
python install_or_upgrade.py --install-root <你的資料夾> --apply --install-skill   # 建議:會一併同步 Skill 與工作區結構
python src/release_manager.py auto       # 或:最多每 24 小時檢查一次,只套用相容版本
  • 新版會比較 semver,驗證 release zip SHA-256 與逐檔 SHA-256 後才套用。
  • config.py、profiles/、projects/、data/、videos/、assets/、後台成效與本機 outcome 永遠留在你的電腦,不進公開包、不被更新器覆蓋。
  • 未知自訂檔永不刪;已修改的官方管理檔在自動模式會停在 CONFIRM_REQUIRED。
  • 新版不再出貨的官方管理檔(例如 v0.25.0 退役的模組)會先備份再移除。每次覆蓋或移除前都會建立 .video-autopilot/backups/<transaction>/;需要時執行 python src/release_manager.py rollback。
  • 透過 install_or_upgrade.py 安裝或升級後,會非破壞地補齊 videos/_PUBLISH_HUB 與根目錄發布入口;不刪除、不覆寫影片、設定或未知檔案。
  • 重大/不相容版本不會靜默升級,必須由使用者確認。

完整契約見 open-source-release-and-upgrade.md。 開發者發布前使用 python src/release_manager.py build --base-url <本版 GitHub release URL>,會產生 固定 zip、.sha256 與 release-channel.json;發布時再連同根目錄的 install_or_upgrade.py,共上傳四件 release assets。

安全邊界:更新的是相容而且驗證過的公開核心,不是把任何人的私人影片、數據、設定或 授權不明素材同步給別人。完整開源與保護使用者資料必須同時成立。

需求

VA(Win / Mac / Linux)

  • Python 3.9+
  • ffmpeg / ffprobe 在 PATH 上(交付 QA、競品拆解會用到)
  • 媒體分析依賴:python -m pip install -r requirements-media.txt(固定版本;CI 與正式 Release 用同一份)
  • Mac/Linux:系統路徑與 CJK 字型由 src/platform_compat.py 自動探測(不要 hardcode 系統字型路徑)
  • 不需要任何依賴就能跑的部分:workflow_contract.py、rhythm_templates.py、範例 02/04/05。 Shorts 閘門 src/longform_maker/shorts_gate.py 是純 Python —— 建議平面 import(把 src/longform_maker/ 加進 sys.path 再 from shorts_gate import …,範例 04 就是這樣寫),不經過套件 __init__,零依賴才確實成立。
  • 訪談生產線的訪前企劃全程純 Python —— 產 7 件套不需要 ffmpeg 也不需要 pip 套件 → python examples/05_interview_plan.py
  • 競品拆解 src/teardown.py 有兩個選配套件:rapidocr-onnxruntime(OCR)+ opencc-python-reimplemented(簡轉繁)
    • 不裝會少什麼:剪點統計(刀速/刀距分布)與 LUFS 照跑;需要 OCR 的字幕相關量測(換句速率、換句÷剪點、 逐字稿)會跳過並印出安裝指令,退出碼仍是 0。
    • ⚠️ OCR 只讀得動燒錄字幕,實景招牌幾乎讀不到,而且讀錯時信心值仍然很高 —— 門檻擋不掉。 所以只能拿來讀別人的片,不可以拿去自動生成你自己影片的品名/價格字幕 → 邊界說明見 knowledge/vertical-teardown-method.md §2-8

Editkin

  • 安裝 Editkin 0.16.0 (目前只有 Windows 10/11 64 位元;免費閉源軟體;沒有數位簽章、沒有自動更新),步驟見 SETUP.md 步驟 0。 在 Editkin 首頁一鍵連接 Claude Code 或 Codex,/mcp 看得到 editkin 就接好了;手寫 MCP 設定時在 env 加上 EDITKIN_MCP_PROFILE = "va"
  • Editkin repo 裡的 GPL-3.0 原始碼停在 0.15.0-preview.20261029,不含 0.16.0 的變更; 0.16.0 起不公開原始碼
  • Editkin 的完整 Video Autopilot 流程(「複製開工指令」)要找得到本 kit 的 Skill:放在 %USERPROFILE%\.codex\skills\video-autopilot\(install_or_upgrade.py --install-skill 會裝在這裡), 或把 EDITKIN_VIDEO_AUTOPILOT_SKILL 設成 SKILL.md 的絕對路徑
  • 你的 AI agent 要能呼叫 Editkin 的 MCP 工具,並依 workflow_contract.json 回傳 receipts
  • 現行 plan schema:hao.video-autopilot.edit-plan/v4;舊 schema 一律 fail closed,不能進 audit 或 apply
  • Motion Library 效果需要內含 Motion Library 的 Editkin 版本(0.16.0 已內含);缺模組時記錄 NEW_MOTION_RUNTIME_REQUIRED

(選用) AI 助手(Claude / ChatGPT)也能照 SETUP.md 自動把你的答案生成 profiles。

設計理念

一套創作系統最值錢的是結構與方法論,不是某個人的私人數字。 所以這個 repo 給你骨架,你用自己的血肉填滿。

License

MIT — 保留標註即可自由使用 / 修改 / 商用。Editkin 是另一個專案:0.16.0 起是免費的閉源軟體(EULA 允許永久個人與商業使用), GPL-3.0 原始碼停在 0.15.0-preview.20261029;Editkin 不隨本 kit 打包。

Author

Hao0321 Studio — 從一套實戰的個人創作系統抽出來的開源框架。

About

Fill-in-your-own-data framework for YouTube / short-form video automation: CapCut JSON + ffmpeg tooling + an onboarding questionnaire. Ships with zero private data.

Topics

Resources

Contributing

Security policy

Stars

2.3k stars

Watchers

9 watching

Forks

Releases

Packages

Contributors

Languages