不适用
安装包
此产品不提供公开下载包。
已装好本机环境,从一次查询开始
用一个本机命令入口查询文件、全文索引和已有结构化资料台账。
给已经在本机整理资料的人:用一个命令入口,查到文件、命中段落和已有台账记录。
安装后占用 0.5 MB · 本人自用,不提供下载与源码。需要已配置的 KB 工作目录、可读的本机索引及 Folio 命令; 项目声明 Python 3.12 或更新版本,最低 macOS 版本未声明。终端查询不需要辅助功能或屏幕录制权限, 不需要登录 KB 账号;目标目录仍须当前用户有权读取。
本人自用,不提供下载与源码。
资源占用
不适用
此产品不提供公开下载包。
0.5 MB
应用本体在磁盘上的大小。
22 MB
任务运行时峰值 RSS;任务结束即退出,不是常驻空闲内存。
95.3 %
任务 CPU 时间 0.041 秒;墙钟 0.043 秒。不是空闲占用。
43 ms
一次全文检索(热)(中位数)。
v0.1.0 · Mac18,5 / Apple M6 / macOS 27.0 · 测量日期 2026-10-09。数字来自所列版本与设备的测量记录;当前版本与测量范围以本页说明为准。
用它完成什么
search 返回文件路径和命中行号,先判断这份资料是不是你要找的,再回到源文档阅读上下文。
加 --path 按文件路径筛选,或用 --ws、--repo 限定已有索引中的工作区与资料组,减少无关结果。
files 列出匹配文件,不展开命中正文;适合先找出处,再逐份核对材料。
求职申请、软著等已有台账保留各自字段与查询入口;例如 apply list、sc list,不必把原文迁到一套新资料库。
第一次使用
打开终端,在已有 KB 工作目录运行 python3 bin/kb.py --help。 帮助里能看到 search、files 和 index-stats,就选对了入口。 本页的 python3 bin/kb.py 是完整命令写法,不假定系统已安装名为 kb 的快捷命令。 截图中的 Demo/ 路径与资料都是虚构示例,实际使用时换成自己允许查询的内容。
运行 python3 bin/kb.py search 生态流量。 结果中的 文件路径:行号 表示命中位置,后面的文字是命中行。 演示里能看到 Demo/river/flow.md 与 Demo/meeting/notes.md 两份资料; 实际结果以本机已建立的索引为准。先读几条命中,不要仅凭标题下结论。
运行 python3 bin/kb.py search 生态流量 --path Demo/river/。 --path 的后面是路径片段;演示里结果缩到 Demo/river/flow.md。 自己使用时换成目标目录的路径片段。需要按已有工作区筛选时可加 --ws Work; 改筛选条件只改变这次查询,不会移动源文件。
运行 python3 bin/kb.py files 生态流量 --path Demo/river/,得到文件清单。 用自己平常的阅读工具打开结果中的源文件,再对照上一条 search 返回的行号与上下文。 当路径属于预期目录、原文确实包含所找内容,才算找到了可用出处; 索引片段不是完整原文,文件改动或移动后还需要核对是否仍在原处。
运行 python3 bin/kb.py index-stats,查看已索引篇数和按工作区的分布。 演示的 docs=3 只说明这份虚构索引有三篇资料。 查询没有输出时,先试更短的关键词或移除 --path,再确认目标资料是否已被索引。 如出现“查询入口不可用”或“找不到 folio 命令”,先核对已有 KB 与 Folio 环境; 如索引不可读,先核对索引位置与读取权限,不要重建或覆盖资料库来碰运气。
跟着界面看一遍
点击播放,可暂停、拖动或全屏查看。
28 秒离屏截图导览,不是连续操作录屏。画面来自真实 KB 命令与 Folio 检索引擎, 使用隔离的虚构资料;中文字幕已烧录,并附四条中文 VTT 字幕,无音频。 依次看全文搜索、目录筛选、文件列表和索引覆盖检查。
离屏截图导览,不是连续操作录屏。四张图来自真实 KB 查询命令与 Folio 引擎, 仅查询隔离的虚构 Markdown/SQLite 资料,未读取私人台账记录;版本为源码元数据 0.1.0, 检索依赖 Folio 1.2.1 (128)。终端 stdout/stderr 保存在证据文件中;中文字幕已烧录并提供 VTT。 没有窗口上屏、没有合成点击或按键;只说明查询结果,不把片段长度当作性能实测。
看看实际界面



