# kn-basic-dd

**Repository Path**: wspshaopeng/kn-basic-dd

## Basic Information

- **Project Name**: kn-basic-dd
- **Description**: 开源，知识库系统开源，知识库系统开源，知识库系统开源，知识库系统开源，知识库系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KN-XT · 企业级知识智能工作台

企业级智能知识库：双轨制文档处理（自动 RAG + 人工策展 OKF Wiki）、动态路由问答、反馈回流闭环、人机协同风控。

## 技术栈

- **后端** `kn-backend-node/` — Node.js + TypeScript + Fastify + SQLite（better-sqlite3）+ sqlite-vec
- **前端** `kn-frontend/` — Vue 3 + Element Plus + TypeScript + Vite
- **MCP** `mcp/` — Gitee SSOT 一致性写入服务（Go）
- **外部依赖（可选）** — SiliconFlow（LLM/向量）、MinerU（文档解析）；未配置时自动降级

## 快速启动

```bash
# 1. 后端（端口 8080）
cd kn-backend-node && npm install && npm run dev

# 2. 前端（端口 5173，自动代理 /api → 8080）
cd kn-frontend && npm install && npm run dev

# 3. 访问
open http://localhost:5173/kn-basic/
```

配置见 `kn-backend-node/config.yaml`（本地配置，已 gitignore；模板 `config.example.yaml`）。首次 clone 需 `cp config.example.yaml config.yaml` 并填入 API key。

## 架构基准

**唯一架构基准文档**：[`docs/architecture-redesign.md`](docs/architecture-redesign.md)

核心设计：

| 主题 | 章节 |
|------|------|
| 双轨写入流水线（Track A RAG / Track B OKF）| §8 双线路状态机、§9 数据写入流水线 |
| 运行时动态路由（小库纯 LLM / 大库三路 RRF）| §10 运行时问答动态路由 |
| 4 通道分级召回（+10/+5/+2/+0）| §4 4 通道分级召回 |
| 编排层协议（Agent/Skill/Card/WS/Trace）| 附录 A |
| OKF v0.1 规范对齐（无 manifest，纯内存 catalog）| [`docs/okf-v0.1-alignment.md`](docs/okf-v0.1-alignment.md) |
| 前端 IA 与线稿 | [`docs/frontend-design.md`](docs/frontend-design.md) |

## 核心理念

1. **双轨制** — 文档上传后，Track A（RAG，自动）快速入库可问答；Track B（OKF/MRP，人工策展）产出结构化 Wiki。两轨独立成败、独立重试。
2. **Git-Centric** — OKF Bundle 以 Markdown 文件形式存于磁盘、同步至 Gitee；MCP 作为唯一写入方保证一致性。
3. **人机协同风控** — 文档上传经 DLP 预检 + 0-100 风险打分 + 人工确认闸门。