KB · 资料查询 使用范围

已装好本机环境,从一次查询开始

记得几个字,就能找到资料出处。

用一个本机命令入口查询文件、全文索引和已有结构化资料台账。

给已经在本机整理资料的人:用一个命令入口,查到文件、命中段落和已有台账记录。

安装后占用 0.5 MB · 本人自用,不提供下载与源码。需要已配置的 KB 工作目录、可读的本机索引及 Folio 命令; 项目声明 Python 3.12 或更新版本,最低 macOS 版本未声明。终端查询不需要辅助功能或屏幕录制权限, 不需要登录 KB 账号;目标目录仍须当前用户有权读取。

本人自用,不提供下载与源码。

真实产品界面
真实 KB 命令输出的离屏渲染;关键词命中两份虚构资料,显示文件路径与行号。
真实 KB 命令输出的离屏渲染;关键词命中两份虚构资料,显示文件路径与行号。

资源占用

资源占用与响应速度。

不适用

安装包

此产品不提供公开下载包。

0.5 MB

安装后占用

应用本体在磁盘上的大小。

22 MB

任务峰值内存/RSS

任务运行时峰值 RSS;任务结束即退出,不是常驻空闲内存。

95.3 %

任务 CPU

任务 CPU 时间 0.041 秒;墙钟 0.043 秒。不是空闲占用。

43 ms

速度

一次全文检索(热)(中位数)。

v0.1.0 · Mac18,5 / Apple M6 / macOS 27.0 · 测量日期 2026-10-09。数字来自所列版本与设备的测量记录;当前版本与测量范围以本页说明为准。

用它完成什么

日常会用到的功能。

01

先看到命中在哪里

search 返回文件路径和命中行号,先判断这份资料是不是你要找的,再回到源文档阅读上下文。

02

把范围缩到相关资料

加 --path 按文件路径筛选,或用 --ws、--repo 限定已有索引中的工作区与资料组,减少无关结果。

03

只要文件清单时更直接

files 列出匹配文件,不展开命中正文;适合先找出处,再逐份核对材料。

04

既有台账沿原字段查询

求职申请、软著等已有台账保留各自字段与查询入口;例如 apply list、sc list,不必把原文迁到一套新资料库。

第一次使用

从这里,一步一步开始。

  1. 01

    在已配置的工作目录查看用法

    打开终端,在已有 KB 工作目录运行 python3 bin/kb.py --help。 帮助里能看到 search、files 和 index-stats,就选对了入口。 本页的 python3 bin/kb.py 是完整命令写法,不假定系统已安装名为 kb 的快捷命令。 截图中的 Demo/ 路径与资料都是虚构示例,实际使用时换成自己允许查询的内容。

  2. 02

    先输入你记得的关键词

    运行 python3 bin/kb.py search 生态流量。 结果中的 文件路径:行号 表示命中位置,后面的文字是命中行。 演示里能看到 Demo/river/flow.md 与 Demo/meeting/notes.md 两份资料; 实际结果以本机已建立的索引为准。先读几条命中,不要仅凭标题下结论。

  3. 03

    用目录筛掉不相关的结果

    运行 python3 bin/kb.py search 生态流量 --path Demo/river/。 --path 的后面是路径片段;演示里结果缩到 Demo/river/flow.md。 自己使用时换成目标目录的路径片段。需要按已有工作区筛选时可加 --ws Work; 改筛选条件只改变这次查询,不会移动源文件。

  4. 04

    只列文件,再核对原文

    运行 python3 bin/kb.py files 生态流量 --path Demo/river/,得到文件清单。 用自己平常的阅读工具打开结果中的源文件,再对照上一条 search 返回的行号与上下文。 当路径属于预期目录、原文确实包含所找内容,才算找到了可用出处; 索引片段不是完整原文,文件改动或移动后还需要核对是否仍在原处。

  5. 05

    没有结果时,先检查覆盖

    运行 python3 bin/kb.py index-stats,查看已索引篇数和按工作区的分布。 演示的 docs=3 只说明这份虚构索引有三篇资料。 查询没有输出时,先试更短的关键词或移除 --path,再确认目标资料是否已被索引。 如出现“查询入口不可用”或“找不到 folio 命令”,先核对已有 KB 与 Folio 环境; 如索引不可读,先核对索引位置与读取权限,不要重建或覆盖资料库来碰运气。

跟着界面看一遍

看得见的操作与结果。

点击播放,可暂停、拖动或全屏查看。

01

从关键词到原文:四段查询导览

28 秒离屏截图导览,不是连续操作录屏。画面来自真实 KB 命令与 Folio 检索引擎, 使用隔离的虚构资料;中文字幕已烧录,并附四条中文 VTT 字幕,无音频。 依次看全文搜索、目录筛选、文件列表和索引覆盖检查。

下载这段视频 ↓

离屏截图导览,不是连续操作录屏。四张图来自真实 KB 查询命令与 Folio 引擎, 仅查询隔离的虚构 Markdown/SQLite 资料,未读取私人台账记录;版本为源码元数据 0.1.0, 检索依赖 Folio 1.2.1 (128)。终端 stdout/stderr 保存在证据文件中;中文字幕已烧录并提供 VTT。 没有窗口上屏、没有合成点击或按键;只说明查询结果,不把片段长度当作性能实测。

