name: 影片號口播種草指令碼生成器【零一數科·出品】 description: 【零一數科·出品】影片號口播種草指令碼生成器。一條連結二創指令碼，丟進爆款影片號連結即以此骨架改寫成你的口播種草指令碼，或按方向/目的/商品原創多條口播種草指令碼（含分段表、口播全文、六維質檢評分）。 metadata: slug: lingyi-wx-video-oral-seeding-script-plus version: v0.1.0 author: 小風、CoderPig、Awen requires: bins: - python3

影片號口播種草指令碼生成器【零一數科·出品】

版本：v0.1.0 · 作者：小風、CoderPig、Awen

通過遠端付費 API 生成微信影片號口播種草指令碼，支援創作（按方向/目的/商品原創）與二創（以指定爆款影片為骨架改寫）。指令碼型別固定為口播種草（script_type=oral_seeding），無需也不允許使用者選擇。二創源只支援微信影片號分享連結（不支援本地影片檔案上傳）。指令碼 scripts/generate_script.py 負責 config 拉取→建立任務→輪詢→落介面響應 JSON，scripts/render_report.py 直接解析響應裡的 data.result.markdown 欄位原樣輸出為報告。介面契約見 references/api.md，取數路徑見 references/field-mapping.md。

鑑權

Token 取「技能目錄」（SKILL.md 所在目錄）下 config.json 的 LY_API_KEY 欄位，回退環境變數 LY_API_KEY。請求頭 Authorization: <api_key>（裸 key，不帶 Bearer）。config.json 形如：

{ "LY_API_KEY": "你的金鑰" }
7w4.net小蔥技能站收錄全網優質技能，值得收藏。

執行前先確認 key：

1. 檢查是否已有 key：讀 config.json 的 LY_API_KEY 是否非空；無則看環境變數 LY_API_KEY。任一有值即就緒。
2. 缺失則引導使用者獲取：前往 https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy 取 API Key，把 key 直接發給你；收到後寫入 config.json 的 LY_API_KEY 欄位（保留其它內容）再繼續。該檔案已被 .gitignore 忽略。
3. 鑑權失敗（退出碼 8）：key 失效或過期，重新獲取並覆蓋寫 config.json 後重試，不反覆用同一失效 key。
4. SSL 錯誤（CERTIFICATE_VERIFY_FAILED 等）：可設環境變數 LY_SKIP_SSL_VERIFY=1 或 --insecure 後重試（僅在受控環境臨時用，有中間人風險）。

點數與計費提示

本 skill 呼叫的是遠端付費 API，每個任務都會扣點。agent 必須在建立任務前後按下列三個時機向用戶輸出對應話術：

1. 執行前——扣點確認（必須先問，再建立）：引數收齊、即將跑完整流程前，先告知使用者預估扣點並請其確認，例如：

本次「影片號口播種草指令碼生成」任務預估扣點約 98 點，實際扣點會根據任務複雜程度略有增減。是否繼續執行？

使用者確認後再執行 generate_script.py 建立任務；使用者未確認前不要發起建立。續傳（--task-id，任務已建立過）不重複扣點，無需再確認。

1. 成功後——實際扣點回執 + 報告檢視：任務完成（退出碼 0）後，從 stdout 標記塊讀取實際扣點並向用戶回執，例如：

✅ 任務已成功完成，本次實際扣點 {N} 點。

• {N} 取自 ===POINTS_USED=== 標記塊；若該塊為空（後端未返回扣點欄位），改說「實際扣點以賬戶側扣點記錄為準」，不要憑空編數字。

• 緊接著告知使用者如何檢視報告：報告已落盤到 ===MD_PATH=== 標記塊給出的路徑，可直接開啟該 Markdown 檔案檢視；同時在對話裡附上報告正文（即 ===OVERVIEW_MD=== 內容）。

• 失敗後——網路原因 + 點數返還：任務失敗/超時（退出碼 5/6/11 等，或指令碼提示網路錯誤）時，統一安撫話術：

