MEX Wiki 知识图谱实战:用 wiki query 秒查项目架构、约定与设计决策
【免费下载链接】mexTeam memory for engineers and their AI agents. Lives in your repo. Shared through Git.项目地址https://gitcode.com/gh_mirrors/mex2/mex点击查看免费下载MEX 是一个把团队记忆放进代码仓库的开源工具项目架构、开发约定、设计决策都被沉淀为 Markdown 知识图谱再用wiki query一条命令即可全文检索秒查你想知道的任何一条团队知识。无论你是刚接手陌生项目的新手还是想让 AI 编码代理读过团队文档再动手的工程师这套工作流都能让你在几秒内从翻代码猜逻辑变成一条命令查到底。为什么需要 MEX Wiki 知识图谱接手一个老项目时最常见的问题是架构在哪看文档散落在 README、博客、聊天记录里没人敢保证是最新的约定是什么为什么我们所有错误都要显式处理——答案只存在于某个老员工脑子里决策依据丢失当初为什么选 A 不选 B代码里只有结果没有理由MEX 的答案是让知识住在仓库里随代码一起通过 Git 共享。每条知识是一个带元数据的 Markdown 实体架构、组件、决策、约定、模式等并建立可重建的本地搜索索引。一条wiki query就能从人肉考古变成精准检索。你想查什么Wiki 实体类型例子系统如何工作、为什么这样设计architecture认证采用会话CSRF 的双层防护团队编码规范convention所有数据库查询必须在 repository 层重要技术选型decision选择 SQLite FTS5 而非向量搜索可复用的解决方案pattern两遍解析保证索引确定性实体类型完整定义见 src/wiki/model/entity.ts。快速上手三步建好你的 Wiki 知识图谱MEX 要求Node.js 22.5和 Git 仓库。在仓库根目录执行npx mex-agent0.8.3 setupsetup 会在本地浏览器中引导你完成初始化选择 AI 工具、生成脚手架文件、构建索引。完成后打开 Hub 控制台mex hub如果团队仓库已经配置过 MEXclone 下来即有.mex/目录只需重建本地索引即可开始查询mex wiki rebuild-index这个命令会把.mex/下所有 Wiki Markdown 解析进本地 SQLite 索引.mex/wiki.db——它只是可重建的派生数据不会被提交到 Git索引路径定义见 src/wiki/index/rebuild.ts。这是 MEX 的核心设计规范知识用 Markdown 随 Git 共享检索机器各人本地自持。wiki query 秒查实战架构、约定与设计决策现在来主角命令注册于 src/cli.tsmex wiki query 认证它的搜索策略是分层精确优先而不是简单的相关度打分精确匹配实体 id 标题命中 摘要命中 正文命中src/wiki/query/session.ts。这意味着——标题里写着数据库选型决策的条目永远排在只在正文里蹭到关键词的条目前面结果稳定可预期。场景 1秒查项目架构想知道系统整体怎么搭的mex wiki query 架构 --type architecture--type过滤让你只看特定类型。架构条目通常还绑定到具体代码符号grounding告诉你这段解释对应的实现在哪里。场景 2查开发约定mex wiki query 错误处理 --type convention --limit 5新人写代码前查一遍约定比被 Code Review 打回三次划算多了。场景 3挖设计决策及其理由mex wiki query SQLite --type decision设计决策条目会记录选了什么、没选什么、为什么。配合mex wiki show id看完整正文mex wiki backlinks id看有哪些知识引用了它——决策的影响面一目了然。组合查询小技巧 需求命令片段只看某个主题下的知识--topic id按生命周期状态过滤--status in_flight/--status deprecated只看 grounding 健康的条目--health health输出结构化 JSON 给脚本/代理--json结果太多被截断收窄关键词或调大--limit默认输出是 JSONL每行一条记录方便管道处理加--json则输出完整包裹对象详见 src/wiki/cli/commands.ts。从一条结果到一片上下文show / related / backlinks 组合技查到一条命中的 id 之后还有三个顺着藤摸瓜的命令mex wiki show id # 看完整正文 mex wiki related id --depth 2 # 看它关联的知识邻域 mex wiki backlinks id # 看谁引用了它related会在深度、条数、token 预算三个维度上同时限制返回量src/wiki/query/session.ts保证你拿到的是一份读完不累的上下文而不是半本 wiki。在 Hub 界面里Context 页把这些关系可视化成了知识图谱——点选任意实体能直接看到它的关联节点和代码 grounding知识如何绑定代码for-code 与 grounding 机制MEX Wiki 最有价值的一点解释必须能指到代码。每条 Wiki 知识可以声明一个 grounding——指向代码图谱中的某个符号节点并存储节点 id、身份指纹与正文哈希。代码一变drift 检测就会给对应知识打上需复核标记而不是默默让解释失效。反过来查也只需一条命令mex wiki for-code node-id给定一个代码符号的节点 id返回所有解释过它的 Wiki 知识。AI 代理改代码前查一下就能带着团队的既有约定与决策上下文动手——这正是 MEX 让代理读过文档的关键闭环。Hub 的 Code 页则把代码与解释并排展示常见问题排查 ️症状原因与解法提示索引不可用/不存在运行mex wiki rebuild-index重建读命令永不静默重建索引只给出修复指引换 Node 版本后索引突然读不了SQLite FTS5 是编译期特性换版本管理器的 Node 可能不带 FTS5重建索引即可src/wiki/index/fts5.ts结果末尾出现 … bounded命中被 limit 截断了收窄查询词或调大--limitpull 新代码后想刷新先mex check体检再按提示执行mex wiki rebuild-index延伸阅读全部 Wiki 命令一览README.md搜索服务层实现src/wiki/service/read.ts检索会话与排序规则src/wiki/query/session.tsCLI 命令适配层src/wiki/cli/commands.ts总结MEX 用Markdown 规范知识 本地可重建索引的组合让wiki query成为秒查项目架构、约定与设计决策的利器。三条命令起步——mex wiki rebuild-index、mex wiki query 关键词、mex wiki related id——你的团队记忆就从散落的文档变成了可检索的知识图谱。赞分享【免费下载链接】mexTeam memory for engineers and their AI agents. Lives in your repo. Shared through Git.项目地址https://gitcode.com/gh_mirrors/mex2/mex点击查看免费下载相关推荐Dendron 笔记链接与知识图谱实战Wiki Link、Backlinks 与 Note Graph 全解析Dendron 笔记链接与知识图谱实战Wiki Link、Backlinks 与 Note Graph 全解析 Dendron 的核心能力之一是 把笔记像神经知识管理知识库graphify 知识图谱查询实战query / path / explain 与可审计的答案闭环graphify 知识图谱查询实战query / path / explain 与可审计的答案闭环 本指南以 graphify 的 Trae 版查询技能参考人工智能知识图谱RAGAI 技能开发工具MCP 服务Thorium浏览器比标准Chromium多出的3个开箱即用改进Thorium浏览器比标准Chromium多出的3个开箱即用改进 Thorium浏览器是一个把完整影音解码、默认隐私保护和可切换的经典界面都打包好的Chrom桌面应用跨平台创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考