Files
ST-Amily2-Chat-Optimisation/HanLin.md

152 lines
8.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
## 翰林院篇忆识核心与RAG系统
翰林院是Amily2号的忆识核心是真正的记忆中枢。它基于RAG检索增强生成技术能让角色拥有可随时查阅、永不遗忘的知识库。
<div style="padding: 10px; background-color: #d1ecf1; border: 1px solid #bee5eb; border-radius: 5px; color: #0c5460;">
注意:本篇所有功能,均围绕着一个核心——将你的知识(无论是聊天记录、手动输入的文本,还是世界书条目)转化为向量数据,存入一个特殊的“忆识宝库”中。当你和角色对话时,系统会自动检索宝库中最相关的内容,注入到提示词中,让角色“记起”相关信息。
</div>
---
### 1. 总览与核心开关
这里是翰林院的仪表面板,展示了核心状态并提供了最高权限的操作。
![总览界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/main_controls.png)
*<center>上图:翰林院总览区域</center>*
| 配置项 | 说明 |
|---|---|
| **开启忆识检索之权** | **翰林院的总开关**。关闭后,所有检索和注入功能都将暂停,但不会影响向量化的录入。 |
| **忆识总数** | 显示当前角色忆识宝库中存储的向量总数。旁边的**刷新**按钮可以手动更新这个数字。 |
| **清空宝库** | **(危险操作)** 一键删除当前角色**所有**的忆识。此操作不可逆,三思而后行。 |
| **存档封印** | 保存你在翰林院界面所做的所有设置。虽然大多数设置是即时生效的,但点击一下总没错。<br />Ps其实`1.1.7`版本后基本没卵用了。 |
> **附加说明**:忘记给刷新按钮增加自动刷新了,最好选择角色之后手动刷新一下。
---
### 2. 忆识检索 (Retrieval)
这里负责配置连接外部“神力之源”Embedding API的通道它是将文字转化为向量的根本。
![忆识检索界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/retrieval_main.png)
*<center>上图:忆识检索配置区域</center>*
| 配置项 | 说明 |
|---|---|
| **API设定** | 选择你的Embedding服务商。如果你有自己的中转或特殊服务……也得`自定义`,毕竟其他的东西没完善。 |
| **自定义路径** | 当`API设定``自定义`在此处填写你的完整API地址。 |
| **通行令牌 (API Key)** | 你的Embedding API密钥。 |
| **嵌入模型** | 你想使用的Embedding模型。点击`获取模型`按钮可以自动从API拉取可用模型列表。 |
| **测试神力** | 点击后会尝试用你填写的配置连接API检查是否能成功“沟通”。 |
| **重置为初** | 将此页面的所有设置恢复到最初的默认状态。 |
> <div style="padding: 10px; background-color: #f8d7da; border: 1px solid #f5c6cb; border-radius: 5px; color: #721c24;"> 重要提示此处的API与主殿的API是**完全独立**的。主殿API负责聊天翰林院API负责将知识向量化。两者可以相同也可以不同。</div>
---
### 3. 书库编纂 (Historiography)
这里是向忆识宝库中“录入”向量的地方,提供了多种方式。
#### 凝识法则
这是最常用的功能,可以将你们的聊天记录转化为忆识(向量)。
![凝识法则界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/Shukubianzhuan.png)
*<center>上图:凝识法则配置区域</center>*
| 配置项 | 说明 |
|---|---|
| **准许凝识** | 此功能的总开关(我一直开着的,不知道关了它之后录入还好不好使。) |
| **凝识范围** | 设定要转换的聊天记录楼层范围。例如1-10就是转换最早的10条消息。 |
| **消息来源** | 选择要转换谁说的话是你还是AI还是两者都要。 |
| **标签提取** | 一个高级功能可以让你只提取消息中特定XML标签里的内容进行转换可单可多可预览编辑但标签顺序要一致。 |
| **开始凝识** | 点击后,立刻根据以上设定,将聊天记录录入忆识宝库。 |
| **预览内容** | 在不实际录入的情况下,查看根据当前设定会生成哪些文本内容。 |
#### 手动录入 & 按条目编纂
![手动与按条目编纂](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/condensation_manual_ingest.png)
![手动与按条目编纂](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/condensation_by_entry.png)
*<center>上图:手动录入与按条目编纂区域</center>*
| 功能区 | 说明 |
|---|---|
| **手动录入** | 在文本框里粘贴任何你想要角色记住的文字(比如角色设定、背景故事),然后点击`开始录入`,即可存入宝库。 |
| **按条目编纂** | 可以直接选择一个**世界书**及其中的**条目**,将其内容整个录入忆识宝库。对于已经整理好的知识非常方便。 |
> **附加说明**:没事不要加太多东西,酒馆向量库炸了你不炸了吗。
---
### 4. 忆识精炼 (Rerank)
当检索到的忆识过多时Rerank功能可以对初步检索结果进行二次排序选出与当前对话**最最相关**的几条,大大提高知识注入的精准度。
![忆识精炼界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/rerank_main.png)
*<center>上图Rerank配置区域</center>*
| 配置项 | 说明 |
|---|---|
| **启用 Rerank** | 此功能的总开关。 |
| **Rerank API 地址/Key/模型** | 和Embedding API一样你需要一个专门的Rerank模型服务。配置方法完全相同。 |
| **返回结果数 (top_n)** | Rerank之后最终返回多少条最相关的忆识。 |
| **混合分数权重 (Alpha)** | 一个高级参数用于平衡原始相似度分数和Rerank分数。保持默认的0.7通常效果最好。 |
| **Rerank 时上奏** | 开启后每次成功执行Rerank都会在聊天框里发一条通知。 |
> **附加说明**听说这东西的提示词挺重要但是我还没加。而且LLM的实现方式有点复杂我慢慢整吧还是。
---
### 5. 高级设定
这里提供了一些微调参数,让你对翰林院的行为有更精细的控制。
![高级设定界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/advanced_settings_1.png)
*<center>上图:检索微调区域</center>*
| 配置项 | 说明 |
|---|---|
| **书卷尺寸 (Chunk Size)** | 在录入知识时,将长文本切分成的小块的大小。这会影响检索的粒度。 |
| **上下文关联度 (Overlap)** | 每个小块之间重叠的字符数,以确保上下文的连续性。 |
| **忆识匹配度 (Threshold)** | 只有相似度高于这个阈值的忆识才会被检索出来。 |
| **检索参考的消息数量** | 系统会拿最近几条消息作为“问题”去检索忆识宝库。 |
| **单次检索最大结果数** | 在Rerank之前初步从向量库中捞出多少条相关的忆识。 |
> **附加说明**:没有附加说明,就单纯不想写。
---
#### 圣言注入
这里决定了检索到的忆识,将以何种方式“告诉”给角色。
![圣言注入界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/advanced_settings_injection.png)
*<center>上图:圣言注入配置区域</center>*
| 配置项 | 说明 |
|---|---|
| **圣言模板** | 注入内容的格式。`{{text}}`是占位符,会被实际的忆识内容替换,占位符不要乱改。<br />但是上面的提示词可以随意改,例如:“这里是已发生过事情中的相关记忆片段,请以以下内容作为参考:{{text}}。”像是这样。 |
| **注入位置** | 决定了这段“圣言”放在提示词的哪个位置。`聊天内 @ 深度`是最常用的,可以模拟一条特定角色的历史消息。 |
---
### 6. 起居注
这里是翰林院的运行日志,记录了每一次知识录入、检索、注入的详细过程。如果遇到问题,来这里看看,通常能找到原因。
![起居注界面](https://cdn.jsdelivr.net/gh/Wx-2025/ST-Amily2-images@main/images/log_view.png)
*<center>上图:起居注区域</center>*
> **附加说明**:翰林院的教程就到这里了。这玩意很强大,但也需要耐心调教。多试试不同的设置,找到最适合你和你的角色的用法吧。
>
> <div style="padding: 10px; background-color: #f8d7da; border: 1px solid #f5c6cb; border-radius: 5px; color: #721c24;"> 重要提示:但要是有关翰林院的报错,你还给我截图红色框框,你看我把不把你头打爆。</div>
---