系 统 操 作 文 档

阅读说明

本文档按「先会用、再排障」的顺序编排，建议从第一章顺着读：

标注约定

全文用三种底色块区分信息的性质，看到底色就知道该用什么态度读：

这份文档的一条原则

整套系统在「查不到」和「没查成」之间保持严格区分，文档也沿用这条：凡是检索没有把握的地方，界面会明说「未命中」或「未启用」，而不是给一个看起来像答案的东西。

因此你会看到不少「结果显示为空但不算失败」的情形——那是设计如此，不是故障。第五章按现象逐条列了该怎么判断。

第一章　系统概述

1.1 这套系统做什么

古籍智能研究平台是一套面向古籍全文的检索与研究辅助系统。它把整批古籍语料（十万量级文献、十亿量级字数）建成索引，让使用者用日常语言提问就能定位到原文，并在此基础上提供校勘、史实考证、释义三类机器辅助分析。

它要解决的核心问题是：古籍语料无法用普通全文检索用好。原因有三——

• 使用者记不住原文，只能描述印象（「有句话讲山高八百里」），而传统检索只能匹配字面；
• 繁体、简体、异体字混用（玉溜／玉瑠），字面匹配漏召严重；
• 语料里同名、常见短语极多，直接给「命中行数最多」的结果，往往把真正的出处压在后面。

系统对这三点的做法分别是：语义检索（按意思找）、繁简与异体归一、按覆盖度排序（一本书覆盖了你要找的多少段，而不是被同一个常见词命中了多少次）。

1.2 三种典型查询，对应三种功能

使用前先分清自己手里是哪一种查询，这决定了该用哪个功能、以及花多久：

系统会自动判断你输入的是哪一类（界面上以徽章显示），不需要你选。判错的代价不大：结果区会说明它按什么找的。

1.3 三层结构：快、准、穷尽，按需逐层付出代价

检索不是单一动作，而是三层。默认只走前两层，第三层由你手动触发——因为它慢得多。

1.4 界面总览

检索页（文献列表页）是主要工作界面，自上而下分四块：

检索区（顶部）

输入框 + 检索按钮组。新按钮与旧按钮并存，互不影响（见 2.1）。

结果区

每条结果是一张卡片：书名、命中类型标签、出处行、原文片段。智能检索还会多一条分项打分条。

AI 回答区（可选）

开启后出现在结果下方——原文永远优先，这是刻意的（见 2.5）。

状态与提示区

索引状态、降级提示、逃生阀入口。这里的信息比结果本身更需要看，见 2.6。

1.5 名词速查

新手最容易卡住的几个词，一次说清：

第二章　用检索功能定位原文

2.1 三个检索按钮，各管什么

检索区有三个按钮，它们是三套不同的做法，不是「新版旧版二选一」。先记住这张表，用错按钮是最常见的效率损失：

2.2 输入框怎么写

系统会自己判断你输入的是哪一类，但写法仍然影响准确率：

2.3 查一本书：按书名查询

输入书名（加不加《》都可以，系统会自动识别），系统会直接定位到这本书，而不是拿书名当关键词去全文里找。结果卡片上会出现「📚 按书名定位」的徽章——看到它就说明识别对了。

2.4 找一段印象：混合检索

描述型的提问走混合检索，它把三类信号加权后给结果：语义（这段话在讲什么）、字面（哪些词真在这本书里）、先验（书名精确命中、分类、热度）。每张卡片下方都有一条打分明细条，把这三项的贡献画出来——它存在的意义是让你能质疑系统：如果一条结果的分数几乎全来自「先验」而没有字面命中，那多半是书名的功劳，不是内容真的对上了。

2.5 找一整句话的出处，以及「全库精查」逃生阀

输入一整句带标点的原文（≥15 字、至少两个标点），系统会判定为「📜 原文出处查找」，用锚点匹配的方式定位：把这句话切成若干片段，看哪些片段落在同一小段文字里。落在一起的片段越多，越可能是出处。

而当候选书中一个字面命中都没有时，结果区会主动摆出一个「全库精查」入口。这是系统在承认自己会漏：第一层的书级召回只采每本书的一小段做指纹，服务不了人名、地名这类专名——「杜如晦」在语料里出现几百处，但那几处未必落在采样窗口里。

精查的排序键是覆盖度——「这本书命中了这段文字的几段」。实测喂进《旧唐书·杜如晦传》的首段（245 字）：