操作完成后
search 返回预期目录里的文件路径、命中行号和文字;再打开源文件,确认上下文确实是要找的内容。 路径与原文都核对上,才算找到了可用出处。files 的清单和索引片段不能代替原文。
看到 (no match),先用更短的关键词或去掉 --path,再运行 index-stats 检查索引覆盖。 没有命中不能证明原文件丢失,也不需要立刻重建资料库。
看到“查询入口不可用”“找不到 folio 命令”或“索引不存在”,保留命令和错误文字, 核对已有 Folio 环境、索引位置和读取权限。不要创建空库或覆盖原库来掩盖错误。
遇到问题
本人自用,不提供下载与源码,也没有公开销售或安装入口。教程面向已经配置好本机环境的人。
本页给出的可照做写法是:在已有 KB 工作目录运行 python3 bin/kb.py 后接子命令。 kb 是帮助中的命令名,不代表每台机器都有这个快捷命令。
search 给出预期文件的路径、命中行号和文字,再打开源文件核对上下文。 files 只证明文件匹配;索引有记录不等于原文件仍在,也不等于这份资料适合当前用途。
search 显示匹配文件及命中行;files 只列匹配文件,不展开正文。先找内容用 search,只要出处清单用 files。
不一定。可能是关键词没有命中、路径筛选过窄,或目标资料尚未被索引。 先减少筛选条件,再用 index-stats 检查覆盖;无命中本身不是命令执行失败,不能据此断言原文件不存在。
KB 的日常全文搜索依赖已有 Folio 命令。先核对这台机器的 Folio 是否就绪及是否能找到命令; 不要把缺依赖解释为资料库为空。
本页演示的文件与全文查询读取本机索引,不上传资料,也无需 KB 账号。 推广页只展示虚构资料的图片与视频,不提供浏览或搜索私人资料的网页入口。 导入、更新或其他台账操作仍按各自真实流程处理。
已有入口保留原台账的字段和流程,例如 python3 bin/kb.py apply list 与 python3 bin/kb.py sc list。 需要相应资料库已经存在且可读;本页没有查询私人台账,也没有演示其记录。
日常全文查询用 search 和 files。private 用于只读回查历史语料;历史快照与现有文件可能不同。 旧 private import 已退役并拒绝写入,不应拿它重建或覆盖日常索引。
以本页「资源占用」一节的实测为准,那里是唯一出处。本页不借用 Folio 数据,也不以示例索引里的 chars=146、0.0 MB 或 28 秒视频时长代表 KB 的体积与速度;这些分别是演示文本量和导览片长。
是真实命令输出的离屏截图导览,不是连续操作录屏。每个镜头展示一次已经执行的查询, 字幕说明该看哪里;固定每段七秒、无音频,不反映真实执行耗时。
本人自用,不提供下载与源码。
本页演示的 search、files 和 index-stats 读取本机索引,不上传资料,也不提供网站搜索私人资料的入口。 图片与视频只使用虚构资料。查询结果应回到原文核对;其他台账与导入操作沿各自已有流程处理。
不需要 KB 账号。终端查询不需要辅助功能或屏幕录制权限;需要已配置的 KB、Folio 命令和可读的索引, 打开源文件时也须当前用户有权读取。权限不足时先核对目标位置与已有授权。
本人自用,由维护者在已有本机环境中维护,不提供下载与源码,也没有公开销售或安装入口。 需要反馈查询问题时可使用页面页脚的维护者联系方式,说明子命令与脱敏后的错误文字;请勿发送私人资料或台账记录。