# KnowledgeInsight-core **Repository Path**: CmbTestWorker/knowledge-insight-core ## Basic Information - **Project Name**: KnowledgeInsight-core - **Description**: No description available - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # knowledge-insight-core 知识数据中台的 Python 知识服务(检索 / 探索 / 摄取 / 建边 / 模型网关),首版为**单镜像、三进程角色**:`api`、`ingest`、`graph`。 ## 设计文档 服务设计文档已归入本仓库 [`docs/`](docs/README.md): | 文档 | 内容 | | --- | --- | | [00-实现方案](docs/00-实现方案.md) | Python 工程实现规划:FastAPI 选型、包结构、模块边界、接口、测试与里程碑 | | [03-检索服务](docs/03-检索服务.md) | BM25 + kNN 双通道、RRF、版本核验、Jev 评分、扩展词、排序与降级 | | [04-探索服务](docs/04-探索服务.md) | 建边算法、图发布、邻居与证据 API | | [05-摄取与模型网关](docs/05-摄取与模型网关.md) | 解析、切片、分词、向量化、特征、任务租约、内网 Jev/embedding 配置、COS 产物写入 | 跨项目文档(总体设计、数据模型、工程规范、实施计划、调用链路)也位于本仓库 `docs/`,入口见 [总体设计索引](docs/总体设计索引.md)。 ## 技术栈 - Python 3.12 + FastAPI + Pydantic v2 + SQLAlchemy 2 async + elasticsearch-py 8.x - 模块划分:`api` / `retrieval` / `explore` / `ingest` / `graph` / `model` / `jobs`,边界由 import 规则强制 - 共享纯逻辑:`knowledge-core`(切片、分词、摘要、IDF、Jev 协议、ES/对象存储封装) ## 状态 当前已实现 API 骨架与 BM25 检索切片。`ingest` 和 `graph` 进程入口随对应阶段实现。整体实施顺序见 [10-实施计划与验收](docs/10-实施计划与验收.md)。 ## 本地运行 当前切片提供内部请求头检查、BM25 召回、发布指针批查和 UTF-8 多区间定位。API 会返回 `degraded=true` 和 `degrade_reason=bm25_only`。入库和建图由后续阶段接入。 ```sh uv sync --locked docker compose -f deploy/compose.yaml up -d uv run --locked python scripts/bootstrap_es.py export CORE_MANAGER_HMAC_SECRET='<本地 Manager 签名密钥>' export CORE_MANAGER_URL='http://127.0.0.1:8081' uv run --locked python -m backend.api ``` `/health/live` 检查进程,`/health/ready` 检查 ES 读别名与 Manager 的 `/actuator/health`。API 监听 8100。当前内网联调中,`/internal/**` 只检查 `X-Namespace-Id`、`X-Principal-Id`、`X-Request-Id`、`X-Timestamp` 和 `X-Signature` 是否非空,后两个可用占位值。向 Manager 批查时,Core 仍使用 `CORE_MANAGER_HMAC_SECRET` 签名,服务主体由 `CORE_MANAGER_PRINCIPAL` 指定(默认 `core`)。 默认的契约测试使用固定数据和 Manager、ES 替身。可在上面的 ES 启动后运行真实 ES 测试, 测试会创建并清理独立索引。 ```sh uv run --locked pytest TEST_ES_URL=http://127.0.0.1:9200 uv run --locked pytest ```