2.6 结果卡片怎么读

一张卡片上有六处信息，从上往下读的顺序就是「先看它凭什么出现在这里，再看它说了什么」：

2.7 结果区那几行提示，比结果本身更该看

系统在结果上方或卡片之间插入的文字，是它在说明这次检索的可靠程度。常见的几种：

「仅命中『X』（检索词的片段，非原文出处）」

书里没有你要找的那几个字，只是某个片段词撞上了。这条结果基本可以不看。

「语义未启用（纯关键词结果）」

语义通道不可用，系统改用字面+先验继续给结果。结果仍可用，但描述型提问的命中率会下降。

「候选共 N 本，已对其中前 400 本做覆盖度重排」

精查的覆盖面说明（见 2.5）。

「没有一本包含这些字串」

全库扫描后确认语料里没有这段文字。这是结论，不是失败。

2.8 分类目录、热搜榜、排序与分页

• 分类目录（左上 ☰）：按 经/史/子/集 与子类逐层筛选。选了分类就是真的按分类过滤，不会因为过滤后没结果而偷偷退回全库。
• 热搜榜：来自该系统的真实检索日志，可用于了解别人在查什么（图 2-5）。
• 排序：默认排序（相关度）与 🔥 最热（按热度）。智能检索的结果不受排序按钮影响——它的顺序就是算法给出的相关度顺序。
• 分页：底部页码，每页条数固定。

2.9 AI 回答卡（可选功能）

智能检索的请求里有一个 generate_answer 开关，打开后系统会把检索到的原文片段交给大模型归纳成一段话，附在结果下方。

回答卡里的每一处引用都会逐字回查原文：核不上的引用会被丢弃并标注，模型答不上来时它会直说「所给片段不足以回答」，而不是编一个像样的答案。

2.10 查不到时怎么办（决策表）

第三章　深度分析：让三个 Agent 读一段原文

深度分析是这套系统里最像「研究助手」的部分：给它一段原文，它会让三个分工不同的 Agent 各自分析，并把语料库里真实收录这段文字的书作为参考来源一并列出。

3.1 从哪里打开

1. 用「🔍 搜索」或「✨ 智能检索」找到一本书；
2. 点击书名打开阅读器（图 3-1）；
3. 在阅读器顶部点「🧠 深度分析」——面板里的书名会自动带上，这一点很重要，见 3.3；
4. 把你要分析的原文粘贴到输入框（默认预填的是当前阅读位置附近的内容，可以直接改），点「开始分析」。

3.2 该喂什么文本

3.3 一次分析要多久

分析过程中面板顶部会显示一行提示：「首次分析会先做一次全库精查（约 1 分钟），之后再问同一段文字会快很多」——这不是敷衍，是实测数字。

3.4 四个页签：分别看什么

3.5 参考来源：那些带方括号的编号

参考来源是这套系统里最值得信赖的部分，因为它是检索出来的、逐字可回溯的，不是模型说的。每条来源都带三样东西：

前缀字母

I = 释义 Agent 用的证据，C = 校勘，H = 史实考证。同一处出处被两个 Agent 用到就会出现两次（如 I1 与 C1），不做重新编号，这样任何一处引用都能直接对上是哪个 Agent 在用。

出处行

《书名》· 片段… （第 N 字起）。点它会打开原文并跳到那个位置。

括号编号

如 (I1)，出现在词语释义、逐句解析等正文里，标明这句话的依据来自哪条来源。没有编号的结论就是没有出处的结论。

3.6 保存笔记

分析完成后，面板上的「📌 保存笔记」可以把这次分析存进系统的研究笔记里，之后在笔记列表里回看。适合把「读到的 + 分析得到的」当成一条读书记录沉淀下来。

3.7 三个 Agent 各自的能力边界（务必读）

这三个 Agent 是辅助，不是权威。系统在提示词层面给它们设了几道线，了解这几道线，你才知道该信到什么程度：

3.8 与检索功能的分工

第四章　阅读、笔记与平台其它功能

4.1 阅读器

在结果卡片上点书名即打开阅读器。可用的操作：

• 翻页：底部「← 上一页 / 下一页 →」，也可用列表下方的「加载更多」继续拉结果；
• 阅读进度自动保存：同一本书再次打开会回到上次的位置；
• 关键词高亮：从检索结果进入时，检索词会在正文里高亮；
• 💬 评论：查看/发表这本书的评论（见 4.2）；
• 🧠 深度分析：见第三章。

