模式注入与知识库详解 · 上下文片段自动插入
核心概念
提示词注入是 RikkaHub 自动插入到对话上下文中指定位置的文本片段。有两种形态：
| 形态 | 触发方式 | 典型用途 |
|---|---|---|
| 模式注入（Mode Injection） | 助手激活时始终注入 | 风格切换（正式 / 创意 / 分步推理） |
| 知识库（Lorebook） | 对话中出现特定关键词时自动触发 | 世界观设定、项目术语表 |
创建模式注入
模式注入是手动切换的文本片段，只要助手激活就始终注入。
步骤
- 打开 设置 → 提示词
- 在「模式注入」部分点击 +
- 填写：
- 名称：可读标签
- 内容：要注入的文本（可以是一段系统提示词扩展）
- 注入位置：见下节详解
- 角色：用户 / 助手
- 优先级：数字越大越先注入
- 保存
常见用法
- 正式写作模式：注入"以正式、简洁的商务风格写作"
- 分步推理模式：注入"先列出要点，再逐个展开"
- 代码审查模式：注入代码审查 checklist
创建知识库
知识库是带关键词的条目集合。每个条目有自己的关键词，当关键词出现在最近消息中时，条目的文本自动注入。
步骤
- 打开 设置 → 提示词
- 在「知识库」部分点击 + 创建新知识库
- 给知识库命名（如 "奇幻世界设定"、"项目术语表"）
- 在知识库内点击 + 创建条目，每个条目配置：
- 关键词：触发此条目的词语（支持正则）
- 内容：触发时注入的文本
- 注入位置、角色、优先级
- 扫描深度：检查最近多少条消息的关键词
- 使用正则表达式：关键词是否按正则匹配
- 区分大小写
- 始终激活：无条件注入此条目（不再检查关键词）
- 保存知识库
将注入附加到助手
- 打开 设置 → 助手 → 某个助手 → 扩展 标签页
- 模式注入 子标签页：开启你要激活的模式注入
- 知识库 子标签页：开启你要激活的知识库
全局安装的注入 / 知识库不会自动为所有助手激活——你需要逐个助手选择开启哪些。这是有意设计，避免不需要的内容无谓占用上下文。
注入位置详解
每个注入可以选以下位置（优先级从上到下）：
| 位置 | 说明 | 适用场景 |
|---|---|---|
| 系统提示词之前 | 在所有系统消息前插入 | 需要最高优先级的框架性指令 |
| 系统提示词之后 | 追加到系统消息末尾（最常用） | 扩展系统提示词而不替换 |
| 对话顶部 | 在第一条用户消息之前 | 开头需要出现一次的场景上下文 |
| 对话底部 | 在最近一条用户消息之前 | 需要保持在模型注意力中的提醒 |
| 指定深度 | 距消息列表末尾 N 条处 | 精确的相对位置控制 |
RikkaHub 会注意不在用户消息和紧随其后的含工具调用的助手消息之间插入注入，因为某些提供商（如 DeepSeek）要求这两条消息相邻。
多注入同时生效时的处理
如果多个注入针对同一位置，RikkaHub 按 优先级值降序排列——数字越大，越先注入。在同一位置具有相同角色的注入会合并为一条消息，保持对话结构整洁。