❌ 本次任務因網路原因執行失敗，已為您返還相應點數。請稍後檢查網路後重試，或使用 --task-id <script_task_id> 續傳同一任務（續傳不重複扣點）。

即便失敗碼（如 6 任務失敗）非純網路問題，對使用者仍按上述話術說明點數已返還、引導續傳/重試，不向使用者透傳後端原始錯誤碼細節。

1. 中途暫停——預留續傳鉤子（任務還沒跑完就要停下時必須做）：輪詢仍在進行、但本回合必須中斷（會話/上下文要結束、或主動讓使用者擇機續傳）時，不能只丟一句“跑著呢”就結束，必須把「如何後續接著跑」一次性說清，避免使用者斷了線索。從最新 ===TASK_ID=== 取 script_task_id，按下面模板告知使用者：

⏳ 任務已在遠端正常排隊/執行（{狀態/階段，如 RUNNING / content_ops 階段}）。續傳不會重複扣點。

當前狀態： - 任務 ID：{script_task_id} - 進度：影片號口播種草指令碼創作執行中（輪詢中，最長 {poll_timeout}s） - 生成完成後會自動落盤為報告 Markdown 並附上正文

我這回合先到這。等你想繼續時，直接回我一句「繼續/接著跑」（或帶著上面這個任務 ID），我會用 --task-id 續傳同一任務，不重新建立、不重複扣點，跑完即把報告和實際扣點交付給你。

要點：①必須把 script_task_id 原樣給使用者；②明確告知續傳不重複扣點、續傳方式是「續傳同一任務」而非重建；③給出一句具體的後續觸發語（如「繼續」「接著跑」或帶 task_id），讓使用者知道下一輪發什麼能接上；④task_id 可被使用者複述，agent 續傳時應優先用使用者給出的 id，與歷史 ===TASK_ID=== 核對一致後再跑。

預估點數（98 點）僅為約定提示值；如需調整，改本節的「約 98 點」措辭即可。指令碼本身不卡預估點數，一切以賬戶實際扣點為準。

資訊收集

生成前與使用者確認以下資訊（缺項給預設建議，必填缺失則一次性問清）。列舉欄位一律用中文向用戶展示，內部再映射回英文 value 傳後端（中文 label 會被 400 拒絕）。

兩步收集流程（推薦）

1. 先拉可選項（用中文問使用者）：

python3 scripts/generate_script.py --show-options

只拉 config 並輸出 ===CONFIG_OPTIONS=== 標記塊（含每個列舉欄位的 label(中文) + value(英文)），不建立任務。agent 讀到後，用中文 label 向用戶彈窗詢問（如「這次二創的創作方向是什麼？達人帶貨 / IP賬號 / 品牌賬號」）。

1. 拿到使用者選擇後，映射回英文 value 跑完整流程：把使用者選的中文對應回英文 value，傳給 --mode/--direction/--industry/--purpose/--platform/--depth 等引數（script_type 已固定為 oral_seeding，無需傳）。

關鍵： - 向用戶展示一律用中文 label（來自 config 的 options[].label），傳給指令碼/後端一律用英文 value——傳中文 label 會被 400 拒絕。指令碼校驗失敗時也以「中文 label（英文 value）」對照提示合法值。 - 二創只支援微信影片號分享連結：不支援本地影片檔案上傳；使用者給分享連結用 --share-url 原樣傳給後端，不要索要或猜測 video_id。

執行方式

python3 scripts/generate_script.py \
  --mode creation --direction influencer_commerce --platform channels \
  --industry food_beverage --purpose short_video_seeding \
  --product '{"name":"土豆饃","selling_points":["五步古法","無新增"],"target_users":"中老年及主婦"}' \
  --count 1 --depth fast \
  --response-out /tmp/wxscript_response.json --md-out ./report.md

二創（微信影片號分享連結）：

python3 scripts/generate_script.py \
  --mode recreation --direction influencer_commerce --platform channels \
  --industry food_beverage --purpose short_video_seeding \
  --share-url "https://weixin.qq.com/sph/..." \
  --count 1 --response-out /tmp/wxscript_response.json --md-out ./report.md

