[![中文](https://img.shields.io/badge/%E4%B8%AD%E6%96%87-8b1a1a?style=for-the-badge)](README.md) [![English](https://img.shields.io/badge/English-f2e3e3?style=for-the-badge&labelColor=f2e3e3&color=b07070)](README.en.md) [![关注作者 X](https://img.shields.io/badge/%E5%85%B3%E6%B3%A8%E4%BD%9C%E8%80%85-%40eternityspring-b07070?style=for-the-badge&labelColor=8b1a1a&logo=x&logoColor=f2e3e3)](https://x.com/eternityspring) # novel-characters 丢一本小说或一篇短故事进去，输出每个角色的完整设定： - **角色表** — 谁出场了，主角还是龙套，跨章节的不同称呼归并到同一个人 - **人物画像** — 性别、年龄、身份、外貌、性情、动机、人物弧光、关系网，每条附**原文逐字引文** - **形象提示词** — 双语出图 prompt + negative prompt + 标签，直接喂 Midjourney / SD / GPT-Image。画风不写进提示词，由调用方在出图时整批附加 - **音色提示词** — 音色、音高、语速、口音、情绪，双语 voice-design prompt，直接喂 Qwen3-TTS / ElevenLabs Voice Design - **角色设定图的版面指令** — **每个角色一条**：16:9 分三区，左侧约 34% 证件照式半身像（面部基准）、右上全身三视图、右下关键细节特写条，白底方便抠图。**本 skill 不出图**，交付的是这段指令 - **关系图谱** — 报告里的一个全景视图：谁跟谁有关系、是什么关系，一眼看完。悬停一个人亮出他的全部关系，点一下跳到那个人的详情 产出 `cast.json` + Markdown + 一个双击就能开的 `report.html`。 **报告语言可指定**，默认中文： ``` /novel-characters ./book.txt --lang en /novel-characters ./book.txt --lang ja ``` 内置 **中文 / English / 日本語** 三套界面文案。**其他语言一样支持**——skill 会现场把界面文案翻译成目标语言，存进 `cast.json` 的 `ui` 字段，渲染时合并进去。所以法语、韩语、西班牙语都能出完整报告，不会露出英文界面。 想自己准备翻译： ```bash node scripts/novel-characters.mjs ui-template fr # 打印待翻译的骨架 ``` ![report.html](assets/report.webp) 角色设定图（自带样例《渡口》的沈知微）： ![角色设定图](assets/sheet.jpg) ## 上游 管线里**大纲在角色的上游**： ``` novel-outline → outline.json （什么：结构与分集，谁进谁不进） novel-characters → cast.json （谁：角色资产） ``` 有 `outline.json` 就走 `seed`——它的 `characters` 块已经定死了角色清单： ```bash node scripts/novel-characters.mjs seed outline.json > seed.json ``` 搬过来的是大纲拍板过的事实（角色码、名字、分档、人物线、由原著的谁合并而来），留空的是这一层才该做的设计（别名、画像、形象提示词、音色提示词）。`tier` 映射成 `importance`：`lead` → protagonist、`support` → supporting、`functional` → minor。 **大纲定的分档不要在这一层推翻**，觉得不对回去改大纲。主角组内部可以细分——`lead` 是「男女主 + 主反派」一整组，seed 一律给 protagonist，照 `seedNote` 里的定位把主角之外的改成 major。 **没有 `outline.json` 也照常跑**，本 skill 不依赖它——跳过 seed，直接丢一本小说进去，自己从原文拆角色表。 ## 使用 安装见[仓库根 README](../../README.md)。装好后： ``` /novel-characters ./你的小说.txt ``` 或者直接说「帮我拆一下这本书的角色」并给出路径。 ### 报告语言 默认中文。用 `--lang`，或者直接说「用英文」「日本語で」： ``` /novel-characters ./book.txt --lang en /novel-characters ./book.txt --lang ja ``` 内置 **中文 / English / 日本語** 三套界面文案。**其他语言一样支持**——skill 会现场把界面文案翻译成目标语言，存进 `cast.json` 的 `ui` 字段，渲染时合并。法语、韩语、西班牙语都能出完整报告，不会露出英文界面。 两条不跟随语言：**出图和 TTS 提示词永远英文**（引擎吃英文最稳）；**原文引文永远保持原文语言**（翻译了就不是证据了）。 ## 报告长什么样 三栏工作台：顶栏搜索，左栏是故事摘要 + 按戏份排的角色列表，主区一次只看一个角色。 **关系图谱**在左栏顶部，跟角色详情互斥。边直接来自每个角色的 `relationships`，不用模型再跑一趟： - 按**名字 + 别名**连边——老周的关系里写「老伯」也连到同一个节点 - 同一对人的两条单向记述合并成一条边，两个方向的说法都留着 - 弦上标一段关系文字（截到 6 字，全文在悬停提示和右侧关系表里）。边多了会糊， ≤ 14 条默认标出来，再多默认收起，顶部有开关 - 悬停一个人亮出他的全部关系线，悬停关系表某一行只亮那一条，点谁跳谁 圆环布局在 Node 里算好直接写进内联 SVG，**不引任何库**——report.html 始终是一个能离线双击打开的单文件。 ### 导出 JSON 顶栏的「导出 JSON」下载的**就是 `cast.json` 本身的形状**，不是另一套导出格式： ```json { "source": "…", "lang": "zh", "summary": "…", "characters": [ … ] } ``` 所以外部工具改完可以**直接喂回 `render` 重新出报告**，也能过 `validate`。角色卡里的 `sheetImage` 一并带出，拿得到哪张图对应哪个人——图由下游出，`render --images <目录>` 指到图所在的目录就会捡起来（不给就找 cast.json 同级的 `images/`）。 数据以 `