diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 1c1569b..f14a391 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -55,7 +55,7 @@ jobs:
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2
         with:
-          workspaces: "codebase"
+          workspaces: "codexray"
           key: ${{ matrix.target }}
 
       - name: Install protoc
@@ -70,8 +70,8 @@ jobs:
           go-version-file: "go.mod"
           cache: true
 
-      - name: Build Rust codebase (${{ matrix.target }})
-        working-directory: codebase
+      - name: Build Rust codexray (${{ matrix.target }})
+        working-directory: codexray
         run: cargo build --release --target ${{ matrix.target }}
         env:
           CC_x86_64_apple_darwin: clang -arch x86_64
@@ -83,8 +83,8 @@ jobs:
 
           mkdir -p dist/bin
 
-          # Copy codeactor-codebase built from Rust
-          cp codebase/target/${{ matrix.target }}/release/codeactor-codebase dist/bin/
+          # Copy codeactor-codexray built from Rust
+          cp codexray/target/${{ matrix.target }}/release/codeactor-codexray dist/bin/
           
           # Download and extract fzf
           echo "Downloading fzf from ${{ matrix.fzf_url }}"
@@ -102,7 +102,7 @@ jobs:
           rm -rf /tmp/rg_extract /tmp/rg.tar.gz
 
           # Set executable permissions
-          chmod +x dist/bin/codeactor-codebase dist/bin/fzf dist/bin/rg
+          chmod +x dist/bin/codeactor-codexray dist/bin/fzf dist/bin/rg
 
           # Verify
           ls -la dist/bin/
@@ -151,7 +151,7 @@ jobs:
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2
         with:
-          workspaces: "codebase"
+          workspaces: "codexray"
           key: musl
 
       - name: Install protoc
@@ -166,8 +166,8 @@ jobs:
           go-version-file: "go.mod"
           cache: true
 
-      - name: Build Rust codebase (static musl)
-        working-directory: codebase
+      - name: Build Rust codexray (static musl)
+        working-directory: codexray
         run: |
           export CC_x86_64_unknown_linux_musl=musl-gcc
           export CXX_x86_64_unknown_linux_musl=musl-g++
@@ -178,8 +178,8 @@ jobs:
           set -euo pipefail
           mkdir -p dist/bin
 
-          # Copy codeactor-codebase (musl static)
-          cp codebase/target/x86_64-unknown-linux-musl/release/codeactor-codebase dist/bin/
+          # Copy codeactor-codexray (musl static)
+          cp codexray/target/x86_64-unknown-linux-musl/release/codeactor-codexray dist/bin/
 
           # Download fzf
           echo "Downloading fzf..."
@@ -196,7 +196,7 @@ jobs:
           find /tmp/rg_extract -name rg -type f -exec mv {} dist/bin/rg \;
           rm -rf /tmp/rg_extract /tmp/rg.tar.gz
 
-          chmod +x dist/bin/codeactor-codebase dist/bin/fzf dist/bin/rg
+          chmod +x dist/bin/codeactor-codexray dist/bin/fzf dist/bin/rg
           ls -la dist/bin/
 
       - name: Build Go codeactor (linux-x64-musl)
@@ -213,14 +213,14 @@ jobs:
       - name: Verify static linking
         run: |
           echo "=== Verifying static linking ==="
-          file dist/bin/codeactor-codebase
+          file dist/bin/codeactor-codexray
           echo ""
           echo "=== Checking for dynamic symbols ==="
           if command -v readelf &> /dev/null; then
-            readelf -d dist/bin/codeactor-codebase 2>&1 | head -20 || echo "(no dynamic section = fully static)"
+            readelf -d dist/bin/codeactor-codexray 2>&1 | head -20 || echo "(no dynamic section = fully static)"
           fi
           if command -v ldd &> /dev/null; then
-            ldd dist/bin/codeactor-codebase 2>&1 | head -10 || true
+            ldd dist/bin/codeactor-codexray 2>&1 | head -10 || true
           fi
 
       - name: Verify artifact
diff --git a/.gitignore b/.gitignore
index e180a09..479f94a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,4 +42,4 @@ go.work.sum
 # .idea/
 # .vscode/
 codeactor
-codebase/config/config.toml
+codexray/config/config.toml
diff --git a/CLAUDE.md b/CLAUDE.md
index 5319e9d..2c13c49 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -39,14 +39,14 @@ Server defaults to `localhost:9080`. Override via `--host`/`--port` or `CODECACT
 - **LLM**: `github.com/openai/openai-go/v3` (multi-provider: OpenAI-compatible, Bedrock)
 - **HTTP/WS**: `gin-gonic/gin` + `olahol/melody`
 - **TUI**: Bubble Tea
-- **External**: `codeactor-codebase` (Rust, `127.0.0.1:12800`) — semantic search, repo investigation, call graph, code skeleton/snippet. See [Codebase Component](#codebase-component) below.
+- **External**: `codeactor-codexray` (Rust, `127.0.0.1:12800`) — semantic search, repo investigation, call graph, code skeleton/snippet. See [Codexray Component](#codexray-component) below.
 - **System deps**: `ripgrep` (rg), `fzf`
 
 ## Project Structure
 
 ```
 codeactor-agent/
-├── main.go                      # Entry point, CLI parsing, start codebase service
+├── main.go                      # Entry point, CLI parsing, start codexray service
 ├── internal/
 │   ├── app/
 │   │   └── app.go               # CodeActor: agent orchestration & init
@@ -131,9 +131,9 @@ codeactor-agent/
 │   ├── memory/                  # ConversationMemory (system/human/assistant/tool)
 │   ├── config/                  # Three-tier TOML config (tools > agents > global)
 │   ├── diff/                    # Unified diff computation
-│   ├── embedbin/                # Embed Rust codebase binary
+│   ├── embedbin/                # Embed Rust codexray binary
 │   ├── datamanager/             # Task persistence (~/.codeactor/tasks/)
-│   ├── globalctx/               # Global context (CodebaseURL, tool references)
+│   ├── globalctx/               # Global context (CodexrayURL, tool references)
 │   └── util/                    # Error handling, crash recovery
 ├── pkg/messaging/               # Pub-Sub message bus
 │   ├── message_event.go         # MessageEvent definition
@@ -158,28 +158,28 @@ codeactor-agent/
 6. **Context compression**: Multi-strategy (conservative/balanced/aggressive) context compression with priority-based message selection and LLM summarization to handle long conversations.
 7. **WorkspaceGuard**: All file operations and bash commands are validated against workspace boundaries. Dangerous operations require user confirmation via Pub-Sub confirmation pipeline.
 
-## Codebase Component
+## Codexray Component
 
-`codeactor-codebase` is a standalone **Rust** service that provides deep code analysis capabilities. It runs as a background HTTP server on `127.0.0.1:12800` (configurable via `config.toml` `[http] codebase_port`).
+`codeactor-codexray` is a standalone **Rust** service that provides deep code analysis capabilities. It runs as a background HTTP server on `127.0.0.1:12800` (configurable via `config.toml` `[http] codexray_port`).
 
 ### Build & Run
 
 ```bash
-cd codebase && cargo build --release
+cd codexray && cargo build --release
 
 # Start with target repo
-./target/release/codeactor-codebase server --repo-path /path/to/project
+./target/release/codeactor-codexray server --repo-path /path/to/project
 
 # Custom address
-./target/release/codeactor-codebase server --repo-path /path/to/project --address 0.0.0.0:8080
+./target/release/codeactor-codexray server --repo-path /path/to/project --address 0.0.0.0:8080
 ```
 
-The Go binary automatically launches `~/.codeactor/bin/codeactor-codebase` as a background process on startup (`main.go:startCodebaseServer()`). Logs go to `~/.codeactor/logs/codeactor-codebase/{date}.log`.
+The Go binary automatically launches `~/.codeactor/bin/codeactor-codexray` as a background process on startup (`main.go:startCodexrayServer()`). Logs go to `~/.codeactor/logs/codeactor-codexray/{date}.log`.
 
 ### Architecture (Rust side)
 
 ```
-codebase/src/
+codexray/src/
 ├── main.rs              # CLI entry: server / vectorize subcommands
 ├── config.rs            # Config loading from ~/.codeactor/config/config.toml
 ├── codegraph/           # AST parsing + graph data structures
@@ -214,7 +214,7 @@ Core design: **single repo per process** — binds to one repo at startup via `-
 
 ### Embedding & Vector Search
 
-The codebase service supports semantic code search via vector embeddings:
+The codexray service supports semantic code search via vector embeddings:
 - **Embedding model**: Configurable (default: `text-embedding-3-small`, 1536 dimensions)
 - **Vector store**: LanceDB for vector indexing
 - **Cache**: SQLite for embedding cache (avoids re-embedding unchanged code)
@@ -225,9 +225,9 @@ The codebase service supports semantic code search via vector embeddings:
 
 | Layer | File | Usage |
 |-------|------|-------|
-| Startup | `main.go:216-257` | `startCodebaseServer()` launches the Rust binary as a background process |
-| Global state | `internal/globalctx/global_context.go:20,31` | `CodebaseURL` field + `RepoOps *RepoOperationsTool` |
-| Initialization | `internal/app/app.go:62,73` | Sets `CodebaseURL=http://127.0.0.1:12800`, creates `RepoOperationsTool` |
+| Startup | `main.go:216-257` | `startCodexrayServer()` launches the Rust binary as a background process |
+| Global state | `internal/globalctx/global_context.go:20,31` | `CodexrayURL` field + `RepoOps *RepoOperationsTool` |
+| Initialization | `internal/app/app.go:62,73` | Sets `CodexrayURL=http://127.0.0.1:12800`, creates `RepoOperationsTool` |
 | Tool wrapper | `internal/tools/repo_operations.go` | `RepoOperationsTool` with 3 methods: `ExecuteSemanticSearch`, `ExecuteQueryCodeSkeleton`, `ExecuteQueryCodeSnippet` |
 | RepoAgent | `internal/agents/repo.go:105-139` | `doPreInvestigate()` calls `POST /investigate_repo` before each Run |
 | Tool routing | `internal/agents/conductor.go:298-303`, `coding.go:59-63`, `repo.go:75-79` | Routes `semantic_search`/`query_code_skeleton`/`query_code_snippet` to `RepoOps` |
@@ -236,15 +236,15 @@ The codebase service supports semantic code search via vector embeddings:
 
 ```toml
 [http]
-codebase_port = 12800
+codexray_port = 12800
 
-[codebase]
+[codexray]
 enable_embedding = true
 # 数据目录自动生成在 $HOME/.codeactor/data/
 # embedding/ — 全局共享索引（BM25 + LanceDB 向量库）
 # graph/     — 项目隔离数据（按 project_id 分目录）
 
-[codebase.embedding]
+[codexray.embedding]
 model = "text-embedding-3-small"
 api_token = "sk-..."
 api_base_url = "https://api.openai.com/v1"
diff --git a/CODEACTOR.md b/CODEACTOR.md
index 3305b99..7ed8936 100644
--- a/CODEACTOR.md
+++ b/CODEACTOR.md
@@ -63,7 +63,7 @@
 | 类别 | 技术 | 版本 | 用途 |
 |------|------|------|------|
 | **主程序** | Go | 1.24+ | 核心实现语言，模块名 `codeactor` |
-| **代码引擎** | Rust | 1.70+ (Tokio) | `codeactor-codebase` 服务，运行在 `127.0.0.1:12800` |
+| **代码引擎** | Rust | 1.70+ (Tokio) | `codeactor-codexray` 服务，运行在 `127.0.0.1:12800` |
 | **LLM 抽象层** | `github.com/openai/openai-go/v3` | - | 多 LLM 提供商的统一接口 (OpenAI-compatible) |
 | **HTTP 框架** | `gin-gonic/gin` | - | REST API 服务器 |
 | **WebSocket** | `olahol/melody` | - | WebSocket 连接管理 |
@@ -73,7 +73,7 @@
 
 | 依赖 | 用途 |
 |------|------|
-| `codeactor-codebase` (Rust) | 代码分析服务（语义搜索、骨架提取、依赖分析） |
+| `codeactor-codexray` (Rust) | 代码分析服务（语义搜索、骨架提取、依赖分析） |
 | `ripgrep` (rg) | 全文正则搜索 |
 | `fzf` | 模糊文件搜索 |
 
@@ -138,7 +138,7 @@
 | `print_dir_tree` | 文件 | 打印目录树 |
 | `search_replace_in_file` | 编辑 | 精准代码块替换 |
 | `search_by_regex` | 搜索 | ripgrep 全文正则搜索 |
-| `semantic_search` | 仓库 | 语义搜索（调用 codebase 服务） |
+| `semantic_search` | 仓库 | 语义搜索（调用 codexray 服务） |
 | `query_code_skeleton` | 仓库 | 查询代码骨架 |
 | `query_code_snippet` | 仓库 | 查询函数实现 |
 | `run_bash` | 系统 | 执行 Shell 命令 |
@@ -166,7 +166,7 @@
 | `search_by_regex` | 搜索 | ripgrep 全文正则搜索 |
 | `list_dir` | 文件 | 列出目录内容 |
 | `print_dir_tree` | 文件 | 打印目录树 |
-| `semantic_search` | 仓库 | 语义搜索（调用 codebase 服务） |
+| `semantic_search` | 仓库 | 语义搜索（调用 codexray 服务） |
 | `query_code_skeleton` | 仓库 | 查询代码骨架 |
 | `query_code_snippet` | 仓库 | 查询函数实现 |
 
@@ -268,7 +268,7 @@ type ExecutorConfig struct {
 | `print_dir_tree` | 文件 | R | 打印目录树 |
 | `search_replace_in_file` | 编辑 | E | 精准代码块替换 |
 | `search_by_regex` | 搜索 | R | ripgrep 全文正则搜索 |
-| `semantic_search` | 仓库 | R | 语义搜索（调用 codebase 服务） |
+| `semantic_search` | 仓库 | R | 语义搜索（调用 codexray 服务） |
 | `query_code_skeleton` | 仓库 | R | 查询代码骨架 |
 | `query_code_snippet` | 仓库 | R | 查询函数实现 |
 | `run_bash` | 系统 | S | 执行 Shell 命令 |
@@ -331,7 +331,7 @@ search_by_regex(
 #### semantic_search
 
 ```go
