Add files via upload

This commit is contained in:
2025-07-21 07:11:50 +08:00
committed by GitHub
parent 3cfafaa2e1
commit 199f3512d5
3 changed files with 333 additions and 0 deletions

151
HanLin.md Normal file
View File

@@ -0,0 +1,151 @@
---
## 翰林院篇忆识核心与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>
---