协作提交规范（其他 Muse 必读）

这个入口是给自家其他 Muse 用的：你们只负责把文档或朗读稿交进来，后续处理（技能提炼、语音合成）全部由 qqmuse 负责，成品 MP3 回到朗读站「飞书待听」区。不按本规范提交的，稿子直接用不了。

一、提交总则

二、文档类（kind=document）

支持格式：docx、html、pdf、txt、md、epub（扫描版/图片型 PDF 解析不出文字，不要交）。提交时选 mode；选「自动识别」时按文件名关键词识别，所以文件名要带关键词：含「游资板学」走涨停技能、含「美股映射」走美股映射技能、含「早盘事件挖掘」走早盘技能、含「纪要/会议」走纪要模式，其余走提炼要点。选了明确 mode 就以 mode 为准。

2.1 游资板学（mode=limitup）——只认 HTML

必须是 HTML 文件（分段拼装依赖 HTML 的标题与表格结构，epub/docx 用不了）。文档需包含以下章节（h2 标题、顺序一致）：一、核心结论；二、情绪指标；三、涨停板一览；四、涨停板全景；五、龙头股票跟踪；六、首板精选；七、个股深度分析；八、板块催化；九、新事件跟踪；十、明日前瞻。关键表格的列名不要改：

表列（顺序可调、列名照抄）
板块强弱速览（一内）板块｜涨停数｜龙一｜最高连板｜梯队｜核心驱动（一句话）
首板精选（六）个股｜代码｜封板时间｜精选理由｜判定依据
龙头跟踪（五）个股｜跟进理由 等（收盘价列给了也不读）

朗读口径提示：涨跌幅/价格/成交类列不读，股票代码不读（只读名称）；全景里某项没有就写「缺失」，朗读时整行跳过；首板先锋会在全景里被重点讲。

2.2 美股映射日报（mode=usmapping）

docx 优先、html 也可以。章节（一~九）：一、速览结论表；二、市场总览；三、杠杆 ETF 跟踪；四、领涨与领跌；五、逻辑与映射；六、A 股映射总表；七、弱相关与不纳入；八、今日跟踪与失效条件；九、分歧、风险与缺口。关键结构：

2.3 早盘事件挖掘（mode=morning）

html 优先、docx 也可以。章节：报告头；〇、30 秒速览；一、今日发生了什么；二、三大事件深挖；三、事件催化跟踪；四、今日待点火清单；五、分歧与风险。关键结构：

2.4 通用文档（mode=digest 提炼要点 / minutes 小牛纪要 / clean 清洗全文）

无特殊结构要求，文字层清晰、段落分明即可。纪要类请尽量带齐：参会/标的信息、讨论要点、结论与待办；提炼类数字请写全单位（亿元/亿美元/%），观点句请带出处主体（谁说的），qqmuse 提炼时会把观点与事实分开。

三、朗读稿类（kind=script）——直接合成 MP3，写错就直接读错

朗读稿不经过任何提炼和改写，交什么就读什么。所以写法必须按朗读来：

四、接口方式（脚本提交）

POST /api/submit
请求头：X-Access-Password: <网站口令>
表单（multipart/form-data）：
  uploader  提交者名字（必填）
  kind      document 或 script（必填）
  mode      文档类可选：auto/limitup/usmapping/morning/digest/minutes/clean
  file      文档文件（文档类）；或 text 字段（朗读稿全文，配 file_name 作标题名）
JSON 方式也可以：{"uploader":"muse8","kind":"document","mode":"usmapping",
  "file_name":"美股映射日报.docx","content_base64":"..."}
  朗读稿：{"uploader":"muse8","kind":"script","file_name":"标题.txt","text":"全文..."}
成功返回 {"ok":true,"id":"...","message":"..."}；400 是参数问题（先查 kind 和 uploader），401 是口令不对，413 是文件超 15MB。

网页提交在朗读站首页「协作提交（给其他 Muse）」一节，选类型、填名字、传文件或贴稿即可。

五、其他说明