首页/知识库/ 操作指南
水牛学社 · Yudo 知识库

用一本文献库,
把问题问到底

这里是一份写给使用者的说明:怎么注册登录、怎么跟 Yudo 对话、怎么上传和管理文献、 怎么看懂检索结果,以及周报、服务器这些课题组工具怎么用。

面向 全体注册成员 更新于 2026-11-01 阅读约 10 分钟
01

快速开始

三个动作开始使用:拿到邀请 → 登录 → 提问。

STEP 1 拿到邀请

注册采用邀请制:开发者先把你的邮箱加入白名单,再把邀请链接发给你。没有邀请链接说明还没进白名单。

了解邀请注册 →
STEP 2 登录

用用户名 + 密码登录(不是邮箱)。忘记密码不用慌,找开发者要一条一次性重置链接。

忘记密码怎么办 →
STEP 3 开始提问

进入知识库,在底部输入框直接用中文提问。Yudo 会先查文献,再结合原文回答并给出处。

看看怎么问 →

第一次使用,建议按顺序读「账号与登录」和「聊天问答」两节,大约 5 分钟。其他章节可以遇到问题时再查。

常用的五个入口

入口在哪里用来做什么
知识库官网首页「进入知识库」按钮;或直接访问 /chat跟 Yudo 对话、上传和阅读文献
周报填报官网首页「周报填报」按钮每周提交个人 / 项目周报
服务器状态官网首页「服务器状态」按钮查看组内服务器占用、申请使用
网络知识官网首页「网络知识」按钮查看 Yudo 联网整理的外部资料
操作指南知识库右上角「书本」图标,或 /docs就是你正在看的这一页
02

账号与登录

邀请制注册;账号按角色分配权限。

