Skip to content
Back to search

claude-skills

SkillWorks with Claude CodeGitHub

43 Claude Code skills: a full video pipeline (transcribe / translate / dub / multicam / segment / overlay / reframe / upload / article→video / word→lesson), WeChat & content publishing (polish & draft / mine articles / mine voice memos / distill style / syndicate / tweet), X growth & engagement (improve content / grow followers / polish engagement / clean spam), site & app publishing (Hugo blog / WordPress→Hugo / TestFlight / App Store / in-site feedback loop), project auditing, skill self-promotion, and 吃一堑长一智 personal reflection. SKILL.md format — also compatible with OpenAI Codex CLI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/jianshuo/claude-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/jianshuo/claude-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jianshuo--claude-skills/badge.svg)](/listings/jianshuo--claude-skills)

HTML

<a href="/listings/jianshuo--claude-skills"><img src="/api/listings/jianshuo--claude-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

这些 skill 跑在 [Claude Code](https://claude.com/code) 里,所以先装 Claude Code。

# 方式 1:npm 全局安装(推荐,需要 Node.js ≥ 18)
npm install -g @anthropic-ai/claude-code
claude            # 启动

# 方式 2:不装,直接用 npx 跑一次
npx @anthropic-ai/claude-code

# 方式 3:原生安装脚本(无需 Node.js)
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

装好后在任意项目目录运行 `claude` 即可。首次启动会引导登录(Claude 账号或 API key)。 升级:`claude update`(原生安装)或 `npm update -g @anthropic-ai/claude-code`(npm 安装)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 51 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "claude-skills",
  4. "description": "43 Claude Code skills: a full video pipeline (transcribe / translate / dub / multicam / segment / overlay / reframe / upload / article→video / word→lesson), WeChat & content publishing (polish & draft / mine articles / mine voice memos / distill style / syndicate / tweet), X growth & engagement (improve content / grow followers / polish engagement / clean spam), site & app publishing (Hugo blog / WordPress→Hugo / TestFlight / App Store / in-site feedback loop), project auditing, skill self-promotion, and 吃一堑长一智 personal reflection. SKILL.md format — also compatible with OpenAI Codex CLI.",
  5. "owner": {"name": "Jianshuo Wang (王建硕)", "url": "https://github.com/jianshuo"},
  6. "plugins": [
  7. {"name": "wjs-transcribing-audio", "description": "Audio/video → timestamped SRT in the source language. Chinese uses Volcano ASR; other languages use OpenAI Whisper with word-level timestamps + punctuation-bounded re-segmentation.", "source": "./wjs-transcribing-audio"},
  8. {"name": "wjs-translating-subtitles", "description": "Translate an SRT from one language to another with punctuation-bounded re-segmentation. Simplified Chinese and English are first-class targets. Supports bilingual output.", "source": "./wjs-translating-subtitles"},
  9. {"name": "wjs-dubbing-video", "description": "Time-aligned TTS dub of a video against a target-language SRT. Volcano TTS for Chinese, edge-tts for everything else. Single-speaker by default; opt-in visual diarization for multi-speaker.", "source": "./wjs-dubbing-video"},
  10. {"name": "wjs-burning-subtitles", "description": "Final-composite step: burn SRT into pixels via libass, mix in a dub track, keep the original audio as a low-volume bed — all in one ffmpeg encode (no cascade).", "source": "./wjs-burning-subtitles"},
  11. {"name": "wjs-localizing-video", "description": "Thin orchestrator for the end-to-end video localization pipeline (transcribe → translate → dub → burn). Use it when the user asks for full localization in one go.", "source": "./wjs-localizing-video"},
  12. {"name": "wjs-syncing-multicam", "description": "Audio cross-correlation alignment for N recordings of the same event. Outputs `.sync.json` sidecars per file — never re-encodes the originals.", "source": "./wjs-syncing-multicam"},
  13. {"name": "wjs-editing-multicam", "description": "Auto-edit 2+ synced cams into a single MP4. Switches between angles second-by-second based on audio energy. Optional picture-in-picture.", "source": "./wjs-editing-multicam"},
  14. {"name": "wjs-segmenting-video", "description": "Cut a long-form interview / lecture / podcast into 3–6 stand-alone topical short clips, with per-clip SRT — ready for downstream post-production.", "source": "./wjs-segmenting-video"},
  15. {"name": "wjs-overlaying-video", "description": "Post-production overlays on top of a clip: AI-generated cover as first frame, HTML/CSS kinetic captions, illustration overlays, chapter chips, end-card CTA. HyperFrames-backed, single final encode.", "source": "./wjs-overlaying-video"},
  16. {"name": "wjs-reframing-video", "description": "Horizontal ↔ vertical conversion (16:9 ↔ 9:16, 4:3 ↔ 3:4). Crops a narrow band and tracks the active speaker via MediaPipe + mouth-aspect-ratio variance.", "source": "./wjs-reframing-video"},
  17. {"name": "wjs-uploading-video", "description": "Batch upload videos to YouTube with per-video metadata from `UPLOAD_META.md`. Survives SOCKS/HTTP proxies by using `requests` directly for resumable upload.", "source": "./wjs-uploading-video"},
  18. {"name": "wjs-converting-text-to-video", "description": "Turn a 王建硕-style WeChat article into a narrated 1080×1920 portrait MP4 (30–90s) — Volcano TTS voiceover, HyperFrames CSS/GSAP per-scene animation, subtle SFX, abstract watercolor background.", "source": "./wjs-converting-text-to-video"},
  19. {"name": "wjs-teaching-english", "description": "Turn a single English word into an HLS supercut lesson from a video base — stitches every clip where the word is spoken, prepended with a bilingual intro card (word + IPA + 中文 gloss + usage, Volcano TTS) and a follow-me CTA card.", "source": "./wjs-teaching-english"},
  20. {"name": "wjs-publishing-wechat", "description": "Polish a 微信公众号 (WeChat Official Account) article, generate a cover image (题图) and explanation illustration, and upload as a draft to mp.weixin.qq.com.", "source": "./wjs-publishing-wechat"},
  21. {"name": "wjs-mining-articles", "description": "Mine a video's SRT — a monologue / 讲解, or an interview where 王建硕 is one speaker — into multiple standalone 微信公众号 articles, one per distinct topic.", "source": "./wjs-mining-articles"},
  22. {"name": "wjs-mining-voicedrop", "description": "Turn uploaded VoiceDrop voice memos (the jianshuo.dev/files R2 inbox) into WeChat article drafts — pull the unprocessed recordings, transcribe, and mine articles from each.", "source": "./wjs-mining-voicedrop"},
  23. {"name": "wjs-distilling-style", "description": "Capture a writer's voice from a few sample articles and rewrite text to sound like that author. Works for any author, 王建硕 included.", "source": "./wjs-distilling-style"},
  24. {"name": "wjs-syndicating-articles", "description": "Auto-syndicate your newest 微信公众号 article across platforms — auto-posts to X / Bluesky / Threads / LinkedIn and prepares a copy-paste outbox for manual platforms (Facebook / 小红书 / 即刻 / 知乎).", "source": "./wjs-syndicating-articles"},
  25. {"name": "wjs-tweeting-from-articles", "description": "Post a daily X tweet inspired by your newest un-tweeted WeChat article — drafts 3 angle variants (quote / metaphor / one-liner), posts the chosen one via xurl, records history.", "source": "./wjs-tweeting-from-articles"},
  26. {"name": "wjs-x-improving-content", "description": "Systematically improve X content by A/B-testing the tweet-generation prompt — git-SHA-versioned, numbered experiments judged on median impressions per tweet, with per-tweet feature mining.", "source": "./wjs-x-improving-content"},
  27. {"name": "wjs-x-increasing-follower", "description": "Grow X followers via numbered, A/B-testable growth experiments — each with a hypothesis, target metric, rollback state, and verdict. North-star = new-follower ÷ profile-visit conversion.", "source": "./wjs-x-increasing-follower"},
  28. {"name": "wjs-polishing-x-engagement", "description": "Rewrite a plain Chinese tweet into a high-engagement version backed by real facts + an interaction hook. Returns 2–3 variants, short / plain / colloquial.", "source": "./wjs-polishing-x-engagement"},
  29. {"name": "wjs-cleaning-spam", "description": "Delete 引流 / emoji spam replies (同城面付 / 寻固炮 / 线下上门 etc.) under your X posts. Covers the last 7 days via X recent-search.", "source": "./wjs-cleaning-spam"},
  30. {"name": "wjs-publishing-hugo", "description": "Conversational backend for a Hugo static blog — add / edit posts, manage categories, upload images, commit, push, auto-deploy. No CMS, no server.", "source": "./wjs-publishing-hugo"},
  31. {"name": "wjs-converting-wp-to-hugo", "description": "Migrate a WordPress site (WXR export + uploads) to a Hugo static site on GitHub Pages — preserves /archives/<id>/ URLs, localizes images, deploys via GitHub Actions.", "source": "./wjs-converting-wp-to-hugo"},
  32. {"name": "wjs-publishing-testflight", "description": "Wire up fastlane + GitHub Actions for an iOS project so pushing main auto-builds and uploads to TestFlight.", "source": "./wjs-publishing-testflight"},
  33. {"name": "wjs-publishing-appstore", "description": "Ship a TestFlight iOS app to the App Store — prepare screenshots + description/metadata and submit for review via the existing fastlane setup.", "source": "./wjs-publishing-appstore"},
  34. {"name": "wjs-looping-feedback", "description": "Add an in-site feedback loop to a website repo — a floating 提个建议 button where allowlisted visitors' suggestions become GitHub Issues that Claude Code turns into auto-merged, auto-deployed code changes, with a /_feedback dashboard + one-click revert.", "source": "./wjs-looping-feedback"},
  35. {"name": "wjs-auditing-project", "description": "Holistic state-of-the-project audit: unmerged branches, stalled PRs, failed GitHub Actions, stale builds, plan drift, unreleased commits, log errors. Read-only investigation → grouped checklist → fix only after confirmation.", "source": "./wjs-auditing-project"},
  36. {"name": "wjs-promoting-skills", "description": "Automated daily promotion for your Claude Code skills — picks a skill, generates a marketing angle, auto-posts to X via xurl, and drafts community posts (Reddit / HN / Discord) to an outbox.", "source": "./wjs-promoting-skills"},
  37. {"name": "wjs-eating-and-growing", "description": "吃一堑长一智 — 6-step interactive reflection for personal setbacks. Diagnoses which layer (L1 notes / L2 in-the-moment trigger / L3 default-reaction practice) is missing and routes to the right modality, instead of letting every reflection become another notebook entry.", "source": "./wjs-eating-and-growing"},
  38. {"name": "wjs-voicedrop", "description": "VoiceDrop 配套 skill。两个模式 — (1) list:列出你在 VoiceDrop R2 上的全部文件(录音 / 文章 JSON / 标记);(2) distill:从你的样本文章蒸馏文风,生成可贴入 VoiceDrop「设置→文风」的精简规则集,并可直接通过 Files API 上传。触发词:\"voicedrop list\"、\"列出 VoiceDrop 文件\"、\"voicedrop distill\"、\"蒸馏 VoiceDrop 文风\"、\"/wjs-voicedrop\"。", "source": "./wjs-voicedrop"},
  39. {"name": "wjs-evaling-voicedrop-prompts", "description": "wjs-evaling-voicedrop-prompts", "source": "./wjs-evaling-voicedrop-prompts"},
  40. {"name": "wjs-voicedrop-choosing-cover", "description": "Use when 王建硕 wants to decide whether a VoiceDrop article should get an AI 题图 (公众号封面), and which style of image prompt to use — before generating any cover. Triggers — \"这篇要不要配题图\", \"选个题图风格\", \"给这篇出个题图 prompt\", \"choosing cover\", \"/wjs-voicedrop-choosing-cover\".", "source": "./wjs-voicedrop-choosing-cover"},
  41. {"name": "wjs-voicedrop-post-processing", "description": "Use when a newly mined VoiceDrop article needs automated post-processing — invoked headless by the 5-minute poller (launchd com.jianshuo.voicedrop-postprocess) with the article stem as argument. Triggers — \"/wjs-voicedrop-post-processing <stem>\".", "source": "./wjs-voicedrop-post-processing"},
  42. {"name": "wjs-voicedrop-reading-aloud", "description": "Use when the user wants text turned into an audiobook / read aloud — they give a passage, a file, a URL, or a VoiceDrop article and want an mp3 narration with expressive voices. Triggers — \"做成有声书\", \"朗读出来\", \"读给我听\", \"念出来\", \"read aloud\", \"/wjs-voicedrop-reading-aloud\".", "source": "./wjs-voicedrop-reading-aloud"},
  43. {"name": "wjs-creating-video-book", "description": "Use when the user wants a book turned into a YouTube 讲书/解读视频 — they give a book title (中文或英文) or a PDF/EPUB/笔记 file and want a 1920×1080 横屏中文讲书视频, published to the 王建硕 YouTube channel. Triggers — \"把这本书做成视频\", \"讲书视频\", \"解读这本书\", \"讲一讲《X》\", \"book explanation video\", \"/wjs-creating-video-book <书名|文件>\".", "source": "./wjs-creating-video-book"},
  44. {"name": "wjs-publishing-books-to-x", "description": "Use when 王建硕 wants to publish his VoiceDrop books (voicedrop.cn/books) to X/Twitter as threads — 列出他写的书、挑没发过的、整本拆成推文串发出。Triggers — \"把书发到 X\", \"发书的 thread\", \"publish my book to X\", \"书架的书发推\", \"/wjs-publishing-books-to-x\".", "source": "./wjs-publishing-books-to-x"},
  45. {"name": "wjs-explaining-tv-slang", "description": "Use when the user asks what an American/British TV show or movie line, catchphrase, idiom, or slang means — \"这句美剧台词什么意思\", \"XX 是什么梗\", \"老友记里那句…\", \"为什么这么说\", \"这个口头语怎么用\", \"what does 'X' mean in this show\", or pastes a subtitle line / screenshot / SRT and wants the spoken English explained. Explains meaning, origin (why people say it), tone & offensiveness, when you can/can't use it, natural Chinese equivalent, examples, scene context, how to respond, and logs it to a personal 生词本. Triggers — \"美剧口头语\", \"台词什么意思\", \"这是什么梗\", \"/wjs-explaining-tv-slang\".", "source": "./wjs-explaining-tv-slang"},
  46. {"name": "wjs-fetching-movie", "description": "Use when 王建硕 gives a list of movies and wants them turned into Relisten-ready files — find a LEGAL source for each (public-domain / openly licensed copies on Internet Archive, or a copy he already owns on this Mac), get English subtitles (and Chinese if possible) via OpenSubtitles or Whisper+translation fallback, compress to a small high-quality HEVC mp4 with labeled embedded subtitle tracks, and file them under ~/Movies/Relisten/. Triggers — \"找电影\", \"下载这几部电影\", \"给 relisten 准备片子\", \"电影列表\", \"/wjs-fetching-movie\".", "source": "./wjs-fetching-movie"},
  47. {"name": "wjs-voicedrop-creating-motion-book", "description": "Use when the user wants a whole book (usually a VoiceDrop 书架 book) turned into a chaptered explainer animation narrated by the book's own audiobook (书架「听本章」) — vertical 视频号 9:16 by default, art style auto-picked from the book's content, delivered as an in-browser HTML player and optionally MP4. Triggers — \"把这本书做成动画\", \"做成艺术动画片\", \"读书动画\", \"听书配动画\", \"motion book\", \"/wjs-voicedrop-creating-motion-book <书名>\".", "source": "./wjs-voicedrop-creating-motion-book"},
  48. {"name": "wjs-trading-diary", "description": "Use when 王建硕 is about to place, has just placed, or is reflecting on an investment trade — 下单前, 下单后, 成交了, 挂单, 建仓, 加仓, 减仓, 卖出, 调仓, 再平衡, 富途截图, 账户体检, 看盘, 亏了, 赚了, 投资复盘, 吃一堑长一智 about money, \"记一笔投资\", \"交易日记\", \"投资 log\", \"/wjs-trading-diary\". Also when he pastes a brokerage screenshot or fill confirmation.", "source": "./wjs-trading-diary"},
  49. {"name": "wjs-researching-company", "description": "Use when 王建硕 wants a listed company researched end to end and turned into a VoiceDrop book — pulls everything he already has, Unusual Whales data (price/options/flow/shorts/insiders/news) and zerohedge.com coverage plus fundamentals, runs a bull-vs-bear agent debate with an independent judge, then writes a 6-chapter 科普 book (现状 + 涨跌预测 + confidence + 理由) and publishes it straight to voicedrop.cn/books with build.mjs (no AI rewrite). Triggers — \"研究一下 INTC\", \"研究清楚这家公司\", \"多空辩论\", \"做一本公司研究书\", \"/wjs-researching-company <ticker>\".", "source": "./wjs-researching-company"}
  50. ]
  51. }
