人工智能搜索引擎本地部署后端MCP 服务【免费下载链接】xerjXERJ is the new way for AI to search data. Its autoindex capability activates agents to know your data without the token waste of grep and sed. One command indexes code, docs, logs and PDFs for search, RAG, security audits and agent memory, using 40x fewer tokens than grep. Elasticsearch compatible, so existing clients just work.项目地址https://gitcode.com/GitHub_Trending/xe/xerj点击查看免费下载XERJ 的xerj brain命令能把任意笔记文件夹一步变成运行中的第二大脑本地服务器自动索引语料、用五个确定性边检测器提取笔记之间的链接关系、生成带仪表盘的图谱视图并通过 REST API 与 MCP 接口向 Agent 开放。本指南以仓库中的 second-brain 演示目录 为骨架结合引擎侧源码深入讲解语料设计、检测器原理、API 语义与验证脚本读完后你能完整复现这套一键建脑 可验证的流程并理解其确定性、双向时间戳与诚实记账的底层设计。这个 Demo 是什么搜索索引上的图状关系层目录 demo/usecases/second-brain 存放着一套语料生成器 验证装置一条命令把一文件夹笔记变成可查询、可重放、带仪表盘的链接索引。其核心理念在 README 中讲得很直白——XERJ doesnt understand your notes — it makes the structure you wrote queryable, timestamped, and evidence-backed, deterministically. It is a search engine with a graph-shaped index over its own documents,not a graph databaseand not a brain.也就是说它不是图数据库更不是大脑而是一个对自己的文档带有图状索引的搜索引擎。每条边都是普通文档存储在保留索引.xerj-memory-{brain}-edges中走既有的 WAL → memtable → segment → doc-values 路径零存储格式改动见 graph_api.rs 模块头注释。目录里没有任何 mock——脚本打印的每个数字都来自对真实运行服务器的实时响应。演示语料库39 个文件每个检测器都有诚实的活儿干gen-corpus.sh 生成一个真实的 39 文件个人知识库酸面包烘焙 面包店启动项目语料形状经过刻意设计让每个链接检测器都有事可做、且测试覆盖到边界文件夹文件数覆盖的检测器与边界notes/15[[wikilink]]——zettel 之间的作者链接其中故意留一个悬空链接[[banana-bread]]没有对应笔记它必须被计数为未解析绝不能凭空发明一条边projects/bakery-launch/6相对 Markdown 链接mdlink包含绝不能变成边的外部 URL如https://www.rofco.be、https://example.gov/...clippings/4保存的 HTML 页面含指向语料文件的a hrefhref 检测器同时测试外部链接被跳过journal/12完全没有作者链接——每条边都是结构性的文件放在同一目录这是让仪表盘上 AUTHORED 与 STRUCTURAL 的区分保持诚实的角落reading/1一篇超过 2KB 分段目标的长文自动索引将其拆分产生 section 顺序边语料生成器还做了一件决定整个演示确定性的事文件字节固定且每个 mtime 都用touch -d钉死。因为检测器边的valid_at取自 mtimesrc_file的 mtime绝不取墙钟见 detect/mod.rs 中EdgeDraft.valid_at_ms的注释所以重新生成语料并重跑xerj brain会重现完全相同的 edge_id。只有created_at大脑学会每条链接的时刻按契约使用墙钟。一键运行从语料到运行中的大脑三个脚本构成完整流程均幂等可重跑./boot-and-brain.sh # 生成语料库若不存在运行 xerj brain # 验证服务器有响应 → 端口 9331-9333 ./transcript.sh # API 证明见下文 → PASS/FAIL 汇总 ./mcp-smoke.sh # MCP 上的 Agent 界面 → PASS/FAIL 汇总boot-and-brain.sh 默认值与环境变量覆盖工作根目录${TMPDIR:-/tmp}/xerj-second-brain-demo用XERJ_BRAIN_DEMO_ROOT覆盖es-compat 端口9331用XERJ_BRAIN_DEMO_PORT覆盖启动的服务器还会占用 1/2 即 9331-9333 给 rest/grpc处于 9330-9345 演示区间内绝不占用 9200/9310二进制repo/engine/target/release/xerj用XERJ_BIN覆盖若未编译脚本会提示cargo build --release -p xerj-server停止服务器kill $(cat root/data/server.pid)xerj brain这一命令本身做了三件事的组合见 brain.rs 模块头注释组合而非重实现——索引与链接检测复用xerj_autoindex::run_index_report完整管线图检测器默认开启控制台鉴权复用服务器自身的首次启动引导xerj-console-api::bootstrap铸造一次性 30 分钟 setup 链接并打印在启动横幅里该命令只负责转发从不自行铸造凭据服务器就是普通的xerj二进制以分离进程组 detached 方式拉起输出到data-dir/server.log因此大脑比这条命令活得更久。boot 脚本等待就绪的超时为 120 秒、轮询间隔 150ms。xerj brain完整选项帮助文本来自 brain.rs选项含义--brain NAME大脑名默认取文件夹名是 URL 的一部分--url U使用的服务器默认http://localhost:9200仅当 localhost URL 无人监听时才引导新服务器--data-dir PATH新引导的服务器存放数据与日志的位置默认~/.xerj/brain--api-key K已运行的安全服务器的 API 密钥或环境变量XERJ_API_KEY本命令引导的服务器无需——密钥写在data-dir/admin.key--fresh忽略恢复日志、就地重建计划并重走全部文件id 保持幂等绝不会删除你移除的笔记的文档--no-open打印链接但不打开浏览器--disable-feedback不打印反馈邀请退出码0就绪3就绪但有垃圾有不可读文件被记录非致命1无内容可索引或服务器失败2用法错误。端到端测试 brain_cli.rs 验证了首次运行引导服务器 → 打印your second brain is ready与控制台深链/_xerj-console/#/second-brain?brainnotes→ 二次运行附着到已运行服务器且边集合收敛到相同 edge_id → 三次运行不带--no-open时打开控制台视图的完整闭环同时断言 5 文件 fixture 恰好产出 13 条边4 wikilink 4 same_dir 5 sequence openers。五个边检测器确定性、带版本、带证据演示依赖的五个检测器在 detect/mod.rs 中通过EdgeDetectortrait 统一抽象无网络、无 LLM、无时钟读取——相同输入必须产出相同草稿。每条边都携带教会它的精确引文evidence.quote裁剪到 240 字符和detector标签如wikilink1任何行为变更都必须 bumpN让旧边始终可归属到产生它的规则。以下是演示语料实际用到的五个源码中的权重/置信度常量均为实测参数检测器标签边类型权重置信度检测内容与设计意图Wikilinkwikilink2wikilink1.00.95[[Target]]/[[Target|alias]]最强信号人类刻意点名另一篇笔记置信度不为 1.0 是因为按名字解析同 stem 多文件歧义会被计数、绝不隐藏wikilink.rsMdlinkmdlink2mdlink0.90.9text指向语料文件内联 Markdown 链接仍是一次明确的作者行为但也是引用外部材料的方式本地解析命中携带略弱的归属同一主题意图mdlink.rsHrefhref2href0.70.85a href指向语料文件仅作用于被 sniff 为htmlfamily 的文件扩展名是 .html 不算数sniffing 说了算有 raw 源扫描与 section 文本双通道href.rsSequencesequence2sequence0.80.99文件卡片开启链然后每个 section 在同一文件内按顺序前置autoindex 把长文档拆成分段没有这些边拆分就会毁掉文档自身的叙事邻接答案之后的那段正是 Agent 需要的sequence.rsSameDirsamedir2same_dir0.30.4同目录文件链式连接而非团式n 个文件恰好 n-1 条边500 文件的目录产出 499 条而非 124,750 条是唯一对完全无链接语料也触发的检测器防止无链接文件夹变成孤立点组成的图samedir.rs几个值得一提的确定性细节悬空链接被计数而非发明Wikilink 对无法解析到语料文件的[[target]]递增unresolved计数器并跳过演示语料里的[[banana-bread]]正是这个测试点运行摘要必须展示它绝不凭空造边。外部链接被跳过而非悬空mdlink/href 共用的resolve_localdetect/mod.rs识别带 scheme 或//前缀的目标为 External——外部 URL 是 Markdown/HTML 链接的本职用途静默跳过是正确的只有本地 miss 才计入 dangling。samedir 链天然是命名顺序序列按 rel 排序使链确定且自然跟随01-intro, 02-setup, …的编号约定文件级按命名排序信号顺带成立。edge_id 确定性edge_id xxh3_128(xg1\0 src \0 type \0 dst \0 decimal(valid_at_ms))渲染成 32 位小写 hexdetect/mod.rs。xerj-api与xerj-autoindex两个 crate 各持一份字节相同的实现用同一个 pin vector 测试锁死edge_id(note-alpha, wikilink, note-beta, 1753600000000) bef814a75bd3d914c3e561f610154304两个写入方永远无法漂移。相同 (src, type, dst, valid_at) → 相同_id→ 重跑时 bulkindex就地覆盖而非重复不同的 valid_at 会创建不同的边——这是双向时间设计不是 bug。transcript.sh六个 API 证明每个数字都来自真实响应transcript.sh 是 HTTP 面上的证据装置覆盖了案例研究触及的每一个断言脚本打印的每个数字都从实时响应中读取、绝不硬编码。它证明六件事1. Overview——大脑级真相GET /_graph/{brain}/overview返回契约字符串xerj-second-brain/1、存在性、live/retired 计数断言invalidated total - live、五个检测器都有 live 边按检测器家族匹配而非钉死N——版本号被设计为会变动钉死它会在每次刻意 bump 时误报、lexical-feature-hash诚实标记以及not_shown记账types_not_listed、hubs_out_not_listed。实现上overview 是对 edges 索引的四次组合搜索总数exists srcmeta 文档因此永远不参与计数、as_of 时刻的 live 切片bool.filter的valid_at lte as_ofmust_not invalid_at lte as_of同时给出 type/detector/hub 的 terms 聚合、创建时间直方图date_histogram、节点总数计数——每个 top-N 列表的尾巴都通过not_shown上报graph_api.rs。2. Ego——单篇笔记的标注邻域GET /_graph/{brain}/ego?nodehubhops2include_nodestrue返回 hub 的 2 跳邻域每条边带hop与directionout/in按 hop 前沿集合判定、检测出的边带教会它的evidence.quote、节点摘要被水合nodes对象含title/preview/path/indexpreview 取text/body前 160 字符ax_path是 autoindex 写入者的诚实文件标签、剪裁的边/过期排除/悬空节点全部进入not_shown。多 seed 形式是nodes最多 64 个超出部分计入not_shown.frontier_clipped深入探索的合规迭代方式是把上一响应reachable的一部分喂回去再展开。ego 完整参数源码注释见 graph_api.rs参数说明node/nodes二选一必填nodes是逗号分隔的多 seed 形式去重保序、上限 64hops1默认或 2其他一律 400 not a graph database 措辞directionout/in/both默认types逗号分隔的边类型白名单缺省为全部limit返回边数上限钳制在 1..1000默认 100as_of双向时间切点epoch-ms 或 RFC3339默认 nowinclude_expired是否同时返回软失效边默认 falseinclude_nodes是否水合节点摘要默认 falsenodes_index节点索引覆盖默认 meta 文档的nodes_index否则.xerj-memory-{brain}include_evidence是否为返回边水合 evidence默认 true3. Link——带引文的幂等断言POST /_graph/{brain}/link手工断言一条边请求体包含src、dst、type与可选weight默认 1.0钳制 [0,1]、valid_at默认服务器 now、created_at、confidence、detector默认manual1、evidence{quote, source, offset}。未知字段被 400 拒绝——打错的键绝不允许悄悄丢掉一条断言细节。首次断言返回 201相同 (src, type, dst, valid_at) 重复断言返回 200 且created:false、edge_id 相同——确定性身份意味着安全重试写路径会惰性创建带 §2.1 mapping 与 §2.5 meta 文档的 edges 索引。4. Unlink——退休永不删除DELETE /_graph/{brain}/link/{edge_id}?invalid_at...是软失效同一个文档在相同_id下重新索引加上invalid_at事实停止为真的时刻与expired_at系统记录这一点的时刻总是服务器 now——响应同时携带两个时钟这就是双向时间对。已失效的边再次 DELETE 是幂等 no-op报告invalidated:false与既有already_invalid_at。边上invalid_at/expired_at未设置时必须省略而非置 null——null_bitmap 本身就是仍然有效的信号§2.2 类型纪律。5. Replay——用 as_of 回到过去在信念区间内用as_of2026-07-10再次询问被退休的边在过去仍然存在不带as_of询问当下它已缺席并且这次排除被计数进not_shown.expired_excluded加include_expiredtrue后它仍可查询、带着invalid_at。autoindex 侧的替换失效文件重写后旧代边被软失效同样复用这套机制invalidate_edges_by_field按src_file或dst逐轮 search → re-index → refresh直到收敛detect/mod.rs。6. Refusals——规范化的拒绝hops3→ 400正文含hops is capped at 2与not a graph措辞GRAPH_HOPS_CAP_REASON自环{src:a,dst:a}→ 400self-edges are not allowed (src dst)未知大脑 → 404正文exists:false。这些拒绝不是错误处理瑕疵而是设计规范引擎的图展开是列式、有界、批量读≤2 跳/次无查询语言、无最短路径、无 PageRank、无无界遍历。MCP 冒烟Agent 界面上的同一套大脑mcp-smoke.sh 验证 Agent 界面xerj-mcpstdio 代理通过XERJ_URL指向演示大脑用换行分隔的 JSON-RPC 完成initialize → notifications/initialized → tools/list → tools/call真实往返。断言包括四个大脑工具被列出xerj_brain_ego、xerj_brain_link、xerj_brain_unlink、xerj_brain_overview每个大脑工具的描述都携带 not a graph database 诚实字符串——这是设计强制的大脑工具缺席即报 FAIL、绝不打马虎眼一次真实的tools/call xerj_brain_overview成功返回exists:true且带 live 边计数。这意味着同样的双向时间语义、同样not_shown记账、同样的 hops 上限Agent 通过 MCP 获得的是与 REST 完全一致的接口契约。大脑即安全边界授权模型graph_api.rs 明确了大边界一个 brain 就是一个安全边界issue #79。每个端点在做事之前——包括在检查大脑是否存在之前——先对这个 brain做授权因此不是你的大脑与不存在的大脑统一返回 403响应码无法用于枚举。授权资源是大脑的 edges 索引.xerj-memory-{brain}-edges主体可达范围开放模式--insecure、指向文件夹所有大脑——单用户、零配置配置的 admin 密钥所有大脑铸造时role_descriptors命名了 edges 索引的密钥该大脑、授予的权限铸造时没有role_descriptors的密钥没有任何大脑无/无效凭据无ego/overview需要readlink/unlink需要write惰性创建 edges 索引属于写一个大脑的一部分不是单独的manage步骤。大脑名校验规则与 agent-memory 命名空间一致小写/数字开头、[a-z0-9._-]、≤200 字符、不含..并额外拒绝-edges后缀——否则名为kb-edges的大脑会与大脑kb的边索引冲突。这层检查只是授权决策的一半边住在普通索引里.xerj-memory-{brain}-edges的.前缀通过IndexName::validate、可被通用 ES-compat 路由触达因此_search、_doc/{id}、DELETE、GET /_mapping等所有旁路都在authz中关闭本模块内的检查是同一决策的 handler 内半边即使脱离中间件单独挂载也保持安全。这个 Demo 明确不声称什么README 的诚实边界也是设计边界无语义理解检测器是词法级的embedder 是 feature hashinglexical-feature-hash绝不标榜 neural无隐藏连接发现作者链接是从你写的内容里重新索引出来的同目录/顺序链接是结构先验且被如实标注为 STRUCTURAL无图数据库功能无路径查询、无 PageRank、无无界遍历——每次调用展开上限为 2 跳这是设计使然无性能数字这套装置测的是正确性不是速度凡未在此测量的一切都是未测量。这套诚实边界在响应里是可见的overview报告embedder标识、not_shown逐项计数被隐藏的内容剪掉的边/前沿、双向时间排除的边、跳过的 segment、悬空节点引用、聚合尾巴MCP 工具描述里强制携带 not a graph database 字符串。演示运行摘要同样如实呈现edges_unresolved等计数器——对悬空链接的记录本身就是对语料的一个事实。与 CI 的关系README 特别说明这三个脚本也正是 CI 通过 .github/scripts/usecase-smoke.sh 运行的——每个 PR 上的门禁就是这套精确的装置而不是它的另一份拷贝。因此你本地重跑boot-and-brain.sh、transcript.sh、mcp-smoke.sh的 PASS/FAIL与项目 CI 对每个提交的判定完全同构。快速上手清单构建二进制(cd engine cargo build --release -p xerj-server -p xerj-mcp)进入 demo/usecases/second-brain运行./boot-and-brain.sh首次会自动生成 39 文件语料库并引导服务器端口 9331-9333运行./transcript.sh查看 6 组 API 证明的 PASS/FAIL 汇总运行./mcp-smoke.sh验证四个 MCP 大脑工具与真实 tools/call 往返浏览器打开控制台深链http://localhost:9331/_xerj-console/#/second-brain?brainvault查看 AUTHORED vs STRUCTURAL 图谱收尾kill $(cat /tmp/xerj-second-brain-demo/data/server.pid)或你覆盖的根目录整个过程零 mock、可重跑、幂等收敛——重新运行gen-corpus.sh与xerj brain会产生相同的 edge_id唯一随时间漂移的是created_at。这正是第二大脑应该有的性质你对笔记写下结构XERJ 让它可查询、可回溯、有据可查。赞分享人工智能搜索引擎本地部署后端MCP 服务【免费下载链接】xerjXERJ is the new way for AI to search data. Its autoindex capability activates agents to know your data without the token waste of grep and sed. One command indexes code, docs, logs and PDFs for search, RAG, security audits and agent memory, using 40x fewer tokens than grep. Elasticsearch compatible, so existing clients just work.项目地址https://gitcode.com/GitHub_Trending/xe/xerj点击查看免费下载相关推荐k-skill 浏览器运行时设计基于 CDP 与 Aside 的 Agent 浏览器自动化可移植回退机制k skill 浏览器运行时设计基于 CDP 与 Aside 的 Agent 浏览器自动化可移植回退机制 本文以 浏览器运行时文档 https://link.人工智能搜索引擎本地部署后端MCP 服务XERJ Second Brain 实战一条命令把笔记文件夹变成 Agent 可引用的双时态知识链接索引XERJ Second Brain 实战一条命令把笔记文件夹变成 Agent 可引用的双时态知识链接索引 本篇技术指南围绕 XERJ 的 second br人工智能搜索引擎本地部署后端MCP 服务XERJ Second Brain 完整复现指南xerj brain 一键把你的笔记变成可检索、可回放的知识图谱XERJ Second Brain 完整复现指南 xerj brain 一键把你的笔记变成可检索、可回放的知识图谱 本篇指南基于 XERJ 仓库 docs/u人工智能搜索引擎本地部署后端MCP 服务上一篇WebdriverIO 日志工具 wdio/logger 完全指南安装、自定义日志级别与敏感信息脱敏下一篇Building [What Youre Building]创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考