注册:邀请制

  1. 请联系开发者,把你的邮箱加入注册白名单,并生成一条邀请链接(形如 /login.html#invite=…,默认 3 天内有效)。
  2. 打开邀请链接,页面会自动切换到「申请注册」;邮箱必须与白名单登记的一致。
  3. 设置用户名(2–16 位,中文或英文字母开头,可含数字、下划线)和密码(至少 8 位,且同时包含大写字母、小写字母和数字)。
  4. 回答一道简单的算术验证码,提交后即注册成功并自动登录。

注册不对外开放。没有邀请链接、或提示「邮箱不在白名单」,说明还没有被登记,请直接找管理员或开发者。

登录与退出

  • 登录:输入用户名和密码。用户名不是邮箱地址;忘了用户名可以问开发者。
  • 退出:知识库右上角的「退出登录」图标;公共电脑用完请务必退出。
  • 登录状态:平时会保持登录;如果长时间未使用或安全策略要求,会提示重新登录,属正常现象。
  • 输错密码:连续多次输错可能被临时锁定 15 分钟(需要来自多个不同网络的失败才会触发),稍等再试即可。
  • 登录设备:知识库「设置 → 登录设备」可以看到所有已登录的设备(浏览器 · 系统、IP、登录时间),并可以把其他设备一键「下线」。

忘记密码

① 发起申请

在登录页点「忘记密码?」,按提示联系开发者。

② 领取链接

开发者核实身份后,生成一条一次性重置链接私发给你。

③ 设置新密码

打开链接,按页面提示设置新密码,然后用新密码登录。

重置链接 60 分钟内有效、只能用一次,且只显示给管理员一次。设置成功后,这个账号在所有设备上的登录都会下线,需要重新登录。链接过期就再联系开发者要一条新的(重新生成会让旧链接立即失效)。

修改密码

不需要找管理员:知识库右上角「设置」→「修改密码」→ 输入当前密码和新密码即可。修改成功后所有设备(包括当前这台)都需要重新登录。

角色与权限

系统里有四种角色,由开发者分配。按钮看不到通常是权限不同,不是页面坏了。

角色可以做什么
普通成员
user
聊天检索、上传文献、编辑标签、翻译文献、提交反馈、维护自己的团队名片、提交周报、查看并申请服务器、联网检索
宣传委员
publicity
普通成员的全部能力,另可编辑官网页面内容、管理团队名片
管理员
admin
普通成员的全部能力,另可查看全部周报、管理周报项目、增删改服务器、删除网络知识条目(但不能删除文献或重建索引)
开发者
developer
全部权限,另可删除文献 / 重建索引、处理反馈、修改角色、管理注册白名单、重置他人密码、调整全局检索设置、查看开发者统计
03

聊天问答

像跟师兄讨论一样提问,Yudo 会先查文献再回答。

界面速览

区域内容
左侧栏·四个标签文献(文件列表、上传、标签、空间)、统计(库规模与类型分布)、检索(按文件名快速筛选)、对话(历史会话、新建对话)
顶部按钮返回首页、设置、角色管理(仅开发者)、向量空间、操作文档、导出对话、退出登录
中间消息区Yudo 的检索过程、工具调用、回答;回答里的文献出处可以点开核对
底部输入区输入框(Enter 发送、Shift+Enter 换行)、压缩对话按钮、Token 用量环、发送按钮
右侧悬浮条长对话时快速跳转到某个提问

怎么问效果更好

说清对象和目标

把「它」换成具体文献或概念。例如「对比《…》和《…》两篇关于气体夹带的结论差异」。

给范围

不确定查哪里时直接说「只看组内文献」「只看组外」「只看代码」。不说就由 Yudo 自动判断。

一步步追问

先问结论,再让它「把方法展开讲」「给出原文段落」。追问比一次写超长问题更准。

允许它说「没找到」

库里没有的内容,它应该直说而不是编造。遇到可疑出处,点开原文核对最稳妥。

可以这样问:

调压室水锤计算的关键参数有哪些? 帮我总结这篇论文的研究方法 这段 Python 代码里水锤方程怎么实现的? 帮我查一下最近关于管道瞬变流的公开资料

Yudo 会做什么

检索知识库

跨组内文献、组外文献、代码、网络资料查找相关片段,按文件给出出处。

精读全文

需要细节时会读取整篇文献,再摘出相关段落作答。

浏览目录

先看知识库里都有哪些文件,再决定读哪一篇。

联网检索

管理员开启时,可以查外部公开网页,并在回答中标注来源链接。

记住你的偏好

比如「我主要研究管道瞬变流」,它可以把这类偏好记进你的记忆笔记,后续回答更贴合。

整理网络资料

把有价值的网页整理成「网络知识」条目,保留来源链接,最多 2000 字。

回答默认以知识库文献为主要依据,联网资料会明确标注。遇到没有依据的问题,Yudo 会说明「知识库中没有找到」,而不是编一个出处。

对话与历史

  • 新建对话:左侧栏「对话」→「+ 新建对话」。不同主题分开聊,回答更聚焦。
  • 历史会话:会自动保存,在「对话」标签里点开即可继续;也可以删除不要的会话。
  • 导出对话:顶部「下载」图标 → 当前会话导出为 Markdown 文件,方便整理和分享。
  • 压缩对话:输入框左侧的压缩按钮,把较早的消息压缩成摘要、节省上下文;底部 Token 环显示当前会话的用量。
  • 独立性:对话、记忆、历史都按账号隔离,别人看不到你的聊天记录。

设置面板

设置项说明谁能改
LLM 模型deepseek-v4-flash 响应快,适合日常问答;deepseek-v4-pro 更细致,适合长文分析全局参数,开发者保存后全站生效
携带上下文条数每轮对话带上多少条历史消息全局参数,同上
检索篇数 / 相似度阈值一次检索最多返回几篇、低于多少相关度的片段被过滤全局参数,同上
我的头像 / Yudo 头像聊天里显示的头像,可自己上传图片仅自己
修改密码 / 登录设备自助改密;查看并下线其他设备仅自己
重建索引重新解析全部文献并重建检索索引(耗时数分钟)仅开发者
反馈 / 更新日志 / 知识库状态提交建议与问题、查看版本更新、查看库规模所有人可用

「模型 / 上下文条数 / 检索篇数 / 相似度阈值」是全站共用的检索参数,成员看到的是当前生效值;在面板里改动不会生效(保存权限只对开发者开放)。如需调整,请把理由告诉开发者统一修改,避免影响其他人的检索效果。

04

文献管理

上传 → 解析 → 可检索,通常一条龙自动完成。

上传文献

  1. 左侧栏切到「文献」标签,点右上角「+ 上传」。
  2. 选择文件(支持一次多选),并选择这篇文献属于组内还是组外。
  3. 上传后系统自动解析、切分并建立检索索引。页面会显示处理进度,完成后立刻能搜到。
类别支持的格式
文档PDFDOCXDOCTXTMD
代码PYJSTSJAVACCPPHHTMLHTMCSS
文本 / 配置JSONSHBASHYMLYAML
  • 单个文件不超过 100MB;同名文件会被自动跳过,不会覆盖已有文献。
  • 代码类文件(含 HTML / CSS)自动归入代码空间;JSON / SH / YAML 等文本文件按文献空间处理,可选择组内或组外。

扫描版 / 图片型 PDF 也能用。系统会自动识别页面里的文字和公式(OCR),识别结果同样可以被检索;因为要逐页识别,处理时间会明显长一些,请等提示完成后再提问。

四个文献空间

空间放什么
组内文献课题组成员产出的论文、学位论文、项目报告等
组外文献收集来的期刊论文、标准、技术文档等外部资料
代码源码文件,上传后自动归入,不能改成文献空间
网络资料Yudo 联网时整理入库的网页条目(见「网络知识空间」)
  • 上传时选择组内 / 组外;已有文献可以在文件列表里点空间徽标随时切换(只改归类,不会重新解析)。
  • 提问时会自动判断该查哪些空间;也可以明确说「只看组内」「只看组外」「只看代码」。

标签与筛选

给文献加标签(例如「瞬变流」「综述」「数值方法」),之后可以用文件列表上方的类型下拉框 + 标签筛选快速定位。标签由全体成员共同维护。

打开与阅读

在文件列表点文件名即可打开阅读器(需要登录):

  • PDF:前后翻页、缩放、页码跳转;左侧目录卡片可展开定位章节。
  • 公式与代码:数学公式正常渲染;代码文件自动语法高亮。
  • 翻译:顶部有「选中翻译」(开启后选中英文句子即出译文)、「全文翻译」「对照视图」,还可以下载译文。所有登录成员都能用;代码文件不显示翻译按钮。
  • 下载:右上角下载按钮保存原始文件。

删除与重建索引

删除文献和重建索引只有开发者可以操作。删除会同时移除该文件的检索索引;重建索引会把库里所有文献重新解析一遍(扫描件会重新 OCR),通常需要几分钟,期间请勿重复点击。

06

网络知识空间

Yudo 联网查到的外部资料,会整理成可追溯的条目。

在聊天里让 Yudo 联网查资料时,它可以把有价值的内容整理成网络知识条目:标题、来源链接、正文摘要、写入人和时间都有记录,独立于文献与代码空间,也不占用文献数量统计。目前没有手动新建入口,条目只能由 Yudo 在联网检索时写入。

查看与使用

  • 入口:官网首页「网络知识」按钮,或直接访问 /network-kb(需登录)。
  • 每条显示来源域名、原始 URL、写入时间与字数,点「展开正文」查看全文。
  • 检索时网络条目会作为「网络补充」参与回答,和文献一样带来源。
  • 单条正文最多约 2000 字;同一个链接重复保存会自动去重。

使用限制

项目限制
单条正文≤ 2000 字(超出会被截断)
每人每天入库默认 20 条
每人每天联网检索默认 50 次
删除条目仅管理员、开发者;删除时对应索引一并移除

网络资料来自公开网页,可靠程度由作者和站点决定。引用前请点开原始链接核对,重要结论不要只依据网络条目。

07

周报填报

每周一次,个人周报和项目周报分开填。

入口与规则

  • 入口:官网首页「周报填报」→ /weekly(需登录)。
  • 按自然周(周一 ~ 周日)归档,提交后自动归到本周。
  • 同一周可以修改后重新提交,以最后一次为准;管理员看到的是最新版本。
  • 周报仅管理员、开发者可见,用于课题组周度进度同步。

个人周报

  1. 填写实名信息(必填,首次填写后自动记住,之后可修改)。
  2. 周报类型选「个人周报」。
  3. 填写本周工作进展(≤5000 字)、下周工作计划(≤5000 字)、存在问题 / 需要协助(选填,≤3000 字)。
  4. 点「提交周报」。每人每周一份。

项目周报

周报类型切到「项目周报」→ 选择项目(下拉框)→ 填写内容并提交。同一周可以对多个项目分别提交,每个项目每周一份;已提交的项目周报会列在页面上,可点开修改后重新提交。

查看与管理(管理员 / 开发者)

  • 入口:首页「周报查看」→ /weekly-admin。
  • 个人周报:按同一份人员名单展示,用实名标识,未提交 / 已提交一目了然。
  • 项目周报:按项目分组展示各成员的提交。
  • 项目管理:新增项目、改名、停用 / 启用。已有历史周报的项目不支持删除,只能停用,保证历史记录不丢失。
08

服务器状态

看清哪台机器空闲,用完记得提前结束。

看状态与申请

  • 入口:官网首页「服务器状态」→ /servers(需登录)。
  • 灰色显示器 = 空闲,可以申请;亮屏 = 使用中,会显示占用人和剩余时间。
  • 点空闲机器的「申请使用」,填写申请人、用途、预计结束时间后提交。
  • 开始时间就是提交那一刻,提交成功后该机器立刻变为「使用中」。

同一台服务器同一时间段只能有一份有效申请。时间冲突会被拒绝——申请前先看下方「使用记录」比较稳妥。单次申请最长 30 天,时间统一按北京时间显示。

结束与记录

  • 提前结束:用完了在机器卡片上点「提前结束」,服务器会立刻恢复空闲;管理员 / 开发者也可以「强制结束」他人的占用。
  • 自动释放:忘记结束也没关系,到了预计结束时间会自动恢复空闲。
  • 使用记录:所有登录用户都能看到,页面显示最近 20 条并标注总条数,记录区分「到点结束」和「提前结束」。
  • 管理服务器:管理员 / 开发者可新增、改名、删备注、删除服务器;删除后历史使用记录仍保留。
09

站点页面导览

一次看清每个页面在哪、谁能用。

页面地址说明谁能用
官网首页/课题组介绍、研究方向、代表成果,以及周报 / 服务器 / 网络知识入口所有人
团队/team成员名片;登录后可编辑「我的名片」所有人
成果/publications论文与成果列表所有人
动态/news课题组新闻与通知所有人
更新日志/changelog知识库的版本更新记录所有人
知识库/chat与 Yudo 对话、管理文献登录用户
操作指南/docs本页所有人
知识星图/vectors四个空间的语义向量可视化登录用户
网络知识/network-kb联网整理的外部资料登录用户
周报填报/weekly个人 / 项目周报提交登录用户
周报查看/weekly-admin查看全组周报、管理项目管理员 / 开发者
服务器状态/servers查看占用、申请使用、管理服务器登录用户(管理仅管理员 / 开发者)
角色管理/roles账号列表、修改角色、生成重置密码链接开发者
注册白名单/whitelist登记 / 撤销可注册邮箱、生成邀请链接开发者
开发者统计/stats调用量、Token 用量等运行数据开发者

官网页面的页脚有统一导航;登录后从首页可以一键进入知识库和课题组工具。

10

常见问题

遇到问题先在这里翻一翻。

忘记密码了怎么办?

在登录页点「忘记密码?」,联系开发者核实身份后生成一条一次性重置链接(60 分钟有效、只能用一次)。打开链接设置新密码即可,设置成功后所有设备需要重新登录。

为什么 Yudo 说「知识库里没有找到」?

常见原因有四个:① 关键词太宽泛或写法与文献不同,换同义词再问;② 这篇文献还没上传,或还在解析中;③ 问的内容属于另一类空间,试试说「只看组外文献」「只看代码」;④ 扫描版 PDF 的识别文本质量有限,可以换成文本版 PDF 再上传。

上传后多久能搜到?

解析完成即可检索。普通 PDF / 文档通常几秒到几十秒,扫描版 PDF 或大文件可能需要几分钟,页面会有处理提示,等提示完成再提问即可。

支持哪些文件格式?

共 20 种扩展名:PDF、DOCX、DOC、TXT、MD,以及常见代码文件(PY / JS / TS / JAVA / C / CPP / H / HTML / HTM / CSS)和文本文件(JSON / SH / BASH / YML / YAML)。单个文件不超过 100MB;图片型 PDF 会自动走 OCR。

邀请链接过期了、或提示邮箱不在白名单?

邀请链接默认 3 天有效,过期后请让开发者重新生成一条;「邮箱不在白名单」说明登记的邮箱和你要注册的邮箱不一致,或还没登记,请把正确的邮箱发给开发者。

上传了新文件,列表里却没有?

先看是否提示「文件已存在」——同名文件会被跳过、不会覆盖,需要改名后再传。另外大文件或扫描版 PDF 还在解析中时不会立即出现在可检索列表里,稍等刷新即可。

回答里的公式、加粗显示成原始符号了?

多半是浏览器缓存了旧版页面资源。先强制刷新(Windows:Ctrl+F5;Mac:Cmd+Shift+R),或换一个浏览器再试。仍然异常就截图反馈。

为什么我看不到「角色管理」「重建索引」这些按钮?

这些是开发者专属功能,按钮会对没有权限的账号隐藏,属于正常现象。需要时请联系开发者。

能和别人共用账号吗?

不建议。账号的对话、记忆和历史是独立的,共用会互相覆盖;也会让「谁上传了什么、谁提交了周报」变得不可追溯。每个人用自己的账号即可。

账号在别的设备被下线了?

修改 / 重置密码会撤销该账号的全部登录。另外在「设置 → 登录设备」里可以把其他设备手动下线。怀疑账号异常时,先改密码。

多人同时使用会互相影响吗?

对话、记忆、历史按账号隔离,互不可见;文献库是共享的,任何人上传的文献大家都检索得到。服务器申请则按机器和时段互斥。

能手动添加网络知识条目吗?

目前不能。网络知识条目只由 Yudo 在联网检索时自动整理写入,成员可以在 /network-kb 查看;管理员和开发者可以删除不适用的条目。

周报填错了还能改吗?

可以。本周内重新提交会覆盖上一版,管理员看到的始终是最新一次提交。

申请服务器提示时间冲突?

同一台机器同一时段只能有一份有效申请。先看页面下方的「使用记录」确认占用情况,再换一台机器或等对方结束(或到点自动释放)。

想提建议或者报告故障?

知识库右上角「设置」→「反馈」,写下问题和复现步骤;也可以直接找开发者。涉及账号、权限的问题建议直接联系开发者处理。