与许多将用户锁定在单一封闭模型、并在月费中捆绑高额 Token 溢价的 AI 写作软件不同，Novelcrafter 采用了**自带密钥（BYOK, Bring Your Own Key）**架构。Novelcrafter 自身专注于提供小说工程的脚手架——包括沉浸式手稿编辑器、场景大纲节拍（Scene Beats）以及结构化的世界观设定集（Codex），而底层用于生成正文的 AI 算力则完全开放给作者自主选择。创作者可以直接连接主流商业大模型、聚合服务平台，甚至完全离线运行的本地开源模型。
要真正发挥出这套系统的威力，小说作者需要完成三项核心设置：接入 API 凭证、在提示词预设中挂载所需模型，并针对虚构写作的语感调校生成采样参数（如 Temperature、Top P 与各类重复惩罚）。
一、接入外部 AI 供应商与 API 密钥
在 Novelcrafter 中，AI 连接属于账户级设置。点击界面左下角或右上角的个人头像 → Open Settings → AI Credentials（或 AI Connections）即可进入配置面板。需要特别注意的是：所有 API 密钥均保存在当前浏览器的本地存储（Local Storage）中，不会同步到云端数据库。如果清理了浏览器缓存、使用隐私无痕窗口，或在多台设备间切换，需要重新授权或通过导出/导入功能迁移连接配置。
1. OpenRouter 接入（推荐大多数创作者首选）
对于希望以最少精力调用多种顶级模型的写作者，OpenRouter 是最便捷的整合方案：
- 在 AI Credentials 列表中找到 OpenRouter，点击 Connect。
- 选择 Continue to OpenRouter，登录或注册账号并完成授权。
- 授权时可选择设置该密钥的消费限额（Credit Limit）。请注意：若设置了额度上限且后续触发该限额，Novelcrafter 将提示密钥无效或额度不足错误；此时需在 OpenRouter 后台手动上调或移除该限制。
- 接入后，只需在 OpenRouter 账户中单次充值（预付费模式），即可同时调用 Anthropic Claude 系列、OpenAI GPT、Mistral、Llama 等数十种云端模型。
2. OpenAI 官方 API 直连
若拥有 OpenAI 开发者平台账户：
- 登录 OpenAI 开放平台后台生成并复制 API 密钥。注意：面向个人日常聊天的 ChatGPT Plus 订阅与开发者 API 并不互通，无法用 Plus 账号直接调用接口。
- 在 Novelcrafter 的 AI Credentials 中找到 OpenAI，粘贴密钥并保存。
3. OpenAI 兼容接口（自定义云服务与本地离线模型）
Novelcrafter 支持通过标准 OpenAI 接口规范接入更多第三方平台与本地私有模型：
- 滚动至 AI Credentials 底部，点击 OpenAI Compatible Connection → Add。
- 填写服务名称（例如 Fireworks、Grok / xAI、Groq、Mancer、NanoGPT 或 NovitaAI）以及对应的 Base URL。绝大多数兼容接口以
/v1结尾（例如https://api.groq.com/openai/v1或https://api.x.ai/v1）。 - 填入 API 密钥后，Novelcrafter 会尝试自动嗅探该平台支持的模型列表。如果未自动识别，可勾选 Use custom model list，手动输入模型标识符（以逗号或换行分隔，名称需与供应商完全一致）。
- 本地完全离线写作：若作者通过 LM Studio 或 Ollama 在本地计算机运行大模型，可在 Base URL 中填入本地服务地址（如
http://localhost:1234/v1）。这既能确保作品内容零泄露，也无需承担任何 Token 费用。 - 关于 Anthropic 官方控制台的特别说明：由于现代浏览器的跨域资源共享（CORS）安全机制，前端应用无法直接从浏览器向 Anthropic 控制台发送请求。想要使用 Claude 模型的作者，应通过 OpenRouter 接入，或自行搭建 LiteLLM 本地中转代理。
二、在提示词预设（Prompts）中配置与管理模型
API 凭证就绪后，模型并不是全局绑定的，而是按任务分配给不同的提示词动作。Novelcrafter 将长篇小说的 AI 功能拆解为独立模块：场景节拍正文生成（Scene Beat Completion）、顺接续写（Continue Writing）、场景自动摘要（Scene Summarization）与工作坊聊天（Workshop Chat）。
如果需要调整某个写作动作所使用的模型：
- 从左侧导航栏或项目菜单中打开 Prompt Library（提示词库）。
- 选择需要配置的提示词（例如系统默认的 General Purpose Scene Beat Completion）。
- 如果是系统只读提示词，先点击 Clone（克隆）复制一份自定义版本，因为官方默认预设不允许直接修改参数。
- 进入提示词详情页的 General 标签页，切换至 Models。
- 在此可以添加、删除模型，或者关联预先配置好的 Model Collections（模型集合）。建议按创作需求分类建立集合，例如将“快速构思集合”（如 Groq Llama 3）与“深度文笔集合”（如 Claude 3.5 Sonnet）分开，便于正文起草时一键切换。
三、调校正文生成采样参数（Prose Settings）
在虚构小说创作中，模型参数的微调往往直接决定了生成文本的文风、语感与逻辑稳定性。在提示词的 Models 列表中，点击每个模型名称旁边的展开箭头（>），即可自定义核心采样参数：
1. Temperature（采样温度：创意度与遵循度）
- 原理：控制模型预测下一个 Token 时的概率分布平滑度。
- 低数值（0.3 – 0.6）：输出更为专注、严谨、可预测。适合用于对前序章节进行摘要提炼、维持严格的角色特定语气，或者推进必须精确包含线索的推理情节。
- 高数值（0.7 – 1.0+）：输出更具想象力与冒险性，用词更为丰富跳跃。适合在觉得正文千篇一律、生硬古板，或者需要撰写氛围描写、超现实梦境与战斗场面时使用。
2. Top P（核采样：词汇广度与异常词过滤）
- 原理：截取累积概率达到阈值的最高概率候选词集合。
- 实战建议：当模型出现怪异乱码、自造怪词或拼写错乱时（在高 Temperature 配合开源模型时尤为常见），调低 Top P（例如降至 0.85 – 0.90）是最有效的纠正方式，它能将模型约束在更常见、更安全的词汇库中。若希望文字更生动典雅，可适当提升 Top P。
3. Max Tokens（最大生成长度与节奏控制）
- 原理：对单次返回的 Token 数量施加硬性截断。
- 实战建议：语言模型在达到 Max Tokens 阈值时会立刻中断生成，哪怕句子只写了一半。因此，不要依赖低 Max Tokens 来控制段落长度。正确的做法是将 Max Tokens 设定为能容纳一个完整场景节拍的上限（例如 800 至 1,500 Tokens），并通过提示词变量或输入项指定预期的字数范围。
4. 惩罚项（Penalties：防止重复与循环车轱辘话）
- Frequency Penalty（频率惩罚）：根据词汇在已生成文本中出现的次数进行惩罚。如果发现模型有过度使用特定口头禅（如“突然”、“凝视”、“深吸一口气”）的毛病，微调增加该值（+0.1 到 +0.3）；注意不要设得过高，否则可能导致模型回避角色名字。
- Presence Penalty（存在惩罚）：只要某个话题或概念出现过一次就会被抑制。适合用于角色对话或场景推进，促使模型引入新话题，避免在同一个争论点反复绕圈。
- Repetition Penalty（通用重复惩罚）：在开源与本地模型中常见（通常在 1.05 到 1.15 之间），能从根本上遏制长篇生成中的句式循环。
- Reasoning / Thinking Effort（思考推理深度）：针对具备深度推理能力的模型（如 Claude 思考模式或 OpenAI 推理系列），配置该参数可让模型在下笔写正文之前，先深入分析剧情伏笔、人物动机与 Codex 世界观设定的前后一致性。
四、在 Write 手稿界面中投入实战
完成配置后，在日常码字流程中调用已调优的模型非常流畅：
- 进入手稿的 Write 界面，打开任意章节或场景。
- 在正文空白处输入斜杠命令
/，从菜单中选择 Scene Beat。 - 输入本段要发生的情节指令（如动作细节、心理状态）。Novelcrafter 会自动识别并关联你提及的 Codex 词条（人物、地点、道具）。
- 在右侧 Play（▶） 按钮旁的下拉菜单中，选择你调优好的模型预设，或点击 Tweak and Generate 临时调整上下文传入参数。
- 生成完毕后，Novelcrafter 提供了四种处理选项：
- Apply：直接将生成的正文采纳并合并入正文。
- Retry：放弃本次生成，使用相同参数重新请求一次。
- Discard：直接废弃本次输出。
- Section：将输出以折叠卡片（Section）的形式保留在文中。你可以使用不同模型分别生成几版，然后通过“套件拼接（Kitbashing）”的方式挑选各家最精彩的段落组合成最终文稿。
通过本地安全的 BYOK 连接、模块化的提示词库与精准的采样参数校准，小说作者既能完全掌控 AI 开销，又能根据不同题材精细塑造专属的叙事声音。