快速开始
三个动作开始使用:拿到邀请 → 登录 → 提问。
常用的五个入口
| 入口 | 在哪里 | 用来做什么 |
|---|---|---|
| 知识库 | 官网首页「进入知识库」按钮;或直接访问 /chat | 跟 Yudo 对话、上传和阅读文献 |
| 周报填报 | 官网首页「周报填报」按钮 | 每周提交个人 / 项目周报 |
| 服务器状态 | 官网首页「服务器状态」按钮 | 查看组内服务器占用、申请使用 |
| 网络知识 | 官网首页「网络知识」按钮 | 查看 Yudo 联网整理的外部资料 |
| 操作指南 | 知识库右上角「书本」图标,或 /docs | 就是你正在看的这一页 |
账号与登录
邀请制注册;账号按角色分配权限。
注册:邀请制
- 请联系开发者,把你的邮箱加入注册白名单,并生成一条邀请链接(形如
/login.html#invite=…,默认 3 天内有效)。 - 打开邀请链接,页面会自动切换到「申请注册」;邮箱必须与白名单登记的一致。
- 设置用户名(2–16 位,中文或英文字母开头,可含数字、下划线)和密码(至少 8 位,且同时包含大写字母、小写字母和数字)。
- 回答一道简单的算术验证码,提交后即注册成功并自动登录。
注册不对外开放。没有邀请链接、或提示「邮箱不在白名单」,说明还没有被登记,请直接找管理员或开发者。
登录与退出
- 登录:输入用户名和密码。用户名不是邮箱地址;忘了用户名可以问开发者。
- 退出:知识库右上角的「退出登录」图标;公共电脑用完请务必退出。
- 登录状态:平时会保持登录;如果长时间未使用或安全策略要求,会提示重新登录,属正常现象。
- 输错密码:连续多次输错可能被临时锁定 15 分钟(需要来自多个不同网络的失败才会触发),稍等再试即可。
- 登录设备:知识库「设置 → 登录设备」可以看到所有已登录的设备(浏览器 · 系统、IP、登录时间),并可以把其他设备一键「下线」。
忘记密码
在登录页点「忘记密码?」,按提示联系开发者。
开发者核实身份后,生成一条一次性重置链接私发给你。
打开链接,按页面提示设置新密码,然后用新密码登录。
重置链接 60 分钟内有效、只能用一次,且只显示给管理员一次。设置成功后,这个账号在所有设备上的登录都会下线,需要重新登录。链接过期就再联系开发者要一条新的(重新生成会让旧链接立即失效)。
修改密码
不需要找管理员:知识库右上角「设置」→「修改密码」→ 输入当前密码和新密码即可。修改成功后所有设备(包括当前这台)都需要重新登录。
角色与权限
系统里有四种角色,由开发者分配。按钮看不到通常是权限不同,不是页面坏了。
| 角色 | 可以做什么 |
|---|---|
| 普通成员 user | 聊天检索、上传文献、编辑标签、翻译文献、提交反馈、维护自己的团队名片、提交周报、查看并申请服务器、联网检索 |
| 宣传委员 publicity | 普通成员的全部能力,另可编辑官网页面内容、管理团队名片 |
| 管理员 admin | 普通成员的全部能力,另可查看全部周报、管理周报项目、增删改服务器、删除网络知识条目(但不能删除文献或重建索引) |
| 开发者 developer | 全部权限,另可删除文献 / 重建索引、处理反馈、修改角色、管理注册白名单、重置他人密码、调整全局检索设置、查看开发者统计 |
聊天问答
像跟师兄讨论一样提问,Yudo 会先查文献再回答。
界面速览
| 区域 | 内容 |
|---|---|
| 左侧栏·四个标签 | 文献(文件列表、上传、标签、空间)、统计(库规模与类型分布)、检索(按文件名快速筛选)、对话(历史会话、新建对话) |
| 顶部按钮 | 返回首页、设置、角色管理(仅开发者)、向量空间、操作文档、导出对话、退出登录 |
| 中间消息区 | Yudo 的检索过程、工具调用、回答;回答里的文献出处可以点开核对 |
| 底部输入区 | 输入框(Enter 发送、Shift+Enter 换行)、压缩对话按钮、Token 用量环、发送按钮 |
| 右侧悬浮条 | 长对话时快速跳转到某个提问 |
怎么问效果更好
把「它」换成具体文献或概念。例如「对比《…》和《…》两篇关于气体夹带的结论差异」。
不确定查哪里时直接说「只看组内文献」「只看组外」「只看代码」。不说就由 Yudo 自动判断。
先问结论,再让它「把方法展开讲」「给出原文段落」。追问比一次写超长问题更准。
库里没有的内容,它应该直说而不是编造。遇到可疑出处,点开原文核对最稳妥。
可以这样问:
Yudo 会做什么
跨组内文献、组外文献、代码、网络资料查找相关片段,按文件给出出处。
需要细节时会读取整篇文献,再摘出相关段落作答。
先看知识库里都有哪些文件,再决定读哪一篇。
管理员开启时,可以查外部公开网页,并在回答中标注来源链接。
比如「我主要研究管道瞬变流」,它可以把这类偏好记进你的记忆笔记,后续回答更贴合。
把有价值的网页整理成「网络知识」条目,保留来源链接,最多 2000 字。
回答默认以知识库文献为主要依据,联网资料会明确标注。遇到没有依据的问题,Yudo 会说明「知识库中没有找到」,而不是编一个出处。
对话与历史
- 新建对话:左侧栏「对话」→「+ 新建对话」。不同主题分开聊,回答更聚焦。
- 历史会话:会自动保存,在「对话」标签里点开即可继续;也可以删除不要的会话。
- 导出对话:顶部「下载」图标 → 当前会话导出为 Markdown 文件,方便整理和分享。
- 压缩对话:输入框左侧的压缩按钮,把较早的消息压缩成摘要、节省上下文;底部 Token 环显示当前会话的用量。
- 独立性:对话、记忆、历史都按账号隔离,别人看不到你的聊天记录。
设置面板
| 设置项 | 说明 | 谁能改 |
|---|---|---|
| LLM 模型 | deepseek-v4-flash 响应快,适合日常问答;deepseek-v4-pro 更细致,适合长文分析 | 全局参数,开发者保存后全站生效 |
| 携带上下文条数 | 每轮对话带上多少条历史消息 | 全局参数,同上 |
| 检索篇数 / 相似度阈值 | 一次检索最多返回几篇、低于多少相关度的片段被过滤 | 全局参数,同上 |
| 我的头像 / Yudo 头像 | 聊天里显示的头像,可自己上传图片 | 仅自己 |
| 修改密码 / 登录设备 | 自助改密;查看并下线其他设备 | 仅自己 |
| 重建索引 | 重新解析全部文献并重建检索索引(耗时数分钟) | 仅开发者 |
| 反馈 / 更新日志 / 知识库状态 | 提交建议与问题、查看版本更新、查看库规模 | 所有人可用 |
「模型 / 上下文条数 / 检索篇数 / 相似度阈值」是全站共用的检索参数,成员看到的是当前生效值;在面板里改动不会生效(保存权限只对开发者开放)。如需调整,请把理由告诉开发者统一修改,避免影响其他人的检索效果。
文献管理
上传 → 解析 → 可检索,通常一条龙自动完成。
上传文献
- 左侧栏切到「文献」标签,点右上角「+ 上传」。
- 选择文件(支持一次多选),并选择这篇文献属于组内还是组外。
- 上传后系统自动解析、切分并建立检索索引。页面会显示处理进度,完成后立刻能搜到。
| 类别 | 支持的格式 |
|---|---|
| 文档 | PDFDOCXDOCTXTMD |
| 代码 | PYJSTSJAVACCPPHHTMLHTMCSS |
| 文本 / 配置 | JSONSHBASHYMLYAML |
- 单个文件不超过 100MB;同名文件会被自动跳过,不会覆盖已有文献。
- 代码类文件(含 HTML / CSS)自动归入代码空间;JSON / SH / YAML 等文本文件按文献空间处理,可选择组内或组外。
扫描版 / 图片型 PDF 也能用。系统会自动识别页面里的文字和公式(OCR),识别结果同样可以被检索;因为要逐页识别,处理时间会明显长一些,请等提示完成后再提问。
四个文献空间
| 空间 | 放什么 |
|---|---|
| 组内文献 | 课题组成员产出的论文、学位论文、项目报告等 |
| 组外文献 | 收集来的期刊论文、标准、技术文档等外部资料 |
| 代码 | 源码文件,上传后自动归入,不能改成文献空间 |
| 网络资料 | Yudo 联网时整理入库的网页条目(见「网络知识空间」) |
- 上传时选择组内 / 组外;已有文献可以在文件列表里点空间徽标随时切换(只改归类,不会重新解析)。
- 提问时会自动判断该查哪些空间;也可以明确说「只看组内」「只看组外」「只看代码」。
标签与筛选
给文献加标签(例如「瞬变流」「综述」「数值方法」),之后可以用文件列表上方的类型下拉框 + 标签筛选快速定位。标签由全体成员共同维护。
打开与阅读
在文件列表点文件名即可打开阅读器(需要登录):
- PDF:前后翻页、缩放、页码跳转;左侧目录卡片可展开定位章节。
- 公式与代码:数学公式正常渲染;代码文件自动语法高亮。
- 翻译:顶部有「选中翻译」(开启后选中英文句子即出译文)、「全文翻译」「对照视图」,还可以下载译文。所有登录成员都能用;代码文件不显示翻译按钮。
- 下载:右上角下载按钮保存原始文件。
删除与重建索引
删除文献和重建索引只有开发者可以操作。删除会同时移除该文件的检索索引;重建索引会把库里所有文献重新解析一遍(扫描件会重新 OCR),通常需要几分钟,期间请勿重复点击。
检索与向量空间
确认「库里有没有」和「哪些文献相近」的两种方式。
按文件名快速检索
左侧栏「检索」标签是按文件名的快速筛选:输入关键词(如「水锤」「CFD」)即可定位文件。它只查文件名,不查正文——要查正文内容请直接问 Yudo。
统计
左侧栏「统计」标签显示知识库规模:文献总数、按分类与扩展名的分布。网络知识条目单独统计,不占用文献数量。
知识星图(向量空间可视化)
点知识库顶部的「坐标轴」图标,在新标签页打开知识星图——把整座知识库摊开成一张语义地图。页面本身可以公开打开,但登录后才看得到数据。
- 四个空间:组内文献 / 代码 / 组外文献 / 网络资料,在顶部切换,每个空间单独投影。
- 一个光点 = 一个语义片段(约 200–1200 字的一小段内容),颜色代表所属文献。讨论内容相近的片段会聚在一起,形成一处处星团。
- 看文献分布:右侧「文献档案」按片段数列出全部文献,可输入关键词筛选。点一篇文献,它的片段会全部亮起并勾出分布范围,其余光点淡化。
- 看片段内容:鼠标悬停光点可预览摘要,点击后左下角固定显示该片段(显示前 100 字)。
- 缩放与平移:滚轮缩放、拖拽平移、双击空白处或点右下角按钮复位;点右上角「?」查看图例说明。
- 用途:提问前先摸清库里的文献结构——某个主题的文献是多还是少、哪些文献彼此接近,一目了然。
二维散点是把每段文献的「语义位置」压到平面上的近似投影,用来看聚集趋势,不代表精确距离;坐标轴上的「主成分 1 / 2」只是投影方向。四个空间的坐标各自独立,不能横向比较。
网络知识空间
Yudo 联网查到的外部资料,会整理成可追溯的条目。
在聊天里让 Yudo 联网查资料时,它可以把有价值的内容整理成网络知识条目:标题、来源链接、正文摘要、写入人和时间都有记录,独立于文献与代码空间,也不占用文献数量统计。目前没有手动新建入口,条目只能由 Yudo 在联网检索时写入。
查看与使用
- 入口:官网首页「网络知识」按钮,或直接访问
/network-kb(需登录)。 - 每条显示来源域名、原始 URL、写入时间与字数,点「展开正文」查看全文。
- 检索时网络条目会作为「网络补充」参与回答,和文献一样带来源。
- 单条正文最多约 2000 字;同一个链接重复保存会自动去重。
使用限制
| 项目 | 限制 |
|---|---|
| 单条正文 | ≤ 2000 字(超出会被截断) |
| 每人每天入库 | 默认 20 条 |
| 每人每天联网检索 | 默认 50 次 |
| 删除条目 | 仅管理员、开发者;删除时对应索引一并移除 |
网络资料来自公开网页,可靠程度由作者和站点决定。引用前请点开原始链接核对,重要结论不要只依据网络条目。
周报填报
每周一次,个人周报和项目周报分开填。
入口与规则
- 入口:官网首页「周报填报」→
/weekly(需登录)。 - 按自然周(周一 ~ 周日)归档,提交后自动归到本周。
- 同一周可以修改后重新提交,以最后一次为准;管理员看到的是最新版本。
- 周报仅管理员、开发者可见,用于课题组周度进度同步。
个人周报
- 填写实名信息(必填,首次填写后自动记住,之后可修改)。
- 周报类型选「个人周报」。
- 填写本周工作进展(≤5000 字)、下周工作计划(≤5000 字)、存在问题 / 需要协助(选填,≤3000 字)。
- 点「提交周报」。每人每周一份。
项目周报
周报类型切到「项目周报」→ 选择项目(下拉框)→ 填写内容并提交。同一周可以对多个项目分别提交,每个项目每周一份;已提交的项目周报会列在页面上,可点开修改后重新提交。
查看与管理(管理员 / 开发者)
- 入口:首页「周报查看」→
/weekly-admin。 - 个人周报:按同一份人员名单展示,用实名标识,未提交 / 已提交一目了然。
- 项目周报:按项目分组展示各成员的提交。
- 项目管理:新增项目、改名、停用 / 启用。已有历史周报的项目不支持删除,只能停用,保证历史记录不丢失。
服务器状态
看清哪台机器空闲,用完记得提前结束。
看状态与申请
- 入口:官网首页「服务器状态」→
/servers(需登录)。 - 灰色显示器 = 空闲,可以申请;亮屏 = 使用中,会显示占用人和剩余时间。
- 点空闲机器的「申请使用」,填写申请人、用途、预计结束时间后提交。
- 开始时间就是提交那一刻,提交成功后该机器立刻变为「使用中」。
同一台服务器同一时间段只能有一份有效申请。时间冲突会被拒绝——申请前先看下方「使用记录」比较稳妥。单次申请最长 30 天,时间统一按北京时间显示。
结束与记录
- 提前结束:用完了在机器卡片上点「提前结束」,服务器会立刻恢复空闲;管理员 / 开发者也可以「强制结束」他人的占用。
- 自动释放:忘记结束也没关系,到了预计结束时间会自动恢复空闲。
- 使用记录:所有登录用户都能看到,页面显示最近 20 条并标注总条数,记录区分「到点结束」和「提前结束」。
- 管理服务器:管理员 / 开发者可新增、改名、删备注、删除服务器;删除后历史使用记录仍保留。
站点页面导览
一次看清每个页面在哪、谁能用。
| 页面 | 地址 | 说明 | 谁能用 |
|---|---|---|---|
| 官网首页 | / | 课题组介绍、研究方向、代表成果,以及周报 / 服务器 / 网络知识入口 | 所有人 |
| 团队 | /team | 成员名片;登录后可编辑「我的名片」 | 所有人 |
| 成果 | /publications | 论文与成果列表 | 所有人 |
| 动态 | /news | 课题组新闻与通知 | 所有人 |
| 更新日志 | /changelog | 知识库的版本更新记录 | 所有人 |
| 知识库 | /chat | 与 Yudo 对话、管理文献 | 登录用户 |
| 操作指南 | /docs | 本页 | 所有人 |
| 知识星图 | /vectors | 四个空间的语义向量可视化 | 登录用户 |
| 网络知识 | /network-kb | 联网整理的外部资料 | 登录用户 |
| 周报填报 | /weekly | 个人 / 项目周报提交 | 登录用户 |
| 周报查看 | /weekly-admin | 查看全组周报、管理项目 | 管理员 / 开发者 |
| 服务器状态 | /servers | 查看占用、申请使用、管理服务器 | 登录用户(管理仅管理员 / 开发者) |
| 角色管理 | /roles | 账号列表、修改角色、生成重置密码链接 | 开发者 |
| 注册白名单 | /whitelist | 登记 / 撤销可注册邮箱、生成邀请链接 | 开发者 |
| 开发者统计 | /stats | 调用量、Token 用量等运行数据 | 开发者 |
官网页面的页脚有统一导航;登录后从首页可以一键进入知识库和课题组工具。
常见问题
遇到问题先在这里翻一翻。
忘记密码了怎么办?
在登录页点「忘记密码?」,联系开发者核实身份后生成一条一次性重置链接(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 查看;管理员和开发者可以删除不适用的条目。
周报填错了还能改吗?
可以。本周内重新提交会覆盖上一版,管理员看到的始终是最新一次提交。
申请服务器提示时间冲突?
同一台机器同一时段只能有一份有效申请。先看页面下方的「使用记录」确认占用情况,再换一台机器或等对方结束(或到点自动释放)。
想提建议或者报告故障?
知识库右上角「设置」→「反馈」,写下问题和复现步骤;也可以直接找开发者。涉及账号、权限的问题建议直接联系开发者处理。