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

## 翰林院篇：忆识核心与RAG系统 翰林院，是Amily2号的忆识核心，是真正的记忆中枢。它基于RAG（检索增强生成）技术，能让角色拥有可随时查阅、永不遗忘的知识库。

注意：本篇所有功能，均围绕着一个核心——将你的知识（无论是聊天记录、手动输入的文本，还是世界书条目）转化为向量数据，存入一个特殊的“忆识宝库”中。当你和角色对话时，系统会自动检索宝库中最相关的内容，注入到提示词中，让角色“记起”相关信息。

1. 总览与核心开关

这里是翰林院的仪表面板，展示了核心状态并提供了最高权限的操作。

上图：翰林院总览区域

配置项	说明
开启忆识检索之权	翰林院的总开关。关闭后，所有检索和注入功能都将暂停，但不会影响向量化的录入。
忆识总数	显示当前角色忆识宝库中存储的向量总数。旁边的刷新按钮可以手动更新这个数字。
清空宝库	（危险操作） 一键删除当前角色所有的忆识。此操作不可逆，三思而后行。
存档封印	保存你在翰林院界面所做的所有设置。虽然大多数设置是即时生效的，但点击一下总没错。 Ps：其实1.1.7版本后基本没卵用了。

附加说明：忘记给刷新按钮增加自动刷新了，最好选择角色之后手动刷新一下。

---

2. 忆识检索 (Retrieval)

这里负责配置连接外部“神力之源”（Embedding API）的通道，它是将文字转化为向量的根本。

上图：忆识检索配置区域

配置项	说明
API设定	选择你的Embedding服务商。如果你有自己的中转或特殊服务……也得自定义，毕竟其他的东西没完善。
自定义路径	当API设定为自定义时，在此处填写你的完整API地址。
通行令牌 (API Key)	你的Embedding API密钥。
嵌入模型	你想使用的Embedding模型。点击获取模型按钮可以自动从API拉取可用模型列表。
测试神力	点击后会尝试用你填写的配置连接API，检查是否能成功“沟通”。
重置为初	将此页面的所有设置恢复到最初的默认状态。

重要提示：此处的API与主殿的API是**完全独立**的。主殿API负责聊天，翰林院API负责将知识向量化。两者可以相同，也可以不同。

---

3. 书库编纂 (Historiography)

这里是向忆识宝库中“录入”向量的地方，提供了多种方式。

凝识法则

这是最常用的功能，可以将你们的聊天记录转化为忆识（向量）。

上图：凝识法则配置区域

配置项	说明
准许凝识	此功能的总开关（我一直开着的，不知道关了它之后录入还好不好使。）
凝识范围	设定要转换的聊天记录楼层范围。例如，1-10就是转换最早的10条消息。
消息来源	选择要转换谁说的话，是你，还是AI，还是两者都要。
标签提取	一个高级功能，可以让你只提取消息中特定XML标签里的内容进行转换，可单可多，可预览编辑，但标签顺序要一致。
开始凝识	点击后，立刻根据以上设定，将聊天记录录入忆识宝库。
预览内容	在不实际录入的情况下，查看根据当前设定会生成哪些文本内容。

手动录入 & 按条目编纂

上图：手动录入与按条目编纂区域

功能区	说明
手动录入	在文本框里粘贴任何你想要角色记住的文字（比如角色设定、背景故事），然后点击开始录入，即可存入宝库。
按条目编纂	可以直接选择一个世界书及其中的条目，将其内容整个录入忆识宝库。对于已经整理好的知识非常方便。

附加说明：没事不要加太多东西，酒馆向量库炸了你不炸了吗。

---

4. 忆识精炼 (Rerank)

当检索到的忆识过多时，Rerank功能可以对初步检索结果进行二次排序，选出与当前对话最最相关的几条，大大提高知识注入的精准度。

上图：Rerank配置区域

配置项	说明
启用 Rerank	此功能的总开关。
Rerank API 地址/Key/模型	和Embedding API一样，你需要一个专门的Rerank模型服务。配置方法完全相同。
返回结果数 (top_n)	Rerank之后，最终返回多少条最相关的忆识。
混合分数权重 (Alpha)	一个高级参数，用于平衡原始相似度分数和Rerank分数。保持默认的0.7通常效果最好。
Rerank 时上奏	开启后，每次成功执行Rerank都会在聊天框里发一条通知。

附加说明：听说这东西的提示词挺重要，但是我还没加。而且LLM的实现方式有点复杂，我慢慢整吧还是。

---

5. 高级设定

这里提供了一些微调参数，让你对翰林院的行为有更精细的控制。

上图：检索微调区域

配置项	说明
书卷尺寸 (Chunk Size)	在录入知识时，将长文本切分成的小块的大小。这会影响检索的粒度。
上下文关联度 (Overlap)	每个小块之间重叠的字符数，以确保上下文的连续性。
忆识匹配度 (Threshold)	只有相似度高于这个阈值的忆识才会被检索出来。
检索参考的消息数量	系统会拿最近几条消息作为“问题”去检索忆识宝库。
单次检索最大结果数	在Rerank之前，初步从向量库中捞出多少条相关的忆识。

附加说明：没有附加说明，就单纯不想写。

---

圣言注入

这里决定了检索到的忆识，将以何种方式“告诉”给角色。

上图：圣言注入配置区域

配置项	说明
圣言模板	注入内容的格式。{{text}}是占位符，会被实际的忆识内容替换，占位符不要乱改。 但是上面的提示词可以随意改，例如：“这里是已发生过事情中的相关记忆片段，请以以下内容作为参考：{{text}}。”像是这样。
注入位置	决定了这段“圣言”放在提示词的哪个位置。聊天内 @ 深度是最常用的，可以模拟一条特定角色的历史消息。

---

6. 起居注

这里是翰林院的运行日志，记录了每一次知识录入、检索、注入的详细过程。如果遇到问题，来这里看看，通常能找到原因。

上图：起居注区域

附加说明：翰林院的教程就到这里了。这玩意很强大，但也需要耐心调教。多试试不同的设置，找到最适合你和你的角色的用法吧。

重要提示：但要是有关翰林院的报错，你还给我截图红色框框，你看我把不把你头打爆。

---