使用指南

五分钟上手,玩转 Knownest

从安装到日常动线,这一页讲清楚 Knownest 怎么用;再从场景库里挑一个今天就用上。左侧菜单按章节导航。

五分钟上手

装好后第一次打开,Knownest 会自动弹出三步向导;跳过了也不要紧,随时照下面的顺序补齐即可。

1

选一个文件夹作为知识库仓库——里面现有的 Markdown 会被自动索引建树。笔记本体就是普通文件,任何编辑器都能打开,永远不会被锁住。

2

配置一个 AI Provider(建议但可选):OpenAI / DeepSeek / Anthropic / Ollama 或任意 OpenAI 兼容 API,填 Key 即用。不配置也能用——阅读、图谱、确定性挖空题等纯本地功能照常工作。

3

让小诺出你的第一道题:打开一篇文档,对它说「帮我出几道题」。题目进入题库,并按 SM-2 记忆曲线排好复习计划。

界面一分钟看懂

左

侧边栏——知识库与各功能页的入口(学习报告、题库、翻译……),可拖宽、可收起。

中

内容区——阅读、编辑、做题、看图谱都在这里。

右

小诺工作面——平时是右缘一条窄栏,点开是「小诺 / 知识体系 / 文件」三个 Tab;任何页面按 Ctrl+K 唤出命令面板,输入即导航。

还没配模型?先把 PDF 和 Markdown 拖进来随便看看——读文档、看图谱、划词朗读都不需要 AI。

先认识五个词

Knownest 的全部功能都围绕这五个概念展开,应用里的页面名与它们一一对应。

知识库仓库

一个普通文件夹 + Git。Knownest 负责索引与加工,文件永远是你的——用别的编辑器改完,回到 Knownest 会自动刷新。

知识体系树

小诺通读全库后自动分类挂载(落点由你确认),上千篇文档也能一层层展开浏览;树上的叶节点可一键 ⚡ 即时练习。

以题复习

出的题进入题库,SM-2 算法按记忆曲线排到期队列,作答即推进调度——记住靠系统,不靠运气。

sys-hub 系统仓

晨报、译文这类系统产物的家,与知识库分开管理;同步时各自独立,互不掺和。

能力包

即插件。学习闭环的每个环节——剪藏、翻译、出题、精听、晨报——都是独立可装卸的能力包,装不装、开不开由你决定。

一天的 Knownest

单个功能都不难,串成动线才是 Knownest 的完整打开方式。

1

早上:点托盘「今日晨报」(或学习报告页)看昨日战报与今日焦点。

2

白天:读文献、剪网页、记笔记;选中一段文字即译即读,值得留的一键剪藏进库。

3

巩固:题库页「今日复习」清偿到期题;中途有事直接走,挂起浮条全局常驻,回来原位续做。

4

碎片时间:手机把灵感投递到收件箱,回桌面时已自动起名、分类、挂上知识树。

5

睡前:学习报告看掌握度与趋势,错题回看、薄弱补练。

快捷键速查

功能默认键位
命令面板Ctrl+K
快呼面板(任何应用里呼出小诺)Ctrl+Shift+Alt+A
剪贴板抓取到快呼Ctrl+Shift+Alt+Q
全局语音提问Ctrl+Shift+Alt+V
应用外划词直翻Ctrl+Shift+Alt+S
选区动作浮层Ctrl+Shift+Alt+T

所有键位都可在「设置 → 快捷键」重绑;与其他应用冲突时自动降级备用键位,设置页可见实际生效键。

场景库:总有一个像你

八个真实场景,每个只用到两三个功能——挑一个今天就用上。

考前冲刺

课件 PDF 拖进仓库 → 对小诺说「按这份讲义出 20 道题」→ 填上考试日期进入考试冲刺模式 → 每天清偿到期题,错题按粗心/薄弱/生疏归因,精准补漏。

专题详解 →

啃论文与硬书

PDF 划词即译即读,关键段落剪藏进库;读完后到图谱里看它和旧知识长出了哪些连线,概念先修链告诉你还缺哪块地基。

专题详解 →

英语精听

从 GitHub / 古登堡 / 维基选一篇专业英语源(或直接粘贴),逐句听写、词级三色判分;错词一键成卡进 SM-2,还有 AI 考试四档陪练。

专题详解 →

手机随手记

「设置 → 收件箱」开启后手机扫码,灵感、课堂速记随手投递;回桌面时碎片已自动起名、分类、挂树,确认落点即可。

专题详解 →

题荒补给

某个专题题不够练?开启题源雷达:按薄弱知识点全网搜材料、接地出题;材料全部可溯源可删除,差评自动停采。

专题详解 →

知识分享

知识体系 Tab 导出知识包:勾选目录,题目自动随包,你的作答与进度不会带走;对方导入即得一套带题笔记,署名与 license 随包携带。

专题详解 →

双机与换机

新电脑装好 Knownest,恢复向导输入口令:快照(配置/题目/记忆)与 Git 仓库(文档)各归各位;仓库缺文件时还有一键就位修复。

专题详解 →

动口不动手

「小诺,今天学什么?」——薄弱缺口、到期量、连击进度一行答给你;「把这篇翻译成英文再出 5 道题」也只需一句话,写文件前一定先给你看 Diff。

想了解每个能力包的完整说明?去插件生态页 →