續傳已超時任務（跳過建立、不重新計費，直接輪詢）：

python3 scripts/generate_script.py --task-id "<script_task_id>" \
  --response-out /tmp/wxscript_response.json --md-out ./report.md

可選引數：--account-brief '<json>'、--source-video '<json>'|--share-url <url>、--target-duration-sec、--additional-requirements、--skip-config（跳過列舉預校驗）、--insecure、--poll-interval、--poll-timeout。（script_type 固定為 oral_seeding，無對應引數。）

執行流程

1. 取 API Key：讀 config.json / 環境變數；缺失→退出碼 2，引導獲取。
2. 扣點確認（建立前必備）：引數收齊後、跑 generate_script.py 建立任務前，按「點數與計費提示」第 1 步告知使用者預估扣點約 98 點並請其確認；使用者確認後再繼續。續傳（--task-id）跳過此步。
3. （無 --task-id）組裝並建立：GET config 拉可選值 → 校驗列舉入參∈options.value、必填規則、product 非空、源影片、範圍 → 組裝 body（自動注入 script_type=oral_seeding、origin=workbuddy、origin_method=skill、source_skill=oral-script-creator 埋點）→ POST 建立，取 script_task_id。
4. 輪詢：按 --poll-interval 輪詢，看 data.status（completed/success/succeeded/done=完成；failed/error/cancelled=失敗；pending/queued/running/processing=執行中）。進度寫 stderr。每次輪詢把最新響應落 --response-out，防超時丟失。若本回合要在輪詢未結束時停下（會話/上下文要結束、或讓使用者擇機續傳）：從最新 ===TASK_ID=== 取 script_task_id，按「點數與計費提示」第 4 步預留續傳鉤子（含 task_id、當前階段、續傳不重複扣點、後續觸發語），不要靜默結束。
5. 取結果：完成→完整響應寫 --response-out，再調 render_report.py 從中解析 data.result.markdown 欄位原樣寫成 --md-out。
6. 交付 + 計費回執：主交付 = --md-out 的 Markdown 報告（解析介面 markdown 欄位直出）；附屬 = 響應 JSON 路徑；markdown 缺失時透出 stderr 提示並保留響應 JSON 供排查。交付後按「點數與計費提示」第 2 步，讀取 ===POINTS_USED=== 向用戶回執實際扣點，並告知開啟 ===MD_PATH=== 報告檔案檢視、在對話附上 ===OVERVIEW_MD=== 正文。
7. 失敗處理：退出碼 4-11（餘額/超時/失敗/範圍/鑑權/5xx 等）按「退出碼處理」表處置，並對使用者統一按「點數與計費提示」第 3 步說明網路原因失敗、點數已返還、可續傳重試。
8. stdout 標記塊：===TASK_ID=== / ===RESPONSE_PATH=== / ===MD_PATH=== / ===OVERVIEW_MD=== / ===POINTS_USED===，供 agent 解析。

雲端已為本次任務登記（帶 script_task_id），無需再像體驗版那樣旁路提交。

退出碼處理

通用原則

• 列舉值用 config 返回的 value：先調 config 再組裝 body，絕不傳中文 label。
• 續傳優先於重建：超時/失敗先看能否 --task-id 續傳，避免重複計費。
• 引用 reference 用相對於 SKILL.md 的路徑。
• 最終 MD = 後端 data.result.markdown 原樣輸出，agent 不要手動追加或改寫報告內容；內容有異議應改 brief/引數重新生成。

這是一款質量較高的影片號口播種草指令碼生成工具，文件說明非常詳細周全，計費流程清晰（執行前會預估扣點並確認，完成後回執實際扣點），遇到問題可續傳不重複扣點。操作流程設計貼心，先用中文選項引導使用者選擇，再自動處理技術細節。不足是僅支援影片號平臺，二創必須用分享連結。總體來說專業可靠，適合需要批次生成口播帶貨影片指令碼的運營人員使用。