企业官网建设流程全解析

• 桌面应用

导读

本文讲解在 Trellis Spec Bootstrap（基于真实代码库生成.trellis/spec/编码规范的引导工作流）中，如何为你的 Agent 宿主配置GitNexus与ABCoder两个代码感知型 MCP（Model Context Protocol）服务器，使 Agent 在编写规范前能直接获取仓库的架构图景与 AST 级代码结构。文末附上针对本仓库（EcoPaste，一款基于 Tauri v2 + React 19 + Rust 的跨平台剪贴板管理工具）的落地建议与验证步骤。读完本文，你将掌握两条 MCP 配置路径的完整命令、工具用途对照，以及启动规范编写前必须执行的连通性检查方法。

为什么在 Trellis Spec Bootstrap 阶段需要代码感知 MCP

Trellis Spec Bootstrap 的核心原则是“先从真实代码出发，再决定规范结构”（见 trellis-spec-bootstrap/SKILL.md）：它要求 Agent 先分析仓库的真实架构，而非从通用模板填空。当代码库较大时，仅靠人工逐文件阅读效率极低，而 GitNexus 与 ABCoder 恰好互补地解决两类需求：

• GitNexus：从仓库构建代码知识图谱（knowledge graph），擅长回答“模块边界在哪”“执行流如何串联”“依赖关系与影响半径如何”这类跨文件、跨模块的架构问题；
• ABCoder：将代码解析为 UniAST 统一抽象语法树，擅长给出包、文件、节点级的精确结构，例如函数签名、类型形状、实现与反向引用。

文档 mcp-setup.md 开篇即强调：这两者是“工具选择（tool choices），而非平台要求（platform requirements）”。它们与具体的 Agent 宿主（Cursor、Claude Code、其他 MCP 兼容宿主）解耦，通过宿主提供的任意 MCP 机制配置即可。

一、GitNexus：从仓库构建代码知识图谱

1.1 安装与建索引

在仓库根目录运行以下命令完成分析与索引：

# 在仓库根目录执行 npx gitnexus analyze # 查看索引状态 npx gitnexus status # 代码变更导致分析过期时，重新索引 npx gitnexus analyze

索引数据写入.gitnexus/目录。文档特别指出：仅当项目原本就在使用 embedding（嵌入向量）时才保留它，对规范引导（spec bootstrapping）而言，普通索引已足够，保留 embedding 只会徒增索引体积与耗时。

1.2 MCP Server 命令

在宿主（host）的 MCP 配置文件中，将该命令注册为 GitNexus 的服务器启动命令：

npx -y gitnexus mcp

-y参数确保 npx 在本地未安装时自动下载，避免配置因依赖缺失而失败。

1.3 常用工具与用途

1.4 在本仓库中的典型用法

在 EcoPaste 的 Trellis 规范引导中，这些工具可回答典型的架构问题，例如：

gitnexus_query({query: "clipboard ingest and watcher flow"}) gitnexus_context({name: "ClipboardWatcher"}) gitnexus_cypher({query: "MATCH (n)-[r]->(m) RETURN n.name, type(r), m.name LIMIT 30"})

可结合 AGENTS.md 中的架构边界（Rust 侧负责剪贴板监听、写回、内容类型识别与数据库，前端负责渲染与交互）理解查询结果对应的模块划分。

二、ABCoder：解析代码为 UniAST 并给出精确结构

2.1 安装

ABCoder 通过 Go 工具链安装，文档给出的命令为：

go install github.com/cloudwego/abcoder@latest abcoder --help

2.2 解析仓库

解析某个包/目录的语法为：

abcoder parse /absolute/path/to/package \ --lang typescript \ --name package-name \ --output ~/abcoder-asts

参数说明：

• /absolute/path/to/package：待解析包的绝对路径；
• --lang：语言标识，如typescript；
• --name：仓库/包名，解析结果将以该名称注册；
• --output：AST 输出目录，如~/abcoder-asts。

对于 monorepo（多包仓库），应为每个包分别解析，并使用稳定一致的--name，这样任务笔记（task notes）可以在后续会话中引用相同的仓库名。在 EcoPaste 这类 Tauri 仓库中，如果同时解析前端与 Rust 侧，可考虑为不同层各自指定独立的--name以保持引用一致。

