NetCoreKevin

快速开始

4. 启动后端

dotnet run --project App/WebApi

launchSettings.json 里已经指定 ASPNETCORE_ENVIRONMENT=Development 与 http://localhost:9901。

5. 启动管理后台

cd vue/kevin.web.vue
npm install
npm run serve

开发服务器已把 /VarApi 反向代理到 http://localhost:9901，不需要额外配跨域。

1. 启动 Qdrant

docker run -d --name qdrant -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant

QdrantClientSetting 默认指向 localhost，本机跑的话不用改。

智能体是配置出来的，不是写死的

• 提示词 / 模型 / 参数：每个智能体单独配置，对话模型与向量模型分开选，温度、上下文裁剪都能调。
• 技能动态加载：技能是 SKILL.md + 脚本（.py / .ps1 / .sh），后台能新建、在线编辑、随时启停，改完不用重新编译。
• 知识库（RAG）：上传文档自动切分写入 Qdrant，检索结果过一遍 qwen3-rerank 重排再喂给模型。
• 记忆：按「租户 + 智能体 + 用户」三维隔离存在 Qdrant，是否使用记忆挂在智能体开关上。
• 多智能体协同：主智能体可以把子任务派给其他智能体执行。
• 上下文压缩：按配置阈值压缩历史消息，长期使用不会越聊越慢、越聊越贵。
• 联网搜索：接入火山引擎豆包搜索，模型需要新信息时自己去查。
• 全模态：图片理解、语音转写（阿里 ASR）、文生图（生成后自动上传 OSS）。

2. 配置连接串

编辑 App/WebApi/appsettings.json：

{
  "ConnectionStrings": {
    "dbConnection": "server=127.0.0.1;port=3306;database=kevin_app;user id=root;password=admin123",
    "redisConnection": "127.0.0.1:6379,DefaultDatabase=0,password=123456"
  }
}

同一个文件里还有 Hangfire、Consul、对象存储、模型服务等配置，按需覆盖；appsettings.Development.json 会覆盖同名项。

AI 能力配置

2. 配置模型

向量模型与对话模型在后台「模型管理」里配，也可以直接改 appsettings.json。模型接入走 OpenAI 协议：只要服务商提供 OpenAI 兼容接口，填好地址、模型名和 Key 就能用——OpenAI、智谱、DeepSeek、通义、Kimi、vLLM、Ollama 都在支持范围内。下面以智谱和 Ollama 为例：

云端服务（以智谱为例，注册地址；换成其它 OpenAI 兼容服务的地址和 Key 即可）：

{
  "OllamaApiSetting": {
    "Url": "https://open.bigmodel.cn/api/paas/v4/embeddings",
    "DefaultModel": "embedding-3",
    "ApiKey": "your-api-key"
  }
}

Ollama（本地，原生接口不传 ApiKey）：

{
  "OllamaApiSetting": {
    "Url": "http://localhost:11434/api/embeddings",
    "DefaultModel": "qwen3:4b"
  }
}

重排模型走 AliRerankApiSetting（默认 qwen3-rerank），不配也能用，只是检索结果不做二次排序。

4. 用 Ollama 跑本地模型（可选）

• 支持 macOS、Windows、Linux 与 Docker 部署，官方下载：<https://ollama.com/download>
• 硬件建议：4 核以上 CPU、16GB 以上内存、足够的磁盘空间；想跑大模型或微调再上 NVIDIA GPU。
• 拉一个能跑得动的小模型先试：

ollama run qwen3:4b

然后在后台把对话模型的地址指向 http://localhost:11434。