企业官网建设流程全解析

MEX 是一个把团队记忆放进代码仓库的开源工具：项目架构、开发约定、设计决策都被沉淀为 Markdown 知识图谱，再用wiki query一条命令即可全文检索，秒查你想知道的任何一条团队知识。无论你是刚接手陌生项目的新手，还是想让 AI 编码代理"读过团队文档"再动手的工程师，这套工作流都能让你在几秒内从"翻代码猜逻辑"变成"一条命令查到底"。🔍

为什么需要 MEX Wiki 知识图谱？

接手一个老项目时，最常见的问题是：

• 架构在哪看？文档散落在 README、博客、聊天记录里，没人敢保证是最新的
• 约定是什么？"为什么我们所有错误都要显式处理？"——答案只存在于某个老员工脑子里
• 决策依据丢失当初为什么选 A 不选 B？代码里只有结果，没有理由

MEX 的答案是：让知识住在仓库里，随代码一起通过 Git 共享。每条知识是一个带元数据的 Markdown 实体（架构、组件、决策、约定、模式等），并建立可重建的本地搜索索引。一条wiki query，就能从"人肉考古"变成"精准检索"。

实体类型完整定义见 src/wiki/model/entity.ts。

快速上手：三步建好你的 Wiki 知识图谱

MEX 要求Node.js 22.5+和 Git 仓库。在仓库根目录执行：

npx mex-agent@0.8.3 setup

setup 会在本地浏览器中引导你完成初始化：选择 AI 工具、生成脚手架文件、构建索引。完成后打开 Hub 控制台：

mex hub

如果团队仓库已经配置过 MEX（clone 下来即有.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.ts）：

mex 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>看有哪些知识引用了它——决策的影响面一目了然。

组合查询小技巧 💡

默认输出是 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 页则把代码与解释并排展示：

常见问题排查 🛠️

延伸阅读

• 全部 Wiki 命令一览：README.md
• 搜索服务层实现：src/wiki/service/read.ts
• 检索会话与排序规则：src/wiki/query/session.ts
• CLI 命令适配层：src/wiki/cli/commands.ts

总结：MEX 用"Markdown 规范知识 + 本地可重建索引"的组合，让wiki query成为秒查项目架构、约定与设计决策的利器。三条命令起步——mex wiki rebuild-index、mex wiki query "关键词"、mex wiki related <id>——你的团队记忆就从"散落的文档"变成了"可检索的知识图谱"。📚