webnovel-writer/docs/user/configuration.md

主模型与可选检索配置

DSH 负责模型连接与凭据，本插件负责小说工作流。先把一个主聊天模型配置成功，再开始建书；嵌入、场景识别和重排均不是首次安装的前提。

最小可用配置

1. 在宿主设置的模型页面添加你实际可用的服务，填写其 API 地址、模型标识和凭据。
2. 把它设为当前任务使用的主模型，发送一条短测试消息。能收到正常回答再运行写作流程。
3. 使用模型服务提供方给出的精确模型标识，不从示例名称猜测服务支持范围。额度、上下文、工具调用能力和速率限制都可能影响写作。

主模型选项保存在宿主 agent-default-model 设置中，结构示例见 minimal-settings.yaml。占位值必须换成已经配置的 provider/model ID；优先使用设置界面保存，避免手工破坏现有设置。

API key 由宿主凭据机制保管。不要把 key 写进作品、可提交的 YAML、截图或公开日志。选择主模型并不自动安装额外检索模型。

可选 embedding-provider

使用主包安装方式时，可单独添加嵌入提供方；完整版已包含此包：

dsh plugin --profile scriptor add webnovel-embedding-provider@0.0.8

首次安装默认停用。在“设置 → 模型 → 嵌入模型 → 混合检索 · 嵌入 API”中配置协议、API 根地址、模型、维度及凭据，并显式启用。支持 OpenAI 兼容和 Gemini 原生协议；维度必须与服务真实输出一致。

场景识别选择宿主已经配置的聊天模型；重排填写其独立接口与模型。两者默认关闭。重排失败回退原排序，场景识别失败回退段落分块；界面会说明状态，不能把降级当作已获得模型增强效果。

“检测默认维度”会发送一条测试文本，可能收费。启用向量索引后会发送定稿切片；重排会发送查询与候选片段。完整边界见 隐私与费用。

高级说明与模型维度表见 提供方 README。