本地索引引擎

为本地私有知识库建立与管理索引：扫描指定目录、解析 pdf/docx/xlsx/pptx/md/txt/eml、分块并本地向量化入库，按文件哈希增量更新；同时提供索引统计与原始检索。当用户要求"把某目录加进知识库""建库""索引这些文档""看看收录了多少文件"或需要检索原始片段时使用。文档内容全程在本机解析与向量化，不上传任何服务器。

LocalMind 本地索引引擎

把本机目录变成可检索的私有知识库。解析与向量化全部在本机完成。

快速开始

BASE="$HOME/.localmind/skills/localmind-index/scripts/localmind_run.py"

# 1) 建立/增量更新索引（员工个人文档，私有域）
python3 "$BASE" index --paths ~/Documents/部门制度 --priv local

# 2) 部门共享文档（参与联邦，同事可命中片段，原文不出机）
python3 "$BASE" index --paths ~/Documents/共享制度 --priv federated

# 3) 查看收录情况
python3 "$BASE" stats

# 4) 原始检索（调试用，返回片段与分数）
python3 "$BASE" search --query "住宿标准" --top-k 5

参数

| 子命令 | 参数 | 说明 | |---|---|---| | index | --paths P [P...] | 必填，要索引的目录（可多个） | | | --priv local\|federated | 隐私域。local 仅本机可搜（默认）；federated 参与部门联邦 | | search | --query / --top-k | 检索词 / 返回条数（默认 5） | | seed-demo | --dir | 生成一份拟真演示语料，用于快速体验 |

隐私域怎么选（重要）

用户说"我自己的文档/笔记/会议记录" → local；
用户说"部门制度、规范、公共资料，同事也能查" → federated。
拿不准就默认 local——宁可少共享，不可越权暴露。

增量与幂等

重复执行 index 是安全的：文件 sha256 未变化则跳过，只索引新增与修改过的文件。返回 {"scanned": n, "updated": m, "skipped": k}。