和小诺协作的五个姿势

1

随时唤出:应用内点右缘窄条;在别的应用里按 Ctrl+Shift+Alt+A 呼出快呼窗,问完自动收起。

2

看得见的上下文:输入框上方的芯片是随消息携带的上下文(当前文档、目标目录……),可预览、可摘除——发什么你说了算。

3

写必过审:小诺改你的笔记前先出逐行 Diff,逐文件接受或跳过;危险命令有拦截,改动可一键撤销。

4

技能批量干:输入 / 唤出技能墙,把「项目分析」「出题」这类多步工作流一键触发;技能放进 ~/.knomi/skills(全局)或 .knomi/skills(项目)即可被发现。

5

语音交互:设置 → 语音 里开启唤醒词「小诺」即可直接开口提问;识别全程本机推理,声音数据不出网(默认关闭,开启后才会监听)。

小诺不内置任何模型:模型由你在 Provider 里自带(BYOK),密钥只存本机。想看完整能力清单?去小诺页 →

数据与安全

本地优先不是口号,是可以亲自验证的六件事:

  • 数据全在本机:SQLite 建索引,笔记就是 Git 仓库里的普通文件;无账号、无云端、无锁定。
  • 备份:「设置 → 备份与恢复」一键导出全量快照,配置、题目、记忆都在里面。
  • 云漫游(可选):配置 S3 兼容对象存储后快照自动上传,强制口令加密,口令不落盘不上云。
  • 换机:恢复向导两步走——口令拉回快照,仓库自动 clone 就位。
  • 删错可救:删除先进回收站,随时恢复。
  • 授权可见:「设置 → 数据与授权」列出每一次数据范围授权的用途、范围与时间。

同步交给 Git 远端:推到 GitHub 私有仓或自建服务,节奏和去处都由你掌握。

外部 Agent 接入(MCP)

让 Claude、Cursor 等外部 AI 助手读取你的知识库——数据不出本机,能力出本机。Knownest 在本机开放一个 MCP 端点(http://127.0.0.1:27080/mcp,仅监听 127.0.0.1),外部 agent 经标准 MCP 协议接入。

1

在 AI 助手里配置 MCP 地址

以 Cursor 为例:MCP 设置里添加服务器,地址填 http://127.0.0.1:27080/mcp。Claude Desktop 经 mcp-remote 桥接同一地址。配置一次即可。

2

在 Knownest 里确认(你拍板的一步)

客户端发起连接时,Knownest 会弹出下面这张确认卡——显示客户端名、范围与有效期。点「允许」才签发;点「拒绝」或 10 分钟不理会即失效。默认策略下,本机助手可免确认只读(可在设置页关闭)。

外部 Agent 接入请求
客户端 Cursor 请求通过 MCP 端点读取你的知识库。
将授予:只读访问(仓库清单/文档内容与清单/题目,不含你的作答流水与复习进度);有效期 8 小时;数据不出本机(端点仅监听 127.0.0.1)。
允许本次接入拒绝
▲ 这张卡长这样——它会在客户端请求接入时从 Knownest 弹出,等你拍板
3

助手开始读取(只读,8 小时)

允许后客户端获得 8 小时只读会话,可调用七个工具:列出仓库、列出文档、读文档全文、检索文档、读题目,以及会话读取(列出会话、读会话内容——仅「允许」签发的显式授权会话可用,本机免确认的匿名只读不含)。在对话里直接问「帮我找知识库里关于 XX 的笔记」就能用上。

边界(可以亲自验证):只读——外部 agent 不能写你的任何数据;你的作答流水与复习进度不在可读范围;每次签发与拒绝都落审计(审计事件 purpose=agent-access)。管理入口:Knownest → 设置 → 数据与授权——查看/撤销会话、开关「本机免确认读取」都在那里;重启应用即清空全部会话(会话只在内存)。

调用示例(curl):先 POST /mcp/auth 发起接入 → 界面允许 → 轮询拿到 token → 带 Authorization: Bearer <token> 调 tools/call。契约全文见仓库 docs/OPEN-CAPABILITY-CLI-ADR.md §8。

常见问题

不配 AI 能用吗?能。阅读、图谱、收件箱、确定性挖空题、精听等纯本地功能全部可用;AI 深度出题、碎片加工、高质量翻译需要配置 Provider。
提示「未检测到 git」?仓库同步、GitHub 导入与插件在线安装依赖系统 git 命令行。安装 Git 后重启应用即可,其余功能不受影响。
手机怎么投递到收件箱?「设置 → 收件箱」开启服务后,手机浏览器扫描二维码(需与电脑同一局域网),凭 token 即可投递文字。
换电脑怎么迁移?「备份与恢复」导出快照带走,新机恢复向导导入;文档仓库推 Git 远端后在新机 clone。两步做完数据就齐了。
想换外观或键位?「设置 → 主题风格」内置四套外观即点即换;「设置 → 快捷键」里全部键位可重绑。
第三方插件安全吗?插件跑在独立进程沙箱里;权限「声明 ≠ 授予」,激活时逐项确认;更新失败自动回滚,安装后还有 AI 安全评估标签。官方能力包源码全部开放。

准备好了?

装好 Knownest,回到第一节的五分钟上手;遇到问题先查上面的常见问题,解决不了欢迎来提 Issue。