快速开始

环境要求

• Node.js >= 20
• pnpm 或 npm
• Embedding 与 Rerank API 配置

安装

npm install -g @chiway/contextweaver

也可以使用 pnpm：

pnpm add -g @chiway/contextweaver

初始化配置

contextweaver init

简写命令：

cw init

命令会创建 ~/.contextweaver/.env。编辑该文件并填入 Embedding 与 Rerank 配置：

EMBEDDINGS_API_KEY=your-api-key-here
EMBEDDINGS_BASE_URL=https://api.siliconflow.cn/v1/embeddings
EMBEDDINGS_MODEL=BAAI/bge-m3
EMBEDDINGS_DIMENSIONS=1024

RERANK_API_KEY=your-api-key-here
RERANK_BASE_URL=https://api.siliconflow.cn/v1/rerank
RERANK_MODEL=BAAI/bge-reranker-v2-m3

索引代码库

在代码库根目录执行：

contextweaver index

指定路径：

contextweaver index /path/to/your/project

强制重新索引：

contextweaver index --force

搜索代码

cw search --information-request "用户认证流程是如何实现的？"

携带精确术语：

cw search \
  --information-request "数据库连接逻辑" \
  --technical-terms "DatabasePool,Connection"

下一步

想让 AI 客户端直接检索代码库，请参阅 MCP 集成，其中包含 Codex 与 Claude Code 的配置示例。