4.2 评论、意见反馈与问题报告

三者在同一个入口（页面顶部的「反馈」面板，或在阅读器里点「💬 评论」），提交后进入相应列表：

4.3 研究笔记

系统的「笔记」用于沉淀研究过程：深度分析面板的「📌 保存笔记」会把该次分析存为一条笔记。笔记属于当前账号，可以在笔记列表中回看、修改、删除。

4.4 AI 智能助手（右下角浮窗）

页面右下角的圆形按钮打开一个对话助手，适合问关于系统本身的问题：怎么用、推荐书目、搜索报错怎么办（浮窗里备了这三个快捷问题）。

• 它有「清空对话」按钮；
• 它回答的是使用问题，不是古籍考据——要考据请用深度分析。

4.5 中医体质测试

平台附带的独立页面，按问卷给出中医体质的倾向性判断。它与古籍检索是两套内容，互不影响，可从页面上的入口进入。

4.6 侧栏的「🔄 重建索引」——使用者请勿点击

左侧分类目录里有这个按钮，它维护的是语义检索索引。

4.7 数据与隐私

检索词会被记录用于统计热搜榜（系统自带此功能）；评论与笔记属于当前账号。页面底部有《隐私政策》入口可查看全文。

第五章　常见问题与故障排查

5.1 三条判断原则

排查之前先记住三条，能省掉大半误判：

1. 「查不到」和「没查成」是两件事。 系统会明确区分：「没有一本包含这些字串」= 全库扫描后的结论；「候选书中未找到」= 只是候选没覆盖到；「语义未启用」= 某个通道不可用。看到后两种，说明还有别的办法可以试。
2. 先看提示行，再看结果。 结果区那几行小字（降级、候选范围、建议精查）比结果本身更能说明这次检索的可靠度。
3. 慢 ≠ 坏。 走大模型的路径按「1～2 分钟」预期；全库精查按「约 1 分钟」预期。

5.2 现象对照表

5.3 「搜不到」的六种情形，逐条对照

5.4 智能检索报错 / 一直转圈

这类现象几乎都是网络或后端服务问题，而不是你的操作问题。先做三件事：换一个按钮试（如「🔍 搜索」）、刷新页面、隔两分钟再试。若只有「✨ 智能检索」不可用而普通搜索正常，说明是检索服务本身的问题，请按 4.2 提交问题报告，并写明：查询内容 + 时间 + 界面提示原文。

5.5 深度分析很慢或没有结果

5.6 「译文」位置出现英文或 JSON 片段

这是 2026 年 9 月发现并已修复的缺陷：早期版本在模型回复超长被截断时，会把模型的原始输出当成译文显示。

现在遇到同类情况，系统会明确写「本次释义未完整生成，请重新分析一次」，不会再显示原始输出。因此：

• 看到「本次释义未完整生成」 → 就是新版本，重新点一次「开始分析」即可；
• 看到「本次释义未完成：模型连续多轮只调用工具……请重新分析一次」 → 同样重新点一次即可。这是一种偶发情况：模型在内部查资料时「查得忘了收口」，连着几轮没给结果，与你的操作无关，也不是没配 AI；系统已让它在最后一轮必须给结果，仍偶发时重试即可。
• 看到「需配置 AI 大模型获取完整白话翻译」 → 这才是真的没配 AI （或配置失效）。请把这句话连同截图报给管理方，不是重试能解决的。
• 看到英文或 {"word":… → 是旧版本或浏览器缓存的旧页面，按 5.7 强制刷新后再看；仍是如此请报修。

5.7 界面没更新（还是旧样子）

浏览器会缓存页面的脚本与样式文件。若管理方刚发过版，而你还看到旧界面：

1. 按 Ctrl+F5（或 Ctrl+Shift+R）强制刷新页面；
2. 仍不行则清一次浏览器缓存，或换无痕窗口打开；
3. 若只是「少了新按钮」，多半就是这个原因。

5.8 什么时候该找管理方

• 「全库精查」返回「未能执行」——说明后台扫描没能跑起来；
• 提示「语义未启用」持续存在；
• 深度分析连续两次失败；
• 任何结果内容明显不对的情况（配错的书、跳不到原文）；
• 报修时带上：查询内容、时间、界面提示原文、操作步骤。

— 文档结束 —