用途
Creator 用于多步骤的内容生产，将写作与媒体生成组合成一个面向平台的、可直接发布的成品包。适用场景包括：用户需要为特定平台生成完整内容包（公众号文章、小红书帖子、口播稿）；用户说“帮我写篇公众号”“小红书图文”“口播稿”等；用户提供 URL、文本或主题，希望转化为带图的可发布内容。
不适用：只需要单张图片（直接用 image-gen）、只需要单段 TTS（直接用 tts）、需要转写音频（直接用 asr）、需要播客节目（直接用 podcast）、只需要从 URL 提取内容而不做后续处理（直接用 content-parser）。
主要能力
输入类型自动分类与处理：URL（网页/文章）调用 content-parser；URL（音视频，如 mp3/mp4/wav/m4a/webm 或 youtube/bilibili/douyin 域名）先下载再调用 coli asr 转写；本地音视频文件直接调用 coli asr；本地文本文件读取内容；原始文本直接作为素材；短文本主题由 AI 从零创作。
模板匹配：支持公众号（wechat，长文加 AI 配图）、小红书（xiaohongshu，图文卡片加长文）、口播稿（narration，口播脚本，可选音频）。
选题辅助：对短文本主题，读取平台 methodology.md，用三圆维恩模型（创作者专业领域、读者普遍兴趣、当下时间节点）评估，并运行 HKR 质量过滤（Happy 有趣有悬念、Knowledge 有信息量、Resonance 情绪共鸣）；不足 2 项时建议 2-3 个替代角度。
风格提取与持久化：用户提供“参考/风格/照着…写”等风格参考时，提炼 3-5 条具体风格指令，经确认后作为本次会话风格；可选择持久化到 .listenhub/creator/styles/{platform}.md。仅提供风格参考时视为独立风格学习，直接保存。
内容原型选择：读取平台原型文件，根据素材/主题自动匹配最佳原型，经用户确认后决定叙事结构与评审标准。
配图预设选择：在确认门禁前选择配图或卡片预设（口播模板及小红书仅长文模式跳过）。
确认门禁：检查是否需要远程 API（公众号总是需要 image-gen；小红书卡片模式需要 image-gen；小红书仅长文无需；口播无 TTS 无需；网页/文章 URL 需要 content-parser），展示含模板、输入、输出目录、API 调用、风格偏好、预设、原型、本次风格参考的摘要，等待明确确认。
执行与组装：按平台模板执行，生成内容文件、图片、meta.json（含标题、slug、平台、日期、标签、摘要），输出到当前工作目录（非 Downloads 或 .listenhub）的 {slug}-{platform}/ 文件夹（重名自动去重）。
偏好更新：将本次生成记录写入 history，每个平台保留最近 5 条。
手动风格调优：用户说“记住：…”时追加指令到对应平台风格文件；“重置风格偏好”时按平台（或全部）删除对应文件。
使用方式
通过 CLI 调用。硬性约束：image-gen 与 TTS 使用 listenhub CLI 命令；content-parser 使用 curl。交互前读取 shared/config-pattern.md 配置，遵循 shared/cli-patterns.md 的轮询、错误与交互模式；文件不得保存到 ~/Downloads/ 或 .listenhub/；JSON 解析仅用 jq。
首次运行静默创建配置：.listenhub/creator/config.json（outputMode 默认 download，language 为 null，含 wechat/xiaohongshu/narration 偏好），以及 .listenhub/creator/styles/ 目录。风格文件为纯 markdown，每行一条指令，不存在则不应用自定义风格。
主要命令示例：转写用 coli asr -j --model sensevoice；内容提取 POST https://api.marswave.ai/openapi/v1/content/extract，轮询 GET 对应 taskId（后台运行，最多 60 次 ×5 秒）；图片生成用 listenhub image create --prompt ... --aspect-ratio ... --json，base64 解码保存（macOS 用 -D，Linux 用 -d），遇到 429 指数退避（15s→30s→60s）最多重试 3 次，失败则跳过并标注，图片顺序生成；TTS 用 listenhub tts create --text ... --speaker ... --json。
风格应用优先级：sessionStyle（本次参考提炼）> .listenhub/creator/styles/{platform}.md（持久化用户风格）> templates/{platform}/style.md（平台基线风格）。
适用场景
适合需要一次产出多文件、面向特定平台发布的内容生产流程，尤其是希望把链接、文本或音视频素材快速转化为带配图、带元数据的成品包的场景，并可通过风格文件与历史记录保持风格一致。
限制
部分流水线需要 API Key（公众号图片、小红书卡片、网页/文章提取均需要）；缺失时 CLI 调用运行 listenhub auth login，content-parser 需配置 LISTENHUB_API_KEY。音视频 URL 走本地 coli asr，无需 API Key；若 coli 未安装，需 npm install -g @marswave/coli，或改为粘贴文本。URL 提取失败时提示用户直接粘贴文字。cardStyle 在 V1 配置中未实现。各平台的具体写作指令与内容原型细节位于对应模板文件中，本资料未逐一提供。