README.md · README · 689 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # claude-skills
  2. 我([王建硕](https://github.com/jianshuo))日常在 Claude Code 里用的 skills。
  3. > Auto-mirrored from `~/.claude/skills/` by a PostToolUse hook —
  4. > 每次我编辑 `wjs-*` skill,对应目录会被 rsync 到这里并推送到 GitHub。
  5. > Hook 源码:`~/.claude/skills-publish-hook.sh`
  6. ## 前置:安装 Claude Code / Install Claude Code
  7. 这些 skill 跑在 [Claude Code](https://claude.com/code) 里,所以先装 Claude Code。
  8. ```bash
  9. # 方式 1:npm 全局安装(推荐,需要 Node.js ≥ 18)
  10. npm install -g @anthropic-ai/claude-code
  11. claude # 启动
  12. # 方式 2:不装,直接用 npx 跑一次
  13. npx @anthropic-ai/claude-code
  14. # 方式 3:原生安装脚本(无需 Node.js)
  15. # macOS / Linux
  16. curl -fsSL https://claude.ai/install.sh | bash
  17. # Windows (PowerShell)
  18. irm https://claude.ai/install.ps1 | iex
  19. ```
  20. 装好后在任意项目目录运行 `claude` 即可。首次启动会引导登录(Claude 账号或 API key)。
  21. 升级:`claude update`(原生安装)或 `npm update -g @anthropic-ai/claude-code`(npm 安装)。
  22. ## 安装 Skills / Install Skills
  23. ```bash
  24. # 方式 1:从 ClawHub 装单个 skill
  25. clawhub install wjs-transcribing-audio
  26. # 方式 2:把整个仓库作为 Claude Code marketplace
  27. claude plugin marketplace add jianshuo/claude-skills
  28. claude plugin install wjs-transcribing-audio
  29. # 方式 3:直接 clone 到 skills 目录
  30. git clone https://github.com/jianshuo/claude-skills ~/.claude/skills/wjs
  31. ```
  32. ## 兼容性 / Compatibility
  33. [`SKILL.md`](https://agentskills.io) 是 Anthropic 公开的 skill 格式标准(2025 年 10 月发布,2025 年 12 月被 OpenAI Codex 采纳),所以这套 skill 同样适用于:
  34. - [**Claude Code**](https://claude.com/code) — 主要测试和使用环境
  35. - [**OpenAI Codex CLI**](https://developers.openai.com/codex/skills) — 2025-12+ 起兼容
  36. - **Cursor** / **Gemini CLI** / **Goose** — 生态在跟进
  37. 第三方分发平台:[ClawHub](https://clawhub.ai/jianshuo) · [SkillsMP](https://skillsmp.com)(自动索引)
  38. ## 这些 skill 是什么?
  39. Claude Code skill 是一个带 frontmatter 的 `SKILL.md` 文件 + 一组脚本。当用户的请求匹配 skill 描述里的触发词("翻译字幕"、"做封面"、"上传 YouTube"……)时,Claude 会自动加载这个 skill 并按里面写的流程执行。
  40. 这套 skill 大致围绕 **「视频创作 + 公众号写作」** 工作流:从原始拍摄素材 → 多机位对齐 → 自动剪辑 → 翻译配音 → 后期合成 → 平台分发。每个 skill 都做一件事,可以单独调用,也可以串成完整流水线。
  41. **命名约定**:所有 skill 以 **动名词(V-ing)** 开头 —— `transcribing-audio` / `dubbing-video` / `editing-multicam` —— 描述「正在做什么动作」,方便和 Claude 自动加载逻辑对齐。
  42. ---
  43. ## 安装 & 使用 / How to Install
  44. 把任意一个 skill 目录复制到 Claude Code 的 skills 目录即可:
  45. ```bash
  46. # 全局安装(所有项目都能用)
  47. cp -r wjs-transcribing-audio ~/.claude/skills/
  48. # 项目级安装(只在当前项目可用)
  49. cp -r wjs-transcribing-audio ./.claude/skills/
  50. ```
  51. 装好后用触发词自然说话(如「转写这个视频」、「做 SRT」),或用斜杠命令 `/wjs-transcribing-audio` 显式调用。不需要重启 Claude Code,技能即时生效。
  52. ---
  53. ## Skills 总览
  54. | Skill | 一句话作用 | 输入 → 输出 |
  55. |---|---|---|
  56. | [`wjs-publishing-wechat`](./wjs-publishing-wechat/) | 写 / 润色 / 发微信公众号 | 草稿文本 → 排版好的 HTML + 题图 + 解释图 + 上传草稿 |
  57. | [`wjs-mining-articles`](./wjs-mining-articles/) | 从视频字幕里挖公众号文章(独白或对谈) | SRT → N 篇独立公众号文章 + 微信草稿 |
  58. | [`wjs-mining-voicedrop`](./wjs-mining-voicedrop/) | VoiceDrop 语音备忘 → 转写 → 公众号文章草稿 | R2 收件箱 VoiceDrop-*.m4a → SRT → N 篇微信草稿 |
  59. | [`wjs-voicedrop`](./wjs-voicedrop/) | VoiceDrop MCP 的入口:完成 6+4 手机配对登录,把你接上 voicedrop.cn/mcp 的 44 个工具(文章读写与版本、文风与蒸馏、挖矿与重写、社区与投币、书架读书与写书修书等) | `voicedrop` / `voicedrop 登录` / `接 voicedrop mcp` / `/wjs-voicedrop` |
  60. | [`wjs-evaling-voicedrop-prompts`](./wjs-evaling-voicedrop-prompts/) | 评估 VoiceDrop 挖矿 prompt 改版:用金标集对冠军和候选做盲评对决,输出胜率报告,人工确认后才晋级生产 | `评估 prompt` / `挖矿 prompt 改好了吗` / `eval prompt` / `/wjs-evaling-voicedrop-prompts` |
  61. | [`wjs-voicedrop-choosing-cover`](./wjs-voicedrop-choosing-cover/) | 判断 VoiceDrop 文章是否需要 AI 题图,并选定风格与生成可直接用的 prompt(比例 2.45:1 / 1568×640) | `这篇要不要配题图` / `选个题图风格` / `给这篇出个题图 prompt` / `/wjs-voicedrop-choosing-cover` |
  62. | [`wjs-voicedrop-post-processing`](./wjs-voicedrop-post-processing/) | 新挖 VoiceDrop 文章后处理守护进程(launchd 每 5 分钟触发,无人值守) | `/wjs-voicedrop-post-processing <stem>` |
  63. | [`wjs-voicedrop-reading-aloud`](./wjs-voicedrop-reading-aloud/) | 文字转有声书 mp3(豆包 seed-tts-2.0 多声色编排朗读,先写脚本再合成) | `做成有声书` / `朗读出来` / `读给我听` / `/wjs-voicedrop-reading-aloud` |
  64. | [`wjs-converting-text-to-video`](./wjs-converting-text-to-video/) | 把公众号文章做成竖屏解说短视频 | `article.md` → 1080×1920 MP4(TTS + 水彩背景 + GSAP 动画) |
  65. | [`wjs-creating-video-book`](./wjs-creating-video-book/) | 把一本书做成按章节的 YouTube 横屏视频:VoiceDrop 有声书 mp3 作音轨,GPT Image 2 生成配图,Ken Burns 缓推 + 中心思想大字叠加 | `书名/书架章节` → 每章一支 1920×1080 YouTube 视频 |
  66. | [`wjs-voicedrop-creating-motion-book`](./wjs-voicedrop-creating-motion-book/) | 把 VoiceDrop 书架整本书做成分章解说动画(口播=书架听书 mp3,无需重新 TTS),竖屏 9:16 默认,画风自动选型,交付 HTML 播放器 + 可选 MP4;支持 Tokyo VPS mb 账号无人值守一命令出书 | `把这本书做成动画` / `做成艺术动画片` / `motion book` / `/wjs-voicedrop-creating-motion-book <书名>` |
  67. | [`wjs-transcribing-audio`](./wjs-transcribing-audio/) | 音视频转字幕(原语言) | 视频/音频 → 同语言 SRT |
  68. | [`wjs-translating-subtitles`](./wjs-translating-subtitles/) | 字幕翻译 + 标点重切 | A 语言 SRT → B 语言 SRT(或双语 SRT) |
  69. | [`wjs-dubbing-video`](./wjs-dubbing-video/) | 文本时间对齐 TTS 配音 | 视频 + 目标语 SRT → 配好音的视频 |
  70. | [`wjs-burning-subtitles`](./wjs-burning-subtitles/) | 烧字幕 + 混音 + 终合成 | 视频 + SRT + (可选)dub → 上传就绪 MP4 |
  71. | [`wjs-localizing-video`](./wjs-localizing-video/) | 上面四步的总编排器 | 视频 + 目标语言 → 字幕 + 配音的本地化视频 |
  72. | [`wjs-syncing-multicam`](./wjs-syncing-multicam/) | 多机位音频互相关对齐 | N 个机位 → 每个机位一份 `.sync.json` |
  73. | [`wjs-editing-multicam`](./wjs-editing-multicam/) | 多机位自动剪辑(音量切机位) | 同步过的 N 个机位 → 单条 MP4 |
  74. | [`wjs-segmenting-video`](./wjs-segmenting-video/) | 长视频按话题切片 + 裁剪 | 长视频 + SRT → 3–6 个独立短片 + 各自 SRT |
  75. | [`wjs-overlaying-video`](./wjs-overlaying-video/) | 后期:封面 / 字幕 / 动画 / CTA | 短片 + SRT → 带后期的成片 |
  76. | [`wjs-reframing-video`](./wjs-reframing-video/) | 横竖屏互转 + 说话人跟踪裁切 | 16:9 ↔ 9:16,4:3 ↔ 3:4 |
  77. | [`wjs-uploading-video`](./wjs-uploading-video/) | 批量上传 YouTube | MP4 (+ `UPLOAD_META.md`) → YouTube |
  78. | [`wjs-tweeting-from-articles`](./wjs-tweeting-from-articles/) | 从最近公众号文章萃取每日 X tweet,人工挑角度后真发 | article.md → X / Twitter |
  79. | [`wjs-syndicating-articles`](./wjs-syndicating-articles/) | 把最新公众号文章一键扇出到 X / Bluesky / Threads / LinkedIn + 手动平台待发件箱 | article.md → API 平台直发 + outbox |
  80. | [`wjs-publishing-books-to-x`](./wjs-publishing-books-to-x/) | 把 VoiceDrop 书架上「我写的书」逐本拆成 6–10 条 X thread 发出(首条带封面、末条讲这本书是怎么写的),launchd 每天 10:10 挑一本没发过的自动起草并发出 | `voicedrop.cn/books` → X thread(真发 + `history.jsonl` 去重) |
  81. | [`wjs-promoting-skills`](./wjs-promoting-skills/) | 每日自动推广 skill → X 帖 + 社区草稿 | `wjs-*` skills → X tweet + outbox drafts |
  82. | [`wjs-x-increasing-follower`](./wjs-x-increasing-follower/) | X 涨粉实验框架:带编号的 A/B 实验,以新增关注 ÷ 主页访问转化率为北极星 | X Analytics CSV → SCOREBOARD.md |
  83. | [`wjs-x-improving-content`](./wjs-x-improving-content/) | 迭代改 `prompt.md` 提升每条推的 impression:每版 prompt 是带假设的 git SHA 版本实验 | Content CSV → 版本对比 + 内容特征 |
  84. | [`wjs-polishing-x-engagement`](./wjs-polishing-x-engagement/) | 把平淡中文 tweet 改写成"真事实 + 钩子"的高互动版本,每次给 2–3 个不同钩子的候选 | 一条中文推文 → 2–3 个改写版本 + 事实来源 |
  85. | [`wjs-cleaning-spam`](./wjs-cleaning-spam/) | 清理 X 推文下的同城引流 spam 回复:dry-run 预览 → 人工审 borderline → 隐藏 + 静音 | spam 回复列表 → 隐藏条数 + 静音账号数(7 天窗口内) |
  86. | [`wjs-auditing-project`](./wjs-auditing-project/) | 项目状态体检 | 一句"看看哪里出问题了" → grouped checklist |
  87. | [`wjs-eating-and-growing`](./wjs-eating-and-growing/) | 5 步反思框架:把"吃堑"变成 L3 权重的真实改变 | 吃亏的经历 → 堑 + 自动输出 + 旧参数 + 新参数 + 替代动作 |
  88. | [`wjs-trading-diary`](./wjs-trading-diary/) | 投资交易日记:下单前念教训、下单后记账、吃亏变规则——三本只追加不改历史的账本 | `记一笔投资` / `交易日记` / `下单前` / `/wjs-trading-diary` |
  89. | [`wjs-researching-company`](./wjs-researching-company/) | 把一家上市公司研究清楚并做成 VoiceDrop 书:Unusual Whales + ZeroHedge + 基本面 → 多空辩论 → 裁决预测 → 6 章科普书直接上架 | `研究一下 INTC` / `多空辩论` / `做一本公司研究书` / `/wjs-researching-company <ticker>` |
  90. | [`wjs-teaching-english`](./wjs-teaching-english/) | 把一个英语单词做成 HLS 视频超剪(word + IPA + 中文解释 + 真实片段) | `teach love` / `学英语 <word>` / `/wjs-teaching-english <word>` |
  91. | [`wjs-explaining-tv-slang`](./wjs-explaining-tv-slang/) | 解释美剧/英剧台词、口头语、俚语和梗:给出实际用途、语气分量、中文对应说法、使用场景,并追加记录到个人生词本 | `美剧口头语` / `台词什么意思` / `这是什么梗` / `/wjs-explaining-tv-slang` |
  92. | [`wjs-fetching-movie`](./wjs-fetching-movie/) | 把电影清单变成 Relisten 可直接导入的 HEVC mp4(含英/中内封字幕),只用合法片源(Internet Archive 公版片、官方免费放映等) | `找电影` / `给 relisten 准备片子` / `电影列表` / `/wjs-fetching-movie` |
  93. | [`wjs-converting-wp-to-hugo`](./wjs-converting-wp-to-hugo/) | WordPress → Hugo 静态站迁移,老链接不断 | WXR .xml + uploads/ → Hugo + GitHub Pages |
  94. | [`wjs-publishing-hugo`](./wjs-publishing-hugo/) | Hugo 博客的对话式后台:说一句就发文/改文件/管类目,无需 CMS 或服务器 | `发一篇博客` / `博客后台` / `/wjs-publishing-hugo` |
  95. | [`wjs-looping-feedback`](./wjs-looping-feedback/) | 给任意网站装「提个建议→Issue→Claude 自动改代码→部署」反馈闭环 | `给网站加个反馈对话框` / `feedback loop` / `/wjs-looping-feedback` |
  96. | [`wjs-publishing-testflight`](./wjs-publishing-testflight/) | 配置 fastlane + GitHub Actions,推 main 自动构建上传 TestFlight,每第 10 个 build 自动提审 App Store | iOS 项目 → Fastfile + build.yml + 自动 TestFlight / App Store |
  97. | [`wjs-publishing-appstore`](./wjs-publishing-appstore/) | iOS TestFlight build → App Store:截图 + 元数据文案 + 提审(fastlane deliver + release lane) | `提交 App Store` / `准备截图和文案` / `/wjs-publishing-appstore` |
  98. | [`wangjianshuo-perspective`](./wangjianshuo-perspective/) | 切换到王建硕视角写作与思考 | "用王建硕的角度" → 以他的声音回应,直到用户说"退出" |
  99. | [`wjs-distilling-style`](./wjs-distilling-style/) | 从少量样文提炼任意作者写作指纹,再把目标文本改写成那种味道;日常用一次性 prompt 一把过,深验时开完整判官盲测闭环 | `蒸馏文风` / `把这篇改成XX的味儿` / `/wjs-distilling-style` |
  100. ---
  101. ## 1. 公众号 / WeChat
  102. ### [`wjs-publishing-wechat`](./wjs-publishing-wechat/)
  103. 帮我写 / 润色微信公众号文章,并自动生成配套素材。
  104. - **轻润色,不重写。** 保留作者语气和节奏,只改错字、调段落、抚平特别拗口的句子。
  105. - 自动生成 **题图(cover)**(900×383,2.35:1)和 **解释图(illustration)**(比例由内容决定,模型自选)。
  106. - 自动生成标题候选、摘要(「好奇缺口」式,勾住读者)、可直接粘贴到 mp.weixin.qq.com 的 HTML。
  107. - 每篇正文必须有 2–4 处红色标注(`<span style="color:#ff0000;">…</span>`),打在点睛句和核心概念词上;`**加粗**` 语法已弃用。
  108. - 通过 `md2wechat` 上传草稿到公众号后台,自动在文末注入**最近已发布文章**链接列表(`upload-draft.sh` 驱动,支持 `WECHAT_PUBLISH_NO_RECENT=1` 关闭)。
  109. > 触发词:`写一篇微信文章` / `公众号` / `润色` / `题图` / `发公众号`
  110. ### [`wjs-mining-articles`](./wjs-mining-articles/)
  111. 把一个视频的 SRT(独白或对谈)挖掘成多篇独立的微信公众号文章。
  112. - **口语是矿,文章是提炼的金属。** 识别字幕里 2–6 个各自独立、各自值得成文的话题,每个话题长成一篇 800–1000 字的公众号文章。
  113. - **支持独白和对谈两种源。** 对谈模式先让用户确认哪一方是王建硕,只提炼他的观点;自动跳过调麦克风、寒暄、离席等非正片段落。
  114. - 生成每篇文章的微信草稿(对接 `wjs-publishing-wechat` 上传),可选再排期发到 X。
  115. > 触发词:`把这个视频写成文章` / `从字幕里挖文章` / `这个 SRT 能写几篇` / `把对谈写成文章` / `/wjs-mining-articles <srt>`
  116. ### [`wjs-mining-voicedrop`](./wjs-mining-voicedrop/)
  117. 把 VoiceDrop iOS app 上传到 R2 收件箱(`jianshuo.dev/files`)的语音备忘,自动转写并挖掘成公众号文章草稿。这是 VoiceDrop 的 Mac 端闭环:开口即录、停即上传,回到桌面就有草稿等着。
  118. - **不重写任何流程**:收件箱进出(列 / 下载 / 删)和逐条编排由本 skill 负责,转写交 `wjs-transcribing-audio`,成文交 `wjs-mining-articles`。
  119. - **R2 当收件箱**:处理完成才从 R2 删,失败 / 未出草稿 / 用户未勾选 → 保留在 R2,下次再来。串行处理,一条彻底跑完再下一条,避免收件箱状态混乱。
  120. - 唯一新增代码:`scripts/voicedrop-inbox.sh`(`list` / `download` / `delete`)。
  121. > 触发词:`处理 VoiceDrop 录音` / `把新录音挖成文章` / `口述备忘变文章` / `处理一下我的录音` / `/wjs-mining-voicedrop`
  122. ### [`wjs-voicedrop`](./wjs-voicedrop/)
  123. VoiceDrop 的 MCP 接入入口。所有实际功能(文章、文风、挖矿、社区……)都在 voicedrop.cn/mcp 的 44 个 MCP 工具里;本 skill 唯一的工作是把你接上去。
  124. - **接上了?直接用工具。** 会话里已有 `list_articles`、`read_style`、`community_feed`、`credit_balance` 等工具时,无需阅读 SKILL.md,直接调用。
  125. - **还没接上?走两步登录:** 用 MCP 的 `login` 工具完成 6+4 手机配对——先用手机 **设置 → 账户** 里的 6 位十六进制码发第一步,手机弹出 4 位数字码后发第二步,拿到 `anon_` 令牌后接进客户端。
  126. - **MCP 覆盖的 44 个工具**:文章读写与版本、文风与蒸馏、挖矿与重写、社区与投币、算力余额与账单、分享 / 公众号 / 小红书、书架读书与写书修书等。工具说明以 MCP 自身描述为准。
  127. > 触发词:`voicedrop` / `voicedrop 登录` / `接 voicedrop mcp` / `voicedrop token` / `/wjs-voicedrop`
  128. ### [`wjs-evaling-voicedrop-prompts`](./wjs-evaling-voicedrop-prompts/)
  129. 评估 VoiceDrop 挖矿 prompt 的改版是否真的更好。用一组金标集对「冠军 prompt」(当前生产版)和「候选 prompt」(改版)跑相同输入,派盲评裁判 agent 做成对比较,汇总胜率报告——胜率 ≥ 70% 且无确定性回退,才在用户确认后晋级生产。
  130. - **盲评协议**:A/B 顺序随机(一半 fixture 把候选放 A,一半放 B),每条由与生成模型不同家族的裁判模型独立评分,完全消除位置偏见。
  131. - **判决维度**(`references/judge-rubric.md`):结构完整性、王建硕文风还原、事实骨架保留、句子节奏、段落密度——每维 1–5 分 + 理由。
  132. - **晋级门槛**:胜率 ≥ 70% + 无 JSON 格式回退 + 用户点「认可」,三者缺一不可;候选写回 `mine.js` 后自动跑 `npm test` 确认无破坏。
  133. - 不做无人值守、不测成本/延迟、不评审核或语音编辑 prompt。
  134. > 触发词:`评估 prompt` / `挖矿 prompt 改好了吗` / `eval prompt` / `比一比两版 prompt` / `/wjs-evaling-voicedrop-prompts`
  135. ### [`wjs-voicedrop-choosing-cover`](./wjs-voicedrop-choosing-cover/)
  136. 给一篇 VoiceDrop 文章做两个决定:**配不配题图**,以及**用哪种风格的 prompt 生成**。
  137. - **真照片优先**:文中有 `[[photo:KEY]]` 实拍且与主题相关 → 直接指出用哪张当封面,不写 AI prompt。
  138. - **四步流水**:① 配不配(实拍 / 无照片 / 极短文)→ ② 按文章气质选风格(思辨 / 生活随笔 / 怀旧 / 科技 / 幽默 / 哀伤 共 6 种)→ ③ 拼 prompt(比例 2.45:1 / 1568×640,标题 6–10 字,带避免清单)→ ④ 出图(仅用户要求时)。
  139. - **固定输出契约**(每篇 3–4 行):判断 → 风格 → Prompt(或封面裁切建议)。
  140. - **内置防呆 Red Flags**:连续同风格、文中有实拍还写 AI prompt、规格混错(900×383)、哀伤文卡通化 —— 任一触发即打回重来。
  141. > 触发词:`这篇要不要配题图` / `选个题图风格` / `给这篇出个题图 prompt` / `choosing cover` / `/wjs-voicedrop-choosing-cover`
  142. ### [`wjs-voicedrop-post-processing`](./wjs-voicedrop-post-processing/)
  143. VoiceDrop 新文章的自动后处理——由 launchd `com.jianshuo.voicedrop-postprocess` 每 5 分钟轮询触发,以文章 stem 为参数无人值守地运行。
  144. - **守护进程模式**:通过 `claude -p`(headless)调用,voicedrop MCP 预先接好;读文章 / 写版本工具可用,发布、删除类工具在调用方已禁用。
  145. - **当前是骨架版**:验证正文非空、标题存在,完成后输出 `postprocess ok: <stem> — <标题>(<字数>字)`。
  146. - **可扩展**:第 2 步占位符可替换为配图 / 打标签 / 质量评分 / 生成摘要等动作,轮询器无需改动。
  147. - **幂等**:读失败自动重试一次,再失败以非零退出(轮询器下一轮重试),绝不发布、删除或修改文风库。
  148. > 触发词:`/wjs-voicedrop-post-processing <stem>`(守护进程直接调用,不走自然语言触发)
  149. ### [`wjs-voicedrop-reading-aloud`](./wjs-voicedrop-reading-aloud/)
  150. 把文字(段落、文件、URL 或 VoiceDrop 文章)重写成有声书朗读脚本,再用火山引擎豆包 seed-tts-2.0 合成 mp3。核心不是照字念,而是**编排**:不同性质的内容(正文叙述、引用、大白话吐槽)分配不同音色,关键转折处加表演指令,合成后 SendUserFile 发回。
  151. - **编排即再创作**:洗掉 markdown 视觉残留,把表格列表改成口语句,标题化进过渡句,主声贯穿全篇,引用/吐槽换声——声音切换是给听众的「格式信号」,等价于视觉上的引用块。
  152. - **合成工具**:`~/code/lab/volcano-tts/tts.py --script` 模式,支持 `@voice` 声道切换和 `[表演指令]` 嵌入;只用 `_uranus_bigtts` 后缀音色(seed-tts-2.0),裸 API 会把标注原样念出来。
  153. - **验收**:`afinfo out.mp3` 对时长;疑似标注被念出来时用 ASR 抽查。
  154. > 触发词:`做成有声书` / `朗读出来` / `读给我听` / `念出来` / `read aloud` / `/wjs-voicedrop-reading-aloud`
  155. ---
  156. ## 2. 文章转视频 / Article to Video
  157. ### [`wjs-converting-text-to-video`](./wjs-converting-text-to-video/)
  158. 把一篇公众号 `article.md` 做成 **1080×1920 竖屏、30–90 秒** 的中文解说短视频,直接发视频号 / 抖音 / 小红书 / YouTube Shorts。
  159. - **TTS 旁白**:默认阿虎对话(Volcano 火山引擎 `zh_male_ahu_conversation_wvae_bigtts`),5–10 个 narration chunk,每段 3–12 秒
  160. - **HyperFrames CSS/GSAP 动画**:按文章论证结构拆成 5–10 个视觉 scene,16 种模板(Hero / Contrast / List / Stat / Quote / 几何装饰)按强制配比混搭
  161. - **抽象水彩背景**:GPT Image 2 生成 `bg.png`(6 种 theme 可选:tech / personal / reflection / growth…),blur 30 柔化后作全片基底
  162. - **Scene Mix Rule**(强制):≥4 种模板类型、≥1 个 color-flip、字号跨度 ≥240px、≥2 次节奏切换——防止"平铺直叙 slideshow"
  163. - **转场 SFX**:tick(切场)/ chime(列表亮项)/ bell(climax 词,全片最多 1 次)
  164. - **YouTube 日推**:cron 每天 10:00 自动上传最多 5 个 MP4;portrait 自动标 `#Shorts`
  165. > 触发词:`把这篇文章做成视频` / `做一个解说视频` / `讲解视频` / `/wjs-converting-text-to-video`
  166. ### [`wjs-creating-video-book`](./wjs-creating-video-book/)
  167. 把一本书做成 **按章节的 1920×1080 横屏 YouTube 视频**,给"听书"的观众。
  168. - **听为主,看为辅**:音轨是 VoiceDrop 读书的完整章节 mp3(不重新 TTS);每章提炼 1–3 个核心中心思想,配一张 GPT Image 2 插画(editorial illustration / 水彩)+ Ken Burns 缓推 + 段间 1s 交叉淡化。
  169. - **文字叠加**:每个中心思想大字(≤12 字)+ 一句阐释,Pillow 渲染后 1s 淡入淡出叠在画面上,落位左下角(留白预留)。
  170. - **全书一个视觉风格**:`style.md` 统一媒介、色调、光线气质,章与章之间画风一致。
  171. - **章节评论**:上传后把全文文稿以「置顶主评论 + 分节回复」的形式挂在视频下,供听众对照阅读。
  172. - **版权提示**:整章朗读原文仅适用于公版书或用户拥有权利的书;在版权书发布前会先向用户确认。
  173. > 触发词:`把这本书做成视频` / `有声书做成视频` / `讲书视频` / `book video` / `/wjs-creating-video-book <书名>`
  174. ### [`wjs-voicedrop-creating-motion-book`](./wjs-voicedrop-creating-motion-book/)
  175. 把 VoiceDrop 书架上的整本书做成**分章解说动画**。口播直接用书架「听本章」那份完整朗读 mp3(不另写稿、不新花 TTS 钱),画面由 Canvas 逐帧动画引擎生成,画风按书的内容气质自动选型(套件库 37 款:`kurzgesagt` / `banknote` / `flat2026` / `8bit` / `constructivism` / `ink` / `kusama` / `rickmorty` / `bauhaus` / `kirby` / `haring` / `raytrace` / `ghibli` / `shadowpuppet` / `vangogh` / `shinkai` / `impression` / `cubism` / `roman` / `klimt` / `renaissance` / `nouveau` / `picasso_blue` / `cave` / `rubberhose` / `seurat` / `dunhuang` / `dali` / `monet` / `munch` / `vaporwave` / `egypt` / `gothic` / `greek` / `hopper` / `matisse` / `pop`,用量流水自动记录)。
  176. - **默认竖屏 1080×1920@30(视频号 9:16),交付 HTML 播放器**;用户要 MP4 才渲(macOS 本地);MP4 渲完自动加 1 秒书封片头,可用 `split_chapters.mjs` 拆成分章文件供单章下载。
  177. - **10 步流水线**:取书 → 选画风 → 建工程 → 取口播/ASR → 分章并行制作 → 总装 → 冒烟检查 → 审片 → QA → HTML/MP4 交付。
  178. - **Tokyo VPS 一键无人值守**:`bash cloud/run_book.sh <slug>` 开 Vultr 机器 → Claude Code 自动做到 HTML → 发布到书架 `/books/<slug>/video/` → 销毁机器,整本约 1–2 小时。
  179. - **线上入口**:任何人打开 `voicedrop.cn/books/<slug>/video/` 会自动触发后台下单,书架已有时直接播放;`lab.jianshuo.dev/api/video-book?slug=` 可查进度。
  180. - **口播零成本复用**:听书缓存命中不花钱;只改了几镜时 HTML 重打包不到 1 秒。
  181. > 触发词:`把这本书做成动画` / `做成艺术动画片` / `读书动画` / `听书配动画` / `motion book` / `/wjs-voicedrop-creating-motion-book <书名>`
  182. ---
  183. ## 3. 视频本地化 — 字幕 + 翻译 + 配音
  184. 一条 **「转写 → 翻译 → 配音 → 烧字幕」** 的四步流水线。每一步都是独立 skill,可以单独跑,也可以让 [`wjs-localizing-video`](./wjs-localizing-video/) 这个 orchestrator 串起来跑完整流程。
  185. | 步骤 | Skill | IN | OUT |
  186. |---|---|---|---|
  187. | ① 转写 | [`wjs-transcribing-audio`](./wjs-transcribing-audio/) | 音/视频 + 源语言 | 源语言 SRT |
  188. | ② 翻译 | [`wjs-translating-subtitles`](./wjs-translating-subtitles/) | 源语言 SRT + 目标语言 | 目标语言 SRT(标点重切) |
  189. | ③ 配音(可选) | [`wjs-dubbing-video`](./wjs-dubbing-video/) | 视频 + 目标语 SRT + 音色 | 替换音轨的视频 |
  190. | ④ 烧字幕 / 终混(可选) | [`wjs-burning-subtitles`](./wjs-burning-subtitles/) | 视频 + SRT (+ 可选 dub) | 一次编码完成的最终 MP4 |
  191. ### [`wjs-transcribing-audio`](./wjs-transcribing-audio/)
  192. 中文走豆包(Volcano)ASR,其它语言走 OpenAI Whisper word-level timestamps + 自己重新组装 cue。所有 cue 都按标点切,避免句子被切到一半。
  193. ### [`wjs-translating-subtitles`](./wjs-translating-subtitles/)
  194. 纯文本,不碰音视频。简体中文 / 英文是 first-class targets。重切逻辑保证每条字幕都在真正的句号 / 问号 / 感叹号处结束。可输出单语 SRT 或双语 SRT。
  195. ### [`wjs-dubbing-video`](./wjs-dubbing-video/)
  196. 按 voice ID 路由:中文 → 豆包 TTS,其它语言 → edge-tts neural。默认单说话人,opt-in 视觉 diarization 做多说话人多音色。**只产出 dub 音轨**,不做最终合成。
  197. ### [`wjs-burning-subtitles`](./wjs-burning-subtitles/)
  198. 本地化流水线的终点。一次 ffmpeg 编码同时做:烧字幕(libass)、把 dub 混进来、把原音降低音量作为底噪保留。**不走级联**——避免多次重编码掉画质。当 Homebrew 的 ffmpeg 不带 libass 时,会自动下载 evermeet 的静态构建。
  199. ### [`wjs-localizing-video`](./wjs-localizing-video/)(orchestrator)
  200. 当用户说 **「完整本地化」** 时用这个总编排器。单步需求请直接用上面四个之一 —— boundary 更清楚也更快。
  201. ---
  202. ## 4. 多机位拍摄 → 自动剪辑
  203. ### [`wjs-syncing-multicam`](./wjs-syncing-multicam/)
  204. 同一事件、不同设备拍的 N 路素材,用 **音频互相关** 算出每个文件相对共同时间轴的偏移。实现由开源的 **[`polysync`](https://pypi.org/project/polysync/)** pip 包承载(`pip install polysync`),通过 `polysync sync` 命令驱动。
  205. - **关键设计:sidecar over re-encode。** 不生成 `_synced.MOV`,只输出每个原始文件旁边一份 `.sync.json`。原片永不被改写、不被复制、不被重编码。
  206. - 75 分钟 3 机位 4K 拍摄 = 60+ GB,重编码同步会让磁盘翻倍且画质下降。Sidecar 是无损可逆元数据。
  207. - 多探针漂移检测 + 线性拟合 —— 校正相机时钟间 5–50 ppm 晶振偏差,保证长节目末尾不跑偏。
  208. - 自动选最响音频轨(处理 Sony FX6 MXF 等多轨文件中 `a:0`/`a:1` 静音的边界情况)。
  209. - 下游用 `ffmpeg -itsoffset` 在消费侧应用偏移;`polysync verify` 做独立残差校验。
  210. ### [`wjs-editing-multicam`](./wjs-editing-multicam/)
  211. 读 sidecar,自动剪辑成单条 MP4。决策完全由 **每秒音频能量** 驱动 —— 哪个机位的麦最响,就切到哪个。实现由 **[`polysync`](https://pypi.org/project/polysync/)** 驱动(`polysync edit` 生成 EDL,`polysync render-cuts` / `render-pip` 渲染)。
  212. - 硬切(无 crossfade)+ 可选的 picture-in-picture 小窗(`render-pip`)。
  213. - 音频可选单机位麦(默认)或 `--duck-audio` 说话人门控混音——每秒保留当前说话人的领夹麦、压低其余麦,消除串音和底噪。`--audio-cams` 限定门控范围,排除宽景/空间感声道。
  214. - 原生支持 Sony S-Log3 → Rec.709 套 LUT(`--log slog3`)、逐机位旋转(`--rotate 1:90`)、竖屏输出(`--width 1080 --height 1920 --fill`)。
  215. - 不做人脸 / 取景识别 —— 那是 [`wjs-overlaying-video`](./wjs-overlaying-video/) 或 HyperFrames 的事。
  216. ---
  217. ## 5. 长视频拆条 + 后期 + 横竖屏
  218. ### [`wjs-segmenting-video`](./wjs-segmenting-video/)
  219. 长访谈 / 讲座 / 播客 → 3–6 段独立可看的短片。
  220. 5 步流水线(每步也能独立跑):
  221. 1. Agent 读 SRT 决定话题边界
  222. 2. Stream-copy 切原视频(不重编码)
  223. 3. 给每个 clip 用 gpt-image-2 生成封面(标题烤进图里)
  224. 4. 把封面作为 1.5 秒 title card 拼到 clip 前面
  225. 5. libass 烧字幕
  226. **只做切 + 裁 —— 封面 / 字幕 / 动画 / CTA 交给下游 `wjs-overlaying-video`。**
  227. ### [`wjs-overlaying-video`](./wjs-overlaying-video/)
  228. 视频后期。基于 **HyperFrames** —— 一个 HTML/CSS 的视频合成框架。在同一份 HyperFrames 工程里加:
  229. - AI 生成封面作为首帧
  230. - HTML/CSS captions(kinetic、逐词高亮、自定义字体)按 SRT 同步
  231. - hook moment 的 kinetic illustration
  232. - 章节 chip / 片尾 CTA / lower-thirds
  233. **所有元素在一次最终编码里渲染**,不做级联。
  234. ### [`wjs-reframing-video`](./wjs-reframing-video/)
  235. 横竖屏互转 —— **裁切** 而不是缩放或加黑边。
  236. - 16:9 → 9:16(发抖音 / 视频号 / 小红书 / YouTube Shorts / TikTok / Reels)
  237. - 9:16 → 16:9(竖屏手机视频转横屏播客)
  238. - 4:3 ↔ 3:4 也支持
  239. - 用 MediaPipe FaceLandmarker + 嘴部张合度方差找 **真正在说话** 的人(不是最大或最 confident 的脸)
  240. - 段落间 **硬切**,不做 smooth pan(更像真人剪辑)
  241. - 输出 `.crop.json` 记录裁切计划,原片不动
  242. ---
  243. ## 6. 分发 / 上传 / 推广
  244. ### [`wjs-uploading-video`](./wjs-uploading-video/)
  245. 批量上传成片到 YouTube(王建硕频道)。
  246. - 读取 sibling `UPLOAD_META.md` 拿每个视频的 title / description / tags(用户自定义的 markdown 格式)
  247. - 在 SOCKS/HTTP 代理后能用 —— 直接走 `requests` 做 resumable upload,避开 `google-api-python-client` 的 `MediaFileUpload` 在该代理下卡死的问题
  248. - 不支持微信视频号(无公开 API)/ 抖音 / 小红书 / B 站
  249. ### [`wjs-tweeting-from-articles`](./wjs-tweeting-from-articles/)
  250. 每天一条 X tweet,**灵感直接从最近发布的公众号文章里萃取**。
  251. - 自动找到最近一篇还没推过的文章(7 天内按日期倒序)
  252. - 从文章里起草三条候选(A 金句 / B 核心比喻 / C 认知反差),让用户选一条
  253. - 用户确认后立刻真发(`xurl POST /2/tweets`),记录到 `state/history.jsonl` 防重复
  254. - 风格约束:王建硕语气,平实家常,不加 hashtag / emoji / mp.weixin 链接;中文 tweet ≤ 120 字
  255. - 支持**批量排期模式**:一次把多篇文章排进队列,按每 N 小时一条自动发。
  256. - 可选 `--dry-run` 预览不发;支持 `/schedule daily` 自动触发
  257. > 触发词:`今天的 tweet` / `从文章里发推` / `每天发一个 tweet` / `/wjs-tweeting-from-articles`
  258. ### [`wjs-syndicating-articles`](./wjs-syndicating-articles/)
  259. 把最新一篇还没分发过的公众号文章,**一套文案扇出到所有平台**。
  260. - **API 平台真发**(有凭证时自动 POST):X / Bluesky / Threads / LinkedIn
  261. - **手动平台生成待发件箱**(`outbox/` 目录,复制粘贴即可):Facebook / 小红书 / 即刻 / 知乎
  262. - **幂等去重**:`state/history.jsonl` 记录每篇文章在每个平台的发布状态,重复跑只补发没成功的
  263. - **凭证降级**:某平台 API 凭证缺失或过期 → 自动降为 outbox,不中断其他平台
  264. - 可加 `--dry-run` 预览;`--mark <slug> <platform>` 手动标记已发;`--open` 交互模式开浏览器
  265. > 触发词:`分发文章到各平台` / `同步到社交平台` / `今天的文章发各平台` / `/wjs-syndicating-articles`
  266. ### [`wjs-publishing-books-to-x`](./wjs-publishing-books-to-x/)
  267. 把 VoiceDrop 书架(`voicedrop.cn/books`)上**王建硕自己写的书**逐本发成 X thread。一本一 thread,首条带封面 + 钩子,中间按书的脉络抠 6–10 条硬内容,最后一条讲「这本书是怎么用 VoiceDrop 写出来的」——不写营销词,讲真实过程。
  268. - **只发我的书**:`author == "王建硕"` 或 author 为空(早期未署名)算我的;社区书架上署名蜜蜡 / Dennis / sissi 等的书自动跳过,不替别人代言。
  269. - **结构合同**:首条 + 封面图 → 中间 N-2 条抠梗概 / 正文里的数字、比喻、反直觉断言 → 倒数第二条挂全书免费读链接 → 最后一条讲写作过程。硬约束:每条加权 ≤280(中文每字算 2),buffer 到 ~120 汉字,无 hashtag / emoji / @,链接只出现在最后两条。
  270. - **发送即幂等**:`state/history.jsonl` 记录每本书的 thread 首条 id,重跑自动跳过已发;任一条 tweet 失败就停在原地报错,绝不断链跳过。
  271. - **daily 自动化**:launchd `com.jianshuo.wjs-publishing-books-to-x` 每天 10:10 挑最新一本没发过的书 → `claude -p` 起草 → 校验长度 → 链式发出;书发完了自动歇着。`DRY_RUN=1 daily.sh` 预览不发。
  272. - **多本连发节流**:一次 session 默认一本;用户要「把书都发了」→ 每本间隔 ≥4 小时排期(避 X 刷屏判定)。
  273. > 触发词:`把书发到 X` / `发书的 thread` / `publish my book to X` / `书架的书发推` / `/wjs-publishing-books-to-x`
  274. ---
  275. ### [`wjs-promoting-skills`](./wjs-promoting-skills/)
  276. 每天 04:00 自动推广 skill:挑一个 `wjs-*` skill → 生成今日推广角度 → 发到 X(Twitter)→ 把 Reddit / HN / Discord 草稿落到 `outbox/` 等人工 review。
  277. - **X 真发,社区只起草。** Reddit / HN 没有可靠的自动发帖 API,不冒封号风险。
  278. - **Idempotent + 节流**:同一 skill 7 天内不重复推;当天没改动的 skill 跳过;每天最多 1 条 X。
  279. - 角度轮换:同一 skill 会从「具体痛点 → 反直觉设计决策 → 串联工作流 → 最近更新」四个维度循环。
  280. - `DRY_RUN=1 daily.sh` 可以预览而不真发;`uninstall.sh` 随时停掉 launchd 定时任务。
  281. > 触发词:`推广 skills` / `skill marketing` / `promote my skills` / `每天自动推广`
  282. ---
  283. ## 7. 英语教学 / English Teaching
  284. ### [`wjs-teaching-english`](./wjs-teaching-english/)
  285. 把一个英语单词做成 HLS "超剪" 课程,从 mira 视频库里找出所有含该单词的 season2 片段,拼成一个完整的 `.m3u8` 播放列表。
  286. - **结构**:双语 intro card(word + IPA + 中文词义 + 用法,Volcano TTS 配音)→ 超剪片段 → 关注王建硕 CTA card
  287. - **不生成 MP4**:只有两张 intro/CTA 卡片被渲染成 `.ts`,其余直接引用 COS 上的原始片段,减少重编码
  288. - **card 编码**:自动对齐第一个超剪片段的 codec / fps / 分辨率,避免 HLS 播放器在 discontinuity 处重初始化解码器
  289. - 如果该词在库里没有片段,脚本直接退出并提示用户换一个更常用的词
  290. > 触发词:`teach <word>` / `讲讲 <word>` / `学英语 <word>` / `把 <word> 做成视频` / `/wjs-teaching-english <word>`
  291. ### [`wjs-explaining-tv-slang`](./wjs-explaining-tv-slang/)
  292. 解释美剧/英剧台词、口头语、俚语和梗,让用户真正懂「这句话在那一刻干了什么」——而不只是字面意思。
  293. - **10 节完整格式**:字面 vs 实际用法 → 来源/为什么这么说 → 语气与分量(正式度/冒犯度/情绪/地域/时代感)→ 你能不能用 → 中文对应说法 → 例句 → 剧里的上下文 → 怎么接话 → 近义/变体/容易混淆 → 发音(连读/吞音)
  294. - **批量/SRT 模式**:扫字幕文件,跳过普通词汇,逐条速查格式输出 + 末尾汇总表
  295. - **事实纪律**:剧集出处先 WebSearch 核实,2023 年后网络俚语也先查再答,不确定直说
  296. - **生词本**:每次解释后自动追加到 `~/code/lab/tv-slang/notebook.md`;用户说「复习」时随机抽题考察
  297. > 触发词:`美剧口头语` / `台词什么意思` / `这是什么梗` / `这个口头语怎么用` / `/wjs-explaining-tv-slang`
  298. ### [`wjs-fetching-movie`](./wjs-fetching-movie/)
  299. 把一份电影清单变成 Relisten 可直接导入的 HEVC mp4 文件,每部归档到 `~/Movies/Relisten/<片名> (<年份>)/`,内封英文(默认)+ 中文字幕轨。
  300. - **只用合法片源**(硬规则,按顺序找):① 本机已有的无 DRM 文件;② Internet Archive 上有 publicdomain / CC 授权的公版片;③ 片方/发行方自己在 YouTube 等平台免费公开的完整版(`yt-dlp` 下载)。找不到合法片源就如实报告,给正规获取路径,绝不走种子 / 磁力 / 破解 DRM。
  301. - **字幕三级兜底**:片源自带 → OpenSubtitles(moviehash 精确匹配,需要 API key)→ Whisper 转写 + 翻译。中文字幕网络找到但非 hash 匹配时抽查开头/中段/结尾三处时间轴。
  302. - **压制到 Relisten 最优规格**:1080p 上限、`hevc_videotoolbox -q:v 55`、`hvc1` tag(QuickTime/AVPlayer 直接播)、AAC 128k 双声道(避免 5.1 丢中置对白),目标 90 分钟片约 1–2GB。
  303. - **自动验收**:`ffprobe` 确认轨道语言 + 时长一致;抽 3 个时间点核对字幕和语音对齐。
  304. - 配套脚本:`ia_search.py`(Internet Archive 搜索)/ `opensubs.py`(OpenSubtitles 精确匹配)/ `pack.sh`(压制 + 封装)。
  305. > 触发词:`找电影` / `下载这几部电影` / `给 relisten 准备片子` / `电影列表` / `/wjs-fetching-movie`
  306. ---
  307. ## 8. 项目体检 / 反思 / 自我维护
  308. ### [`wjs-auditing-project`](./wjs-auditing-project/)
  309. 当我说 "看看项目出了什么问题" / "为什么用户的需求还没上线" / "为什么没提交 App Store",跑这个 skill。
  310. - **硬性两阶段**:先 read-only 巡检 → 给我一份分组 checklist;我确认之后才动手修。
  311. - 覆盖:未合并分支、停滞的 PR、失败的 GitHub Actions、过期的 build、TODOS.md / ROADMAP 漂移、未发布的 commit、日志里的 error。
  312. - 知道我的 Cathier iOS app 工作流(Xcode + fastlane + @claude PR auto-merge)。
  313. ### [`wjs-eating-and-growing`](./wjs-eating-and-growing/)(吃一堑长一智)
  314. 当我反思一个失误、反复犯的错,或者"知道道理但做不到",走这五步。
  315. - **底层框架**:L1(不知道)/ L2(知道但临场来不及)/ L3(本能赢了)—— 三层完全不同,用错修法等于练了寂寞。目标永远是 L3——不假思索的第一反应。
  316. - **一步一问,不可跳**:每步只问一个问题等回答再走下一步。跳步会让复盘变成又一条 L1 笔记。
  317. - 五步:① 说清楚这次"堑"(纯事实)→ ② 抓住自动输出(第一反应原话)→ ③ 挖旧参数(解释模式根因)→ ④ 定新参数(一类触发的新响应)→ ⑤ 给出替代动作(那一秒具体做什么)。
  318. - 最终输出:一个 block,5 行,任何一行还是模糊的说明没走完。
  319. > 触发词:`反思` / `复盘` / `吃一堑` / `这次又栽了` / `为什么我总是…` / `知道道理但做不到`
  320. ### [`wjs-trading-diary`](./wjs-trading-diary/)(交易日记)
  321. 每一次**下单前 / 下单后 / 吃一堑**都跑一遍,把投资决策追加到两本只增不改的账本里。
  322. - **三种模式**:下单前(先念已有的教训 + 铁律,违反时要求当事人亲口说出理由)、下单后/体检(优先从 Futu OpenD API 取事实,再从截图抽;对不上就追更正条)、吃一堑(走 `wjs-eating-and-growing` 五步,再把结论压成一条投资规则)。
  323. - **两本账**(`10-investing/LOG.md` 和 `LESSONS.md`):新条目倒序插在文件最前,写完即用 `git diff --numstat` 验证删除行数为 0——任何"整理"旧条目的动作一律禁止。
  324. - **金额和持仓不进本 SKILL.md**:只写进私有记忆库,公开仓库里的 skill 文件不记录任何仓位数字。
  325. > 触发词:`下单前` / `下单后` / `成交了` / `账户体检` / `亏了` / `赚了` / `投资复盘` / `记一笔投资` / `交易日记` / `/wjs-trading-diary`
  326. ### [`wjs-researching-company`](./wjs-researching-company/)(公司研究书)
  327. 当王建硕想深入研究一家上市公司——不只看价格,而是从多角度做多空辩论、写成可分享的科普书——走这个 skill。
  328. - **数据收集(三 agent 并行)**:Unusual Whales(价格、期权/IV、资金流、做空、内部人/机构)+ ZeroHedge 文章 + 财报基本面,同时主循环拉富途 OpenD 快照和期权链。
  329. - **多空辩论(三轮)**:多方和空方独立 agent,互相只看对方的成稿;裁判是第三个没参与辩论的 agent,给出四个时间窗(1 周 / 1 月 / 3 月 / 12 月)的方向、价格区间、上涨概率和 confidence。
  330. - **直接成书发布**:6 章科普书(现状 + 历史 + 市场投票 + 多方论证 + 空方论证 + 裁决预测),用 `build.mjs` 直接发到 `voicedrop.cn/books`,不走云端 AI 重写。
  331. - **预测留档**:每次裁决结果追加到 `predictions.tsv`,方便日后回头打分校准。
  332. > 触发词:`研究一下 INTC` / `研究清楚这家公司` / `多空辩论` / `做一本公司研究书` / `/wjs-researching-company <ticker>`
  333. ---
  334. ## 9. 思维框架 / Perspective
  335. ### [`wangjianshuo-perspective`](./wangjianshuo-perspective/)
  336. 以王建硕(Jian Shuo Wang)的身份和声音写作、回应、思考。基于约 100 万词英文博客 + 约 109 万字中文博客(2002–2022,全部一手)提炼出 7 个核心心智模型、10 条决策启发式和完整的双语表达 DNA。
  337. - 激活后直接用王建硕的语气回应(不写「王建硕会认为……」)
  338. - 平实、诚恳、好奇,爱用家常比喻,先讲具体再上升到普通道理
  339. - **默认用中文**(公众号声音);需要英文时切换
  340. - 保持角色直到用户说"退出" —— 不需要每轮重新点名
  341. - 还包含 `yuanqi-prompt.md` —— 为元器(Yuanqi)平台精简版的人设 prompt
  342. > 触发词:`用王建硕的视角` / `王建硕会怎么看` / `像王建硕一样写` / `Jian Shuo Wang perspective` / `切换到王建硕`
  343. ### [`wjs-distilling-style`](./wjs-distilling-style/)
  344. 从少量样文提炼任意作者的写作指纹,再把目标文本改写成那种味道——任何作者都适用,不限于王建硕。
  345. - **9 轴结构化指纹**:句子节奏、段落长度、词汇签名、语气腔调、论证结构、比喻运用、情绪强度、开头收尾、雷区——每轴必须摘 2–3 句真实锚点原句(没有锚点的轴等于没蒸馏)。
  346. - **事实骨架纪律**:先把原文信息点列成 bullet,改写只换「怎么说」,不增不减事实——改风格不是改内容。
  347. - **默认一次性 prompt(日常推荐)**:`references/oneshot-prompts.md` 提供两段自包含提示词——Prompt A(Style Card + 目标文章 → 改写稿)和 Prompt B(样本文章 → Style Card)——内嵌 9 轴指纹、事实骨架纪律和 AI 露馅 6 条反制,把多轮判官循环压缩成一轮内联自检,够用、一把过。
  348. - **独立判官盲测(深验时启用)**:起一个 subagent,只给它 Style Card + 改写稿,不告诉它是 AI 改的,逐轴评分(1–5),列出具体出戏句;发布级 / 批量高仿真时才跑完整闭环(含图灵判别盲测)。
  349. - **两种模式**:蒸馏(样本 → `~/code/lab/style-cards/<author>/style-card.md`)/ 改写(目标文本 + Style Card → 改写稿,不达标最多 2–3 轮回炉)。样本 < 3 篇会明确提示用户指纹会不稳。
  350. - Style Cards 存在本地独立库(`~/code/lab/style-cards/`),不同步到公开 repo,防止他人稿件外泄。
  351. > 触发词:`蒸馏文风` / `提炼XX的风格` / `把这篇改成XX的味儿` / `mimic this writer` / `match this author's style` / `/wjs-distilling-style`
  352. ---
  353. ## 10. X 增长 / X Growth
  354. ### [`wjs-x-increasing-follower`](./wjs-x-increasing-follower/)
  355. 把「涨粉」当工程做:每个改动是带编号的实验,有假设、有目标指标、有 before 可回滚、有判决。不靠感觉,靠数。
  356. - **北极星指标**:新增关注 ÷ 主页访问(转化率 ratio)——对爆款流量免疫,bio 改好了才让每个来访的人更愿意关注。
  357. - **实验分层**:profile(转化)/ posting(触达)/ engagement(触达)/ timing(触达),每个 action 声明被哪个指标考核。
  358. - 数据来源:X Analytics CSV 导出(ratio 数据 API 拿不到),每日 `daily-check.sh` 自动 ingest + 算判决。
  359. - **判决规则**:中位数对比(抗均值被爆款骗);Δ ≥ +10% keep / Δ ≤ -10% rollback / 之间 flat;回滚永远先问用户,绝不静默改 bio。
  360. > 触发词:`涨粉` / `X 涨粉实验` / `A/B 测我的 profile` / `今天的涨粉检查` / `/wjs-x-increasing-follower`
  361. ### [`wjs-x-improving-content`](./wjs-x-improving-content/)
  362. 把「写好推」当工程做:不断改 `prompts/x/prompt.md`,用 impression 数据看哪版最好,挖出内容特征反哺下一版。是 `wjs-x-increasing-follower` 的孪生——那个测 profile→关注转化,这个测 **prompt→每条推的 impression**。
  363. - **版本 = prompt.md 的 git short-SHA**:推发布时间对应当时 git 历史里的 prompt SHA,无需改 Action,历史推也能回填。
  364. - **内容特征分析**(最有用的部分):按 angle/长度/话题拆 impression 中位数,告诉你 prompt 该往哪改。版本对比给方向,内容特征给抓手。
  365. - 数据来源:X Analytics Content CSV 导出(丢进 `inbox/` 目录)。
  366. - 判决用中位数,每版至少 5 条成熟推(发布满 3 天)才下版本级结论。
  367. > 触发词:`改 X 的 prompt` / `X 内容改进` / `哪版 prompt 最好` / `什么内容 impression 高` / `/wjs-x-improving-content`
  368. ### [`wjs-polishing-x-engagement`](./wjs-polishing-x-engagement/)
  369. 把一条平淡的中文推文改写成"有真实事实支撑 + 带互动钩子"的高参与度版本,每次给 2–3 个钩子不同的候选。核心是两件事叠加:**一个真事实**(用 `web_search` 现查,绝不编造)+ **一个钩子**(留缺口让读者忍不住接话)。
  370. - **风格铁律**:短、白、口语——能删的字全删,日常说话的调子,不煽情不堆形容词。
  371. - **五种钩子**:历史规律外推(最强)/ 提问 / 填空 / 反常识 / 二选一站队。
  372. - 每版末尾附事实来源,方便用户核实后再发。
  373. - 有合适老照片或对比图时顺手用 `image_search` 找出来给用户。
  374. > 触发词:`润色这条推` / `改写这条推文` / `让它更有互动` / `涨互动` / `帮我把这条发得更好` / `/wjs-polishing-x-engagement`
  375. ### [`wjs-cleaning-spam`](./wjs-cleaning-spam/)
  376. 清理挂在王建硕 X/Twitter 推文下的同城引流 spam 回复。X API 只允许串主 **隐藏回复**(访客不可见)和 **静音账号**(通知静音),block 端点已从 API 下线,拉黑只能网页手动。
  377. - **三步走**:先 dry-run 输出 flagged + borderline 名单 → Claude 逐条审 borderline(区分真人评论和变体 spam)→ apply(隐藏 + 静音)
  378. - **自动幂等**:`state/cleaned.jsonl` 记录已处理 id,重跑自动跳过;撞 429 限流(约 50 次/15 分钟)脚本自动停,等窗口刷新后续跑
  379. - **只覆盖 7 天内**:X recent-search 接口上限;更早的 spam 需网页手动处理
  380. - **block 做不到**:如需拉黑,提示用户到账号主页手动操作
  381. > 触发词:`把这些spam删掉` / `清理X垃圾回复` / `推文下面好多引流号` / `clean spam replies` / `/wjs-cleaning-spam`
  382. ---
  383. ## 11. Hugo 博客 / Hugo Blog
  384. ### [`wjs-publishing-hugo`](./wjs-publishing-hugo/)
  385. Hugo 博客的对话式后台。没有 CMS,没有 /admin 页面——说要发什么,Claude 就改 `content/`、放图、commit、push,走仓库现有部署流自动上线。先做前置检测(确认 `hugo.toml` 和现有帖子 front matter 格式),再动手,格式不漂。
  386. - 新增帖子:`scripts/new-post.py`(生成标准 front matter,日期/URL/类目一次到位)
  387. - 管理类目:`scripts/categories.sh` 列现有类目,防止造重复;批量改名/合并类目也支持
  388. - 上传图片:`scripts/add-image.py`,新图进 `static/uploads/<年>/`,超 2000px 宽自动缩小
  389. - 发布:`scripts/publish.sh` commit + push,触发 GitHub Actions 自动部署
  390. > 触发词:`发一篇博客` / `给 Hugo 加文章` / `写篇帖子到博客` / `博客后台` / `/wjs-publishing-hugo`
  391. ### [`wjs-converting-wp-to-hugo`](./wjs-converting-wp-to-hugo/)
  392. 把任意 WordPress 站迁成 **Hugo + Markdown + git** 静态站,部署到 **GitHub Pages**。全程离线、零第三方依赖。
  393. - **输入**:WordPress 后台导出的 WXR `.xml` + 站点 `wp-content/uploads/` 文件夹。
  394. - **产出**:`content/*.md` + `static/wp-content/uploads/` + 手写极简主题,Hugo 构建,GitHub Actions 自动发布。
  395. - **老链接 100% 不断**:全站 URL 保持 `/archives/<数字>/` 格式,SEO 和外部引用不受影响。
  396. - **安全优先**:WXR 含密码文章正文和作者邮箱,`gitignore` 已根锚定,绝不进 git 历史。密码保护文章和脚手架页的处理方式必须由用户决定,不静默发布。
  397. - **TDD 转换器**:`wxr_to_hugo.py` 是纯函数,`test_wxr.py` 先跑测试再全量转换;`verify_build.py` 断言每个老链接都命中。
  398. > 触发词:`把 WordPress 迁成 Hugo` / `wordpress 转静态站` / `migrate WordPress to Hugo` / `WXR to Hugo` / `/wjs-converting-wp-to-hugo`
  399. ---
  400. ## 12. 网站反馈闭环 / Website Feedback Loop
  401. ### [`wjs-looping-feedback`](./wjs-looping-feedback/)
  402. 给任意网站装「提一句话就自动改代码」的反馈闭环。完全跑在仓库所有者自己的 GitHub Actions 上,用自己的 Pro/Max OAuth token 或 `ANTHROPIC_API_KEY`,无需任何第三方服务或后端。
  403. 工作流:访客点浮动「提个建议」按钮 → 填建议 → 变成 GitHub Issue(`feedback` 标签)→ allowlist 检查(只有白名单用户能触发)→ Claude Code 按 `.feedback/INSTRUCTIONS.md` 改网站 → 自动 commit 到 `main` → 触发部署上线 → `/_feedback` 仪表板记录每条建议的处理状态 + issue 回复 commit 链接。Revert:发一条 `revert: #N` issue 即可。
  404. 支持 Hugo / Next.js / Astro / 静态站。
  405. > 触发词:`给网站加个反馈对话框` / `提一句话就自动改网站` / `装上反馈闭环` / `feedback loop` / `/wjs-looping-feedback`
  406. ---
  407. ## 13. iOS 持续集成 / iOS CI
  408. ### [`wjs-publishing-testflight`](./wjs-publishing-testflight/)
  409. 为任意 iOS 项目配置 **fastlane + GitHub Actions** CI/CD,基于 Cathier 项目的实战模板。
  410. - 推送 `main` 分支 → GitHub Actions 在 `macos-15` (Xcode 26.2) 上自动构建
  411. - 查询 App Store Connect 最新 build number、自动加 1,运行 `match`(只读)签名,导出 app-store IPA
  412. - **TestFlight**:每次 push 都上传,打 `testflight/<build_num>` tag
  413. - **自动提审规则**:每第 10 个 build(`build_num % 10 == 0`)自动 bump minor 版本并提审 App Store;或开发者手动改 `MARKETING_VERSION` 触发;CI 永不静默 commit pbxproj
  414. - 三条 lane:`beta`(日常 CI)/ `bump`(本地版本升级)/ `release`(强制立即提审)
  415. - 配套完整的 `Appfile` / `Matchfile` / `Fastfile` / `Gemfile` 模板和 `build.yml` workflow,只需全局替换三个占位符(bundle ID、repo 名、Xcode scheme)
  416. > 触发词:`testflight` / `fastlane` / `自动构建` / `CI TestFlight` / `/wjs-publishing-testflight`
  417. ### [`wjs-publishing-appstore`](./wjs-publishing-appstore/)
  418. `wjs-publishing-testflight` 的配套技能——接过 CI/CD 之后的那一步:把 TestFlight 上已有 build 的 iOS app 正式提交 App Store。
  419. - **流程**:`scripts/scaffold-metadata.sh` 搭 `deliver` 元数据骨架(VoiceDrop 模板起步)→ `scripts/shoot.sh` 用 `simctl` 截图(iPhone 6.9" 为唯一必要尺寸,每 locale 一轮)→ `scripts/release_lane.rb` 粘入 Fastfile 加 `release` lane → `fastlane release` 提审。
  420. - **全局唯一名陷阱**:App Store 的 `name` 字段全局唯一(显示名,非 bundle ID)——短常用名几乎必然被占,要加词或中文后缀;是可改的,不是永久锁死的。
  421. - **首次提审前置清单**:年龄评级问卷(2025 年 Apple 新增了若干字段,fastlane 未覆盖,需在 ASC 网页完成)、定价(Free)、内容版权声明、App 隐私「营养标签」——四项在 ASC 网页控制台配置一次,之后不需要再动;提审失败时 Apple 会列出所有缺项,一并修好再重触发即可。
  422. - **iOS 26 Simulator 已知坑**:麦克风权限弹框 `simctl privacy grant` 无法抑制(手动点一次 Allow,之后重跑截图脚本即是干净画面);TabView 标签栏附近会出现 Liquid Glass 幻影(device only 没有,不必追查)。
  423. - **稳妥两步发布**:`beta` lane 上传并等 Apple 处理完毕 → 再触发 `fastlane release skip_build:true` 复用已处理的 build,避免提审时 build 还在 processing 的竞争条件。
  424. > 触发词:`提交 App Store` / `上架` / `app store 审核` / `准备截图和文案` / `submit for review` / `/wjs-publishing-appstore`
  425. ---
  426. ## 典型工作流串接
  427. **完整本地化一个西班牙语播客 → 中文版上 YouTube:**
  428. ```
  429. 源视频
  430. └─ wjs-transcribing-audio → 西语 SRT
  431. └─ wjs-translating-subtitles → 中文 SRT
  432. └─ wjs-dubbing-video → 中文配音的视频
  433. └─ wjs-burning-subtitles → 烧字幕 + 混音 → 最终 MP4
  434. └─ wjs-uploading-video → YouTube
  435. ```
  436. **或者一句话**:`/wjs-localizing-video` 把上面四步串起来跑。
  437. **双机位访谈 → 抖音 + YouTube 双版本:**
  438. ```
  439. 两路 MOV
  440. └─ wjs-syncing-multicam → 两份 .sync.json
  441. └─ wjs-editing-multicam → 单条 16:9 MP4
  442. ├─ wjs-segmenting-video → 4 个独立话题 clip
  443. │ └─ wjs-overlaying-video → 加封面 + 字幕 + CTA
  444. │ └─ wjs-uploading-video → YouTube
  445. └─ wjs-reframing-video → 9:16 竖屏版本 → 视频号 / 抖音
  446. ```
  447. **写公众号文章并做成视频:**
  448. ```
  449. 草稿 → wjs-publishing-wechat → 题图 + 解释图 + HTML + 上传草稿 → mp.weixin.qq.com 后台微调发布
  450. └─ wjs-converting-text-to-video → 1080×1920 MP4(TTS + 水彩背景 + GSAP 动画)
  451. └─ 日推 cron → YouTube Shorts
  452. ```
  453. ---
  454. ## 如何贡献 / Contributing
  455. 欢迎提 Issue 或 PR。新增 skill 的要求:
  456. 1. 目录名用 **V-ing 动名词**(如 `wjs-doing-something`),加 `wjs-` 前缀与本仓库风格保持一致。
  457. 2. 目录内放一个 `SKILL.md`,frontmatter 里写 `name` 和 `description`(含具体触发词/例句),正文写清楚 when to use / when NOT to use / 执行步骤。
  458. 3. 需要的脚本放同目录下。
  459. 4. 提 PR,在 PR 描述里说明 skill 的用途和触发词。
  460. 有问题或建议,请到 [Issues](https://github.com/jianshuo/Claude-skills/issues) 反馈。
wjs-voicedrop-creating-motion-book/cloud/run_book.sh · Bundled script · 241 lines · 1 finding marked
  1. #!/bin/bash
  2. # 做一本书:在 Tokyo VPS 上跑(root,或 lab 服务的 claude-agent 用户——/api/video-book 就是用 systemd-run 起它)。
  3. # 2026-11-10 起不再开一次性 Vultr 机器(开机/销毁靠 Vultr API,reaper 误删过常驻 VPS,风险太大):
  4. # 制作就在 VPS 本机的 mb 用户里跑(setup_worker.sh 装好,slice 限内存 2.8G/CPU 150%,挤不到常驻服务),一次只做一本(worker.lock)。
  5. # 流程:ssh mb@127.0.0.1 → 无人值守 Claude Code 按本 skill 做完 HTML 版 → 拉回 → 发布到书架 voicedrop.cn/books/<slug>/video/
  6. # → 杀掉 mb 名下残留进程、清工作目录(--keep 保留工作目录)。
  7. #
  8. # 用法:bash run_book.sh <slug> [--only ch01,ch02,ch03] [--max-hours 12] [--keep] [--no-publish] [--dry]
  9. # --dry:不派 Claude,只验证做书账号的 Node、Claude Code、Chromium 能出图
  10. # --max-hours:缺省整本 12、试看版(--only)6;到点收工(拉回已有的东西、不发布)
  11. # 路径(环境变量可改,lab 服务用 MB_ROOT=/opt/claude-agent/motion-book):
  12. # $MB_ROOT/secrets.env VOLC_ASR_APPID、VOLC_ASR_ACCESS_TOKEN、CLAUDE_TOKEN_*/KIMI_KEY_*(600)
  13. # $MB_ROOT/worker_id ssh mb@127.0.0.1 的专用密钥(setup_worker.sh 生成,authorized_keys 限 from=127.0.0.1)
  14. # $MB_CLAUDE_ENV CLAUDE_CODE_OAUTH_TOKEN(缺省 /opt/claude-agent/.env:写书引擎同一个 setup-token 长期令牌,不轮换,可多机共用)
  15. # $VOICEDROP_CREDENTIALS 书架发布令牌(缺省 /opt/claude-agent/.config/voicedrop/credentials,build.mjs 发书同一份)
  16. # 产物:$MB_ROOT/books/<slug>/(html/、稿、句时间、镜头表、qa、RESULT.md、cloud.log、claude.jsonl、state.json)
  17. # state.json:{state: booting|setup|making|publishing|done|failed, step, startedAt, updatedAt, only, instance(=local), url?, error?}
  18. set -euo pipefail
  19. SK="$(cd "$(dirname "$0")/.." && pwd)"
  20. slug=${1:?用法:bash run_book.sh <slug> [--only …]}; shift
  21. ONLY=""; MAXH=""; KEEP=0; PUBLISH=1; DRY=0
  22. while [ $# -gt 0 ]; do case $1 in
  23. --only) ONLY=$2; shift 2;; --plan) shift 2;; --max-hours) MAXH=$2; shift 2;;
  24. --keep) KEEP=1; shift;; --no-publish) PUBLISH=0; shift;; --dry) DRY=1; PUBLISH=0; shift;; *) echo "不认识的参数 $1"; exit 2;; esac; done
  25. [ -n "$MAXH" ] || { [ -n "$ONLY" ] && MAXH=6 || MAXH=12; }
  26. ROOT=${MB_ROOT:-/root/motion-book}; CLAUDE_ENV=${MB_CLAUDE_ENV:-/opt/claude-agent/.env}
  27. export VOICEDROP_CREDENTIALS=${VOICEDROP_CREDENTIALS:-/opt/claude-agent/.config/voicedrop/credentials}
  28. OUT=$ROOT/books/$slug; mkdir -p "$OUT"; exec > >(tee -a "$OUT/cloud.log") 2>&1
  29. STARTED=$(date +%s); ID=""; STATE=booting; WD=0
  30. MB="$SK/cloud/mb.mjs" # JSON 小活都交给它(以前是内嵌 python,2026-10-25 统一成 Node)
  31. # st <state> <step> [url] [内部日志尾]:写 state.json(接口读它答进度;logTail 只内部用),并把 step 记进对外日志
  32. st() { STATE=$1; node "$MB" state "$OUT/state.json" "$1" "$2" "${3:-}" "${4:-}" "$STARTED" "$ONLY" "$ID"; ev "$2"; prog "$2"; }
  33. # 对外日志 events.json:只记「时间+一句中文步骤」,不写路径、IP、机器 ID;同一句不连着重复记
  34. ev() { node "$MB" event "$OUT/events.json" "$1"; }
  35. # 有租约就把这一步报给 engine-router(状态页 lab.jianshuo.dev/router/「租约」栏显示;每报一次租约按 ttl 续期,12h 的整本也不会过期)
  36. prog() { [ -n "${LEASE:-}" ] || return 0; STEP="$1" node -e 'process.stdout.write(JSON.stringify({step:process.env.STEP}))' | rt "/$LEASE/progress" >/dev/null || true; }
  37. st booting "检查书和凭据"
  38. # 编排机上的 skill 副本跟上 GitHub(以前从不更新,停在旧版本)。git 换文件是删了重建,正在跑的这份脚本不受影响,下一单才用新版。
  39. ( flock -w 120 9 && git -C "$SK" pull -q --ff-only origin main ) 9>"$(git -C "$SK" rev-parse --absolute-git-dir 2>/dev/null || echo /tmp)/harvest.lock" 2>/dev/null || echo "skill 副本没更新成(不影响这一单)"
  40. echo "=== $(date -u +%FT%TZ) 开始:$slug ${ONLY:+(只做 $ONLY)} worker=mb@127.0.0.1 max=${MAXH}h dry=$DRY"
  41. J() { node "$MB" get "$1"; } # J 'd.instance.id':从 stdin 的 JSON 取值
  42. LEASE=""; RURL=""; RTOK=""
  43. # engine-router 租约(见 engine-router/README「接入方」):lease → 「租约id 引擎 账号id 最早恢复」,挑不出是「- - - <eta>」,router 不通是空串
  44. # 引擎 claude(订阅令牌)或 kimi(同一个 Claude Code CLI,换 Anthropic 兼容端点)——做书机上跑的都是 claude -p。
  45. rt() { curl -4 -sS -m 10 -H "Authorization: Bearer $RTOK" -H 'Content-Type: application/json' -X POST "$RURL/v1/leases$1" -d @- 2>/dev/null; }
  46. lease() { # label = 状态页上显示的书名
  47. local lj; lj=$(T="《${TITLE}》视频书${ONLY:+(试看 ${ONLY})}" node -e 'process.stdout.write(JSON.stringify(process.env.T))')
  48. echo "{\"kind\":\"text\",\"task_class\":\"video\",\"engine_hints\":{\"require\":[\"claude\",\"kimi\"]},\"ttl_ms\":21600000,\"label\":$lj}" | rt "" \
  49. | J '[d.lease_id||"-",d.engine||"-",String(d.account||"-").split("/").pop(),d.eta||"-"].join(" ")' 2>/dev/null || true; }
  50. lease_done() { # 回报并释放;本轮起过 Claude 又没成功,就把报错给 router,额度/凭据类报错会让该账号冷却
  51. # 429/额度在 claude.jsonl 的 is_api_error_message 里,不在 stderr;stderr 里 kimi 腿每次都有 unrecognized_model 告警(无害),滤掉
  52. # (2026-10-30 market-oracle:kimi 5h 撞墙,回报的却只有三行告警)
  53. [ -n "$LEASE" ] || return 0
  54. local err=""; if [ "$STATE" != done ] && [ -n "${ROUND:-}" ]; then
  55. err=$( { tail -c 300000 "$OUT/claude.jsonl" 2>/dev/null | grep '"is_api_error_message":true' | tail -1 | J 'd.message.content[0].text' 2>/dev/null || true
  56. grep -v 'claude-code:unrecognized_model' "$OUT/claude.err" 2>/dev/null || true; } | tail -c 400); fi
  57. OK=$([ "$STATE" = done ] && echo true || echo false) ERR="$err" ENG="${ENG:-claude}" node -e 'process.stdout.write(JSON.stringify({ok:process.env.OK==="true",engine_used:process.env.ENG,error:process.env.ERR}))' \
  58. | rt "/$LEASE/complete" >/dev/null || true
  59. LEASE=""; }
  60. destroy() { set +e # 退出一律走这里:收拾做书账号、交还租约、没成功就把 state.json 落成 failed
  61. if [ $WD = 1 ]; then cleanup_worker; [ $KEEP = 1 ] || R "rm -rf ~/art-films/$slug" 2>/dev/null; echo "=== 做书账号已收拾 $(date -u +%FT%TZ)"; fi
  62. lease_done
  63. case $STATE in done) ;; *) st failed "${STEP_DESC:-中途退出}" "" "$(tail -3 "$OUT/cloud.log" | tr '\n' ' ' | cut -c1-300)";; esac; }
  64. trap destroy EXIT
  65. getenv() { [ -r "$2" ] || return 0; grep -E "^(export )?$1=" "$2" | head -1 | sed -E "s/^(export )?$1=//; s/^[\"']//; s/[\"']\$//" || true; }
  66. ASR_ID=$(getenv VOLC_ASR_APPID $ROOT/secrets.env); ASR_TK=$(getenv VOLC_ASR_ACCESS_TOKEN $ROOT/secrets.env)
  67. CLAUDE_TK=$(getenv CLAUDE_CODE_OAUTH_TOKEN "$CLAUDE_ENV")
  68. [ -f "$ROOT/worker_id" ] && [ -n "$ASR_ID" ] && [ -n "$ASR_TK" ] && [ -n "$CLAUDE_TK" ] || { STEP_DESC="凭据不全"; echo "凭据不全"; exit 2; }
  69. # 要做的章都写完了才开工
  70. STEP_DESC="取书"; node "$SK/scripts/fetch_book.mjs" "$slug" "$OUT/章名.txt" ${ONLY:+--only $ONLY} > "$OUT/book_meta.json"
  71. NCH=$(J 'd.chapters' < "$OUT/book_meta.json"); TITLE=$(J 'd.title' < "$OUT/book_meta.json")
  72. ev "读到书:《$TITLE》共 $NCH 章${ONLY:+,这次只做 $(echo $ONLY | tr ',' ' ')}"
  73. # 口播=听书朗读:要做的每章在听书接口都得有朗读原文(<stem>.txt 纯读、不触发合成)。旧版单页书(book.json legacy:true,
  74. # 全书一个 index.html、没有 01.html…)这里一律 404——以前要跑满 3 轮 Claude 才失败(2026-11-12 tcm-analysis),现在开工前就退,不租账号。
  75. STEP_DESC="检查听书口播"
  76. if [ -n "$ONLY" ]; then STEMS=$(echo "$ONLY" | tr ',' '\n' | sed 's/^ch//'); else STEMS=$(J 'd.stems.join("\n")' < "$OUT/book_meta.json"); fi
  77. for stem in $STEMS; do
  78. code=$(curl -s -o /dev/null -m 20 -w '%{http_code}' "https://jianshuo.dev/voicedrop/books/audiobook/$slug/$stem.txt" || echo 000)
  79. if [ "$code" != 200 ]; then
  80. STEP_DESC="这本书没有按章的听书口播(旧版单页书),做不了动画版"
  81. echo "第 $stem 章听书原文 HTTP $code,不开工"; exit 1
  82. fi
  83. done
  84. # 账号由 engine-router 在 claude-1/2、kimi-1 里按配速和红线挑。挑不出就在开工前排队等(每 10 分钟再问,最多 WAITH 小时),
  85. # 不再 force 硬拿——2026-10-30 两个 Claude 号就是被视频书 force 吃光的。
  86. # router 只回账号名,凭据取 secrets.env:claude → CLAUDE_TOKEN_<账号 id,- 换 _>;kimi → KIMI_KEY_<账号 id>(可选 KIMI_BASE_URL、KIMI_MODEL)。
  87. # router 不通 / 没有这个账号的凭据 → 用 CLAUDE_TK(lab .env 那个 = claude-1)照做,不因此停工。
  88. RURL=$(getenv ROUTER_URL "$CLAUDE_ENV"); RTOK=$(getenv ROUTER_TOKEN "$CLAUDE_ENV")
  89. WAITH=${MB_WAIT_HOURS:-6}; WAITED=0; DEFAULT_TK=$CLAUDE_TK
  90. # 挑账号:开工时一次;中途撞额度(见下方续跑循环)换号时再来一次。会改 LEASE ENG ACCT A CLAUDE_TK KIMI_KEY WAITED。
  91. acquire_account() {
  92. ACCT="缺省令牌(claude-1)"; ENG=claude; A=""; KIMI_KEY=""; CLAUDE_TK=$DEFAULT_TK; LEASE=""
  93. [ -n "$RURL" ] && [ -n "$RTOK" ] || return 0
  94. local E T ETA
  95. while :; do
  96. E=""; ETA=""; read -r LEASE E A ETA <<< "$(lease)" || true
  97. if [ "${LEASE:-}" != - ]; then break; fi
  98. if [ "${ETA:-}" = - ]; then ETA=""; fi
  99. if [ $WAITED -ge $((WAITH * 3600)) ]; then STEP_DESC="等 AI 额度超时"; echo "等了 ${WAITH}h 仍挑不出账号,放弃"; exit 1; fi
  100. st booting "等 AI 额度(几个账号都到了配速线或红线${ETA:+,最早 $(TZ=Asia/Shanghai date -d "$ETA" +%H:%M 2>/dev/null || echo "$ETA")})"
  101. sleep 600; WAITED=$((WAITED + 600))
  102. done
  103. T=""
  104. if [ -n "$LEASE" ] && [ "$E" = kimi ]; then KIMI_KEY=$(getenv "KIMI_KEY_${A//-/_}" $ROOT/secrets.env); [ -n "$KIMI_KEY" ] && T=kimi
  105. elif [ -n "$LEASE" ]; then T=$(getenv "CLAUDE_TOKEN_${A//-/_}" $ROOT/secrets.env); fi
  106. if [ -n "$T" ]; then ENG=${E:-claude}; ACCT=$A; if [ "$ENG" = claude ]; then CLAUDE_TK=$T; fi
  107. else echo "router 没给出能用的账号(${LEASE:-router 不通} ${A:-}),用缺省令牌"; KIMI_KEY=""; lease_done; fi
  108. }
  109. acquire_account
  110. echo "引擎账号:${ACCT}${LEASE:+($ENG,租约 $LEASE)}"; ev "这本由 ${ACCT} 来做"
  111. # 做书账号一次只做一本:拿不到锁就排队(同一账号的 ~/art-films/claude.jsonl、--continue 会话都只有一份)
  112. exec 8>"$ROOT/worker.lock"
  113. if ! flock -n 8; then st booting "排队:上一本还在做"; flock 8; fi
  114. SSHO="-i $ROOT/worker_id -o StrictHostKeyChecking=accept-new -o BatchMode=yes -o ConnectTimeout=10 -o ServerAliveInterval=30 -o LogLevel=ERROR"
  115. R() { ssh $SSHO mb@127.0.0.1 "$@"; }
  116. # 杀掉 mb 名下的 claude / Chromium / 渲染(上一单被 kill -9、VPS 重启后的残留也在这里清;代替以前删超时机器的 reaper)
  117. # 模式写成 [c]laude:远端执行这串命令的 shell 自己的命令行里也有这几个词,不这么写会先把自己杀了
  118. cleanup_worker() { R 'pkill -f "[c]laude -p" ; pkill -f "[c]hrom" ; pkill -f "[r]ender\.py" ; true' >/dev/null 2>&1 || true; }
  119. ID=local; WD=1; st setup "准备制作环境"; STEP_DESC="准备制作环境"
  120. R test -f .ready || { STEP_DESC="做书账号没装好"; echo "mb 用户没装好:root 跑一次 cloud/setup_worker.sh"; exit 1; }
  121. cleanup_worker
  122. # 工作区复位:skill 副本对齐 GitHub、清掉上一单已收回的新套件(未跟踪文件),~/art-films 整个清空(上一单的会话日志、章名.txt、静帧、别的书目录都不留;续做的半成品下面再从编排侧传上去)
  123. R "set -e; cd ~/code/claude-skills && git fetch -q --depth 1 origin main && git reset -q --hard origin/main && git clean -fdq -- wjs-voicedrop-creating-motion-book/kits
  124. git -C ~/code/huashu-art-motion pull -q --ff-only || true
  125. cd ~/art-films && find . -mindepth 1 -maxdepth 1 -exec rm -rf {} +" || { STEP_DESC="复位做书账号失败"; exit 1; }
  126. echo "做书账号就绪 $(date -u +%T)"; ev "制作环境就绪(Node、Chromium、Claude Code、动画引擎)"
  127. # 把当前账号的凭据写进做书账号的 ~/code/.env(换号后再调一次,整份覆盖:kimi→claude 不会残留 ANTHROPIC_BASE_URL)
  128. push_creds() {
  129. if [ "$ENG" = kimi ]; then # 同 engine-router adapters.ts 的 kimi 腿:换端点,Claude Code 内部各档位(含子 agent)全映射到 Kimi 模型
  130. KM=$(getenv KIMI_MODEL $ROOT/secrets.env); KM=${KM:-k3[1m]}; KB=$(getenv KIMI_BASE_URL $ROOT/secrets.env); KB=${KB:-https://api.kimi.com/coding/}
  131. { printf 'export VOLC_ASR_APPID=%q\nexport VOLC_ASR_ACCESS_TOKEN=%q\nexport RENDER_SLOTS=1\n' "$ASR_ID" "$ASR_TK"
  132. printf 'export ANTHROPIC_BASE_URL=%q\nexport ANTHROPIC_API_KEY=%q\n' "$KB" "$KIMI_KEY"
  133. for k in ANTHROPIC_MODEL ANTHROPIC_DEFAULT_FABLE_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_SUBAGENT_MODEL; do printf 'export %s=%q\n' $k "$KM"; done
  134. printf 'export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1048576\nexport CLAUDE_CODE_MAX_CONTEXT_TOKENS=1048576\nexport CLAUDE_CODE_EFFORT_LEVEL=high\n'
  135. printf 'export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32000\n' # behavesAs opus 会把 max_tokens 抬到 64000,钉回 Kimi 的 32000
  136. } | R 'umask 077; cat > ~/code/.env'
  137. # 新版 Claude Code 不认识 k3 会往 stderr 刷 [claude-code:unrecognized_model]:behavesAs 指一个它认识的模型,发出去的模型名不变。
  138. # 选 opus-4-8 是因为实测请求和「不认识」时几乎一样(同 beta、同 tools);sonnet-4-6 会换掉整套 system prompt(2026-10-30)
  139. KMJ=$(K="$KM" node -e 'process.stdout.write(JSON.stringify({modelPicker:{options:[{model:process.env.K,behavesAs:"claude-opus-4-8"}]}}))')
  140. printf '%s' "$KMJ" | R 'cat > ~/code/kimi.settings.json'
  141. else
  142. printf 'export VOLC_ASR_APPID=%q\nexport VOLC_ASR_ACCESS_TOKEN=%q\nexport CLAUDE_CODE_OAUTH_TOKEN=%q\nexport RENDER_SLOTS=1\n' "$ASR_ID" "$ASR_TK" "$CLAUDE_TK" | R 'umask 077; cat > ~/code/.env'
  143. fi
  144. }
  145. push_creds
  146. if [ $DRY = 1 ]; then # 演习:只验证环境(Node、Claude Code、Chromium 出一张静帧)
  147. R 'bash -lc "set -e; node --version; claude --version; cd ~/code/huashu-art-motion/scripts/engine && uv run --with playwright python render.py --film gallery --solo 01_cave --stills 1.0 --no-counter --out /tmp/dry && ls -la /tmp/dry"' | tee "$OUT/dry.txt"
  148. st done "演习完成"; exit 0
  149. fi
  150. S='~/.claude/skills/wjs-voicedrop-creating-motion-book/scripts'
  151. # 续做:上一轮拉回来的半成品(口播、ASR、句时间、已交稿的分镜和场景、稿、book.json)先传上去,Claude 只补缺的
  152. RESUMED=0
  153. if ls "$OUT"/音频/ch??.mp3 >/dev/null 2>&1; then
  154. R "mkdir -p ~/art-films/$slug"
  155. rsync -az -e "ssh $SSHO" --exclude 'html/' --exclude 'qa/' --exclude 'output/' --exclude '*.json.tmp' --exclude 'state.json' --exclude 'events.json' \
  156. --exclude 'cloud.log' --exclude 'claude.*' --exclude 'book_meta.json' --exclude '章名.txt' --exclude 'dry.txt' --exclude 'RESULT.md' "$OUT/" "mb@127.0.0.1:art-films/$slug/" && RESUMED=1
  157. [ $RESUMED = 1 ] && ev "接着上一轮的半成品做(口播 $(ls "$OUT"/音频/ch??.mp3 | wc -l | tr -d ' ') 章、分镜 $(ls "$OUT"/音频/*.shots.json 2>/dev/null | wc -l | tr -d ' ') 段已在)"
  158. fi
  159. RULES="- **子 agent 一律前台并行**:在同一条消息里同时发出多个 Agent 调用(这台机器小,一条消息别超过 4 个),不要用 run_in_background / 后台 agent,也不要说「等通知」就结束回合。这是 claude -p 无人值守模式:你一结束回合,进程就退出,还在跑的后台 agent 会被一起杀掉。一批全部返回后再派下一批。
  160. - 不写完 ~/art-films/$slug/RESULT.md 不要结束回合。"
  161. PROMPT="你在 Tokyo VPS 的专用做书账号 mb 里(Ubuntu,2 核,这个账号内存上限 2.8GB,有 Chromium,全程无人值守:没有人回答问题,不要停下来问)。
  162. 用 wjs-voicedrop-creating-motion-book skill 把书架上的《$TITLE》(slug $slug)做成竖屏 HTML 动画版${ONLY:+,只做 $ONLY 这几章(试看版,总装用 assemble.mjs --only $ONLY)}。
  163. - 项目目录 ~/art-films/$slug。取书用 node $S/fetch_book.mjs $slug ~/art-films/章名.txt(这台机器没有 VoiceDrop MCP),再 new_book.mjs、narrate.mjs。
  164. $([ $RESUMED = 1 ] && echo "- 项目目录里已经有上一轮做了一半的东西:先照样跑 new_book.mjs 把引擎装上(它不覆盖已有文件,book.json 里的画风沿用);口播/ASR 已齐的章 narrate.mjs 会跳过;已有 chNN_x.js 和对应 shots.json、且冒烟通过的段不要重做,只补缺的段。" || true)
  165. - 画风按 references/选画风.md 定,现在是**探索期**:先跑 node $S/pick_styles.mjs 抽候选,三个候选的主镜头必须真画出来(这台机器有 Chromium),评委必须用没参与画图的子 agent,不许跳过直接选已有套件。选中新画风就在 skill 的 kits/<名>/ 建成套件再开工——编排脚本会把它收回进 git,下一本书能复用。
  166. - 分章制作派子 agent 并行;单个 agent 负责的口播不超过约 4 分钟,长章拆成 chNN_a / chNN_b(assemble 会自动按字母顺序拼)。渲染命令一律 bash $S/render_lock.sh 前缀(RENDER_SLOTS=1:同一时刻只开一个 Chromium,内存超限会被杀)。
  167. $RULES
  168. - 每章交稿前冒烟检查零报错零缺字;总装后整本冒烟检查,再 build_html.mjs。不要发布、不要上传到任何地方(编排脚本会拉回去发布),不要 git push。
  169. - 全部完成后写 ~/art-films/$slug/RESULT.md:画风和理由、章节、镜头数、时长、冒烟结果、你知道的遗留问题。"
  170. PROMPT_CONT="你上一轮在子 agent 还没全部交稿时就结束了回合,进程退出,那时还在跑的 agent 都被杀了。现在接着做《$TITLE》:
  171. 先看项目 ~/art-films/$slug 里已经有什么(各段 shots.json、代码工程/scenes/book/chNN*.js、qa/smoke),只补缺的段,然后总装、整本冒烟检查、build_html.mjs、写 RESULT.md。
  172. $RULES"
  173. # 起一轮 Claude。注意是「cd …;」不是「cd … &&」:「a && b &」会把整串放进一个后台子 shell,它攥着 ssh 的管道不放,ssh 一直不返回(2026-10-25 第一单就卡在这)
  174. launch() { # launch <第几轮>:第 1 轮用 PROMPT,之后 --continue 接着同一个会话、用 PROMPT_CONT
  175. local flag=""; if [ "$1" -gt 1 ]; then flag="--continue"; printf '%s' "$PROMPT_CONT" | R 'cat > ~/art-films/prompt.txt'; else printf '%s' "$PROMPT" | R 'cat > ~/art-films/prompt.txt'; fi
  176. if [ "$ENG" = kimi ]; then flag="$flag --settings ~/code/kimi.settings.json"; fi
  177. R "rm -f ~/art-films/exit.code"
  178. R -n "cd ~/art-films; nohup bash -lc 'source ~/code/.env; timeout ${MAXH}h claude -p $flag \"\$(cat prompt.txt)\" --dangerously-skip-permissions --output-format stream-json --verbose >> claude.jsonl 2>> claude.err; echo \$? > exit.code' > /dev/null 2>&1 < /dev/null &"
  179. }
  180. # 这一轮是不是死在额度上:看做书账号 claude.jsonl 里最后一条 result(stream-json 是紧凑 JSON)
  181. quota_hit() { R "tail -c 400000 art-films/claude.jsonl" 2>/dev/null | grep -E '"type": ?"result"' | tail -1 \
  182. | grep -qiE '"api_error_status": ?429|usage limit|rate.?limit|quota|额度'; }
  183. ROUND=1; MAXROUND=3; SWAPS=0; MAXSWAP=${MB_MAX_SWAPS:-4}; launch 1
  184. echo "Claude 开工 $(date -u +%T)"; st making "Claude 开始制作"; STEP_DESC="制作中"
  185. # 进度:每 2 分钟在做书机上跑一次 probe.mjs(开机时随 skill 克隆过去了),里程碑记进对外日志(只记变化),state.json 的 step 是一句总括。
  186. # Claude 退出了但还没做出网页版 → 续跑(最多 MAXROUND 轮);到时限就收工(开机前等额度的时间不算进时限)。
  187. deadline=$(( STARTED + WAITED + MAXH * 3600 - 1200 )); TIMEUP=0; prevsum=""
  188. while :; do
  189. while ! R test -f art-films/exit.code 2>/dev/null; do
  190. [ "$(date +%s)" -gt "$deadline" ] && { echo "到时限了,收工(未完成)"; ev "到了时限还没做完,收工"; TIMEUP=1; break; }
  191. sleep 120
  192. pj=$(R "node ~/.claude/skills/wjs-voicedrop-creating-motion-book/cloud/probe.mjs $slug" 2>/dev/null || true); echo "$(date -u +%T) $pj"
  193. [ -n "$pj" ] || continue
  194. summary=$(node "$MB" summary "$pj" "$NCH" "$SK/kits") || true # 进度显示出错不能连累制作(set -e 会直接退出、整单作废)
  195. while IFS= read -r line; do [ -n "$line" ] && ! grep -qxF -- "$line" <<< "$prevsum" && ev "$line"; done <<< "$summary"; prevsum=$summary # 只记跟上一轮比变了的行
  196. last=$(printf '%s\n' "$summary" | tail -1); st making "${last:-Claude 制作中}"
  197. done
  198. echo "第 $ROUND 轮 Claude 退出码:$(R cat art-films/exit.code 2>/dev/null || echo 无)"
  199. [ $TIMEUP = 1 ] && break
  200. R test -f "art-films/$slug/html/index.html" 2>/dev/null && break
  201. # 撞额度(429 / 5 小时用量上限)不是「没做完」,同一个号再续几轮也是白跑——2026-11-16 diamond-sutra:kimi-1 撞 5h 墙,
  202. # 第 2、3 轮各 3 分钟又被 429 弹回,3 轮用完收工。改成:交还租约(报错给 router,该号冷却)→ 重新挑号(都挑不出就排队等)
  203. # → 写新凭据 → --continue 接着同一个会话(claude↔kimi 跨号续会话实测可用)。换号这轮不占 MAXROUND,最多换 MAXSWAP 次。
  204. if quota_hit; then
  205. SWAPS=$((SWAPS + 1))
  206. [ $SWAPS -gt $MAXSWAP ] && { ev "撞额度换号 $MAXSWAP 次仍没做完,收工"; break; }
  207. ev "${ACCT} 撞到额度上限,换个账号接着做"
  208. R "cat art-films/claude.jsonl" > "$OUT/claude.jsonl" 2>/dev/null || true # lease_done 从这里取报错
  209. lease_done
  210. W0=$WAITED; acquire_account; deadline=$((deadline + WAITED - W0)) # 等额度的时间不算进时限
  211. push_creds
  212. echo "换号:${ACCT}${LEASE:+($ENG,租约 $LEASE)}"; ev "改由 ${ACCT} 接着做"
  213. ROUND=$((ROUND + 1)); MAXROUND=$((MAXROUND + 1)); launch $ROUND; continue
  214. fi
  215. [ $ROUND -ge $MAXROUND ] && { ev "续跑 $MAXROUND 轮仍没做完,收工"; break; }
  216. ROUND=$((ROUND + 1)); ev "Claude 中途停了,第 $ROUND 轮接着做"; launch $ROUND
  217. done
  218. STEP_DESC="取回成品"; ev "制作完成,取回成品"
  219. rsync -az -e "ssh $SSHO" --exclude '代码工程/lib/' --exclude '代码工程/demos/' --exclude '代码工程/reference_films/' --exclude '代码工程/examples/' --exclude '静帧/' \
  220. "mb@127.0.0.1:art-films/$slug/" "$OUT/" || true
  221. rsync -az -e "ssh $SSHO" "mb@127.0.0.1:art-films/claude.jsonl" "mb@127.0.0.1:art-films/claude.err" "$OUT/" 2>/dev/null || true
  222. # 新画风套件收回:做书账号 kits/ 里新建(git 未跟踪)的套件目录 → 本书产物 kits/ → harvest_kits.sh 提交进 claude-skills 并推送。
  223. # 下一单开工会 git clean 掉做书账号里的未跟踪套件,这一步不收就丢了。做没做完都收(套件常在第一章前就建好)。
  224. STEP_DESC="收回画风套件"
  225. KR='code/claude-skills/wjs-voicedrop-creating-motion-book/kits'
  226. newkits=$(R "cd ~/code/claude-skills && git status --porcelain --untracked-files=normal -- wjs-voicedrop-creating-motion-book/kits" 2>/dev/null \
  227. | sed -n 's#^?? wjs-voicedrop-creating-motion-book/kits/\([^/]*\)/.*#\1#p' | sort -u || true)
  228. for n in $newkits; do mkdir -p "$OUT/kits/$n"; rsync -az -e "ssh $SSHO" "mb@127.0.0.1:$KR/$n/" "$OUT/kits/$n/" && ev "收回新画风套件:$n"; done
  229. bash "$SK/cloud/harvest_kits.sh" "$OUT" "$slug" || true
  230. if [ $PUBLISH = 1 ] && [ -f "$OUT/html/index.html" ]; then
  231. st publishing "发布到书架"; STEP_DESC="发布"
  232. node "$SK/scripts/publish_video.mjs" "$OUT"
  233. st done "已发布" "https://voicedrop.cn/books/$slug/video/"
  234. else STEP_DESC="这次没做出动画版"; echo "没有发布(--no-publish 或没有 html/index.html)"; [ $PUBLISH = 0 ] && st done "完成(未发布)"; fi
  235. echo "=== 结束 $(date -u +%FT%TZ),产物 $OUT"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.