-// 调用 codebase Rust 服务进行语义搜索
+// 调用 codexray Rust 服务进行语义搜索
 semantic_search(
     query: string,         // 自然语言或代码片段
     limit: int             // 返回结果数量上限
@@ -461,7 +461,7 @@ Agent → MessagePublisher → MessageDispatcher → TUIConsumer / WebSocketCons
 ```
 1. 用户输入 (TUI 或 HTTP POST /api/start_task)
 2. TaskManager.CreateTask() - 生成 UUID，创建 Memory
-3. ExecuteTask() - 初始化 codebase 索引，启动消息分发
+3. ExecuteTask() - 初始化 codexray 索引，启动消息分发
 4. ConductorAgent.Run() - 进入循环
 5. Conductor 循环 (最多 maxSteps 步):
    ├── 构造 messages: [SystemPrompt, ...Memory.Messages]
@@ -505,7 +505,7 @@ codeactor-agent/
 │   ├── config/                # 配置加载
 │   ├── datamanager/           # 数据存储
 │   ├── diff/                  # 差异计算 (unified diff)
-│   ├── embedbin/              # 嵌入二进制 (Rust codebase 服务)
+│   ├── embedbin/              # 嵌入二进制 (Rust codexray 服务)
 │   ├── globalctx/             # 全局上下文
 │   ├── http/                  # HTTP API
 │   ├── llm/                   # LLM 抽象层
@@ -528,7 +528,7 @@ codeactor-agent/
 │   ├── tui/                   # 终端界面
 │   └── util/                  # 工具函数
 ├── pkg/messaging/             # 消息总线
-├── codebase/                  # Rust 代码引擎 (独立二进制)
+├── codexray/                  # Rust 代码引擎 (独立二进制)
 │   ├── src/
 │   │   ├── codegraph/         # AST 解析 + 调用图 (tree-sitter, petgraph)
 │   │   ├── http/              # Axum HTTP 服务
@@ -553,8 +553,8 @@ codeactor-agent/
 # 构建主程序
 go build -o codeactor .
 
-# 构建 Rust codebase 服务
-cd codebase && cargo build --release
+# 构建 Rust codexray 服务
+cd codexray && cargo build --release
 ```
 
 ### 6.2 运行模式
@@ -646,7 +646,7 @@ thinking.use_provider = "xiaomi"
 |------|------|
 | 任务 Memory | `~/.codeactor/tasks/{taskID}.json` |
 | LLM 日志 | `~/.codeactor/logs/llm-{date}.log` |
-| Codebase 日志 | `~/.codeactor/logs/codeactor-codebase/{date}.log` |
+| Codexray 日志 | `~/.codeactor/logs/codeactor-codexray/{date}.log` |
 
 ---
 
@@ -759,7 +759,7 @@ Thought Process:
 | `internal/tools/` | 工具适配器 |
 | `internal/memory/` | 任务记忆管理 |
 | `pkg/messaging/` | Pub-Sub 消息总线 |
-| `codebase/` | Rust 代码引擎 |
+| `codexray/` | Rust 代码引擎 |
 | `clients/nodejs-cli/` | Node.js CLI 客户端 |
 | `config/config.toml` | 示例配置文件 |
 | `docs/` | 补充文档 |
@@ -772,7 +772,7 @@ go build -o codeactor .          # 构建
 ./codeactor tui                  # TUI 模式
 ./codeactor http                 # HTTP 模式
 go test ./internal/... -v -count=1  # 测试
-cd codebase && cargo build       # Rust 构建
+cd codexray && cargo build       # Rust 构建
 ```
 
 ### C. 安全机制
diff --git a/README.md b/README.md
index fbb5643..6724fe7 100644
--- a/README.md
+++ b/README.md
@@ -134,7 +134,7 @@ User Query
 
 ### Download Pre-built Binary (Recommended)
 
-Download the latest all-in-one release for your platform from the [GitHub Releases page](https://github.com/iohub/codeactor-agent/releases). The binary bundles the **codebase intelligence engine** (Rust), **fzf** (fuzzy finder), and **ripgrep** (regex search) — everything you need is included. Just extract and run `./codeactor` — zero dependencies, zero configuration.
+Download the latest all-in-one release for your platform from the [GitHub Releases page](https://github.com/iohub/codeactor-agent/releases). The binary bundles the **codexray intelligence engine** (Rust), **fzf** (fuzzy finder), and **ripgrep** (regex search) — everything you need is included. Just extract and run `./codeactor` — zero dependencies, zero configuration.
 
 ### Prerequisites (for building from source)
 - Go 1.24+
diff --git a/README_zh.md b/README_zh.md
index fa1fadd..9783c60 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -134,7 +134,7 @@
 
 ### 下载预编译包（推荐）
 
-从 [GitHub Releases 页面](https://github.com/iohub/codeactor-agent/releases) 下载最新的 all-in-one 二进制包。包内已集成 **codebase 代码智能引擎**（Rust）、**fzf**（模糊搜索）和 **ripgrep**（正则搜索）——所有依赖一应俱全。解压后直接运行 `./codeactor`，零依赖、零配置，开箱即用。
+从 [GitHub Releases 页面](https://github.com/iohub/codeactor-agent/releases) 下载最新的 all-in-one 二进制包。包内已集成 **codexray 代码智能引擎**（Rust）、**fzf**（模糊搜索）和 **ripgrep**（正则搜索）——所有依赖一应俱全。解压后直接运行 `./codeactor`，零依赖、零配置，开箱即用。
 
 ### 前置要求（从源码编译）
 - Go 1.24+
diff --git a/build.sh b/build.sh
index 54744fd..fccf313 100755
--- a/build.sh
+++ b/build.sh
@@ -25,11 +25,11 @@ set -euo pipefail
 readonly SCRIPT_NAME="$(basename "$0")"
 readonly SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 readonly DIST_DIR="${SCRIPT_DIR}/dist/bin"
-readonly RUST_PROJECT_DIR="${SCRIPT_DIR}/codebase"
+readonly RUST_PROJECT_DIR="${SCRIPT_DIR}/codexray"
 readonly GO_PROJECT_DIR="${SCRIPT_DIR}"
 
 # 产物名称
-readonly RUST_BIN="codeactor-codebase"
+readonly RUST_BIN="codeactor-codexray"
 readonly GO_BIN="codeactor"
 
 # 保留的文件模式（不清理的文件）
@@ -222,7 +222,7 @@ build_rust() {
     cd "$RUST_PROJECT_DIR"
     start_time=$(date +%s%N)
     
-    local cargo_flags="-p codeactor-codebase"
+    local cargo_flags="-p codeactor-codexray"
     cargo_flags+=" --manifest-path ${RUST_PROJECT_DIR}/Cargo.toml"
     if [[ "${BUILD_TYPE}" == "release" ]]; then
         cargo_flags+=" --release"
@@ -400,7 +400,7 @@ ${BOLD}示例:${RESET}
   DEBUG=1 ${SCRIPT_NAME}            # 显示调试信息
 
 ${BOLD}产物:${RESET}
-  dist/bin/codeactor-codebase    # Rust 子项目产物
+  dist/bin/codeactor-codexray    # Rust 子项目产物
   ./codeactor                    # Go 主项目产物
 
 EOF
@@ -485,7 +485,7 @@ cmd_build() {
     # 先构建 Rust（除非跳过）
     if [[ "${SKIP_RUST}" != "true" ]]; then
         # 只在构建 Rust 前清理
-        log_info "building codebase"
+        log_info "building codexray"
         build_rust || exit 1
     else
         log_warning "⊘ 跳过 Rust 构建 (SKIP_RUST=true)"
diff --git a/codebase/.gitignore b/codexray/.gitignore
similarity index 100%
rename from codebase/.gitignore
rename to codexray/.gitignore
diff --git a/codebase/CLAUDE.md b/codexray/CLAUDE.md
similarity index 94%
rename from codebase/CLAUDE.md
rename to codexray/CLAUDE.md
index 862f602..c40d21d 100644
--- a/codebase/CLAUDE.md
+++ b/codexray/CLAUDE.md
@@ -48,7 +48,7 @@ src/
 │   ├── incremental.rs   # MD5-based incremental file change detection
 │   └── mod.rs           # StorageManager: central hub (graph, watchers, tasks, config, current_repo)
 ├── http/                # Axum HTTP server
-│   ├── server.rs        # CodeBaseServer: startup init + router
+│   ├── server.rs        # CodeXRayServer: startup init + router
 │   ├── handlers/        # Request handlers (query, search, investigate, embed)
 │   └── models/          # Request/response types + ApiResponse<T>
 └── config/              # Config file template
@@ -63,7 +63,7 @@ The process binds to exactly one repository at startup via `--repo-path`. `Stora
 - **`StorageManager`** — Central state: in-memory graph, persistence, file watchers, embedding tasks, config, current repo binding
 - **`PetCodeGraph`** — petgraph `DiGraph<FunctionInfo, CallRelation>` with query methods (`get_callers`, `get_callees`, `find_functions_by_name`, `find_functions_by_file`)
 - **`CodeAnalyzer`** — Wraps `CodeParser`, runs full directory analysis, provides analysis methods
-- **`CodeBaseServer`** — Axum server; `start()` auto-inits (load/analyze graph + embed + watch) before binding port
+- **`CodeXRayServer`** — Axum server; `start()` auto-inits (load/analyze graph + embed + watch) before binding port
 - **`EmbeddingService`** — LanceDB-backed; per-repo tables named `{last_dir}_{md5(repo_path)}`; batch embedding with SQLite cache; incremental via `projects.json` file hashes
 - **`PersistenceManager`** — File-based graph persistence in `.codegraph_db/{project_id}/`
 
@@ -88,9 +88,9 @@ All handlers use `State<Arc<StorageManager>>` for shared state. Response type is
 
 Config file at `~/.codeactor/config/config.toml`. Key sections:
 
-- `[http]` — `server_port`, `codebase_port` (default 12800)
-- `[codebase]` — `enable_embedding`
-- `[codebase.embedding]` — `model`, `api_token`, `api_base_url`, `dimensions`
+- `[http]` — `server_port`, `codexray_port` (default 12800)
+- `[codexray]` — `enable_embedding`
+- `[codexray.embedding]` — `model`, `api_token`, `api_base_url`, `dimensions`
 
 ## File Watching
 
diff --git a/codebase/Cargo.lock b/codexray/Cargo.lock
similarity index 99%
rename from codebase/Cargo.lock
rename to codexray/Cargo.lock
index 0244257..f771dbe 100644
--- a/codebase/Cargo.lock
+++ b/codexray/Cargo.lock
@@ -1185,7 +1185,7 @@ dependencies = [
 ]
 
 [[package]]
-name = "codeactor-codebase"
+name = "codeactor-codexray"
 version = "0.1.0"
 dependencies = [
  "anyhow",
diff --git a/codebase/Cargo.toml b/codexray/Cargo.toml
similarity index 98%
rename from codebase/Cargo.toml
rename to codexray/Cargo.toml
index 0d0e994..b613128 100644
--- a/codebase/Cargo.toml
+++ b/codexray/Cargo.toml
@@ -1,5 +1,5 @@
 [package]
-name = "codeactor-codebase"
+name = "codeactor-codexray"
 version = "0.1.0"
 edition = "2021"
 
diff --git a/codebase/LICENSE b/codexray/LICENSE
similarity index 100%
rename from codebase/LICENSE
rename to codexray/LICENSE
diff --git a/codebase/README.md b/codexray/README.md
similarity index 98%
rename from codebase/README.md
rename to codexray/README.md
index f844519..ba2e723 100644
--- a/codebase/README.md
+++ b/codexray/README.md
@@ -2,7 +2,7 @@
   <img src="assets/logo.png" alt="CodeActor Logo" width="120"/>
 </p>
 
-<h1 align="center">CodeActor Codebase</h1>
+<h1 align="center">CodeActor CodeXRay</h1>
 
 <p align="center">
   <b>A Dual-Engine Code Intelligence & Retrieval System</b> <br>
@@ -21,7 +21,7 @@
 
 ## 🔥 Overview
 
-**CodeActor Codebase** is a high-performance code intelligence and retrieval system built with **Rust**. Think of it as a **CT scan for your codebase** — it doesn't just parse your source code; it builds a complete **function call graph** AND a **semantic vector index**, then fuses them together through a sophisticated hybrid retrieval pipeline.
+**CodeActor CodeXRay** is a high-performance code intelligence and retrieval system built with **Rust**. Think of it as a **CT scan for your codebase** — it doesn't just parse your source code; it builds a complete **function call graph** AND a **semantic vector index**, then fuses them together through a sophisticated hybrid retrieval pipeline.
 
 > 🎯 **Core Value**: Transform your chaotic codebase into a navigable, searchable, and machine-understandable knowledge graph.
 
@@ -123,7 +123,7 @@ sequenceDiagram
 
 ```bash
 git clone <your-repo-url>
-cd codeactor-agent/codebase
+cd codeactor-agent/codexray
 cargo build --release
 ```
 
@@ -241,16 +241,16 @@ Configuration file at `~/.codeactor/config/config.toml`:
 [http]
 server_port = 12800
 
-[codebase]
+[codexray]
 enable_embedding = true
 
-[codebase.embedding]
+[codexray.embedding]
 model = "Qwen/Qwen3-Embedding-4B"
 api_token = "sk-..."
 api_base_url = "https://api.siliconflow.cn/v1"
 dimensions = 2560
 
-[codebase.retrieval_pipeline]
+[codexray.retrieval_pipeline]
 enable_sparse = true              # Enable BM25 full-text search
 sparse_search_limit_factor = 2    # Sparse search amplification factor
 short_code_threshold = 30         # Short code penalty threshold (chars)
@@ -302,7 +302,7 @@ src/
 │   ├── incremental.rs   # MD5 incremental change detection
 │   └── tantivy_index.rs       # BM25 full-text search index
 └── http/                # HTTP service layer
-    ├── server.rs        # CodeBaseServer: startup + routes
+    ├── server.rs        # CodeXRayServer: startup + routes
     ├── handlers/        # Request handlers (query / search / investigate / embed)
     └── models/          # Request/response data structures
 ```
diff --git a/codebase/README_ZH.md b/codexray/README_ZH.md
similarity index 97%
rename from codebase/README_ZH.md
rename to codexray/README_ZH.md
index dbeacce..9a24d21 100644
--- a/codebase/README_ZH.md
+++ b/codexray/README_ZH.md
@@ -2,7 +2,7 @@
   <img src="assets/logo.png" alt="CodeActor Logo" width="120"/>
 </p>
 
-<h1 align="center">CodeActor Codebase</h1>
+<h1 align="center">CodeActor CodeXRay</h1>
 
 <p align="center">
   <b>融合代码图与语义向量的双引擎代码智能检索系统</b> <br>
@@ -21,7 +21,7 @@
 
 ## 🔥 项目简介
 
-**CodeActor Codebase** 是一个用 **Rust** 构建的双引擎代码智能检索系统。它不仅像一张「代码的 CT 扫描图」——深入解析 AST 构建函数调用图谱，还同时为代码建立**语义向量索引**，让你可以用自然语言搜索代码，并通过**混合检索流水线**将图遍历、向量搜索、BM25 关键词匹配融合为精准结果。
+**CodeActor CodeXRay** 是一个用 **Rust** 构建的双引擎代码智能检索系统。它不仅像一张「代码的 CT 扫描图」——深入解析 AST 构建函数调用图谱，还同时为代码建立**语义向量索引**，让你可以用自然语言搜索代码，并通过**混合检索流水线**将图遍历、向量搜索、BM25 关键词匹配融合为精准结果。
 
 > 🎯 **核心价值**：将混乱的代码仓库变为可导航、可搜索、可理解的知识图谱
 
@@ -123,7 +123,7 @@ sequenceDiagram
 
 ```bash
 git clone <your-repo-url>
-cd codeactor-agent/codebase
+cd codeactor-agent/codexray
 cargo build --release
 ```
 
@@ -225,16 +225,16 @@ curl -X POST http://localhost:12800/query_call_graph \
 [http]
 server_port = 12800
 
-[codebase]
+[codexray]
 enable_embedding = true
 
-[codebase.embedding]
+[codexray.embedding]
 model = "Qwen/Qwen3-Embedding-4B"
 api_token = "sk-..."
 api_base_url = "https://api.siliconflow.cn/v1"
 dimensions = 2560
 
-[codebase.retrieval_pipeline]
+[codexray.retrieval_pipeline]
 enable_sparse = true              # 启用 BM25 全文搜索
 sparse_search_limit_factor = 2    # 稀疏搜索放大系数
 short_code_threshold = 30         # 短代码惩罚阈值
@@ -286,7 +286,7 @@ src/
 │   ├── incremental.rs   # MD5 增量变更检测
 │   └── tantivy_index.rs       # BM25 全文搜索索引
 └── http/                # HTTP 服务层
-    ├── server.rs        # CodeBaseServer：启动 + 路由
+    ├── server.rs        # CodeXRayServer：启动 + 路由
     ├── handlers/        # 请求处理（query / search / investigate / embed）
     └── models/          # 请求/响应数据结构
 ```
diff --git a/codebase/build.rs b/codexray/build.rs
similarity index 100%
rename from codebase/build.rs
rename to codexray/build.rs
diff --git a/codebase/src/cli/analyze.rs b/codexray/src/cli/analyze.rs
similarity index 100%
rename from codebase/src/cli/analyze.rs
rename to codexray/src/cli/analyze.rs
diff --git a/codebase/src/cli/args.rs b/codexray/src/cli/args.rs
similarity index 100%
rename from codebase/src/cli/args.rs
rename to codexray/src/cli/args.rs
diff --git a/codebase/src/cli/mod.rs b/codexray/src/cli/mod.rs
similarity index 82%
rename from codebase/src/cli/mod.rs
rename to codexray/src/cli/mod.rs
index 13aacc8..f2dd076 100644
--- a/codebase/src/cli/mod.rs
+++ b/codexray/src/cli/mod.rs
@@ -4,6 +4,6 @@ pub mod analyze;
 pub mod vectorize;
 
 pub use args::Cli;
-pub use runner::CodeBaseRunner;
+pub use runner::CodeXRayRunner;
 pub use analyze::run_analyze;
 pub use vectorize::run_vectorize;
\ No newline at end of file
diff --git a/codebase/src/cli/runner.rs b/codexray/src/cli/runner.rs
similarity index 88%
rename from codebase/src/cli/runner.rs
rename to codexray/src/cli/runner.rs
index b587141..f9ef11d 100644
--- a/codebase/src/cli/runner.rs
+++ b/codexray/src/cli/runner.rs
@@ -1,15 +1,15 @@
 use tracing::info;
 use crate::config::Config;
-use crate::http::server::CodeBaseServer;
+use crate::http::server::CodeXRayServer;
 use crate::storage::StorageManager;
 use std::sync::Arc;
 
 use super::args::{Cli, Commands};
 use super::vectorize::run_vectorize;
 
-pub struct CodeBaseRunner;
+pub struct CodeXRayRunner;
 
-impl CodeBaseRunner {
+impl CodeXRayRunner {
     pub fn new() -> Self {
         Self
     }
@@ -26,7 +26,7 @@ impl CodeBaseRunner {
                 };
 
                 let addr = address.unwrap_or_else(|| "127.0.0.1:3000".to_string());
-                let mut server = CodeBaseServer::new(storage, repo_path);
+                let mut server = CodeXRayServer::new(storage, repo_path);
                 server.start(&addr).await?;
             }
             Commands::Vectorize { path, collection, db_uri } => {
diff --git a/codebase/src/cli/vectorize.rs b/codexray/src/cli/vectorize.rs
similarity index 100%
rename from codebase/src/cli/vectorize.rs
rename to codexray/src/cli/vectorize.rs
diff --git a/codebase/src/codegraph/chunker.rs b/codexray/src/codegraph/chunker.rs
similarity index 100%
rename from codebase/src/codegraph/chunker.rs
rename to codexray/src/codegraph/chunker.rs
diff --git a/codebase/src/codegraph/graph.rs b/codexray/src/codegraph/graph.rs
similarity index 100%
rename from codebase/src/codegraph/graph.rs
rename to codexray/src/codegraph/graph.rs
diff --git a/codebase/src/codegraph/mod.rs b/codexray/src/codegraph/mod.rs
similarity index 100%
rename from codebase/src/codegraph/mod.rs
rename to codexray/src/codegraph/mod.rs
diff --git a/codebase/src/codegraph/parser.rs b/codexray/src/codegraph/parser.rs
similarity index 100%
rename from codebase/src/codegraph/parser.rs
rename to codexray/src/codegraph/parser.rs
diff --git a/codebase/src/codegraph/repository.rs b/codexray/src/codegraph/repository.rs
similarity index 100%
rename from codebase/src/codegraph/repository.rs
rename to codexray/src/codegraph/repository.rs
diff --git a/codebase/src/codegraph/treesitter/ast_instance_structs.rs b/codexray/src/codegraph/treesitter/ast_instance_structs.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/ast_instance_structs.rs
rename to codexray/src/codegraph/treesitter/ast_instance_structs.rs
diff --git a/codebase/src/codegraph/treesitter/file_ast_markup.rs b/codexray/src/codegraph/treesitter/file_ast_markup.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/file_ast_markup.rs
rename to codexray/src/codegraph/treesitter/file_ast_markup.rs
diff --git a/codebase/src/codegraph/treesitter/language_id.rs b/codexray/src/codegraph/treesitter/language_id.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/language_id.rs
rename to codexray/src/codegraph/treesitter/language_id.rs
diff --git a/codebase/src/codegraph/treesitter/mod.rs b/codexray/src/codegraph/treesitter/mod.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/mod.rs
rename to codexray/src/codegraph/treesitter/mod.rs
diff --git a/codebase/src/codegraph/treesitter/parsers.rs b/codexray/src/codegraph/treesitter/parsers.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers.rs
rename to codexray/src/codegraph/treesitter/parsers.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/cpp.rs b/codexray/src/codegraph/treesitter/parsers/cpp.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/cpp.rs
rename to codexray/src/codegraph/treesitter/parsers/cpp.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/go.rs b/codexray/src/codegraph/treesitter/parsers/go.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/go.rs
rename to codexray/src/codegraph/treesitter/parsers/go.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/java.rs b/codexray/src/codegraph/treesitter/parsers/java.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/java.rs
rename to codexray/src/codegraph/treesitter/parsers/java.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/js.rs b/codexray/src/codegraph/treesitter/parsers/js.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/js.rs
rename to codexray/src/codegraph/treesitter/parsers/js.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/python.rs b/codexray/src/codegraph/treesitter/parsers/python.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/python.rs
rename to codexray/src/codegraph/treesitter/parsers/python.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/rust.rs b/codexray/src/codegraph/treesitter/parsers/rust.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/rust.rs
rename to codexray/src/codegraph/treesitter/parsers/rust.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests.rs b/codexray/src/codegraph/treesitter/parsers/tests.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests.rs
rename to codexray/src/codegraph/treesitter/parsers/tests.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp b/codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/circle.cpp.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp b/codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/cpp/main.cpp.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/go/main.go b/codexray/src/codegraph/treesitter/parsers/tests/cases/go/main.go
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/go/main.go
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/go/main.go
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/go/main.go.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/go/main.go.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/go/main.go.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/go/main.go.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go b/codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/go/shape.go.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/java/main.java b/codexray/src/codegraph/treesitter/parsers/tests/cases/java/main.java
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/java/main.java
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/java/main.java
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/java/main.java.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/java/main.java.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/java/main.java.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/java/main.java.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java b/codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/java/person.java.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/java/person.java.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js b/codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/js/car.js.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/js/car.js.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/js/main.js b/codexray/src/codegraph/treesitter/parsers/tests/cases/js/main.js
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/js/main.js
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/js/main.js
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/js/main.js.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/js/main.js.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/js/main.js.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/js/main.js.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py b/codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/python/calculator.py.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/python/main.py b/codexray/src/codegraph/treesitter/parsers/tests/cases/python/main.py
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/python/main.py
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/python/main.py
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/python/main.py.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/python/main.py.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/python/main.py.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/python/main.py.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs b/codexray/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/rust/main.rs.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs b/codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/rust/point.rs.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts b/codexray/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts.json b/codexray/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts.json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts.json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/ts/main.ts.json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts b/codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.decl_json b/codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.decl_json
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.decl_json
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.decl_json
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.skeleton b/codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.skeleton
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.skeleton
rename to codexray/src/codegraph/treesitter/parsers/tests/cases/ts/person.ts.skeleton
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/cpp.rs b/codexray/src/codegraph/treesitter/parsers/tests/cpp.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/cpp.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/cpp.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/go.rs b/codexray/src/codegraph/treesitter/parsers/tests/go.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/go.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/go.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/java.rs b/codexray/src/codegraph/treesitter/parsers/tests/java.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/java.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/java.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/js.rs b/codexray/src/codegraph/treesitter/parsers/tests/js.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/js.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/js.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/python.rs b/codexray/src/codegraph/treesitter/parsers/tests/python.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/python.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/python.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/rust.rs b/codexray/src/codegraph/treesitter/parsers/tests/rust.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/rust.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/rust.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/tests/ts.rs b/codexray/src/codegraph/treesitter/parsers/tests/ts.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/tests/ts.rs
rename to codexray/src/codegraph/treesitter/parsers/tests/ts.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/ts.rs b/codexray/src/codegraph/treesitter/parsers/ts.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/ts.rs
rename to codexray/src/codegraph/treesitter/parsers/ts.rs
diff --git a/codebase/src/codegraph/treesitter/parsers/utils.rs b/codexray/src/codegraph/treesitter/parsers/utils.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/parsers/utils.rs
rename to codexray/src/codegraph/treesitter/parsers/utils.rs
diff --git a/codebase/src/codegraph/treesitter/skeletonizer.rs b/codexray/src/codegraph/treesitter/skeletonizer.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/skeletonizer.rs
rename to codexray/src/codegraph/treesitter/skeletonizer.rs
diff --git a/codebase/src/codegraph/treesitter/structs.rs b/codexray/src/codegraph/treesitter/structs.rs
similarity index 100%
rename from codebase/src/codegraph/treesitter/structs.rs
rename to codexray/src/codegraph/treesitter/structs.rs
diff --git a/codebase/src/codegraph/types.rs b/codexray/src/codegraph/types.rs
similarity index 100%
rename from codebase/src/codegraph/types.rs
rename to codexray/src/codegraph/types.rs
diff --git a/codebase/src/config.rs b/codexray/src/config.rs
similarity index 95%
rename from codebase/src/config.rs
rename to codexray/src/config.rs
index 8b193e1..40ded6d 100644
--- a/codebase/src/config.rs
+++ b/codexray/src/config.rs
@@ -5,11 +5,11 @@ use tracing::{info, warn};
 
 #[derive(Debug, Deserialize, Clone)]
 pub struct Config {
-    pub codebase: CodeBaseConfig,
+    pub codexray: CodeXRayConfig,
 }
 
 #[derive(Debug, Deserialize, Clone)]
-pub struct CodeBaseConfig {
+pub struct CodeXRayConfig {
     #[serde(default)]
     pub enable_embedding: bool,
     pub embedding: EmbeddingConfig,
@@ -249,16 +249,16 @@ impl Config {
 
         // 检测旧的已废弃配置字段并发出警告
         if let Ok(value) = toml::from_str::<toml::Value>(&contents) {
-            if let Some(codebase) = value.get("codebase") {
-                if codebase.get("embedding_db_uri").is_some() {
+            if let Some(codexray) = value.get("codexray") {
+                if codexray.get("embedding_db_uri").is_some() {
                     warn!(
-                        "Config field 'codebase.embedding_db_uri' is deprecated and will be ignored. \
+                        "Config field 'codexray.embedding_db_uri' is deprecated and will be ignored. \
                         Embedding data is now stored under <data_dir>/embedding/ automatically."
                     );
                 }
-                if codebase.get("graph_db_uri").is_some() {
+                if codexray.get("graph_db_uri").is_some() {
                     warn!(
-                        "Config field 'codebase.graph_db_uri' is deprecated and will be ignored. \
+                        "Config field 'codexray.graph_db_uri' is deprecated and will be ignored. \
                         Graph data is now stored under <data_dir>/graph/ automatically."
                     );
                 }
diff --git a/codebase/src/http/handlers/commit.rs b/codexray/src/http/handlers/commit.rs
similarity index 100%
rename from codebase/src/http/handlers/commit.rs
rename to codexray/src/http/handlers/commit.rs
diff --git a/codebase/src/http/handlers/mod.rs b/codexray/src/http/handlers/mod.rs
similarity index 100%
rename from codebase/src/http/handlers/mod.rs
rename to codexray/src/http/handlers/mod.rs
diff --git a/codebase/src/http/handlers/repo_knowledge.rs b/codexray/src/http/handlers/repo_knowledge.rs
similarity index 100%
rename from codebase/src/http/handlers/repo_knowledge.rs
rename to codexray/src/http/handlers/repo_knowledge.rs
diff --git a/codebase/src/http/handlers/templates/echarts_call_graph.html b/codexray/src/http/handlers/templates/echarts_call_graph.html
similarity index 100%
rename from codebase/src/http/handlers/templates/echarts_call_graph.html
rename to codexray/src/http/handlers/templates/echarts_call_graph.html
diff --git a/codebase/src/http/handlers/templates/error_page.html b/codexray/src/http/handlers/templates/error_page.html
similarity index 100%
rename from codebase/src/http/handlers/templates/error_page.html
rename to codexray/src/http/handlers/templates/error_page.html
diff --git a/codebase/src/http/handlers/templates/main_page.html b/codexray/src/http/handlers/templates/main_page.html
similarity index 98%
rename from codebase/src/http/handlers/templates/main_page.html
rename to codexray/src/http/handlers/templates/main_page.html
index fbe3313..1f52b3b 100644
--- a/codebase/src/http/handlers/templates/main_page.html
+++ b/codexray/src/http/handlers/templates/main_page.html
@@ -69,7 +69,7 @@ <h1>🔗 Function Call Graph</h1>
         </div>
         <div class="content">
             <div class="step" id="step1">
-                <h2 class="step-title"><span class="badge">1</span> Build Codebase</h2>
+                <h2 class="step-title"><span class="badge">1</span> Build Codexray</h2>
                 <div class="form-row">
                     <div class="form-group">
                         <label for="project_dir">Project Directory *</label>
@@ -83,7 +83,7 @@ <h2 class="step-title"><span class="badge">1</span> Build Codebase</h2>
                     </div>
                 </div>
                 <div class="actions">
-                    <button class="btn" id="build_btn" onclick="buildCodebase()">🚀 Build Codebase</button>
+                    <button class="btn" id="build_btn" onclick="buildCodexray()">🚀 Build Codexray</button>
                 </div>
                 <div id="build_status" class="status" style="display:none;"></div>
             </div>
@@ -112,7 +112,7 @@ <h2 class="step-title"><span class="badge">2</span> Draw Graph</h2>
         </div>
     </div>
     <script>
-        async function buildCodebase() {
+        async function buildCodexray() {
             const btn = document.getElementById('build_btn');
             const statusEl = document.getElementById('build_status');
             const projectDir = document.getElementById('project_dir').value.trim();
diff --git a/codebase/src/http/handlers/vectorize.rs b/codexray/src/http/handlers/vectorize.rs
similarity index 99%
rename from codebase/src/http/handlers/vectorize.rs
rename to codexray/src/http/handlers/vectorize.rs
index 541a278..fc64642 100644
--- a/codebase/src/http/handlers/vectorize.rs
+++ b/codexray/src/http/handlers/vectorize.rs
@@ -38,7 +38,7 @@ pub async fn trigger_embedding_build(
     };
 
     // Check if embedding is enabled
-    if !config.codebase.enable_embedding {
+    if !config.codexray.enable_embedding {
         let mut tasks = storage.vector_tasks.lock().unwrap();
         tasks.remove(&repo_path);
         return Err("Embedding is not enabled".to_string());
diff --git a/codebase/src/http/middleware/mod.rs b/codexray/src/http/middleware/mod.rs
similarity index 100%
rename from codebase/src/http/middleware/mod.rs
rename to codexray/src/http/middleware/mod.rs
diff --git a/codebase/src/http/mod.rs b/codexray/src/http/mod.rs
similarity index 68%
rename from codebase/src/http/mod.rs
rename to codexray/src/http/mod.rs
index ff2f6dc..98b3b85 100644
--- a/codebase/src/http/mod.rs
+++ b/codexray/src/http/mod.rs
@@ -3,4 +3,4 @@ pub mod handlers;
 pub mod models;
 pub mod middleware;
 
-pub use server::CodeBaseServer; 
\ No newline at end of file
+pub use server::CodeXRayServer; 
\ No newline at end of file
diff --git a/codebase/src/http/models/commit.rs b/codexray/src/http/models/commit.rs
similarity index 100%
rename from codebase/src/http/models/commit.rs
rename to codexray/src/http/models/commit.rs
diff --git a/codebase/src/http/models/embedding.rs b/codexray/src/http/models/embedding.rs
similarity index 100%
rename from codebase/src/http/models/embedding.rs
rename to codexray/src/http/models/embedding.rs
diff --git a/codebase/src/http/models/init.rs b/codexray/src/http/models/init.rs
similarity index 100%
rename from codebase/src/http/models/init.rs
rename to codexray/src/http/models/init.rs
diff --git a/codebase/src/http/models/investigate.rs b/codexray/src/http/models/investigate.rs
similarity index 100%
rename from codebase/src/http/models/investigate.rs
rename to codexray/src/http/models/investigate.rs
diff --git a/codebase/src/http/models/mod.rs b/codexray/src/http/models/mod.rs
similarity index 100%
rename from codebase/src/http/models/mod.rs
rename to codexray/src/http/models/mod.rs
diff --git a/codebase/src/http/models/query.rs b/codexray/src/http/models/query.rs
similarity index 100%
rename from codebase/src/http/models/query.rs
rename to codexray/src/http/models/query.rs
diff --git a/codebase/src/http/models/repo_knowledge.rs b/codexray/src/http/models/repo_knowledge.rs
similarity index 100%
rename from codebase/src/http/models/repo_knowledge.rs
rename to codexray/src/http/models/repo_knowledge.rs
diff --git a/codebase/src/http/models/skeleton.rs b/codexray/src/http/models/skeleton.rs
similarity index 100%
rename from codebase/src/http/models/skeleton.rs
rename to codexray/src/http/models/skeleton.rs
diff --git a/codebase/src/http/models/snippet.rs b/codexray/src/http/models/snippet.rs
similarity index 100%
rename from codebase/src/http/models/snippet.rs
rename to codexray/src/http/models/snippet.rs
diff --git a/codebase/src/http/server.rs b/codexray/src/http/server.rs
similarity index 96%
rename from codebase/src/http/server.rs
rename to codexray/src/http/server.rs
index b688219..ec08ef9 100644
--- a/codebase/src/http/server.rs
+++ b/codexray/src/http/server.rs
@@ -40,7 +40,7 @@ pub struct AppState {
     pub hybrid: Option<Arc<HybridSearchService>>,
 }
 
-pub struct CodeBaseServer {
+pub struct CodeXRayServer {
     storage: Arc<StorageManager>,
     repo_path: String,
     /// Hybrid search service for semantic search endpoint.
@@ -58,7 +58,7 @@ struct StatusResponse {
     indexing_status: String,
 }
 
-impl CodeBaseServer {
+impl CodeXRayServer {
     pub fn new(storage: Arc<StorageManager>, repo_path: String) -> Self {
         Self {
             storage,
@@ -124,7 +124,7 @@ impl CodeBaseServer {
         // This avoids LockBusy conflicts from multiple open_or_create calls on the same dir.
         let shared_bm25_index: Arc<dyn TextSearchProvider> = {
             let config = self.storage.get_config();
-            if config.as_ref().map_or(false, |c| c.codebase.enable_embedding) {
+            if config.as_ref().map_or(false, |c| c.codexray.enable_embedding) {
                 let config = config.unwrap();
                 // 使用项目特定子目录实现 BM25 索引隔离（与向量索引 collection 命名对齐）
                 let repo_path = std::path::Path::new(&self.repo_path);
@@ -166,8 +166,8 @@ impl CodeBaseServer {
 
         // 初始化混合检索服务 (Hybrid Search)
         if let Ok(config) = self.storage.get_config().ok_or("Config not set") {
-            if config.codebase.enable_embedding {
-                let _embedding_config = &config.codebase.embedding;
+            if config.codexray.enable_embedding {
+                let _embedding_config = &config.codexray.embedding;
                 let embedding_dir = config.embedding_dir();
                 let db_path_str = embedding_dir.to_string_lossy().to_string();
                 
@@ -194,11 +194,11 @@ impl CodeBaseServer {
                 
                  // 创建 HybridSearchService
                 if let Some(embedding_service) = embedding_service {
-                    let hybrid_cfg = &config.codebase.retrieval_pipeline.hybrid;
+                    let hybrid_cfg = &config.codexray.retrieval_pipeline.hybrid;
                     
                     // 可选：创建 RerankerService
-                    let reranker = if config.codebase.retrieval_pipeline.reranker.enabled {
-                        Some(RerankerService::new(config.codebase.retrieval_pipeline.reranker.clone()))
+                    let reranker = if config.codexray.retrieval_pipeline.reranker.enabled {
+                        Some(RerankerService::new(config.codexray.retrieval_pipeline.reranker.clone()))
                     } else {
                         None
                     };
@@ -251,7 +251,7 @@ impl CodeBaseServer {
         let config = self.storage.get_config().ok_or("Config not set")?;
         
         // 检查 embedding 是否启用
-        if !config.codebase.enable_embedding {
+        if !config.codexray.enable_embedding {
             return Err("Embedding not enabled in config".into());
         }
 
@@ -260,7 +260,7 @@ impl CodeBaseServer {
         let mut base_url = None;
         let mut model = "Qwen/Qwen3-Embedding-4B".to_string();
 
-        let embedding_config = &config.codebase.embedding;
+        let embedding_config = &config.codexray.embedding;
         if !embedding_config.api_token.is_empty() {
             api_token = Some(embedding_config.api_token.clone());
         }
@@ -290,7 +290,7 @@ impl CodeBaseServer {
         let config = self.storage.get_config().ok_or("Config not set")?;
         
         // 检查 embedding 是否启用
-        if !config.codebase.enable_embedding {
+        if !config.codexray.enable_embedding {
             return Err("Embedding not enabled in config".into());
         }
 
@@ -299,7 +299,7 @@ impl CodeBaseServer {
         let mut base_url = None;
         let mut model = "Qwen/Qwen3-Embedding-4B".to_string();
 
-        let embedding_config = &config.codebase.embedding;
+        let embedding_config = &config.codexray.embedding;
         if !embedding_config.api_token.is_empty() {
             api_token = Some(embedding_config.api_token.clone());
         }
@@ -436,7 +436,7 @@ impl CodeBaseServer {
 async fn health_check() -> Json<ApiResponse<&'static str>> {
     Json(ApiResponse {
         success: true,
-        data: "Codebase HTTP service is running",
+        data: "Codexray HTTP service is running",
     })
 }
 
@@ -462,7 +462,7 @@ async fn get_status(
 
     let embedding_enabled = storage.storage
         .get_config()
-        .map(|c| c.codebase.enable_embedding)
+        .map(|c| c.codexray.enable_embedding)
         .unwrap_or(false);
 
     let indexing_status = {
diff --git a/codebase/src/lib.rs b/codexray/src/lib.rs
similarity index 100%
rename from codebase/src/lib.rs
rename to codexray/src/lib.rs
diff --git a/codebase/src/main.rs b/codexray/src/main.rs
similarity index 79%
rename from codebase/src/main.rs
rename to codexray/src/main.rs
index 736a995..3cbd0ac 100644
--- a/codebase/src/main.rs
+++ b/codexray/src/main.rs
@@ -1,9 +1,9 @@
 use clap::Parser;
-use codeactor_codebase::cli::{Cli, CodeBaseRunner};
-use codeactor_codebase::cli::args::Commands;
-use codeactor_codebase::http::CodeBaseServer;
-use codeactor_codebase::storage::StorageManager;
-use codeactor_codebase::config::Config;
+use codeactor_codexray::cli::{Cli, CodeXRayRunner};
+use codeactor_codexray::cli::args::Commands;
+use codeactor_codexray::http::CodeXRayServer;
+use codeactor_codexray::storage::StorageManager;
+use codeactor_codexray::config::Config;
 use std::sync::Arc;
 use tracing::{info, warn};
 
@@ -38,7 +38,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
         Commands::Server { address, storage_mode, repo_path } => {
             let default_addr = format!("127.0.0.1:{}", 12700);
             let server_addr = address.as_deref().unwrap_or(&default_addr);
-            info!("Starting CodeBase HTTP server on {}, repo: {}", server_addr, repo_path);
+            info!("Starting CodeXRay HTTP server on {}, repo: {}", server_addr, repo_path);
 
             // Determine storage mode
             let storage_mode = storage_mode.as_ref().unwrap_or(&cli.storage_mode).clone();
@@ -50,11 +50,11 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
                 Arc::new(StorageManager::with_storage_mode(storage_mode))
             };
 
-            let mut server = CodeBaseServer::new(storage, repo_path.clone());
+            let mut server = CodeXRayServer::new(storage, repo_path.clone());
             server.start(server_addr).await?;
         }
         Commands::Vectorize { .. } => {
-            CodeBaseRunner::run(cli, config).await?;
+            CodeXRayRunner::run(cli, config).await?;
         }
     }
 
diff --git a/codebase/src/services/analyzer.rs b/codexray/src/services/analyzer.rs
similarity index 100%
rename from codebase/src/services/analyzer.rs
rename to codexray/src/services/analyzer.rs
diff --git a/codebase/src/services/commit_embedding_service.rs b/codexray/src/services/commit_embedding_service.rs
similarity index 99%
rename from codebase/src/services/commit_embedding_service.rs
rename to codexray/src/services/commit_embedding_service.rs
index f42676c..b588549 100644
--- a/codebase/src/services/commit_embedding_service.rs
+++ b/codexray/src/services/commit_embedding_service.rs
@@ -122,7 +122,7 @@ impl CommitEmbeddingService {
         let mut dimensions = 2560;
 
         if let Some(conf) = config {
-            let embedding_config = &conf.codebase.embedding;
+            let embedding_config = &conf.codexray.embedding;
             if !embedding_config.api_token.is_empty() {
                 api_token = Some(embedding_config.api_token.clone());
             }
diff --git a/codebase/src/services/embedding_service.rs b/codexray/src/services/embedding_service.rs
similarity index 99%
rename from codebase/src/services/embedding_service.rs
rename to codexray/src/services/embedding_service.rs
index a711db3..0c9720e 100644
--- a/codebase/src/services/embedding_service.rs
+++ b/codexray/src/services/embedding_service.rs
@@ -218,7 +218,7 @@ impl EmbeddingService {
         let mut dimensions = 2560;
 
         if let Some(conf) = config {
-             let embedding_config = &conf.codebase.embedding;
+             let embedding_config = &conf.codexray.embedding;
              if !embedding_config.api_token.is_empty() {
                  api_token = Some(embedding_config.api_token.clone());
              }
@@ -238,7 +238,7 @@ impl EmbeddingService {
         let provider = OpenAICompatibleEmbeddingProvider::new(api_token, base_url, model);
         
         let min_code_block_length = config
-            .map(|cfg| cfg.codebase.retrieval_pipeline.min_code_block_length)
+            .map(|cfg| cfg.codexray.retrieval_pipeline.min_code_block_length)
             .unwrap_or(16);
         
         let cpu_count = std::thread::available_parallelism()
diff --git a/codebase/src/services/hybrid_search.rs b/codexray/src/services/hybrid_search.rs
similarity index 100%
rename from codebase/src/services/hybrid_search.rs
rename to codexray/src/services/hybrid_search.rs
diff --git a/codebase/src/services/mod.rs b/codexray/src/services/mod.rs
similarity index 100%
rename from codebase/src/services/mod.rs
rename to codexray/src/services/mod.rs
diff --git a/codebase/src/services/repo_knowledge_service.rs b/codexray/src/services/repo_knowledge_service.rs
similarity index 99%
rename from codebase/src/services/repo_knowledge_service.rs
rename to codexray/src/services/repo_knowledge_service.rs
index 4591de4..b1cc807 100644
--- a/codebase/src/services/repo_knowledge_service.rs
+++ b/codexray/src/services/repo_knowledge_service.rs
@@ -119,7 +119,7 @@ impl RepoKnowledgeService {
         let mut dimensions = 2560i32;
 
         if let Some(conf) = config {
-            if let Some(dim) = conf.codebase.embedding.dimensions {
+            if let Some(dim) = conf.codexray.embedding.dimensions {
                 dimensions = dim as i32;
             }
         }
diff --git a/codebase/src/services/reranker_service.rs b/codexray/src/services/reranker_service.rs
similarity index 97%
rename from codebase/src/services/reranker_service.rs
rename to codexray/src/services/reranker_service.rs
index 028536d..6879f7c 100644
--- a/codebase/src/services/reranker_service.rs
+++ b/codexray/src/services/reranker_service.rs
@@ -72,7 +72,7 @@ impl RerankerService {
         // 检查 API Token 是否已配置
         if self.config.api_token.is_empty() {
             return Err(anyhow!(
-                "Reranker API token not configured. Set [codebase.retrieval_pipeline.reranker] api_token in config.toml"
+                "Reranker API token not configured. Set [codexray.retrieval_pipeline.reranker] api_token in config.toml"
             ));
         }
 
diff --git a/codebase/src/services/snippet_service.rs b/codexray/src/services/snippet_service.rs
similarity index 100%
rename from codebase/src/services/snippet_service.rs
rename to codexray/src/services/snippet_service.rs
diff --git a/codebase/src/storage/incremental.rs b/codexray/src/storage/incremental.rs
similarity index 100%
rename from codebase/src/storage/incremental.rs
rename to codexray/src/storage/incremental.rs
diff --git a/codebase/src/storage/mod.rs b/codexray/src/storage/mod.rs
similarity index 98%
rename from codebase/src/storage/mod.rs
rename to codexray/src/storage/mod.rs
index fd874fe..7c33c60 100644
--- a/codebase/src/storage/mod.rs
+++ b/codexray/src/storage/mod.rs
@@ -186,7 +186,7 @@ impl StorageManager {
         })?;
 
         let embedding_dir = config.embedding_dir();
-        let dimensions = config.codebase.embedding.dimensions.unwrap_or(2560) as i32;
+        let dimensions = config.codexray.embedding.dimensions.unwrap_or(2560) as i32;
 
         // 构建 LanceDB 连接路径
         let db_path = embedding_dir.join("commit_embeddings.lance");
@@ -252,7 +252,7 @@ impl StorageManager {
         })?;
 
         let embedding_dir = config.embedding_dir();
-        let dimensions = config.codebase.embedding.dimensions.unwrap_or(2560) as i32;
+        let dimensions = config.codexray.embedding.dimensions.unwrap_or(2560) as i32;
 
         // 构建 LanceDB 连接路径
         let db_path = embedding_dir.join("repo_knowledge.lance");
diff --git a/codebase/src/storage/persistence.rs b/codexray/src/storage/persistence.rs
similarity index 100%
rename from codebase/src/storage/persistence.rs
rename to codexray/src/storage/persistence.rs
diff --git a/codebase/src/storage/petgraph_storage.rs b/codexray/src/storage/petgraph_storage.rs
similarity index 100%
rename from codebase/src/storage/petgraph_storage.rs
rename to codexray/src/storage/petgraph_storage.rs
diff --git a/codebase/src/storage/prelude.rs b/codexray/src/storage/prelude.rs
similarity index 100%
rename from codebase/src/storage/prelude.rs
rename to codexray/src/storage/prelude.rs
diff --git a/codebase/src/storage/tantivy_index.rs b/codexray/src/storage/tantivy_index.rs
similarity index 100%
rename from codebase/src/storage/tantivy_index.rs
rename to codexray/src/storage/tantivy_index.rs
diff --git a/codebase/src/storage/traits.rs b/codexray/src/storage/traits.rs
similarity index 100%
rename from codebase/src/storage/traits.rs
rename to codexray/src/storage/traits.rs
diff --git a/codebase/src/storage/traits_bm25.rs b/codexray/src/storage/traits_bm25.rs
similarity index 100%
rename from codebase/src/storage/traits_bm25.rs
rename to codexray/src/storage/traits_bm25.rs
diff --git a/codebase/tests/core-ouptputs.json b/codexray/tests/core-ouptputs.json
similarity index 100%
rename from codebase/tests/core-ouptputs.json
rename to codexray/tests/core-ouptputs.json
diff --git a/codebase/tests/run_functional_tests.sh b/codexray/tests/run_functional_tests.sh
similarity index 100%
rename from codebase/tests/run_functional_tests.sh
rename to codexray/tests/run_functional_tests.sh
diff --git a/codebase/tests/test_functional.rs b/codexray/tests/test_functional.rs
similarity index 99%
rename from codebase/tests/test_functional.rs
rename to codexray/tests/test_functional.rs
index 686f0f2..c77f21a 100644
--- a/codebase/tests/test_functional.rs
+++ b/codexray/tests/test_functional.rs
@@ -3,9 +3,9 @@ use std::sync::Arc;
 use tempfile::TempDir;
 use std::fs;
 
-use codeactor_codebase::storage::StorageManager;
-use codeactor_codebase::services::CodeAnalyzer;
-use codeactor_codebase::codegraph::types::PetCodeGraph;
+use codeactor_codexray::storage::StorageManager;
+use codeactor_codexray::services::CodeAnalyzer;
+use codeactor_codexray::codegraph::types::PetCodeGraph;
 use uuid::Uuid;
 
 /// 测试构建图功能
diff --git a/codebase/tests/test_repos/simple_js_project/dataProcessor.js b/codexray/tests/test_repos/simple_js_project/dataProcessor.js
similarity index 100%
rename from codebase/tests/test_repos/simple_js_project/dataProcessor.js
rename to codexray/tests/test_repos/simple_js_project/dataProcessor.js
diff --git a/codebase/tests/test_repos/simple_js_project/index.js b/codexray/tests/test_repos/simple_js_project/index.js
similarity index 100%
rename from codebase/tests/test_repos/simple_js_project/index.js
rename to codexray/tests/test_repos/simple_js_project/index.js
diff --git a/codebase/tests/test_repos/simple_js_project/mathUtils.js b/codexray/tests/test_repos/simple_js_project/mathUtils.js
similarity index 100%
rename from codebase/tests/test_repos/simple_js_project/mathUtils.js
rename to codexray/tests/test_repos/simple_js_project/mathUtils.js
diff --git a/codebase/tests/test_repos/simple_js_project/package.json b/codexray/tests/test_repos/simple_js_project/package.json
similarity index 100%
rename from codebase/tests/test_repos/simple_js_project/package.json
rename to codexray/tests/test_repos/simple_js_project/package.json
diff --git a/codebase/tests/test_repos/simple_js_project/stringUtils.js b/codexray/tests/test_repos/simple_js_project/stringUtils.js
similarity index 100%
rename from codebase/tests/test_repos/simple_js_project/stringUtils.js
rename to codexray/tests/test_repos/simple_js_project/stringUtils.js
diff --git a/codebase/tests/test_repos/simple_python_project/data_processor.py b/codexray/tests/test_repos/simple_python_project/data_processor.py
similarity index 100%
rename from codebase/tests/test_repos/simple_python_project/data_processor.py
rename to codexray/tests/test_repos/simple_python_project/data_processor.py
diff --git a/codebase/tests/test_repos/simple_python_project/main.py b/codexray/tests/test_repos/simple_python_project/main.py
similarity index 100%
rename from codebase/tests/test_repos/simple_python_project/main.py
rename to codexray/tests/test_repos/simple_python_project/main.py
diff --git a/codebase/tests/test_repos/simple_python_project/math_utils.py b/codexray/tests/test_repos/simple_python_project/math_utils.py
similarity index 100%
rename from codebase/tests/test_repos/simple_python_project/math_utils.py
rename to codexray/tests/test_repos/simple_python_project/math_utils.py
diff --git a/codebase/tests/test_repos/simple_python_project/string_utils.py b/codexray/tests/test_repos/simple_python_project/string_utils.py
similarity index 100%
rename from codebase/tests/test_repos/simple_python_project/string_utils.py
rename to codexray/tests/test_repos/simple_python_project/string_utils.py
diff --git a/codebase/tests/test_repos/simple_rust_project/Cargo.toml b/codexray/tests/test_repos/simple_rust_project/Cargo.toml
similarity index 100%
rename from codebase/tests/test_repos/simple_rust_project/Cargo.toml
rename to codexray/tests/test_repos/simple_rust_project/Cargo.toml
diff --git a/codebase/tests/test_repos/simple_rust_project/src/lib.rs b/codexray/tests/test_repos/simple_rust_project/src/lib.rs
similarity index 100%
rename from codebase/tests/test_repos/simple_rust_project/src/lib.rs
rename to codexray/tests/test_repos/simple_rust_project/src/lib.rs
diff --git a/codebase/tests/test_repos/simple_rust_project/src/main.rs b/codexray/tests/test_repos/simple_rust_project/src/main.rs
similarity index 100%
rename from codebase/tests/test_repos/simple_rust_project/src/main.rs
rename to codexray/tests/test_repos/simple_rust_project/src/main.rs
diff --git a/codebase/tests/test_repos/simple_rust_project/src/math.rs b/codexray/tests/test_repos/simple_rust_project/src/math.rs
similarity index 100%
rename from codebase/tests/test_repos/simple_rust_project/src/math.rs
rename to codexray/tests/test_repos/simple_rust_project/src/math.rs
diff --git a/codebase/tests/test_repos/simple_rust_project/src/utils.rs b/codexray/tests/test_repos/simple_rust_project/src/utils.rs
similarity index 100%
rename from codebase/tests/test_repos/simple_rust_project/src/utils.rs
rename to codexray/tests/test_repos/simple_rust_project/src/utils.rs
diff --git a/codebase/tests/test_repos/simple_ts_project/package.json b/codexray/tests/test_repos/simple_ts_project/package.json
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/package.json
rename to codexray/tests/test_repos/simple_ts_project/package.json
diff --git a/codebase/tests/test_repos/simple_ts_project/src/dataProcessor.ts b/codexray/tests/test_repos/simple_ts_project/src/dataProcessor.ts
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/src/dataProcessor.ts
rename to codexray/tests/test_repos/simple_ts_project/src/dataProcessor.ts
diff --git a/codebase/tests/test_repos/simple_ts_project/src/main.ts b/codexray/tests/test_repos/simple_ts_project/src/main.ts
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/src/main.ts
rename to codexray/tests/test_repos/simple_ts_project/src/main.ts
diff --git a/codebase/tests/test_repos/simple_ts_project/src/mathUtils.ts b/codexray/tests/test_repos/simple_ts_project/src/mathUtils.ts
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/src/mathUtils.ts
rename to codexray/tests/test_repos/simple_ts_project/src/mathUtils.ts
diff --git a/codebase/tests/test_repos/simple_ts_project/src/stringUtils.ts b/codexray/tests/test_repos/simple_ts_project/src/stringUtils.ts
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/src/stringUtils.ts
rename to codexray/tests/test_repos/simple_ts_project/src/stringUtils.ts
diff --git a/codebase/tests/test_repos/simple_ts_project/tsconfig.json b/codexray/tests/test_repos/simple_ts_project/tsconfig.json
similarity index 100%
rename from codebase/tests/test_repos/simple_ts_project/tsconfig.json
rename to codexray/tests/test_repos/simple_ts_project/tsconfig.json
diff --git a/codebase/tests/test_semantic_search.py b/codexray/tests/test_semantic_search.py
similarity index 99%
rename from codebase/tests/test_semantic_search.py
rename to codexray/tests/test_semantic_search.py
index 6621cf6..1392946 100644
--- a/codebase/tests/test_semantic_search.py
+++ b/codexray/tests/test_semantic_search.py
@@ -2,7 +2,7 @@
 """
 CodeActor Semantic Search 功能测试脚本
 
-测试 codebase 语义搜索接口（运行在本地 12800 端口）的准确性，
+测试 codexray 语义搜索接口（运行在本地 12800 端口）的准确性，
 特别关注混合检索（Hybrid Search）与纯 Embedding 检索的对比分析。
 
 版本: 2.0
diff --git a/config/config.toml b/config/config.toml
index febd026..9f29c29 100644
--- a/config/config.toml
+++ b/config/config.toml
@@ -65,20 +65,20 @@ use_provider = "deepseek_v4_pro"
 enable_streaming = true
 
 # ── 代码库（语义搜索）──
-[codebase]
+[codexray]
 enable_embedding = true
 
-[codebase.embedding]
+[codexray.embedding]
 model = "Qwen/Qwen3-Embedding-4B"
 api_token = "your-key"
 api_base_url = "https://api.siliconflow.cn/v1"
 dimensions = 2560
 
 # ── 检索管线（多阶段级联检索，默认启用）──
-[codebase.retrieval_pipeline]
+[codexray.retrieval_pipeline]
 enabled = true
 
-[codebase.retrieval_pipeline.reranker]
+[codexray.retrieval_pipeline.reranker]
 enabled = false
 api_token = "your-key"
 model = "Qwen/Qwen3-Reranker-4B"
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 1e9e0eb..ec30761 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -78,13 +78,13 @@ codeactor-agent/
 │   │   │   ├── flow_control.go      # FlowControlTool：finish、ask_user_for_help
 │   │   │   ├── search_operations.go # SearchOperationsTool：ripgrep 全文搜索、fzf 文件搜索
 │   │   │   ├── system_operations.go # SystemOperationsTool：Shell 命令执行（前台/后台）
-│   │   │   ├── repo_operations.go   # RepoOperationsTool：语义搜索/代码骨架/代码片段（调用 codebase 服务）
+│   │   │   ├── repo_operations.go   # RepoOperationsTool：语义搜索/代码骨架/代码片段（调用 codexray 服务）
 │   │   │   ├── file_operations_test.go
 │   │   │   └── system_operations_test.go
 │   ├── http/
 │   │   ├── server.go                # HTTP 服务器：路由注册、REST API 处理、CORS
 │   │   ├── task_manager.go          # 任务生命周期管理：创建、状态更新、取消、WebSocket 推送
-│   │   ├── task_executor.go         # 任务执行引擎：启动 codebase_init、消息分发、Agent 调用
+│   │   ├── task_executor.go         # 任务执行引擎：启动 codexray_init、消息分发、Agent 调用
 │   │   ├── websocket.go             # WebSocket 事件处理：start_task、chat_message、get_memory、clear_memory
 │   │   └── types.go                 # 数据结构：Task、SocketMessage、TaskUpdate、API 请求/响应
 │   ├── memory/
@@ -120,7 +120,7 @@ main.go
   │     └── agents/
   │           ├── conductor.go ── tools (Adapter), memory, globalctx
   │           ├── coding.go ───── tools (Adapter), tools.json
-  │           ├── repo.go ─────── tools (codebase HTTP API), globalctx
+  │           ├── repo.go ─────── tools (codexray HTTP API), globalctx
   │           └── chat.go ─────── globalctx
   ├── internal/http/
   │     ├── server.go ─────────── gin, melody (WebSocket), assistant
@@ -192,13 +192,13 @@ main.go
                           ┌───────┼───────────────────────────────┐
                           │       ▼                                │
                           │  ┌──────────────────────────────┐    │
-                          │  │  codeactor-codebase (Rust)    │    │
+                          │  │  codeactor-codexray (Rust)    │    │
                           │  │  外部代码分析服务 (127.0.0.1:12800)│   │  外部服务
                           │  │  - semantic_search             │    │
                           │  │  - investigate_repo            │    │
                           │  │  - query_code_skeleton         │    │
                           │  │  - query_code_snippet          │    │
-                          │  │  - codebase_init               │    │
+                          │  │  - codexray_init               │    │
                           │  └──────────────────────────────┘    │
                           └──────────────────────────────────────┘
                                   │
@@ -261,7 +261,7 @@ type Agent interface {
   - `read_file`, `search_by_regex`, `list_dir`, `print_dir_tree`
   - `semantic_search`, `query_code_skeleton`, `query_code_snippet`
 - **预调查机制** (`doPreInvestigate`):
-  - 在每次 Run 之前，自动调用 `POST /investigate_repo` 到 codebase 服务
+  - 在每次 Run 之前，自动调用 `POST /investigate_repo` 到 codexray 服务
   - 获取目录树、核心函数列表（含调用者/被调者依赖图）、文件骨架
   - 将调查结果注入系统提示词
 - **最大步数限制**（默认 20 步，可配置）
@@ -303,7 +303,7 @@ type Adapter struct {
 | `search_by_regex` | 搜索 | `search_operations.go` | ripgrep 正则全文搜索 |
 | `run_bash` | 系统 | `system_operations.go` | 执行 Shell 命令（前台/后台） |
 | `thinking` | 认知 | `cognitive.go` | 错误分析和反思思维链 |
-| `semantic_search` | 仓库 | `repo_operations.go` | 语义搜索（调用 codebase 服务） |
+| `semantic_search` | 仓库 | `repo_operations.go` | 语义搜索（调用 codexray 服务） |
 | `query_code_skeleton` | 仓库 | `repo_operations.go` | 查询代码骨架（函数/类定义） |
 | `query_code_snippet` | 仓库 | `repo_operations.go` | 查询代码片段（函数实现） |
 | `finish` | 流程 | `flow_control.go` | 通知 Conductor 任务完成 |
@@ -523,13 +523,13 @@ llms.ToolCallResponse{ToolCallID, Name, Content}
 llms.Tool{Type: "function", Function: &llms.FunctionDefinition{...}}
 ```
 
-### 5.5 Codebase 服务 API（Rust 外部服务）
+### 5.5 Codexray 服务 API（Rust 外部服务）
 
 运行在 `http://127.0.0.1:12800`：
 
 | 端点 | 方法 | 调用方 | 说明 |
 |------|------|--------|------|
-| `/codebase_init` | POST | task_executor | 初始化代码库索引 |
+| `/codexray_init` | POST | task_executor | 初始化代码库索引 |
 | `/investigate_repo` | POST | RepoAgent | 仓库预调查 → 返回目录树+核心函数+文件骨架 |
 | `/semantic_search` | POST | RepoAgent/CodingAgent | 语义搜索代码 |
 | `/query_code_skeleton` | POST | RepoAgent/CodingAgent | 查询文件骨架 |
@@ -556,7 +556,7 @@ llms.Tool{Type: "function", Function: &llms.FunctionDefinition{...}}
    - 设置状态为 "running"
         │
 3. go ExecuteTask()
-   ├── 后台: POST /codebase_init (初始化代码索引)
+   ├── 后台: POST /codexray_init (初始化代码索引)
    ├── 创建 MessageDispatcher(100)
    ├── 注册 TUIConsumer (终端输出)
    ├── 注册 WebSocketConsumer (广播到 ws 客户端)
@@ -684,11 +684,11 @@ lang = "Chinese"                       # 输出语言
 
 ## 8. 外部依赖服务
 
-### 8.1 codeactor-codebase（Rust 服务）
+### 8.1 codeactor-codexray（Rust 服务）
 
-- **路径**: `~/.codeactor/bin/codeactor-codebase`
+- **路径**: `~/.codeactor/bin/codeactor-codexray`
 - **端口**: `127.0.0.1:12800`
-- **启动**: `main.go::startCodebaseServer()` 在程序启动时自动以子进程方式启动
+- **启动**: `main.go::startCodexrayServer()` 在程序启动时自动以子进程方式启动
 - **功能**: 代码索引、语义搜索、仓库分析、代码骨架/Snippet 查询
 
 ### 8.2 系统工具依赖
@@ -704,4 +704,4 @@ lang = "Chinese"                       # 输出语言
 - **任务 Memory**: `~/.codeactor/tasks/{taskID}.json`
 - **LLM 日志**: `~/.codeactor/logs/llm-{YYYY-MM-DD}.log`
 - **服务日志**: `./logs/server.log`（HTTP 模式）
-- **Codebase 日志**: `~/.codeactor/logs/codeactor-codebase/{date}.log`
+- **Codexray 日志**: `~/.codeactor/logs/codeactor-codexray/{date}.log`
diff --git a/docs/Browser_Agent_Design.md b/docs/Browser_Agent_Design.md
index eee6242..d6afec1 100644
--- a/docs/Browser_Agent_Design.md
+++ b/docs/Browser_Agent_Design.md
@@ -77,7 +77,7 @@
 | `internal/tui/` | **低** | 浏览器输出文本/文件路径在聊天 UI 中显示 |
 | `main.go` | **中** | Agent 注册、依赖注入、生命周期钩子 |
 | `go.mod` | **低** | 添加 `github.com/go-rod/rod` |
-| `codebase/` (Rust) | **无** | 不受影响 |
+| `codexray/` (Rust) | **无** | 不受影响 |
 
 ---
 
diff --git a/docs/VSCODE_SERVER_INTEGRATION.md b/docs/VSCODE_SERVER_INTEGRATION.md
index 53cd1bc..3b21b32 100644
--- a/docs/VSCODE_SERVER_INTEGRATION.md
+++ b/docs/VSCODE_SERVER_INTEGRATION.md
@@ -34,7 +34,7 @@
 | **HTTP 框架** | Gin + Melody WebSocket |
 | **运行模式** | TUI（终端交互）/ HTTP（Web API） |
 | **前端** | React WebUI（`webui/build` 已构建但未服务） |
-| **端口分配** | HTTP Server（从 9800 自动分配）+ Codebase 引擎（从 12800 自动分配） |
+| **端口分配** | HTTP Server（从 9800 自动分配）+ Codexray 引擎（从 12800 自动分配） |
 | **已有 VS Code 集成** | `vscode/` 扩展，通过 WebView 嵌入 WebUI |
 | **缺失能力** | ❌ 浏览器中浏览/编辑代码 ❌ 文件树/语法高亮 ❌ IDE ↔ Agent 协作 |
 
diff --git a/docs/architecture.svg b/docs/architecture.svg
index 0c50e6d..32db78a 100644
--- a/docs/architecture.svg
+++ b/docs/architecture.svg
@@ -40,7 +40,7 @@
 
   <!-- Title -->
   <text x="480" y="36" text-anchor="middle" font-size="20" font-weight="700" fill="#1f2937">CodeActor Agent — System Architecture</text>
-  <text x="480" y="56" text-anchor="middle" font-size="11" fill="#9ca3af">Hub-and-Spoke Multi-Agent · 6 Sub-Agents · 22 Tools · Rust Codebase Engine</text>
+  <text x="480" y="56" text-anchor="middle" font-size="11" fill="#9ca3af">Hub-and-Spoke Multi-Agent · 6 Sub-Agents · 22 Tools · Rust Codexray Engine</text>
 
   <!-- ============================================================ -->
   <!-- LAYER 1: Interaction -->
@@ -239,9 +239,9 @@
   <text x="345" y="954" text-anchor="middle" font-size="10" fill="#6b7280">DeepSeek reasoning_content · streaming + non-streaming</text>
   <text x="345" y="970" text-anchor="middle" font-size="9" fill="#9ca3af">LoggingEngine → ~/.codeactor/logs/llm-{date}.log</text>
 
-  <!-- Codebase Service -->
+  <!-- Codexray Service -->
   <rect x="555" y="862" width="380" height="115" rx="6" fill="#fff" stroke="#d1d5db" stroke-width="1"/>
-  <text x="745" y="882" text-anchor="middle" font-size="12" font-weight="700" fill="#374151">Codebase Service (Rust)</text>
+  <text x="745" y="882" text-anchor="middle" font-size="12" font-weight="700" fill="#374151">Codexray Service (Rust)</text>
   <text x="745" y="899" text-anchor="middle" font-size="10.5" fill="#4b5563">auto-launch · health-check · retry ×3 · cleanup</text>
   <line x1="570" y1="906" x2="920" y2="906" stroke="#e5e7eb" stroke-width="0.5"/>
   <text x="745" y="922" text-anchor="middle" font-size="10" fill="#6b7280">Tree-sitter: Rust · Python · JS/TS · Java · C++ · Go</text>
diff --git a/docs/knowledge-indexing-and-retrieval.md b/docs/knowledge-indexing-and-retrieval.md
index d6146d4..c59ae24 100644
--- a/docs/knowledge-indexing-and-retrieval.md
+++ b/docs/knowledge-indexing-and-retrieval.md
@@ -25,14 +25,14 @@
 
 ### 1.1 背景
 
-CodeActor 项目采用 **Hub-and-Spoke（中枢-辐条）** 多智能体架构，由 Go 实现的 Agent 系统（`codeactor-agent`）与 Rust 实现的代码分析服务（`codeactor-codebase`）协同工作。知识索引与检索是整个系统的核心基础设施，为 Agent 提供代码理解、语义搜索和依赖分析能力。
+CodeActor 项目采用 **Hub-and-Spoke（中枢-辐条）** 多智能体架构，由 Go 实现的 Agent 系统（`codeactor-agent`）与 Rust 实现的代码分析服务（`codeactor-codexray`）协同工作。知识索引与检索是整个系统的核心基础设施，为 Agent 提供代码理解、语义搜索和依赖分析能力。
 
 ### 1.2 核心组件
 
 | 组件 | 语言 | 职责 |
 |------|------|------|
-| **CodeBase Server** | Rust | 源码解析、图谱构建、向量嵌入、HTTP API 服务 |
-| **RepoOperationsTool** | Go | Agent 侧封装，通过 HTTP 调用 CodeBase 服务 |
+| **CodeXRay Server** | Rust | 源码解析、图谱构建、向量嵌入、HTTP API 服务 |
+| **RepoOperationsTool** | Go | Agent 侧封装，通过 HTTP 调用 CodeXRay 服务 |
 | **StorageManager** | Rust | 图谱缓存、持久化、文件监听、嵌入任务调度 |
 | **CodeGraph** | Rust | 函数调用有向图（Petgraph DiGraph） |
 | **EmbeddingService** | Rust | 向量索引构建与语义检索 |
@@ -41,7 +41,7 @@ CodeActor 项目采用 **Hub-and-Spoke（中枢-辐条）** 多智能体架构
 
 #### 1.3.1 单进程单仓库
 
-每个 CodeBase 进程在启动时通过 `--repo-path` 参数绑定一个代码仓库，生命周期内不可切换。
+每个 CodeXRay 进程在启动时通过 `--repo-path` 参数绑定一个代码仓库，生命周期内不可切换。
 
 **设计动机**：
 - 简化 API 设计，端点无需携带仓库路径参数
@@ -64,7 +64,7 @@ fn try_bind_repo(&self, repo_path: &str) -> Result<(), String> {
 
 #### 1.3.2 启动自初始化
 
-`CodeBaseServer::start()` 在绑定端口前执行完整初始化：
+`CodeXRayServer::start()` 在绑定端口前执行完整初始化：
 
 ```
 启动流程:
@@ -484,7 +484,7 @@ Tree-sitter 解析 → 提取函数/结构体声明
 |------|------|---------|------|------|
 | `GET` | `/health` | `health_check` | 健康检查 | 无 |
 | `GET` | `/status` | `get_status` | 当前仓库状态 | 无 |
-| `POST` | `/codebase_init` | `perform_analysis` | 初始化代码索引 | 无 |
+| `POST` | `/codexray_init` | `perform_analysis` | 初始化代码索引 | 无 |
 | `POST` | `/query_call_graph` | `query_call_graph` | 查询函数调用图谱 | 无 |
 | `POST` | `/query_hierarchical_graph` | `query_hierarchical_graph` | 查询层级调用树 | 无 |
 | `POST` | `/query_code_skeleton` | `query_code_skeleton` | 批量提取代码骨架 | 无 |
@@ -574,11 +574,11 @@ GET /status
 | `embedding_enabled` | boolean | 是否启用嵌入索引 |
 | `indexing_status` | string | 索引状态: `not_started` / `indexing` / `completed` / `failed` |
 
-#### 4.3.3 `POST /codebase_init` — 初始化代码索引
+#### 4.3.3 `POST /codexray_init` — 初始化代码索引
 
 **请求**:
 ```http
-POST /codebase_init
+POST /codexray_init
 Content-Type: application/json
 
 {
@@ -988,16 +988,16 @@ package tools
 
 import "context"
 
-// RepoOperationsTool 封装与 codebase Rust 服务的 HTTP 通信
+// RepoOperationsTool 封装与 codexray Rust 服务的 HTTP 通信
 type RepoOperationsTool struct {
-    CodebaseURL string            // CodeBase 服务地址，如 "http://127.0.0.1:12800"
+    CodexrayURL string            // CodeXRay 服务地址，如 "http://127.0.0.1:12800"
     ProjectPath string            // 当前项目/仓库路径
 }
 
 // NewRepoOperationsTool 构造函数
-func NewRepoOperationsTool(codebaseURL, projectPath string) *RepoOperationsTool {
+func NewRepoOperationsTool(codexrayURL, projectPath string) *RepoOperationsTool {
     return &RepoOperationsTool{
-        CodebaseURL: codebaseURL,
+        CodexrayURL: codexrayURL,
         ProjectPath: projectPath,
     }
 }
@@ -1041,7 +1041,7 @@ func (t *RepoOperationsTool) ExecuteSemanticSearch(ctx context.Context, params m
     }
 
     // 2. 发送 HTTP 请求 (含 3 次重试)
-    body, err := t.doCodebaseRequest("/semantic_search", map[string]interface{}{
+    body, err := t.doCodexrayRequest("/semantic_search", map[string]interface{}{
         "repo_path": t.ProjectPath,
         "limit":     limit,
         "text":      query,
@@ -1124,18 +1124,18 @@ QueryCodeSnippetResponse{
 
 ### 5.3 底层 HTTP 请求封装
 
-#### 5.3.1 doCodebaseRequest — 带重试的 HTTP 请求
+#### 5.3.1 doCodexrayRequest — 带重试的 HTTP 请求
 
 ```go
-// doCodebaseRequest 发送 HTTP POST 到 codebase 服务，含重试逻辑
+// doCodexrayRequest 发送 HTTP POST 到 codexray 服务，含重试逻辑
 // 返回成功时的响应体字节
-func (t *RepoOperationsTool) doCodebaseRequest(endpoint string, body interface{}) ([]byte, error) {
+func (t *RepoOperationsTool) doCodexrayRequest(endpoint string, body interface{}) ([]byte, error) {
     bodyBytes, err := json.Marshal(body)
     if err != nil {
         return nil, fmt.Errorf("failed to marshal request: %w", err)
     }
 
-    url := fmt.Sprintf("%s%s", t.CodebaseURL, endpoint)
+    url := fmt.Sprintf("%s%s", t.CodexrayURL, endpoint)
 
     var lastErr error
     for attempt := 0; attempt < 3; attempt++ {
@@ -1172,7 +1172,7 @@ func (t *RepoOperationsTool) doCodebaseRequest(endpoint string, body interface{}
         return respBody, nil
     }
 
-    return nil, fmt.Errorf("codebase request failed after 3 retries: %w", lastErr)
+    return nil, fmt.Errorf("codexray request failed after 3 retries: %w", lastErr)
 }
 ```
 
@@ -1184,7 +1184,7 @@ func (t *RepoOperationsTool) doCodebaseRequest(endpoint string, body interface{}
 ### 5.4 响应结构定义
 
 ```go
-// QueryCodeSkeletonResponse codebase /query_code_skeleton 响应
+// QueryCodeSkeletonResponse codexray /query_code_skeleton 响应
 type QueryCodeSkeletonResponse struct {
     Success bool `json:"success"`
     Data    struct {
@@ -1196,7 +1196,7 @@ type QueryCodeSkeletonResponse struct {
     } `json:"data"`
 }
 
-// QueryCodeSnippetResponse codebase /query_code_snippet 响应
+// QueryCodeSnippetResponse codexray /query_code_snippet 响应
 type QueryCodeSnippetResponse struct {
     Success bool `json:"success"`
     Data    struct {
@@ -1290,17 +1290,17 @@ func registerRepoOperationsTool(agentType string, tool *RepoOperationsTool) []ll
 
 ### 5.6 错误处理
 
-Go 层通过 `doCodebaseRequest` 统一处理错误：
+Go 层通过 `doCodexrayRequest` 统一处理错误：
 
 | 错误类型 | 返回 | 示例 |
 |----------|------|------|
 | JSON 序列化失败 | `nil, error` | `"failed to marshal request: ..."` |
 | HTTP 请求失败 | `nil, error` | `"failed to send request: ..."` |
 | 非 200 状态码 | `nil, error` | `"server returned status 500: ..."` |
-| 重试耗尽 | `nil, error` | `"codebase request failed after 3 retries: ..."` |
+| 重试耗尽 | `nil, error` | `"codexray request failed after 3 retries: ..."` |
 | 参数类型错误 | `nil, error` | `"query parameter must be a string"` |
 | 响应 unsuccessful | `nil, error` | `"server returned unsuccessful response: ..."` |
-| 服务不可用 | `nil, error` | `"codebase request failed after 3 retries: failed to send request: dial tcp 127.0.0.1:12800: connect: connection refused"` |
+| 服务不可用 | `nil, error` | `"codexray request failed after 3 retries: failed to send request: dial tcp 127.0.0.1:12800: connect: connection refused"` |
 
 ---
 
@@ -1326,7 +1326,7 @@ Go 层通过 `doCodebaseRequest` 统一处理错误：
 ┌─────────────────────────────────────────────────────────────────────────┐
 │  ExecuteTask()                                                          │
 │  ┌─────────────────────────────────────────────────────────────────┐    │
-│  │ Step 1: POST /codebase_init (Go → Rust codebase service)        │    │
+│  │ Step 1: POST /codexray_init (Go → Rust codexray service)        │    │
 │  │   目的: 初始化代码索引                                            │    │
 │  │   触发: 全量 AST 解析 + 图谱构建 + 嵌入索引构建                   │    │
 │  └─────────────────────────────────────────────────────────────────┘    │
@@ -1378,7 +1378,7 @@ Go 层通过 `doCodebaseRequest` 统一处理错误：
        │                     │ HTTP POST
        │                     ▼
        │          ┌──────────────────────┐
-       │          │ CodeBase Server      │
+       │          │ CodeXRay Server      │
        │          │ (Rust, :12800)       │
        │          └──────────┬───────────┘
        │                     │
@@ -1459,7 +1459,7 @@ ConductorAgent 接收摘要
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
-│                    CodeBase Server 后台任务                      │
+│                    CodeXRay Server 后台任务                      │
 ├─────────────────────────────────────────────────────────────────┤
 │                                                                  │
 │  setup_watcher()                                                 │
@@ -1500,11 +1500,11 @@ ConductorAgent 接收摘要
 
 | 文档 | 路径 | 本文档与之的关系 |
 |------|------|-----------------|
-| `codebase/docs/ARCHITECTURE.md` | `codebase/docs/ARCHITECTURE.md` | **补充细化**: 本文档将其中关于检索 API 的部分系统化，补充 Go 层封装细节 |
+| `codexray/docs/ARCHITECTURE.md` | `codexray/docs/ARCHITECTURE.md` | **补充细化**: 本文档将其中关于检索 API 的部分系统化，补充 Go 层封装细节 |
 | `docs/ARCHITECTURE.md` | `docs/ARCHITECTURE.md` | **引用关系**: 本文档描述 Go 层 `RepoOperationsTool` 如何调用 Rust 服务，与其中第 5.5 节、第 6.3 节互补 |
 | `docs/Agent_Design.md` | `docs/Agent_Design.md` | **实现落地**: 将其中"代码检索"、"code_search"设计转化为具体的接口定义 |
 
-### 7.2 与 codebase/docs/ARCHITECTURE.md 的关系
+### 7.2 与 codexray/docs/ARCHITECTURE.md 的关系
 
 | 章节 | 原文档 | 本文档补充 |
 |------|--------|-----------|
@@ -1527,7 +1527,7 @@ ConductorAgent 接收摘要
 ┌─────────────────────────────────────────────────────────────┐
 │                    文档体系                                   │
 ├──────────────────┬──────────────────────────────────────────┤
-│ codebase docs    │ 聚焦 Rust 服务内部实现细节                 │
+│ codexray docs    │ 聚焦 Rust 服务内部实现细节                 │
 │ ARCHITECTURE     │ - 模块架构                                │
 │                  │ - 核心数据结构                             │
 │                  │ - 持久化格式                               │
@@ -1562,13 +1562,13 @@ ConductorAgent 接收摘要
 #### 8.1.1 Rust 层测试
 
 ```rust
-// codebase/tests/test_functional.rs 中新增
+// codexray/tests/test_functional.rs 中新增
 
 #[tokio::test]
 async fn test_query_call_graph() {
     // 1. 启动测试服务器
     let storage = create_test_storage();
-    let server = CodeBaseServer::new(storage, "/path/to/test/repo");
+    let server = CodeXRayServer::new(storage, "/path/to/test/repo");
     
     // 2. 发送请求
     let resp = reqwest::Client::new()
@@ -1674,7 +1674,7 @@ func TestRetryLogic(t *testing.T) {
     defer server.Close()
     
     tool := NewRepoOperationsTool(server.URL, "/path/to/repo")
-    _, err := tool.doCodebaseRequest("/semantic_search", nil)
+    _, err := tool.doCodexrayRequest("/semantic_search", nil)
     
     assert.NoError(t, err)
     assert.Equal(t, 3, callCount)
@@ -1693,8 +1693,8 @@ set -e
 
 echo "=== Knowledge Retrieval Integration Tests ==="
 
-# 1. 启动 CodeBase 服务
-echo "[1/5] Starting codebase server..."
+# 1. 启动 CodeXRay 服务
+echo "[1/5] Starting codexray server..."
 cargo run -- server --repo-path /tmp/test-repo --address 127.0.0.1:12800 &
 SERVER_PID=$!
 sleep 5
@@ -1768,7 +1768,7 @@ echo "=== All tests passed ==="
 | 不存在的文件 | 返回 `success: false, error: "file not found"` |
 | 不存在的函数 | 返回空 functions 列表 |
 | 语义搜索无结果 | 返回空 results 列表 |
-| CodeBase 服务未启动 | Go 层重试 3 次后返回错误 |
+| CodeXRay 服务未启动 | Go 层重试 3 次后返回错误 |
 | 超大响应 (>1MB) | 设置响应体大小限制 |
 | 非法 JSON 输入 | 返回 400 Bad Request |
 
@@ -1783,7 +1783,7 @@ echo "=== All tests passed ==="
 ```toml
 # ~/.codeactor/config/config.toml
 
-[codebase.embedding]
+[codexray.embedding]
 model = "Qwen/Qwen3-Embedding-4B"          # 嵌入模型
 api_base_url = "https://api.siliconflow.cn/v1"  # API 端点
 api_token = "sk-..."                        # API 密钥
@@ -1838,7 +1838,7 @@ Authorization: Bearer sk-...
 
 ### 9.2 存储路径规范
 
-#### 9.2.1 CodeBase 持久化
+#### 9.2.1 CodeXRay 持久化
 
 ```
 .codegraph_db/
@@ -1883,15 +1883,15 @@ data/
 
 ### 9.3 配置系统
 
-#### 9.3.1 CodeBase 配置
+#### 9.3.1 CodeXRay 配置
 
 ```toml
 # ~/.codeactor/config/config.toml
 
 [http]
-server_port = 12800           # CodeBase HTTP 端口
+server_port = 12800           # CodeXRay HTTP 端口
 
-[codebase]
+[codexray]
 enable_embedding = true       # 是否启用语义搜索
 # 数据目录自动生成在 $HOME/.codeactor/data/
 #   embedding/ — 全局共享索引（BM25 + LanceDB 向量库）
@@ -1947,13 +1947,13 @@ A: 简化 API 设计、避免并发冲突。多仓库场景通过启动多个进
 A: 不同模型的嵌入向量不兼容，切换模型后必须重新计算。包含模型名的 hash 确保缓存隔离。
 
 **Q3: 如何切换嵌入模型？**  
-A: 修改 `config.toml` 中的 `model` 字段，重启 CodeBase 服务。旧缓存不会误用，但需要重新构建索引。
+A: 修改 `config.toml` 中的 `model` 字段，重启 CodeXRay 服务。旧缓存不会误用，但需要重新构建索引。
 
 **Q4: 语义搜索的 `score` 越大越相关吗？**  
 A: 是的。该值已统一转换为相关性分数（范围 0-1），值越大表示语义越相似。底层 Dense 搜索使用 `1 / (1 + L2距离)` 将距离转换为分数。
 
-**Q5: CodeBase 服务与 Agent 如何协同？**  
-A: Agent 启动时自动启动 CodeBase 子进程 (:12800)，通过 `RepoOperationsTool` 封装 HTTP 调用。服务生命周期由 Agent 管理。
+**Q5: CodeXRay 服务与 Agent 如何协同？**  
+A: Agent 启动时自动启动 CodeXRay 子进程 (:12800)，通过 `RepoOperationsTool` 封装 HTTP 调用。服务生命周期由 Agent 管理。
 
 ### 9.6 术语表
 
diff --git a/docs/multi_stage_retrieval_pipeline.md b/docs/multi_stage_retrieval_pipeline.md
index bfa4cee..5ea16d4 100644
--- a/docs/multi_stage_retrieval_pipeline.md
+++ b/docs/multi_stage_retrieval_pipeline.md
@@ -1,7 +1,7 @@
 # 多阶段级联检索 Pipeline：架构设计与实现路径
 
 > **版本**: v1.0  
-> **项目**: codeactor-agent / codebase (Rust 代码分析引擎)  
+> **项目**: codeactor-agent / codexray (Rust 代码分析引擎)  
 > **目标读者**: 核心 Rust 开发、AI Agent 架构师、检索系统工程师  
 > **文档性质**: 架构设计与实现路径规格书（Architecture RFC）
 
@@ -11,7 +11,7 @@
 
 ### 1.1 项目定位
 
-`codebase` 是 `codeactor-agent` 系统的**代码分析与检索中枢**。它为上层 Agent（Conductor、Coding-Agent、Repo-Agent）提供以下核心能力：
+`codexray` 是 `codeactor-agent` 系统的**代码分析与检索中枢**。它为上层 Agent（Conductor、Coding-Agent、Repo-Agent）提供以下核心能力：
 
 | 能力 | 实现模块 | 技术栈 |
 |------|---------|--------|
@@ -70,10 +70,10 @@
 
 ### 2.1 索引构建数据流
 
-当前系统的索引构建在 `CodeBaseServer::start()` 启动时触发，完整流程如下：
+当前系统的索引构建在 `CodeXRayServer::start()` 启动时触发，完整流程如下：
 
 ```
-CodeBaseServer::start()
+CodeXRayServer::start()
     │
     ├── try_bind_repo() ── 绑定仓库路径
     │
@@ -1392,7 +1392,7 @@ pub fn retrieval_routes() -> Router<Arc<StorageManager>> {
 
 ### 7.5 配置管理
 
-建议通过 `codebase/` 的 `config.toml` 管理 Pipeline 配置：
+建议通过 `codexray/` 的 `config.toml` 管理 Pipeline 配置：
 
 ```toml
 # config.toml（扩展）
@@ -1405,7 +1405,7 @@ enable_graph_expansion = false  # 待边类型完善后开启
 
 # Stage 1: Hybrid Search
 [retrieval_pipeline.hybrid]
-bm25_index_path = ".codebase/index.bm25/"
+bm25_index_path = ".codexray/index.bm25/"
 fusion_k = 60
 top_k_per_channel = 200
 
@@ -1529,18 +1529,18 @@ pub struct PipelineFeatures {
 
 | 文件 | 关键类型/函数 | 文档章节 |
 |------|-------------|---------|
-| `codebase/src/codegraph/types.rs` | `PetCodeGraph`, `FunctionInfo`, `CallRelation`, `FileIndex`, `SnippetIndex` | §2.2, §4 |
-| `codebase/src/codegraph/parser.rs` | `CodeParser::build_petgraph_code_graph()`, `_analyze_file_calls()` | §2.1 |
-| `codebase/src/services/embedding_service.rs` | `EmbeddingService::search()`, `vectorize_directory()` | §2.3, §3 |
-| `codebase/src/services/analyzer.rs` | `CodeAnalyzer::find_callers()`, `find_callees()`, `find_call_chains()` | §2.3, §4 |
-| `codebase/src/storage/traits.rs` | `GraphPersistence`, `IncrementalUpdater`, `GraphSerializer` | §2.4 |
-| `codebase/src/storage/incremental.rs` | `IncrementalManager::refresh_file()`, `needs_update()` | §2.4, §3.5 |
-| `codebase/src/storage/persistence.rs` | `PersistenceManager` | §2.1 |
-| `codebase/src/http/handlers/mod.rs` | `query_call_graph()`, `query_code_snippet()`, `expand_call_chain()` | §2.3 |
-| `codebase/src/http/handlers/vectorize.rs` | `semantic_search()` | §2.3 |
-| `codebase/src/http/models/query.rs` | `QueryCallGraphRequest/Response` | §2.3 |
-| `codebase/src/http/models/embedding.rs` | `SemanticSearchRequest/Response` | §2.3 |
-| `codebase/src/storage/mod.rs` | `StorageManager` | §2.1 |
+| `codexray/src/codegraph/types.rs` | `PetCodeGraph`, `FunctionInfo`, `CallRelation`, `FileIndex`, `SnippetIndex` | §2.2, §4 |
+| `codexray/src/codegraph/parser.rs` | `CodeParser::build_petgraph_code_graph()`, `_analyze_file_calls()` | §2.1 |
+| `codexray/src/services/embedding_service.rs` | `EmbeddingService::search()`, `vectorize_directory()` | §2.3, §3 |
+| `codexray/src/services/analyzer.rs` | `CodeAnalyzer::find_callers()`, `find_callees()`, `find_call_chains()` | §2.3, §4 |
+| `codexray/src/storage/traits.rs` | `GraphPersistence`, `IncrementalUpdater`, `GraphSerializer` | §2.4 |
+| `codexray/src/storage/incremental.rs` | `IncrementalManager::refresh_file()`, `needs_update()` | §2.4, §3.5 |
+| `codexray/src/storage/persistence.rs` | `PersistenceManager` | §2.1 |
+| `codexray/src/http/handlers/mod.rs` | `query_call_graph()`, `query_code_snippet()`, `expand_call_chain()` | §2.3 |
+| `codexray/src/http/handlers/vectorize.rs` | `semantic_search()` | §2.3 |
+| `codexray/src/http/models/query.rs` | `QueryCallGraphRequest/Response` | §2.3 |
+| `codexray/src/http/models/embedding.rs` | `SemanticSearchRequest/Response` | §2.3 |
+| `codexray/src/storage/mod.rs` | `StorageManager` | §2.1 |
 
 ---
 
diff --git a/docs/retrieval-quality-analysis.md b/docs/retrieval-quality-analysis.md
index 8f092c7..649abf3 100644
--- a/docs/retrieval-quality-analysis.md
+++ b/docs/retrieval-quality-analysis.md
@@ -47,8 +47,8 @@ RRF融合 (hybrid_search.rs:207-218): 双通道分数叠加 → 排名显著前
 
 #### 环节一：符号解析 — interface 被当作 StructDeclaration
 
-**文件**: `codebase/src/codegraph/treesitter/structs.rs:26-38`  
-**文件**: `codebase/src/codegraph/treesitter/parsers/ts.rs:605`
+**文件**: `codexray/src/codegraph/treesitter/structs.rs:26-38`  
+**文件**: `codexray/src/codegraph/treesitter/parsers/ts.rs:605`
 
 ```rust
 // structs.rs — SymbolType 枚举：没有 InterfaceDeclaration 变体
@@ -70,7 +70,7 @@ pub enum SymbolType {
 
 #### 环节二：索引构建 — 无任何质量过滤
 
-**文件**: `codebase/src/services/embedding_service.rs:364-450`
+**文件**: `codexray/src/services/embedding_service.rs:364-450`
 
 ```rust
 // process_file_content() 方法中
@@ -106,7 +106,7 @@ for symbol in symbols {
 
 #### 环节三：向量搜索 — 无分数阈值
 
-**文件**: `codebase/src/services/embedding_service.rs:595-602`
+**文件**: `codexray/src/services/embedding_service.rs:595-602`
 
 ```rust
 // 从 LanceDB 搜索结果中读取距离并转换分数
@@ -121,7 +121,7 @@ let score = (1.0 / (1.0 + distance)) as f32;
 
 #### 环节四：BM25 搜索 — 算法偏袒短文档
 
-**文件**: `codebase/src/storage/tantivy_index.rs:282-284`
+**文件**: `codexray/src/storage/tantivy_index.rs:282-284`
 
 ```rust
 let query_parser = QueryParser::for_index(
@@ -139,7 +139,7 @@ let query_parser = QueryParser::for_index(
 
 #### 环节五：RRF 融合 — 双通道叠加放大
 
-**文件**: `codebase/src/services/hybrid_search.rs:195-235`
+**文件**: `codexray/src/services/hybrid_search.rs:195-235`
 
 ```rust
 fn reciprocal_rank_fusion(&self, dense, sparse, limit) {
@@ -185,7 +185,7 @@ fn reciprocal_rank_fusion(&self, dense, sparse, limit) {
 **文件**: `config.toml`
 
 ```toml
-[codebase.retrieval_pipeline.hybrid]
+[codexray.retrieval_pipeline.hybrid]
 bm25_top_k = 20      # BM25每通道召回20条
 vector_top_k = 20    # 向量每通道召回20条
 rrf_k = 60           # RRF融合参数
@@ -200,7 +200,7 @@ rrf_top_k = 20       # 最终保留20条
 
 ### P0 — 索引阶段添加最小长度过滤（高优先级，低成本）
 
-**文件**: `codebase/src/services/embedding_service.rs`，在 `process_file_content()` 第405行之前
+**文件**: `codexray/src/services/embedding_service.rs`，在 `process_file_content()` 第405行之前
 
 ```rust
 // 在 extracted 解构之后、索引之前添加
@@ -226,7 +226,7 @@ if let Some((code_block, name, symbol_type_str, language_str, start_row, end_row
 
 ### P1 — 搜索结果后处理短文档降权（中优先级，安全网）
 
-**文件**: `codebase/src/services/hybrid_search.rs`，在 `reciprocal_rank_fusion()` 返回前
+**文件**: `codexray/src/services/hybrid_search.rs`，在 `reciprocal_rank_fusion()` 返回前
 
 对最终排序结果，对 `code_block` 过短的候选进行软惩罚：
 
@@ -239,13 +239,13 @@ final_score *= penalty_factor
 
 ### P2 — SymbolType 增加 InterfaceDeclaration 变体（低优先级，可独立做）
 
-**文件**: `codebase/src/codegraph/treesitter/structs.rs` + `parsers/ts.rs`
+**文件**: `codexray/src/codegraph/treesitter/structs.rs` + `parsers/ts.rs`
 
 将 interface 从 StructDeclaration 中分离出来，使索引层可以独立控制是否索引 interface 类型。
 
 ### P3 — Fallback 机制增加保护（低优先级，但建议尽快做）
 
-**文件**: `codebase/src/services/embedding_service.rs:394-398`
+**文件**: `codexray/src/services/embedding_service.rs:394-398`
 
 当前 fallback 逻辑：
 ```rust
diff --git a/internal/agents/commit_api_test.go b/internal/agents/commit_api_test.go
index 2e34b23..0a661a5 100644
--- a/internal/agents/commit_api_test.go
+++ b/internal/agents/commit_api_test.go
@@ -56,7 +56,7 @@ type CommitSearchRequest struct {
 
 // getBaseURL 获取 API 基础 URL，支持环境变量覆盖端口
 func getBaseURL(t *testing.T) string {
-	port := os.Getenv("CODEBASE_PORT")
+	port := os.Getenv("CODEXRAY_PORT")
 	if port == "" {
 		port = "12800"
 	}
diff --git a/internal/agents/commit_learner.go b/internal/agents/commit_learner.go
index cca15fc..bfc0ae6 100644
--- a/internal/agents/commit_learner.go
+++ b/internal/agents/commit_learner.go
@@ -84,7 +84,7 @@ type CommitLearner struct {
 	config          CommitLearnConfig
 	llmEngine       llm.Engine           // 默认 LLM 引擎
 	dedicatedEngine llm.Engine           // 专用的 LLM 引擎（可选，用于摘要生成）
-	globalCtx       *globalctx.GlobalCtx // 全局上下文，包含 CodebaseURL
+	globalCtx       *globalctx.GlobalCtx // 全局上下文，包含 CodexrayURL
 	httpClient      *http.Client
 	cache           map[string]*CachedSummary
 	cacheMu         sync.RWMutex
@@ -207,7 +207,7 @@ func (cl *CommitLearner) StoreEmbeddings(ctx context.Context, summaries []Commit
 		}
 
 		// 调用 Rust API
-		reqURL := cl.globalCtx.CodebaseURL + "/commit/embed"
+		reqURL := cl.globalCtx.CodexrayURL + "/commit/embed"
 		req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(reqJSON))
 		if err != nil {
 			// 创建请求失败，跳过该 commit
@@ -260,7 +260,7 @@ func (cl *CommitLearner) SearchSimilar(ctx context.Context, userInput string, to
 	}
 
 	// 调用 Rust API
-	reqURL := cl.globalCtx.CodebaseURL + "/commit/search"
+	reqURL := cl.globalCtx.CodexrayURL + "/commit/search"
 	req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(reqJSON))
 	if err != nil {
 		return nil, fmt.Errorf("failed to create search request: %w", err)
@@ -317,7 +317,7 @@ func (cl *CommitLearner) ClearCommits(ctx context.Context) error {
 		return fmt.Errorf("failed to marshal clear request: %w", err)
 	}
 
-	reqURL := cl.globalCtx.CodebaseURL + "/commit/clear"
+	reqURL := cl.globalCtx.CodexrayURL + "/commit/clear"
 	req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(reqJSON))
 	if err != nil {
 		return fmt.Errorf("failed to create clear request: %w", err)
diff --git a/internal/agents/commit_manager.go b/internal/agents/commit_manager.go
index 7e3d982..535c665 100644
--- a/internal/agents/commit_manager.go
+++ b/internal/agents/commit_manager.go
@@ -49,7 +49,7 @@ type CommitManager struct {
 //   - cfg: 全局配置（从中读取 CommitLearner 配置）
 //   - llmEngine: LLM 引擎，用于生成 commit 摘要
 //   - llmClient: LLM 客户端，用于获取专用引擎（如果配置了 summarization_provider）
-//   - globalCtx: 全局上下文，包含 CodebaseURL
+//   - globalCtx: 全局上下文，包含 CodexrayURL
 //
 // 返回值:
 //   - *CommitManager: 初始化的管理器实例
diff --git a/internal/agents/conductor_test.go b/internal/agents/conductor_test.go
index 3655f14..c736c6f 100644
--- a/internal/agents/conductor_test.go
+++ b/internal/agents/conductor_test.go
@@ -39,7 +39,7 @@ func newTestGlobalCtx(workDir string) *globalctx.GlobalCtx {
 		OS:           "linux",
 		Arch:         "amd64",
 		SpeakLang:    "Chinese",
-		CodebaseURL:  "http://127.0.0.1:12800",
+		CodexrayURL:  "http://127.0.0.1:12800",
 		FileOps:      tools.NewFileOperationsTool(workDir),
 		SearchOps:    tools.NewSearchOperationsTool(workDir),
 		SysOps:       tools.NewSystemOperationsTool(workDir),
diff --git a/internal/agents/repo.go b/internal/agents/repo.go
index 074f20f..e5e1452 100644
--- a/internal/agents/repo.go
+++ b/internal/agents/repo.go
@@ -116,7 +116,7 @@ func (a *RepoAgent) doPreInvestigate(projectDir string) (*PreInvestigateResponse
 		return nil, fmt.Errorf("failed to marshal request data: %v", err)
 	}
 
-	url := fmt.Sprintf("%s/investigate_repo", a.GlobalCtx.CodebaseURL)
+	url := fmt.Sprintf("%s/investigate_repo", a.GlobalCtx.CodexrayURL)
 	slog.Info("RepoAgent pre-investigation request", "project_dir", projectDir)
 
 	var lastErr error
@@ -175,7 +175,7 @@ func makeGetRepoOverviewFn(globalCtx *globalctx.GlobalCtx) tools.ToolFunc {
 }
 
 // executeGetRepoOverview 是 get_repo_overview 工具的实际实现
-// 它调用 codebase 服务的 /investigate_repo 端点获取仓库全景画像
+// 它调用 codexray 服务的 /investigate_repo 端点获取仓库全景画像
 func executeGetRepoOverview(globalCtx *globalctx.GlobalCtx) (interface{}, error) {
 	projectDir := globalCtx.ProjectPath
 
@@ -192,7 +192,7 @@ func executeGetRepoOverview(globalCtx *globalctx.GlobalCtx) (interface{}, error)
 		return "", fmt.Errorf("failed to marshal request data: %v", err)
 	}
 
-	url := fmt.Sprintf("%s/investigate_repo", globalCtx.CodebaseURL)
+	url := fmt.Sprintf("%s/investigate_repo", globalCtx.CodexrayURL)
 	slog.Info("get_repo_overview request", "project_dir", projectDir)
 
 	var lastErr error
diff --git a/internal/agents/repo_knowledge_manager.go b/internal/agents/repo_knowledge_manager.go
index b234337..b40dcff 100644
--- a/internal/agents/repo_knowledge_manager.go
+++ b/internal/agents/repo_knowledge_manager.go
@@ -49,10 +49,10 @@ func NewRepoKnowledgeManager(agent Agent, globalCtx *globalctx.GlobalCtx, thresh
 
 // AnalyseTask 核心方法：先搜索相似历史，命中则返回缓存，否则执行并异步存储。
 // 如果搜索失败，fallback 到正常 RepoAgent 执行。
-// 如果 globalCtx.CodebaseURL 为空，直接 fallback 到正常执行。
+// 如果 globalCtx.CodexrayURL 为空，直接 fallback 到正常执行。
 func (m *RepoKnowledgeManager) AnalyseTask(ctx context.Context, task string) (string, error) {
-	// 如果 CodebaseURL 为空，优雅降级
-	if m.globalCtx == nil || m.globalCtx.CodebaseURL == "" {
+	// 如果 CodexrayURL 为空，优雅降级
+	if m.globalCtx == nil || m.globalCtx.CodexrayURL == "" {
 		result, err := m.agent.Run(ctx, task)
 		if err != nil {
 			return "", err
@@ -105,7 +105,7 @@ func (m *RepoKnowledgeManager) searchSimilar(ctx context.Context, task string) (
 		return nil, fmt.Errorf("marshal request: %w", err)
 	}
 
-	reqURL := m.globalCtx.CodebaseURL + "/repo_knowledge/search"
+	reqURL := m.globalCtx.CodexrayURL + "/repo_knowledge/search"
 	req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(reqJSON))
 	if err != nil {
 		return nil, fmt.Errorf("create request: %w", err)
@@ -153,7 +153,7 @@ func (m *RepoKnowledgeManager) embedTaskAndResult(ctx context.Context, task, res
 		return fmt.Errorf("marshal request: %w", err)
 	}
 
-	reqURL := m.globalCtx.CodebaseURL + "/repo_knowledge/embed"
+	reqURL := m.globalCtx.CodexrayURL + "/repo_knowledge/embed"
 	req, err := http.NewRequestWithContext(ctx, http.MethodPost, reqURL, bytes.NewReader(reqJSON))
 	if err != nil {
 		return fmt.Errorf("create request: %w", err)
diff --git a/internal/agents/repo_knowledge_test.go b/internal/agents/repo_knowledge_test.go
index 4d028df..df0e212 100644
--- a/internal/agents/repo_knowledge_test.go
+++ b/internal/agents/repo_knowledge_test.go
@@ -57,10 +57,10 @@ func TestRepoKnowledgeManager_SearchSimilar_Success(t *testing.T) {
 	}))
 	defer server.Close()
 
-	// 创建 globalCtx 并覆盖 CodebaseURL 为 mock server
+	// 创建 globalCtx 并覆盖 CodexrayURL 为 mock server
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	// 创建 mock RepoAgent
 	agent := &RepoAgent{
@@ -105,7 +105,7 @@ func TestRepoKnowledgeManager_SearchSimilar_ServerError(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -133,7 +133,7 @@ func TestRepoKnowledgeManager_SearchSimilar_InvalidJSON(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -173,7 +173,7 @@ func TestRepoKnowledgeManager_EmbedTaskAndResult_Success(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -204,7 +204,7 @@ func TestRepoKnowledgeManager_EmbedTaskAndResult_ServerError(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -252,7 +252,7 @@ func TestRepoKnowledgeManager_AnalyseTask_CacheHit(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	// 创建一个 mock RepoAgent，通过 atomic 记录是否被调用
 	mockAgent := &mockRepoAgent{
@@ -322,7 +322,7 @@ func TestRepoKnowledgeManager_AnalyseTask_CacheMiss(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	mockAgent := &mockRepoAgent{
 		runFn: func(ctx context.Context, task string) (AgentResult, error) {
@@ -356,15 +356,15 @@ func TestRepoKnowledgeManager_AnalyseTask_CacheMiss(t *testing.T) {
 	}
 }
 
-// ── TestRepoKnowledgeManager_AnalyseTask_EmptyCodebaseURL ──
+// ── TestRepoKnowledgeManager_AnalyseTask_EmptyCodexrayURL ──
 
-func TestRepoKnowledgeManager_AnalyseTask_EmptyCodebaseURL(t *testing.T) {
-	// 当 CodebaseURL 为空字符串时，验证 AnalyseTask 直接调用 RepoAgent
+func TestRepoKnowledgeManager_AnalyseTask_EmptyCodexrayURL(t *testing.T) {
+	// 当 CodexrayURL 为空字符串时，验证 AnalyseTask 直接调用 RepoAgent
 	var repoAgentCalled int32
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = "" // 设置为空字符串
+	gctx.CodexrayURL = "" // 设置为空字符串
 
 	mockAgent := &mockRepoAgent{
 		runFn: func(ctx context.Context, task string) (AgentResult, error) {
@@ -379,7 +379,7 @@ func TestRepoKnowledgeManager_AnalyseTask_EmptyCodebaseURL(t *testing.T) {
 	ctx := context.Background()
 	result, err := mgr.AnalyseTask(ctx, "分析项目结构")
 	if err != nil {
-		t.Fatalf("AnalyseTask failed: nil CodebaseURL should fallback gracefully: %v", err)
+		t.Fatalf("AnalyseTask failed: nil CodexrayURL should fallback gracefully: %v", err)
 	}
 
 	if result != "直接 RepoAgent 结果" {
@@ -387,7 +387,7 @@ func TestRepoKnowledgeManager_AnalyseTask_EmptyCodebaseURL(t *testing.T) {
 	}
 
 	if atomic.LoadInt32(&repoAgentCalled) != 1 {
-		t.Error("RepoAgent.Run should have been called when CodebaseURL is empty")
+		t.Error("RepoAgent.Run should have been called when CodexrayURL is empty")
 	}
 }
 
@@ -411,7 +411,7 @@ func TestRepoKnowledgeManager_AnalyseTask_SearchErrorFallback(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	mockAgent := &mockRepoAgent{
 		runFn: func(ctx context.Context, task string) (AgentResult, error) {
@@ -483,38 +483,38 @@ func TestRepoKnowledgeManager_CustomThreshold(t *testing.T) {
 	}
 }
 
-// ─── Test 2: CodebaseURL 硬编码验证（端口写死 12800） ─────────────────────
+// ─── Test 2: CodexrayURL 硬编码验证（端口写死 12800） ─────────────────────
 
-// ── TestRepoOperationsTool_CodebaseURL_DefaultsTo12800 ──
+// ── TestRepoOperationsTool_CodexrayURL_DefaultsTo12800 ──
 
-func TestRepoOperationsTool_CodebaseURL_DefaultsTo12800(t *testing.T) {
+func TestRepoOperationsTool_CodexrayURL_DefaultsTo12800(t *testing.T) {
 	repoOps := tools.NewRepoOperationsTool("http://127.0.0.1:12800", "/tmp/test")
-	if repoOps.CodebaseURL != "http://127.0.0.1:12800" {
-		t.Errorf("CodebaseURL = %q, want %q", repoOps.CodebaseURL, "http://127.0.0.1:12800")
+	if repoOps.CodexrayURL != "http://127.0.0.1:12800" {
+		t.Errorf("CodexrayURL = %q, want %q", repoOps.CodexrayURL, "http://127.0.0.1:12800")
 	}
 }
 
-// ── TestGlobalCtx_CodebaseURL_DefaultsTo12800 ──
+// ── TestGlobalCtx_CodexrayURL_DefaultsTo12800 ──
 
-func TestGlobalCtx_CodebaseURL_DefaultsTo12800(t *testing.T) {
+func TestGlobalCtx_CodexrayURL_DefaultsTo12800(t *testing.T) {
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
 
-	// 验证 GlobalCtx 的 CodebaseURL
-	if gctx.CodebaseURL != "http://127.0.0.1:12800" {
-		t.Errorf("GlobalCtx.CodebaseURL = %q, want %q", gctx.CodebaseURL, "http://127.0.0.1:12800")
+	// 验证 GlobalCtx 的 CodexrayURL
+	if gctx.CodexrayURL != "http://127.0.0.1:12800" {
+		t.Errorf("GlobalCtx.CodexrayURL = %q, want %q", gctx.CodexrayURL, "http://127.0.0.1:12800")
 	}
 
-	// 验证 RepoOps 的 CodebaseURL
-	if gctx.RepoOps.CodebaseURL != "http://127.0.0.1:12800" {
-		t.Errorf("GlobalCtx.RepoOps.CodebaseURL = %q, want %q", gctx.RepoOps.CodebaseURL, "http://127.0.0.1:12800")
+	// 验证 RepoOps 的 CodexrayURL
+	if gctx.RepoOps.CodexrayURL != "http://127.0.0.1:12800" {
+		t.Errorf("GlobalCtx.RepoOps.CodexrayURL = %q, want %q", gctx.RepoOps.CodexrayURL, "http://127.0.0.1:12800")
 	}
 }
 
-// ── TestRepoKnowledgeManager_UsesCodebaseURL ──
+// ── TestRepoKnowledgeManager_UsesCodexrayURL ──
 
-func TestRepoKnowledgeManager_UsesCodebaseURL(t *testing.T) {
-	// 验证 RepoKnowledgeManager 使用 globalCtx.CodebaseURL 构建请求 URL
+func TestRepoKnowledgeManager_UsesCodexrayURL(t *testing.T) {
+	// 验证 RepoKnowledgeManager 使用 globalCtx.CodexrayURL 构建请求 URL
 	var capturedURL string
 	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		capturedURL = r.URL.String()
@@ -526,7 +526,7 @@ func TestRepoKnowledgeManager_UsesCodebaseURL(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -586,7 +586,7 @@ func TestDelegateRepo_WithRepoKnowledgeMgr(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	// 使用 mockEngine
 	engine := &mockEngine{
@@ -762,7 +762,7 @@ func TestSearchSimilar_RequestFormat(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -845,7 +845,7 @@ func TestRepoKnowledgeManager_AnalyseTask_EmbedErrorNonFatal(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	mockAgent := &mockRepoAgent{
 		runFn: func(ctx context.Context, task string) (AgentResult, error) {
@@ -894,7 +894,7 @@ func TestRepoKnowledgeManager_SearchSimilar_ContextCancellation(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -923,7 +923,7 @@ func TestRepoKnowledgeManager_EmbedTaskAndResult_ContextCancellation(t *testing.
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	agent := &RepoAgent{GlobalCtx: gctx}
 	mgr := NewRepoKnowledgeManager(agent, gctx, 0.95)
@@ -957,7 +957,7 @@ func TestRepoKnowledgeManager_EmptyMatches_ReturnsCacheMiss(t *testing.T) {
 
 	workDir := t.TempDir()
 	gctx := newTestGlobalCtx(workDir)
-	gctx.CodebaseURL = server.URL
+	gctx.CodexrayURL = server.URL
 
 	mockAgent := &mockRepoAgent{
 		runFn: func(ctx context.Context, task string) (AgentResult, error) {
diff --git a/internal/app/app.go b/internal/app/app.go
index b8d5160..f597708 100644
--- a/internal/app/app.go
+++ b/internal/app/app.go
@@ -33,7 +33,7 @@ type CodeActor struct {
 
 	globalCtx      *globalctx.GlobalCtx
 	DisabledAgents string // comma-separated list of agent names to disable (e.g. "repo,coding,chat")
-	CodebasePort   int    // codebase 服务端口，由 main 函数动态分配
+	CodexrayPort   int    // codebase 服务端口，由 main 函数动态分配
 
 	SkillRegistry *skills.SkillRegistry // 技能注册表，加载 .codeactor/skills/ 下的 .md 文件
 }
@@ -79,7 +79,7 @@ func (ca *CodeActor) Init(engine llm.Engine, workDir string) {
 		Arch:        runtime.GOARCH,
 		// Global utility
 		Publisher:   publisher,
-		CodebaseURL: fmt.Sprintf("http://127.0.0.1:%d", ca.CodebasePort),
+		CodexrayURL: fmt.Sprintf("http://127.0.0.1:%d", ca.CodexrayPort),
 
 		// Tools
 		FileOps:          tools.NewFileOperationsTool(workDir),
@@ -89,7 +89,7 @@ func (ca *CodeActor) Init(engine llm.Engine, workDir string) {
 		ThinkingTool:     tools.NewThinkingTool(),
 		MicroAgentTool:   tools.NewMicroAgentTool(microAgentEngine),
 		FlowOps:          tools.NewFlowControlTool(workDir),
-		RepoOps:          tools.NewRepoOperationsTool(fmt.Sprintf("http://127.0.0.1:%d", ca.CodebasePort), workDir),
+		RepoOps:          tools.NewRepoOperationsTool(fmt.Sprintf("http://127.0.0.1:%d", ca.CodexrayPort), workDir),
 		UserConfirmMgr:   userConfirmMgr,
 		DeepThinkingTool: tools.NewDeepThinkingTool(deepthinkingEngine),
 	}
diff --git a/internal/config/default_config.toml b/internal/config/default_config.toml
index 447a8c9..5414b9d 100644
--- a/internal/config/default_config.toml
+++ b/internal/config/default_config.toml
@@ -64,20 +64,20 @@ use_provider = "deepseek_v4_pro"
 enable_streaming = true
 
 # ── 代码库（语义搜索）──
-[codebase]
+[codexray]
 enable_embedding = true
 
-[codebase.embedding]
+[codexray.embedding]
 model = "Qwen/Qwen3-Embedding-4B"
 api_token = "your-key"
 api_base_url = "https://api.siliconflow.cn/v1"
 dimensions = 2560
 
 # ── 检索管线（多阶段级联检索，默认启用）──
-[codebase.retrieval_pipeline]
+[codexray.retrieval_pipeline]
 enabled = true
 
-[codebase.retrieval_pipeline.reranker]
+[codexray.retrieval_pipeline.reranker]
 enabled = false
 api_token = "your-key"
 model = "BAAI/bge-reranker-v2-m3"
diff --git a/internal/globalctx/global_context.go b/internal/globalctx/global_context.go
index 9cd6015..38a2c83 100644
--- a/internal/globalctx/global_context.go
+++ b/internal/globalctx/global_context.go
@@ -17,8 +17,8 @@ type GlobalCtx struct {
 	RepoSummary     string
 	// Global utility
 	Publisher *messaging.MessagePublisher
-	// Codebase baseurl
-	CodebaseURL string
+	// Codexray baseurl
+	CodexrayURL string
 
 	// MaxContextTokens 最大上下文token数
 	MaxContextTokens int
@@ -91,6 +91,6 @@ func (g *GlobalCtx) SetCustomizePrompt(prompt string) {
 	g.CustomizePrompt = prompt
 }
 
-func (g *GlobalCtx) SetCodebaseURL(url string) {
-	g.CodebaseURL = url
+func (g *GlobalCtx) SetCodexrayURL(url string) {
+	g.CodexrayURL = url
 }
diff --git a/internal/tools/repo_operations.go b/internal/tools/repo_operations.go
index faea911..9131e9d 100644
--- a/internal/tools/repo_operations.go
+++ b/internal/tools/repo_operations.go
@@ -11,26 +11,26 @@ import (
 )
 
 type RepoOperationsTool struct {
-	CodebaseURL string
+	CodexrayURL string
 	ProjectPath string
 }
 
-func NewRepoOperationsTool(codebaseURL, projectPath string) *RepoOperationsTool {
+func NewRepoOperationsTool(codexrayURL, projectPath string) *RepoOperationsTool {
 	return &RepoOperationsTool{
-		CodebaseURL: codebaseURL,
+		CodexrayURL: codexrayURL,
 		ProjectPath: projectPath,
 	}
 }
 
-// doCodebaseRequest sends an HTTP POST to the codebase service with retry logic.
+// doCodexrayRequest sends an HTTP POST to the codexray service with retry logic.
 // Returns the raw response body on success.
-func (t *RepoOperationsTool) doCodebaseRequest(endpoint string, body interface{}) ([]byte, error) {
+func (t *RepoOperationsTool) doCodexrayRequest(endpoint string, body interface{}) ([]byte, error) {
 	bodyBytes, err := json.Marshal(body)
 	if err != nil {
 		return nil, fmt.Errorf("failed to marshal request: %w", err)
 	}
 
-	url := fmt.Sprintf("%s%s", t.CodebaseURL, endpoint)
+	url := fmt.Sprintf("%s%s", t.CodexrayURL, endpoint)
 
 	var lastErr error
 	for attempt := 0; attempt < 3; attempt++ {
@@ -66,7 +66,7 @@ func (t *RepoOperationsTool) doCodebaseRequest(endpoint string, body interface{}
 		return respBody, nil
 	}
 
-	return nil, fmt.Errorf("codebase request failed after 3 retries: %w", lastErr)
+	return nil, fmt.Errorf("codexray request failed after 3 retries: %w", lastErr)
 }
 
 type QueryCodeSkeletonResponse struct {
@@ -105,7 +105,7 @@ func (t *RepoOperationsTool) ExecuteSemanticSearch(ctx context.Context, params m
 		limit = 5
 	}
 
-	body, err := t.doCodebaseRequest("/semantic_search", map[string]interface{}{
+	body, err := t.doCodexrayRequest("/semantic_search", map[string]interface{}{
 		"repo_path": t.ProjectPath,
 		"limit":     limit,
 		"text":      query,
@@ -135,7 +135,7 @@ func (t *RepoOperationsTool) ExecuteQueryCodeSkeleton(ctx context.Context, param
 		filepaths[i] = s
 	}
 
-	body, err := t.doCodebaseRequest("/query_code_skeleton", map[string]interface{}{
+	body, err := t.doCodexrayRequest("/query_code_skeleton", map[string]interface{}{
 		"filepaths": filepaths,
 	})
 	if err != nil {
@@ -162,7 +162,7 @@ func (t *RepoOperationsTool) ExecuteQueryCodeSnippet(ctx context.Context, params
 		return nil, fmt.Errorf("function_name parameter must be a string")
 	}
 
-	body, err := t.doCodebaseRequest("/query_code_snippet", map[string]interface{}{
+	body, err := t.doCodexrayRequest("/query_code_snippet", map[string]interface{}{
 		"filepath":      filepath,
 		"function_name": functionName,
 	})
diff --git a/internal/tui/render.go b/internal/tui/render.go
index eec3b72..b51fc06 100644
--- a/internal/tui/render.go
+++ b/internal/tui/render.go
@@ -161,7 +161,7 @@ func RenderResultBody(toolName string, content string, width int) string {
 
 	// 1. Try JSON — check for embedded fields first
 	if isJSON(content) {
-		// Detect codebase tool results by JSON structure (not tool name)
+		// Detect codexray tool results by JSON structure (not tool name)
 		if formatted := tryFormatCodebaseResult(content, bodyWidth); formatted != "" {
 			return formatted
 		}
@@ -229,8 +229,8 @@ func extractOutputField(jsonStr string) string {
 	return ""
 }
 
-// tryFormatCodebaseResult detects codebase tool result JSON by structure and formats it.
-// Returns empty string if the JSON doesn't match any known codebase result pattern.
+// tryFormatCodebaseResult detects codexray tool result JSON by structure and formats it.
+// Returns empty string if the JSON doesn't match any known codexray result pattern.
 func tryFormatCodebaseResult(content string, width int) string {
 	var parsed map[string]interface{}
 	if err := json.Unmarshal([]byte(content), &parsed); err != nil {
diff --git a/main.go b/main.go
index 8d58569..07bf005 100644
--- a/main.go
+++ b/main.go
@@ -93,24 +93,24 @@ func main() {
 }
 
 // initApp 执行 TUI 和 HTTP 模式共用的初始化逻辑
-// 返回: repoPath, codebasePort, codebaseCmd (用于清理), error
+// 返回: repoPath, codexrayPort, codexrayCmd (用于清理), error
 func initApp() (string, int, *exec.Cmd, error) {
 	repoPath, err := os.Getwd()
 	if err != nil {
 		return "", 0, nil, fmt.Errorf("failed to get current working directory: %w", err)
 	}
 
-	codebasePort, err := findAvailablePort(12800)
+	codexrayPort, err := findAvailablePort(12800)
 	if err != nil {
-		return "", 0, nil, fmt.Errorf("failed to find available port for codebase: %w", err)
+		return "", 0, nil, fmt.Errorf("failed to find available port for codexray: %w", err)
 	}
 
 	if _, err := embedbin.ExtractBinaries(distBinFS, "dist/bin"); err != nil {
 		slog.Warn("Failed to extract embedded binaries", "error", err)
 	}
 
-	codebaseCmd := startCodebaseServer(codebasePort, repoPath)
-	return repoPath, codebasePort, codebaseCmd, nil
+	codexrayCmd := startCodexrayServer(codexrayPort, repoPath)
+	return repoPath, codexrayPort, codexrayCmd, nil
 }
 
 // runTUI 启动终端 UI 模式
@@ -121,21 +121,21 @@ func runTUI(taskFile, disableAgents string) {
 	}
 	defer logging.Close()
 
-	repoPath, codebasePort, codebaseCmd, err := initApp()
+	repoPath, codexrayPort, codexrayCmd, err := initApp()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
 		os.Exit(1)
 	}
-	if codebaseCmd != nil {
+	if codexrayCmd != nil {
 		defer func() {
-			if err := codebaseCmd.Process.Kill(); err != nil {
-				slog.Warn("Failed to kill codebase process", "error", err)
+			if err := codexrayCmd.Process.Kill(); err != nil {
+				slog.Warn("Failed to kill codexray process", "error", err)
 			} else {
-				slog.Info("Codebase process killed on exit", "pid", codebaseCmd.Process.Pid)
+				slog.Info("Codebase process killed on exit", "pid", codexrayCmd.Process.Pid)
 			}
 		}()
 	} else {
-		fmt.Fprintf(os.Stderr, "WARNING: codeactor-codebase server failed to start. Semantic search and code analysis features will be unavailable.\n")
+		fmt.Fprintf(os.Stderr, "WARNING: codeactor-codexray server failed to start. Semantic search and code analysis features will be unavailable.\n")
 	}
 
 	// TUI mode init — matches original switch "tui" case exactly
@@ -166,7 +166,7 @@ func runTUI(taskFile, disableAgents string) {
 	}
 
 	codeActor.DisabledAgents = disableAgents
-	codeActor.CodebasePort = codebasePort
+	codeActor.CodexrayPort = codexrayPort
 
 	defer codeActor.Close()
 
@@ -208,17 +208,17 @@ func runHTTP(taskFile, disableAgents string, httpPort int) {
 	}
 	defer logging.Close()
 
-	_, codebasePort, codebaseCmd, err := initApp()
+	_, codexrayPort, codexrayCmd, err := initApp()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
 		os.Exit(1)
 	}
-	if codebaseCmd != nil {
+	if codexrayCmd != nil {
 		defer func() {
-			if err := codebaseCmd.Process.Kill(); err != nil {
-				slog.Warn("Failed to kill codebase process", "error", err)
+			if err := codexrayCmd.Process.Kill(); err != nil {
+				slog.Warn("Failed to kill codexray process", "error", err)
 			} else {
-				slog.Info("Codebase process killed on exit", "pid", codebaseCmd.Process.Pid)
+				slog.Info("Codebase process killed on exit", "pid", codexrayCmd.Process.Pid)
 			}
 		}()
 	}
@@ -264,7 +264,7 @@ func runHTTP(taskFile, disableAgents string, httpPort int) {
 		os.Exit(1)
 	}
 	codeActor.DisabledAgents = disableAgents
-	codeActor.CodebasePort = codebasePort
+	codeActor.CodexrayPort = codexrayPort
 
 	defer codeActor.Close()
 
@@ -326,26 +326,26 @@ func findAvailablePort(startPort int) (int, error) {
 	return 0, fmt.Errorf("no available port found starting from %d", startPort)
 }
 
-// startCodebaseServer starts the codeactor-codebase server as a background process.
+// startCodexrayServer starts the codeactor-codexray server as a background process.
 // Returns the *exec.Cmd so the caller can kill the process on exit.
-func startCodebaseServer(port int, repoPath string) *exec.Cmd {
+func startCodexrayServer(port int, repoPath string) *exec.Cmd {
 	homeDir, err := os.UserHomeDir()
 	if err != nil {
 		slog.Error("Failed to get user home directory", "error", err)
 		return nil
 	}
 
-	binPath, err := embedbin.BinPath("codeactor-codebase")
+	binPath, err := embedbin.BinPath("codeactor-codexray")
 	if err != nil {
-		slog.Error("Failed to get codeactor-codebase bin path", "error", err)
+		slog.Error("Failed to get codeactor-codexray bin path", "error", err)
 		return nil
 	}
 	if _, err := os.Stat(binPath); os.IsNotExist(err) {
-		slog.Error("codeactor-codebase binary not found, skipping startup", "path", binPath)
+		slog.Error("codeactor-codexray binary not found, skipping startup", "path", binPath)
 		return nil
 	}
 
-	logDir := filepath.Join(homeDir, ".codeactor/logs/codeactor-codebase")
+	logDir := filepath.Join(homeDir, ".codeactor/logs/codeactor-codexray")
 	if err := os.MkdirAll(logDir, 0755); err != nil {
 		slog.Error("Failed to create log directory", "error", err)
 		return nil
@@ -368,14 +368,14 @@ func startCodebaseServer(port int, repoPath string) *exec.Cmd {
 	cmd.Stderr = logFile
 
 	if err := cmd.Start(); err != nil {
-		slog.Error("Failed to start codeactor-codebase", "error", err)
+		slog.Error("Failed to start codeactor-codexray", "error", err)
 		return nil
 	}
 
-	slog.Info("Started codeactor-codebase server", "pid", cmd.Process.Pid, "address", address, "repo", repoPath, "log", logPath)
+	slog.Info("Started codeactor-codexray server", "pid", cmd.Process.Pid, "address", address, "repo", repoPath, "log", logPath)
 
 	go func() {
-		if err := waitForCodebase(address, 60*time.Second); err != nil {
+		if err := waitForCodexray(address, 60*time.Second); err != nil {
 			slog.Error("Codebase server failed to become healthy", "error", err)
 			cmd.Process.Kill()
 		}
@@ -384,8 +384,8 @@ func startCodebaseServer(port int, repoPath string) *exec.Cmd {
 	return cmd
 }
 
-// waitForCodebase polls the /health endpoint until the service responds or timeout.
-func waitForCodebase(address string, timeout time.Duration) error {
+// waitForCodexray polls the /health endpoint until the service responds or timeout.
+func waitForCodexray(address string, timeout time.Duration) error {
 	healthURL := fmt.Sprintf("http://%s/health", address)
 	deadline := time.Now().Add(timeout)
 	client := &nethttp.Client{Timeout: 2 * time.Second}
@@ -407,5 +407,5 @@ func waitForCodebase(address string, timeout time.Duration) error {
 		time.Sleep(500 * time.Millisecond)
 	}
 
-	return fmt.Errorf("codebase server at %s not healthy after %v: %w", address, timeout, lastErr)
+	return fmt.Errorf("codexray server at %s not healthy after %v: %w", address, timeout, lastErr)
 }
diff --git a/scripts/build-centos7.sh b/scripts/build-centos7.sh
index a6f9cb6..369edbc 100755
--- a/scripts/build-centos7.sh
+++ b/scripts/build-centos7.sh
@@ -39,15 +39,15 @@ unzip /tmp/protoc.zip -d /usr/local
 rm -f /tmp/protoc.zip
 protoc --version
 
-echo "=== Step 6: Build Rust codebase ==="
+echo "=== Step 6: Build Rust codexray ==="
 source /opt/rh/devtoolset-9/enable
-cd codebase
+cd codexray
 cargo build --release
 
 echo "=== Step 7: Prepare embedded binaries ==="
 cd ..
 mkdir -p dist/bin
-cp codebase/target/release/codeactor-codebase dist/bin/
+cp codexray/target/release/codeactor-codexray dist/bin/
 
 # Download fzf
 curl -fLo /tmp/fzf.tar.gz "https://github.com/junegunn/fzf/releases/download/v0.73.1/fzf-0.73.1-linux_amd64.tar.gz"
@@ -62,7 +62,7 @@ tar -xzf /tmp/rg.tar.gz -C /tmp/rg_extract
 find /tmp/rg_extract -name rg -type f -exec mv {} dist/bin/rg \;
 rm -rf /tmp/rg_extract /tmp/rg.tar.gz
 
-chmod +x dist/bin/codeactor-codebase dist/bin/fzf dist/bin/rg
+chmod +x dist/bin/codeactor-codexray dist/bin/fzf dist/bin/rg
 
 echo "=== Step 8: Build Go codeactor ==="
 export PATH="/usr/local/go/bin:$PATH"