2.3 MCP Server 命令

将解析输出目录传给 MCP 服务器启动命令：

abcoder mcp ~/abcoder-asts

2.4 常用工具与分层

层级编号体现了从“仓库 → 包 → 文件 → AST 节点”的逐级下钻路径。当规范需要精确代码形状（构造函数模式、函数签名、类型契约、引用链）时，ABCoder 价值最大，这正是 repository-analysis.md 中所说的“spec 需要确切代码形状时优先用 ABCoder”。

2.5 本仓库中的典型用法

EcoPaste 前端为 TypeScript（src/目录），解析时可运行：

abcoder parse /data/web/disk1/git_repo/ayangweb/EcoPaste/src \ --lang typescript \ --name ecopaste-frontend \ --output ~/abcoder-asts

随后在 Agent 会话中：

list_repos() get_repo_structure({repo_name: "ecopaste-frontend"}) get_file_structure({repo_name: "ecopaste-frontend", file_path: "src/components/Tooltip/index.tsx"}) get_ast_node({repo_name: "ecopaste-frontend", node_ids: [{mod_path: "src", pkg_path: "components", name: "Tooltip"}]})

三、配置完成后必须执行的验证

文档 mcp-setup.md 明确要求：配置结束后，先确认两个 MCP 服务器在 Agent 宿主中可见，再对每个服务器各跑一次简单查询，最后才开始规范写作。这是防止“配置了但没生效”导致整轮引导白跑的关键步骤。

验证命令：

# 确认 GitNexus 索引元数据已生成 ls .gitnexus/meta.json # 确认 ABCoder 解析产物已生成 ls ~/abcoder-asts/*.json

若两者都存在，再在 Agent 宿主中对 GitNexus 跑一次gitnexus_query、对 ABCoder 跑一次list_repos，确认返回结果而非报错。

四、两套工具在 Trellis 工作流中的配合方式

结合 trellis-spec-bootstrap/SKILL.md 的工作流与 repository-analysis.md 的分析顺序，推荐的配合路径为：

1. 先用 GitNexus 建图：用gitnexus_query定位执行流与功能区域、用gitnexus_impact识别影响敏感区域，得到“哪些模块需要写规范”的候选清单；
2. 再用 ABCoder 精读：对候选模块用get_file_structure/get_ast_node提取精确签名、类型与实现示例，作为规范的代码证据；
3. 直接读源文件交叉验证：如 repository-analysis.md 所说，“不要直接引用图输出作为最终权威，先核对相关源文件”——规范中的每一条规则最终都应落到真实文件路径与可复现模式上；
4. 记录分析笔记：按包/层记录本地模式文件、应写入的规范规则、发现的 anti-pattern 以及需要新建/合并/删除的规范文件；
5. 收尾用gitnexus_detect_changes：在规范写作结束前检查变更符号与受影响流程，确保规范与当前代码一致。

五、常见误区与注意事项

• 不要为规范引导强行保留 embedding：普通索引足以支撑架构查询，embedding 只在项目已有使用场景时保留；
• monorepo 的--name必须稳定：ABCoder 解析时名称不一致会导致后续任务笔记中引用失效；
• 图查询不等于事实：GitNexus 结果用于“找文件、找流程”，但写入规范前必须读源文件确认；
• 配置与宿主解耦：两个工具通过 MCP 机制接入，不要在技能或规范文件中写死某个特定宿主的配置语法；
• 先验证再开工：跳过 Verification 步骤往往导致规范写作阶段才发现 MCP 不可用，浪费整轮会话。

结语

GitNexus 与 ABCoder 是 Trellis Spec Bootstrap 中“从代码出发”的得力助手：前者提供架构级知识图谱，后者提供 AST 级精确结构。按本文完成安装、索引、MCP 注册与连通性验证后，Agent 就能在 EcoPaste 这类真实仓库上高效地生成有源码依据、无占位符的.trellis/spec/规范。相关参考文件均可在此仓库中查阅：mcp-setup.md、repository-analysis.md、trellis-spec-bootstrap/SKILL.md，以及 Trellis 组织入口 AGENTS.md。

• 桌面应用