看看实际界面

界面细节。

同一演示索引加上 --path Demo/river/ 后,只返回该目录的资料和命中行。
同一演示索引加上 --path Demo/river/ 后,只返回该目录的资料和命中行。
files 只列出命中文件的路径、所属资料组、修改时间和标题,不展开正文。
files 只列出命中文件的路径、所属资料组、修改时间和标题,不展开正文。
无命中后检查 index-stats;docs=3 表示虚构演示索引有三篇资料,界面的 0.0 MB 是文本量显示,不是 KB 资源测量。
无命中后检查 index-stats;docs=3 表示虚构演示索引有三篇资料,界面的 0.0 MB 是文本量显示,不是 KB 资源测量。

操作完成后

怎样确认已经做好?

找到可核对的出处

search 返回预期目录里的文件路径、命中行号和文字;再打开源文件,确认上下文确实是要找的内容。 路径与原文都核对上,才算找到了可用出处。files 的清单和索引片段不能代替原文。

没有命中时缩小问题

看到 (no match),先用更短的关键词或去掉 --path,再运行 index-stats 检查索引覆盖。 没有命中不能证明原文件丢失,也不需要立刻重建资料库。

入口或索引不可用时先检查环境

看到“查询入口不可用”“找不到 folio 命令”或“索引不存在”,保留命令和错误文字, 核对已有 Folio 环境、索引位置和读取权限。不要创建空库或覆盖原库来掩盖错误。

遇到问题

常见问题与处理方法。

现在可以下载或购买吗?

本人自用,不提供下载与源码,也没有公开销售或安装入口。教程面向已经配置好本机环境的人。

我应该运行 kb,还是 python3 bin/kb.py?

本页给出的可照做写法是:在已有 KB 工作目录运行 python3 bin/kb.py 后接子命令。 kb 是帮助中的命令名,不代表每台机器都有这个快捷命令。

什么样的结果才算找到了资料?

search 给出预期文件的路径、命中行号和文字,再打开源文件核对上下文。 files 只证明文件匹配;索引有记录不等于原文件仍在,也不等于这份资料适合当前用途。

search 和 files 有什么区别?

search 显示匹配文件及命中行;files 只列匹配文件,不展开正文。先找内容用 search,只要出处清单用 files。

没有任何输出,是不是资料丢了?

不一定。可能是关键词没有命中、路径筛选过窄,或目标资料尚未被索引。 先减少筛选条件,再用 index-stats 检查覆盖;无命中本身不是命令执行失败,不能据此断言原文件不存在。

为什么会提示找不到 folio 命令?

KB 的日常全文搜索依赖已有 Folio 命令。先核对这台机器的 Folio 是否就绪及是否能找到命令; 不要把缺依赖解释为资料库为空。

它会把资料上传到网站吗,需要登录吗?

本页演示的文件与全文查询读取本机索引,不上传资料,也无需 KB 账号。 推广页只展示虚构资料的图片与视频,不提供浏览或搜索私人资料的网页入口。 导入、更新或其他台账操作仍按各自真实流程处理。

能查求职申请、软著等资料吗?

已有入口保留原台账的字段和流程,例如 python3 bin/kb.py apply list 与 python3 bin/kb.py sc list。 需要相应资料库已经存在且可读;本页没有查询私人台账,也没有演示其记录。

private 是平时应该用的全文入口吗?

日常全文查询用 search 和 files。private 用于只读回查历史语料;历史快照与现有文件可能不同。 旧 private import 已退役并拒绝写入,不应拿它重建或覆盖日常索引。

安装体积、内存、CPU 和查询速度是多少?

以本页「资源占用」一节的实测为准,那里是唯一出处。本页不借用 Folio 数据,也不以示例索引里的 chars=146、0.0 MB 或 28 秒视频时长代表 KB 的体积与速度;这些分别是演示文本量和导览片长。

视频是实际连续操作录屏吗?

是真实命令输出的离屏截图导览,不是连续操作录屏。每个镜头展示一次已经执行的查询, 字幕说明该看哪里;固定每段七秒、无音频,不反映真实执行耗时。

KB · 资料查询 图标

KB · 资料查询,从这里开始。

本人自用,不提供下载与源码。

数据与隐私

本页演示的 search、files 和 index-stats 读取本机索引,不上传资料,也不提供网站搜索私人资料的入口。 图片与视频只使用虚构资料。查询结果应回到原文核对;其他台账与导入操作沿各自已有流程处理。

权限与账号

不需要 KB 账号。终端查询不需要辅助功能或屏幕录制权限;需要已配置的 KB、Folio 命令和可读的索引, 打开源文件时也须当前用户有权读取。权限不足时先核对目标位置与已有授权。

更新与反馈

本人自用,由维护者在已有本机环境中维护,不提供下载与源码,也没有公开销售或安装入口。 需要反馈查询问题时可使用页面页脚的维护者联系方式,说明子命令与脱敏后的错误文字;请勿发送私人资料或台账记录。