# CodeWeaver

**Repository Path**: panda26/code-weaver

## Basic Information

- **Project Name**: CodeWeaver
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeWeaver

CodeWeaver 是一个本地优先的代码分析与检索服务，核心链路是：

`静态分析 -> 调用图/数据流 -> 增量索引 -> 上下文裁剪 -> OpenAI 兼容接口`

当前版本已经支持：

- Python 代码静态分析。
- 调用图与跨函数数据流。
- `git diff` 驱动增量索引。
- 模块级影响面传播和图重建。
- 文件监听驱动自动增量索引。
- 读取 `.gitignore` 与自定义排除规则。
- 本地检索与 OpenAI 兼容聊天接口。
- 新版 OpenAI Responses API 兼容网关，和 `chat/completions` 共享本地检索注入与会话摘要记录。
- 历史上下文裁剪与检索上下文注入。
- 真实云端模型配置。
- `uv` 本地运行和 Docker 运行。

## 工程结构

```text
.
├── src/codeweaver
│   ├── api
│   ├── analysis
│   ├── indexing
│   ├── llm
│   ├── cli.py
│   ├── config.py
│   ├── models.py
│   └── service.py
├── docs
│   ├── technical-design.md
│   └── user-guide.md
├── tests
├── Dockerfile
├── docker-compose.yml
└── pyproject.toml
```

说明：

- `src/codeweaver` 是当前正式代码目录。
- `app` 目录只保留最小兼容入口，不再承载实际业务实现。
- 当前增量索引会把“变更模块”沿模块依赖和历史模块调用关系做影响面传播，只重算受影响模块。

## 快速开始

### 1. 安装依赖

```powershell
uv sync --extra dev
```

### 2. 建立索引

```powershell
uv run python -m codeweaver.cli index --repo C:\path\to\repo
```

### 3. 本地检索

```powershell
uv run python -m codeweaver.cli retrieve --repo C:\path\to\repo --query "create_user 的调用链"
```

### 4. 启动自动监听

```powershell
uv run python -m codeweaver.cli watch --repo C:\path\to\repo
```

### 5. 启动 API

```powershell
uv run uvicorn codeweaver.api.app:app --host 0.0.0.0 --port 8000 --reload
```

### 6. Docker

```powershell
docker compose up --build
```

## 关键接口

- `GET /health`
- `GET /api/config/llm`
- `POST /api/index`
- `POST /api/retrieve`
- `POST /api/watch/start`
- `POST /api/watch/stop`
- `GET /api/watch/status`
- `POST /api/knowledge/query`
- `POST /api/knowledge/overview`
- `POST /api/knowledge/adr`
- `POST /v1/chat/completions`
- `POST /v1/responses`

## 文档

- 技术设计文档：[technical-design.md](/C:/myself/CodeWeaver/docs/technical-design.md)
- 使用说明文档：[user-guide.md](/C:/myself/CodeWeaver/docs/user-guide.md)
- Responses 网关文档：[openai-responses-gateway.md](/C:/myself/CodeWeaver/docs/openai-responses-gateway.md)
- 工程组织规范：[engineering-guidelines.md](/C:/myself/CodeWeaver/docs/engineering-guidelines.md)
- 知识沉淀架构：[knowledge-memory-architecture.md](docs/knowledge-memory-architecture.md)

## 常用命令

查看云端模型配置：

```powershell
uv run python -m codeweaver.cli config
```

开启 `.gitignore` 并追加自定义排除规则：

```powershell
$env:CODEWEAVER_REPO_USE_GITIGNORE="true"
$env:CODEWEAVER_REPO_EXCLUDE_PATTERNS='["generated/","legacy/*.py"]'
```

强制使用 `git diff` 增量索引：

```powershell
uv run python -m codeweaver.cli index --repo C:\path\to\repo --source git_diff
```

强制全量重建：

```powershell
uv run python -m codeweaver.cli index --repo C:\path\to\repo --full
```

启用知识对象 PostgreSQL + Qdrant 双写：

```powershell
$env:CODEWEAVER_USE_PG="true"
$env:CODEWEAVER_PG_DSN="postgresql://user:pass@127.0.0.1:5432/codeweaver"
$env:CODEWEAVER_PG_KNOWLEDGE_TABLE="codeweaver_knowledge"
$env:CODEWEAVER_KNOWLEDGE_QDRANT_COLLECTION="codeweaver_knowledge"
```