本地优先的 MCP 代码智能工具集：快速代码搜索、依赖感知模块发现、可视化代码 atlas 网页，以及 DeepWiki-style 仓库文档生成。
简体中文 | English
项目介绍 • MCP 工具 • Code Module Atlas • DeepWiki • Benchmark • Setup • Skills
codebase-mcp 会把一个本地仓库变成常驻 MCP 代码智能服务。它把 tree-sitter 索引源码、符号、引用、依赖、图元数据、词法索引和向量搜索数据都放在目标仓库的 .codedb-mcp 目录下。
常驻 MCP 进程内的 warm tool 调用目标是毫秒级响应。实测数据见 Benchmark 速览、MCP vs rg 和 Warm MCP 工具验证。
| 领域 | 能力 |
|---|---|
| 快速 MCP 工具 | 索引化 exact/regex 搜索、BM25/符号搜索、懒加载向量搜索、outline、definition、callers、deps、模糊文件查找、query pipeline 和 100-call bundle。 |
| 模块发现 | 先按依赖连通文件组件划分，再做 dependency-weighted label propagation；路径和术语用于可解释标签和证据。 |
| Code Module Atlas | 打包 meet-blog 风格 3D viewer：一个源码文件一个星点，支持模块/文件列表、依赖边、文件聚焦和详情。 |
| DeepWiki | 基于 MCP 证据和当前 agent 推理生成本地仓库文档，强调业务模块优先、代码引用和源码证据。 |
| 本地部署 | 显式 .codedb-mcp/codedb-mcp.toml、项目本地存储、可复制 skills，不依赖隐藏环境变量行为。 |
服务会把 tree-sitter 索引和项目本地数据放在 .codedb-mcp 下，并提供这些 MCP 能力：
- 快速 exact/regex 搜索、BM25/符号搜索，以及懒加载向量搜索；
- 符号大纲和定义查找；
- 基于 definition path/line 锚定的 LSP-like callers；
- 文件正向依赖、反向依赖和 transitive 依赖查询；
- 模糊文件查找、路径 glob、小型 query pipeline 和一次最多 100 个内部调用的 bundle；
- 图摘要、懒计算 Louvain community、模块规划、atlas 导出和 DeepWiki 证据收集。
Atlas 网页由 skills/code-module-atlas skill 生成。它调用本地 MCP 的模块 atlas 导出，把结果转换成内置 meet-blog 风格 3D viewer 的数据集，并用一个星点表示一个源码文件。
模块边界先从依赖连通文件图开始划分。在每个连通块内部，Rust 模块规划器使用 dependency-weighted label propagation；路径和 distinctive terms 只用于命名、证据展示和过大连通块拆分，不作为主要分组规则。网页提供模块列表、选中模块内的文件列表、文件之间的依赖边，以及文件聚焦和详情展示。
node skills\code-module-atlas\scripts\build-module-atlas.mjs u3dclient
cd skills\code-module-atlas\assets\viewer
npm run dev -- --port 5174 --strictPortskills/deepwiki skill 会基于 MCP 证据和当前 agent 的推理能力生成本地 DeepWiki-style 文档。它从依赖感知的模块候选开始规划页面，然后生成业务模块优先的文档，包含代码引用、入口点、流程、依赖关系和风险说明，不需要单独配置大模型 API。
推荐的部署方式是 setup-guide first：先把 setup-for-agent.md 交给 agent，让它创建 .codedb-mcp、优先复用已有的默认 HuggingFace cache；如果默认 cache 不存在，再走第二盘符逻辑。之后询问人类是否要给某个特定 agent 注册 MCP。codedb-mcp skill 只负责安装后的工具使用，不负责安装。
测试目标：u3dclient。
Benchmark 于 2026-05-28 在 Windows 上重跑。单次 CLI 行包含进程启动和 cache load；warm 行通过一个已加载进程内的 codedb_bundle timing=true 测量。内存口径是子进程 sampled peak Working Set / Private Bytes。
当前 Unity C# benchmark 配置索引状态：
- 19,035 indexed files
- 129,858 chunks
- 277,213 symbols
- 19,941 graph nodes
- 166,132 graph edges
- Model2Vec
minishlab/potion-code-16M - lazy flat cosine file vectors
- 存储目录：
u3dclient\.codedb-mcp - cache v18 sidecar：紧凑
index.bin、懒加载bm25.postings、懒加载word_index.bin/word_hits.bin、懒加载callers.bin、懒加载deps.bin、懒加载embeddings.bin，以及二进制源码 fingerprint。 - 下方峰值内存为短命令子进程 sampled Working Set / Private Bytes；冷重建行没有在这次短内存采样中重跑。
索引耗时：
| 场景 | Cache | 耗时 | 峰值内存 | 说明 |
|---|---|---|---|---|
| cache v18 项目本地冷重建 | miss | 36.820s | 未重跑 | scan、tree-sitter 声明解析、embedding、BM25、compact sidecar cache save |
| cache-hit index open | hit | 0.768s | 151.1 MB WS / 154.7 MB private | 包含进程启动、源码 fingerprint 校验和 cache load |
单次 CLI codedb_status |
hit | 0.252s | 14.1 MB WS / 7.9 MB private | manifest/fingerprint fast path，不反序列化完整 index |
单次 codedb_find PoolManager |
hit | 0.283s | 14.4 MB WS / 8.2 MB private | manifest/fingerprint fast path，只扫缓存文件列表 |
单次符号 codedb_search PoolManager |
hit | 0.739s | 151.5 MB WS / 154.8 MB private | 符号形态 query 走 BM25 + 精确符号增强，不加载 embeddings |
单次 codedb_callers PoolManager |
hit | 0.243s | 14.2 MB WS / 7.8 MB private | callers.bin sidecar 命中；未缓存 target 第一次会走完整 caller 路径并写入 sidecar |
单次 codedb_deps PoolManager.cs |
hit | 0.303s | 34.8 MB WS / 28.3 MB private | deps.bin fast path，不反序列化完整 index |
单次业务短语 codedb_search |
hit | 0.777s | 152.1 MB WS / 154.7 MB private | BM25 候选足够时直接返回 lexical 结果，不加载 Model2Vec |
单次包含 20 个符号搜索的 codedb_bundle |
hit | 0.895s | 154.3 MB WS / 156.9 MB private | 一次进程加载 + 20 个内部符号搜索 |
单次 codedb_module_atlas 导出 |
hit | 12.355s | 471.3 MB WS / 527.9 MB private | 包含 cache-hit index load 和 atlas JSON export |
| warm module atlas 生成 | ready | 7.223s internal | 已加载状态 | 依赖连通文件图生成 1,373 个模块、16,365 个文件点 |
Java 工程 gameserver：
| 场景 | Files | Chunks | Symbols | 耗时 | 峰值内存 |
|---|---|---|---|---|---|
| 配置/model path 变更后的 cold build | 6,940 | 55,057 | 245,238 | 10.477s | 656.0 MB WS / 664.4 MB private |
| 文件和配置不变的 cache hit | 6,940 | 55,057 | 245,238 | 1.027s | 129.4 MB WS / 176.4 MB private |
多语言 smoke benchmark：C#、Java、Rust、Python、Lua、TypeScript、C、C++ 共 8 个文件，8 chunks，14 symbols，0.219s。
Rust smoke check：当前仓库 29 个索引文件，1,752 chunks，1,901 symbols；codedb_outline、codedb_search、codedb_deps 都能返回 Rust 结果。
下面的 warm MCP 工具耗时都不包含 MCP 进程启动和 index load。
对于精确文本和 regex 搜索，codedb_search regex=true 和 rg 都能回答。rg 基准使用 --no-ignore，因为这个 Unity 项目刻意包含 Library/PackageCache。
cache v18 不再常驻完整文件正文，并把大索引拆到懒加载 sidecar。大范围未限定的 regex 会按需读取源码文件，所以这种场景可能比 rg 慢；path-scoped regex、file glob、符号搜索、引用、依赖和 outline 才是 MCP 的低延迟主路径。
| 场景 | MCP tool | MCP hits | MCP avg / p95 | rg baseline | rg hits | rg avg / p95 |
|---|---|---|---|---|---|---|
Exact PoolManager |
codedb_search regex=true |
154 | 2.625s / 2.733s | rg --no-ignore -n -i -F |
154 | 1.595s / 1.754s |
Exact Joystick |
codedb_search regex=true |
938 | 2.577s / 2.590s | rg --no-ignore -n -i -F |
938 | 1.461s / 1.484s |
Exact NetworkListenerManager |
codedb_search regex=true |
14 | 2.482s / 2.494s | rg --no-ignore -n -i -F |
14 | 1.570s / 1.679s |
Exact GameObjectPoolMgr |
codedb_search regex=true |
8 | 2.556s / 2.621s | rg --no-ignore -n -i -F |
8 | 1.491s / 1.517s |
Exact AllianceManager |
codedb_search regex=true |
16 | 2.559s / 2.634s | rg --no-ignore -n -i -F |
16 | 1.669s / 1.762s |
Joystick Pack 内 scoped Joystick |
codedb_search regex=true path_glob=... |
46 | 7.342ms / 7.870ms | scoped rg --no-ignore -n -i -F |
46 | 0.133s / 0.203s |
UnityNativeTools 内 scoped NetworkListenerManager |
codedb_search regex=true path_glob=... |
14 | 7.120ms / 7.416ms | scoped rg --no-ignore -n -i -F |
14 | 0.047s / 0.050s |
| Alliance UI ranking/donation/gift regex | codedb_search regex=true path_glob=... |
176 | 14.001ms / 14.577ms | scoped rg --no-ignore -n -i |
176 | 0.097s / 0.184s |
Alliance UI .cs 文件 glob |
codedb_glob |
52 | 4.231ms / 4.254ms | rg --files --no-ignore -g |
52 | 0.045s / 0.051s |
功能对比：
| 能力 | codedb-mcp | rg |
|---|---|---|
| 原始精确 grep | 支持，codedb_search regex=true 走索引 |
支持 |
| Regex 行搜索 | 支持，限定在配置源码语料 | 支持，直接扫文件系统 |
| 路径/文件范围过滤 | 支持，path_glob、codedb_find、codedb_query |
支持，-g 和路径参数 |
| 模糊文件查找 | 支持，codedb_find 排名 |
不直接支持 |
| 符号/名称搜索 | 支持，BM25 + 精确符号增强，不加载 embeddings | 不支持 |
| 自然语言向量搜索 | 支持，BM25 + 懒加载 Model2Vec flat cosine vectors | 不支持 |
| 符号大纲 | 支持，codedb_outline 读预计算 tree-sitter symbols |
不支持 |
| 定义锚定引用查找 | 支持，codedb_callers |
不支持语义锚定 |
| 文件依赖图 | 支持，codedb_deps |
不支持 |
| 代码图分析/导出 | 支持，codedb_graph、codedb_analyze、codedb_export |
不支持 |
| 一次 MCP 请求内批量调用 | 支持，batch 参数和 codedb_bundle |
不适用 |
| 任意未索引文件/二进制/普通文本 | 不适合，只索引配置里的源码扩展 | 适合 |
MCP-only 实测能力：
| 场景 | MCP tool | 结果 | 耗时 | rg 等价能力 |
|---|---|---|---|---|
PoolManager 相关 chunk 符号感知搜索 |
codedb_search |
20 | 3.898ms | 无 |
Joystick 相关 chunk 符号感知搜索 |
codedb_search |
20 | 4.076ms | 无 |
NetworkListenerManager 相关 chunk 符号感知搜索 |
codedb_search |
20 | 3.908ms | 无 |
Assets/Scripts 下业务语义搜索：alliance member ranking donation gift |
codedb_search path_glob=... |
20 | 49.068ms | 无 |
PoolManager.cs:26 定义锚定引用 |
codedb_callers |
7 | 3.422ms | 无 |
Joystick.cs:8 定义锚定引用 |
codedb_callers |
7 | 10.854ms | 无 |
结论：rg 仍然适合临时扫任意文件；codedb-mcp 适合在配置好的源码语料上做反复、低延迟、代码感知的查询。
这些调用通过一个已经加载 index 的进程内 codedb_bundle timing=true 测量；精确 regex 搜索都用同范围的 rg --no-ignore 做了命中数校验。
| 场景 | Tool | 准确性 | avg | p95 |
|---|---|---|---|---|
scoped PoolManager exact |
codedb_search regex=true |
MCP 52 = rg 52 | 6.663ms | 7.053ms |
scoped Joystick exact |
codedb_search regex=true |
MCP 46 = rg 46 | 7.325ms | 7.784ms |
scoped NetworkListenerManager exact |
codedb_search regex=true |
MCP 14 = rg 14 | 7.348ms | 8.120ms |
PoolManager 符号感知搜索 |
codedb_search |
20 results | 3.898ms | 4.354ms |
Joystick 符号感知搜索 |
codedb_search |
20 results | 4.076ms | 4.264ms |
NetworkListenerManager 符号感知搜索 |
codedb_search |
20 results | 3.908ms | 4.458ms |
alliance member ranking donation gift |
codedb_search |
20 个 Alliance 相关结果 | 49.068ms | 51.448ms |
PoolManager refs |
codedb_callers |
7 refs | 3.422ms | 3.619ms |
Joystick refs |
codedb_callers |
7 refs | 10.854ms | 11.426ms |
GameObjectPoolMgr.cs depends_on |
codedb_deps |
7 files | 0.098ms | 0.117ms |
NetworkListenerManager.cs imported_by |
codedb_deps |
3 files | 0.076ms | 0.087ms |
NetworkListenerManager.cs transitive imported_by |
codedb_deps |
62 files | 0.149ms | 0.177ms |
NetworkListenerManager.cs path lookup |
codedb_find |
top1 correct | 20.230ms | 20.655ms |
Joystick Pack Base Joystick path lookup |
codedb_find |
top1 correct | 18.019ms | 18.311ms |
ResTypDef typo-ish lookup |
codedb_find |
ResourceTypeDefine.cs rank 3 |
19.024ms | 19.347ms |
find NetworkListenerManager -> outline |
codedb_query |
outline 存在 | 21.085ms | 21.874ms |
filter Joystick Pack -> limit 3 -> outline |
codedb_query |
outline 存在 | 6.786ms | 7.201ms |
filter UnityNativeTools -> search NetworkListenerManager |
codedb_query |
结果存在 | 9.366ms | 9.808ms |
find GameObjectPoolMgr -> search PoolManager |
codedb_query |
17 results | 25.139ms | 26.146ms |
其他工具耗时：
| Tool / 场景 | 结果 | 耗时 |
|---|---|---|
codedb_deps GameObjectPoolMgr.cs depends_on |
7 files | 0.098ms |
codedb_deps NetworkListenerManager.cs imported_by |
3 files | 0.076ms warm，首次反向依赖懒加载 132.938ms |
codedb_deps AndroidPlatform.cs depends_on |
3 files | 0.069ms |
codedb_outline NetworkListenerManager.cs |
2 symbols | 0.069ms |
codedb_outline Joystick.cs |
19 symbols | 0.069ms |
codedb_outline PoolManager.cs |
36 symbols | 0.074ms |
codedb_outline NEON_AArch64.cs |
1,116 symbols | 0.324ms |
100 次 codedb_outline compact=true |
p95 | 0.118ms |
codedb_analyze on u3dclient |
graph analysis | 首次 lazy graph build 830.637ms，之后 warm 约 36.8ms |
codedb_bundle 一次 MCP 请求最多执行 100 个内部操作；超过 100 个时只执行前 100 个并返回 truncation notice。
| 场景 | 请求内部操作数 | 重复次数 | 实际执行 | 耗时 |
|---|---|---|---|---|
| 快速 metadata/deps/outline/read 混合 bundle | 100 | 1 | 100 | 57.725ms inner sum |
| overflow bundle | 120 | 1 | 100 + truncation notice | 58.606ms inner sum |
| repeated fast bundle | 100 | 10 | 1,000 total | avg 61.005ms, p95 94.948ms inner sum |
| search/callers/deps/outline 混合 bundle | 100 | 1 | 100 | 326.347ms inner sum |
| heavy regex search bundle | 100 | 1 | 100 | 142.002s inner sum |
- 把
setup-for-agent.md交给目标 agent。 - agent 创建
<repo-root>\.codedb-mcp和<repo-root>\.codedb-mcp\models。 - Windows 上先检查默认 HuggingFace hub cache。如果
minishlab/potion-code-16M已经有有效 snapshot，配置就指向这个 snapshot。如果默认 hub 存在但模型不存在，就下载到C:\Users\<user>\.cache\huggingface\hub\codedb-mcp\models\potion-code-16M。如果默认 hub 不存在，再按盘符排序选择第二个盘符，例如D:\codedb-mcp-cache\models\potion-code-16M。 - agent 写入
<repo-root>\.codedb-mcp\codedb-mcp.tomldemo 配置，模型写绝对路径，并告诉人类当前会遍历哪些语言。 - 人类可以在第一次索引前修改
extensions、include_paths、skip_dirs和模型路径。 - agent 跑一次 index 检查。
- agent 询问人类是否要给当前特定 agent 配置 MCP；确认后才按该 agent 的方式配置。
- 重启或 reload agent MCP session，然后检查
/mcp。
MCP 命令形态：
<package-root>\skills\codedb-mcp\assets\codebase-mcp.exe --config <repo-root>\.codedb-mcp\codedb-mcp.toml mcp <repo-root>
这个项目刻意保持安装显式化：setup 只初始化项目本地文件，agent/user 决定何时、在哪里注册 MCP。
- 通过 MCP 暴露
codedb_search、codedb_callers、codedb_deps、codedb_outline、codedb_find、codedb_query、codedb_bundle、codedb_graph、codedb_communities、codedb_module_map、codedb_module_atlas等工具。 - 所有配置都来自目标项目内的
.codedb-mcp/codedb-mcp.toml，不依赖环境变量切换行为。 - 所有生成数据都放在目标项目的
.codedb-mcp目录下；删除该目录即可清理本地索引、缓存、Louvain 缓存和 DeepWiki 输出。 - 使用统一 tree-sitter 解析层支持 C#、Java、Rust、Python、Lua、JavaScript、TypeScript/TSX、C、C++。
- C#/Java 的 typed callers 和 deps 额外实现 namespace/package import、qualified name、using alias、static using、annotation、attribute suffix 等规则，准确性最强。
- 使用 Minish 生态的
model2vec-rs和显式路径配置的minishlab/potion-code-16M生成本地文件级向量。 - 使用 BM25、精确 identifier 倒排索引；符号形态 query 不加载向量，自然语言 query 才懒加载 Model2Vec 并做 flat cosine 向量检索。
- 构建 graphify 风格代码图，并对
codedb_communities懒计算 Louvain community；codedb_module_map和codedb_module_atlas是 Rust 原生模块视图，先按依赖连通文件图划分，再在连通块内做 dependency-weighted label propagation，并输出依赖内聚度、跨目录证据、语义近邻、入口点、关键符号和 c-TF-IDF-like 标签。 - MCP 模式下监听配置内的源码扩展，文件改动后 debounce 并后台重建索引。
- 显式配置层：读取
.codedb-mcp/codedb-mcp.toml，配置扫描扩展、文件大小上限、gitignore 行为、include paths、skip dirs、embedding 模型、watch 和 storage。 - 本地存储层：索引 payload、manifest、Louvain cache、DeepWiki 证据和文档都写入
.codedb-mcp。数据跟随项目目录，不写全局数据库。 - 扫描层：基于配置遍历代码库，读取项目内
.gitignore，但目标 root 下的嵌套 Git worktree/submodule 会作为普通源码目录继续索引。Unity 项目中可以跳过大部分Library，同时显式包含Library/PackageCache。 - 语言解析层：所有语言统一走 tree-sitter grammar，输出同一套
FileEntry和Symbol结构。当前支持 C#、Java、Rust、Python、Lua、JavaScript、TypeScript/TSX、C、C++，解析时只遍历声明层，避免大型方法体拖慢索引。 - 代码语义增强层：C#/Java 上继续做 namespace/package import、别名、静态 using、注解、属性后缀、限定名引用等轻量语义推断；Lua 会抽取
require()并生成轻量文件依赖。 - 搜索索引层：构建 chunks、identifier word hits、symbol definition chunks、BM25 和 Model2Vec file embeddings。符号形态 query 走词法/符号增强；自然语言 query 才懒加载 embeddings 并做 flat cosine 向量检索。
- 内存友好缓存层：cache v18 吸收
justrach/codedb的 bounded content cache 思路：完整文件正文、chunk 预览正文、重复 chunk 文件路径、重复 language/kind 字符串、BM25 postings、word-index hits、caller 结果、embeddings、正向/反向依赖、graph 对象和 Louvain 结果都不再默认常驻。工具需要时再按需读取精确行、postings、word hits、caller sidecar、embedding、依赖或图数据。 - 依赖与图层：graphify 风格代码图懒构建。小仓库保留 file、namespace/package、symbol、dependency、reference 等节点和边；大仓库只有 graph/community/module 工具会触发 graph 构建，symbol 数据仍保留在 outline/search/callers 专用索引；Louvain community 懒加载并缓存。
- 模块 atlas 层：
codedb_module_map和codedb_module_atlas在 Rust 里运行。它们先按依赖图弱连通分量切开文件，再在每个连通块内部做依赖加权 label propagation。路径和 token 只用于命名、证据展示和过大连通块拆分，不作为主要聚类依据。codedb_module_atlas导出 Embedding Atlas 可视化数据。 - MCP 工具层：基于 Rust
rmcpSDK 的 stdio server 实现；工具运行在 warm in-process index 上，支持 batch 和 bundle，减少 MCP 往返成本。 - Setup guide 和 Skill 打包层：
setup-for-agent.md负责安装指导。skills/codedb-mcp只负责工具使用，内含最新codebase-mcp.exe、配置模板、MCP 注册参考和工具说明。skills/code-module-atlas调用codedb_module_atlas，并打包本地 meet-blog 风格的模块/文件图网页。
默认配置路径：
<repo-root>/.codedb-mcp/codedb-mcp.toml
关键配置：
[scan]
extensions = ["cs", "java", "rs", "py", "pyw", "lua", "js", "jsx", "mjs", "cjs", "ts", "tsx", "c", "h", "cc", "cpp", "cxx", "hpp", "hh", "hxx"]
max_file_bytes = 50000000
respect_gitignore = true
include_paths = ["Library/PackageCache"]
[embedding]
model = "C:/Users/<user>/.cache/huggingface/hub/codedb-mcp/models/potion-code-16M"
[storage]
enabled = true
dir = ".codedb-mcp"include_paths 会覆盖被跳过的父目录，例如 Unity 项目中可以跳过 Library，但保留 Library/PackageCache。respect_gitignore=true 会读取项目内 .gitignore，但目标 root 下的嵌套 Git worktree/submodule 仍会被当作源码目录索引，除非被 skip_dirs 或扩展名规则排除。模型路径是显式绝对路径；Windows setup 会优先复用默认 HuggingFace cache，不存在时才走第二盘符。
cargo build --release直接启动 MCP：
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml mcp u3dclientCLI 快速检查：
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml index u3dclient
target\release\codebase-mcp.exe --config u3dclient\.codedb-mcp\codedb-mcp.toml --root u3dclient tool codedb_status "{}"MCP 模式会先完成协议握手，再在后台构建默认项目索引；如果索引还没完成，早期工具调用会等待首次构建结束。文件监听默认开启，源码变更后会 debounce 并后台重建索引。
| Tool | 用途 |
|---|---|
codedb_search |
混合搜索或 regex 行搜索；支持 queries batch |
codedb_callers |
LSP-like 引用查找；支持 definition path/line 锚定和 targets batch |
codedb_deps |
文件依赖和反向依赖；支持 transitive |
codedb_outline |
返回预计算符号大纲，不在请求时重新 parse |
codedb_symbol |
按符号名找定义 |
codedb_word |
精确 identifier 倒排索引查询 |
codedb_find |
模糊文件名/路径查找 |
codedb_query |
find/search/filter/limit/outline 小型 pipeline |
codedb_bundle |
一次 MCP 请求里执行最多 100 个工具调用 |
codedb_graph |
图摘要或导出 |
codedb_communities |
懒计算 Louvain community/subcommunity |
codedb_module_map |
DeepWiki 模块规划 atlas：依赖内聚度、跨目录证据、入口点、关键符号、语义近邻和 c-TF-IDF-like 标签 |
codedb_module_atlas |
导出 module/file atlas JSON，供 skills/code-module-atlas 生成网页 |
codedb_analyze |
图统计、top nodes、关系计数、建议问题 |
codedb_hot |
最近修改的索引文件 |
codedb_status |
索引健康状态和统计 |
skills/ 目录可以作为独立包复制。
setup-for-agent.md：给 agent 用的安装指导，Windows 上优先复用默认 HuggingFace cache，不存在时才选择第二个盘符，并写入带绝对模型路径的项目本地配置。skills/codedb-mcp：包含assets/codebase-mcp.exe、配置模板、MCP 注册参考和工具使用建议；不负责安装。skills/deepwiki：使用本地codedb_*工具和当前 agent 的推理能力生成 DeepWiki-style 文档，强调业务模块边界，而不是只按文件夹或 community 分组。skills/code-module-atlas：调用codedb_module_atlas生成本地 3D 模块/文件 atlas 网页；项目特定 JSON 是生成物，不提交。
- 推荐发布时带上
setup-for-agent.md和整个skills/目录；先由 setup guide 初始化项目，再按需安装/使用 skill。 .codedb-mcp/index.bin、.codedb-mcp/manifest.json、.codedb-mcp/*.bin是项目本地生成物，不建议提交。- 旧
.codebase-mcp名称已经迁移为.codedb-mcp；配置文件名也统一为codedb-mcp.toml。
- meet-blog.buyixiao.xyz 启发了 Code Module Atlas 的视觉风格和 viewer 体验。
- justrach/codedb 启发了最初的 MCP 工具接口方向。