Skip to content

README.zh-CN.md

Latest commit

 

History

History
116 lines (89 loc) · 2.8 KB

README.zh-CN.md

File metadata and controls

116 lines (89 loc) · 2.8 KB
Raw

Code Context Engine

ci release license npm version npm downloads

简体中文 | English

Code Context Engine 是一个面向 review agent 和 coding agent 的本地运行时。它把仓库转成结构化证据包和上下文包，而不是把零散搜索结果当作产品核心。

产品定位

产品核心是：

  • 本地 TypeScript runtime
  • task-oriented context builders
  • agent bundle / skill 模板

默认检索策略：

  • lexical / symbol first
  • graph expand second
  • semantic rerank last

安装

npm install -g code-context-engine

Runtime API

import { createCodeContextEngine } from 'code-context-engine';

const engine = createCodeContextEngine({ repoRoot: '/path/to/repo' });

const lexical = await engine.search.lexical({
  query: 'authenticateUser',
  mode: 'exact',
  pathPattern: 'src/auth/**',
  lang: 'ts',
});

const implementation = await engine.tasks.implementationContext({
  task: 'implementation_context',
  query: 'UserRepository',
  symbolHints: ['findById', 'save'],
});

const impact = await engine.tasks.findImpact({
  task: 'find_impact',
  query: 'UserService',
});

const review = await engine.tasks.reviewContextForDiff({
  task: 'review_pr',
  diffText: rawDiff,
});

Symbol Navigation

Runtime 暴露的高阶导航能力：

  • findDefinition
  • findReferences
  • findImplementations
  • findImporters
  • findExports
  • findContainingScope

薄 MCP 适配层

MCP 只保留直接服务 agent 工作流的工具：

  • check_index
  • rebuild_index
  • read_file
  • repo_map
  • lexical_search
  • implementation_context
  • find_tests
  • find_impact
  • find_extension_points
  • review_context_for_diff
code-context-engine ai serve
code-context-engine ai serve --http --port 3000

薄 CLI 适配层

CLI 仅保留本地调试和验证用途：

code-context-engine ai index --overwrite
code-context-engine ai check-index
code-context-engine ai status --json
code-context-engine ai repo-map --max-files 20
code-context-engine ai agent install
code-context-engine ai serve

Agent Bundle

npx skills add mars167/git-ai-cli/skills/git-ai-code-search
code-context-engine ai agent install

验证

npm run build
npm test